ec2.instance-type-offerings.list

List instance types per availability zone with inStock and when it last changed (e.g. "arm-2 sold out in de1a, in stock in de1b")

GET /ec2/api/instance-type-offeringsIAM ec2:DescribeInstanceTypeOfferingsRead

Request syntax

GET /ec2/api/instance-type-offerings

Query parameters

  • regionIdOptional

    string

    Region (default: the caller’s)

    Constraints: 1-32 chars

  • availabilityZoneIdOptional

    string

    Only this zone

    Constraints: /^[a-z]+[0-9]+[a-z]$/

  • instanceTypeOptional

    string

    Only this instance type, e.g. performance-2

    Constraints: /^[a-z0-9-]{2,24}$/

Response

200: `data` is a list sorted by type, then zone: instanceType, availabilityZoneId, providerLocation, inStock, changedAt, checkedAt. Beside it, `unknownZones` names the zones whose stock could not be read.

A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.

Errors

  • 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
  • 401No credentials, or an access key that is unknown, revoked or expired.
  • 403The caller's policies do not allow ec2:DescribeInstanceTypeOfferings on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
  • 404The resource does not exist in your organization.

Examples

The required parameters only, with example values. Replace id and the other placeholders with your own.

dcloud ec2 instance-type-offerings list

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_ec2_instance-type-offerings_list.