Describes the zones that are available to you in a specified region. For more information, see Regions and zones.

Request parameters

Name Type Required Description
Action String Yes The name of this interface. Value: Description zones.
RegionId String Yes The region ID. For more information, call DescribeRegions to obtain the latest region list.
InstanceChargeType String No Billing methods of the instance. For more information, see Pricing overview. Optional values:
  • PrePaid (Default): Subscription.
  • PostPaid: Pay-As-You-Go.
SpotStrategy String No Sets your expected spot price for preemptible instances. This parameter takes effect when you set InstanceChargeType to PostPaid. For more information, see Preemptible instance. Optional values:
  • NoSpot (Default): Bids as a normal Pay-As-You-Go instance.
  • SpotWithPriceLimit: Sets a bidding price threshold for the spot instance.
  • SpotAsPriceGo: Sets a highest Pay-As-You-Go price by the bidding system automatically.

Response parameters

Name Type Description
Zones ZoneType A collection that contains ZoneType information.

Examples

Request example
https://ecs.aliyuncs.com/?Action=DescribeZones
&RegionId=cn-hangzhou
&<Common Request Parameters>
Response example

XML format

<DescribeZonesResponse>
    <Zones>
        <Zone>
            <AvailableResourceCreation>
                <ResourceTypes>Instance</ResourceTypes>
                <ResourceTypes>Disk</ResourceTypes>
            </AvailableResourceCreation>
            <LocalName></LocalName>
            <ZoneId>cn-hangzhou-d</ZoneId>
            <AvailableDiskCategories>
                <DiskCategories>cloud</DiskCategories>
            </AvailableDiskCategories>
        </Zone>
        <Zone>
            <AvailableResourceCreation>
                <ResourceTypes>Instance</ResourceTypes>
                <ResourceTypes>Disk</ResourceTypes>
            </AvailableResourceCreation>
            <LocalName></LocalName>
            <ZoneId>cn-hangzhou-b</ZoneId>
            <AvailableDiskCategories>
                <DiskCategories>cloud</DiskCategories>
            </AvailableDiskCategories>
        </Zone>
    </Zones>
    <RequestId>6DB97BCC-92BA-424D-A7C8-3F6486612BAE</RequestId>
</DescribeZonesResponse>
JSON format
{
  "RequestId": "A347EF0E-BBCC-4EFA-BD79-27AA3ACFD1BF",
  "Zones": {
    "Zone": [
      {
        "AvailableDiskCategories": {
          "DiskCategories": [
            "cloud"
          ]
        },
        "AvailableResourceCreation": {
          "ResourceTypes": [
            "Instance",
            "Disk"
          ]
        },
        "LocalName": "",
        "ZoneId": "cn-hangzhou-d"
      },
      {
        "AvailableDiskCategories": {
          "DiskCategories": [
            "cloud"
          ]
        },
        "AvailableResourceCreation": {
          "ResourceTypes": [
            "Instance",
            "Disk"
          ]
        },
        "LocalName": "",
        "ZoneId": "cn-hangzhou-b"
      }
    ]
  }
}

Error codes

All are common error codes. For more information, see API Error Center.