Get a cost estimate for a snapshot

POST

https://api.americancloud.com/api/v1/storage/snapshots/cost-estimate

POST

/api/v1/storage/snapshots/cost-estimate

curl -X POST https://api.americancloud.com/api/v1/storage/snapshots/cost-estimate \
     -H "X-API-Client-ID: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "volumeId": "vol-123456",
  "name": "my-data-snapshot",
  "type": "DataDisk"
}'

{
  "estimates": {
    "hourly": {
      "base": 36,
      "discount": 7.2,
      "total": 28.8,
      "prorated": {
        "days_remaining": 15,
        "amount": 14.4
      }
    },
    "monthly": {
      "base": 36,
      "discount": 7.2,
      "total": 28.8,
      "prorated": {
        "days_remaining": 15,
        "amount": 14.4
      }
    }
  },
  "discount_applied": {
    "name": "20% off VMs",
    "percent": 20,
    "resource_types": [
      "Virtual Machine",
      "Block Storage"
    ]
  },
  "billing_note": "Nothing is charged now. Usage appears on your monthly bill, with a minimum of $5/month for 250 GB, prorated for your first partial month.",
  "metered": {
    "rate_per_gb_month": {
      "base": 36,
      "discount": 7.2,
      "total": 28.8,
      "prorated": {
        "days_remaining": 15,
        "amount": 14.4
      }
    },
    "minimum_gb": 250
  }
}

Returns the estimated cost for a snapshot of the given volume without creating it. Accepts the same body as create.

Authentication

X-API-Client-IDstring

API Client ID

X-API-Client-Secretstring

API Client Secret

Request

This endpoint expects an object.

volumeIdstringRequiredformat: "uuid"

ID of the volume to create a snapshot from

namestringRequired

Name for the new snapshot

typeenumRequired

Type of the snapshot (data or root)

Allowed values:

Response

Cost estimate for the snapshot

estimatesobject

Cost estimates for the resource

discount_appliedobjectOptional

Discount applied to the estimate (if any)

billing_notestringOptional

Additional billing information or notes about pricing structure

meteredobjectOptional

The usage rate, for a resource that is billed by usage (object storage only).

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error