DescribeZones - Elastic Compute Service - Centre de documentation Alibaba Cloud

Consulte la liste des zones actives en fonction de paramètres tels que l'identifiant de la région et le mode de facturation.

Description de l'opération

DescribeZones interroge uniquement la liste des zones fournies par Alibaba Cloud et renvoie des informations d'inventaire limitées. Pour interroger les types d'instances et les catégories de disques disponibles à l'achat dans une zone spécifique, utilisez DescribeAvailableResource.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région où se trouvent les zones. Vous pouvez appeler DescribeRegions pour consulter la liste des régions la plus récente.	cn-hangzhou
Verbose	boolean	Non	Indique si des informations détaillées doivent être affichées. true : affiche des informations détaillées. false : n'affiche pas d'informations détaillées. Valeur par défaut : true.	false
InstanceChargeType	string	Non	Le mode de facturation pris en charge par les ressources dans la zone active. Pour plus d'informations, consultez Présentation de la facturation. Valeurs valides : PrePaid : abonnement. PostPaid : paiement à l'usage. Valeur par défaut : PostPaid.	PostPaid
SpotStrategy	string	Non	La stratégie d'enchères pour les instances à paiement à l'usage. Vous pouvez spécifier ce paramètre lorsque InstanceChargeType=PostPaid. Pour plus d'informations, consultez Instances spot. Valeurs valides : NoSpot : instance à paiement à l'usage standard. SpotWithPriceLimit : instance spot avec une limite de prix maximum. SpotAsPriceGo : instance spot facturée au prix du marché avec le prix à l'usage comme limite supérieure. Valeur par défaut : NoSpot.	NoSpot
AcceptLanguage	string	Non	La langue naturelle utilisée pour filtrer les résultats de la réponse. Pour plus d'informations, consultez la RFC 7231. Valeurs valides : zh-CN : chinois simplifié. zh-TW : chinois traditionnel. en-US : anglais. ja : japonais. fr : français. de : allemand. ko : coréen. Valeur par défaut : zh-CN. Valeurs valides : de : Allemand. en-US : Anglais. ko : Coréen. zh-TW : Chinois traditionnel. ja : Japonais. fr : Français. zh-CN : Chinois simplifié.	zh-CN

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Zones	object
Zone	array<object>	La collection de zones et les informations sur les ressources prises en charge dans chaque zone.
	array<object>
ZoneId	string	The zone ID.	cn-hangzhou-g
ZoneType	string	The type of the zone. Valid values: AvailabilityZone: public cloud zone.	AvailabilityZone
LocalName	string	The name of the zone in the local language.	华东 1 可用区 G
AvailableResources	object
ResourcesInfo	array<object>	The array of available resources that can be created.
	array<object>
IoOptimized	boolean	Indicates whether the instance is an I/O optimized instance.	true
SystemDiskCategories	object
supportedSystemDiskCategory	array	The list of system disk categories.
	string	The system disk category that can be created. Valid values: cloud: basic disk. cloud_efficiency: ultra disk. cloud_ssd: standard SSD. cloud_essd: enterprise SSD.	cloud_essd
InstanceGenerations	object
supportedInstanceGeneration	array	The list of supported instance family generations.
	string	The instance family generation.	ecs-6
DataDiskCategories	object
supportedDataDiskCategory	array	The data disk categories that can be created.
	string	The data disk category. Valid values: cloud: basic disk. cloud_efficiency: ultra disk. cloud_ssd: standard SSD. cloud_essd: enterprise SSD. ephemeral_ssd: local SSD.	cloud_essd
InstanceTypes	object
supportedInstanceType	array	The list of instance types.
	string	The list of instance types that can be created for the current zone, network type (NetworkTypes), and I/O optimization (IoOptimized) combination.	ecs.g5.large
InstanceTypeFamilies	object
supportedInstanceTypeFamily	array	The list of instance families that can be created.
	string	The instance family.	ecs.r7t
NetworkTypes	object
supportedNetworkCategory	array	The list of supported network types.
	string	The supported network type. Valid values: VPC: virtual private cloud (VPC). Classic: classic network. The classic network is deprecated. For more information, see Deprecation notice.	vpc
AvailableResourceCreation	object
ResourceTypes	array	The list of resource types that can be created.
	string	The resource type that can be created. Valid values: VSwitch: vSwitch. IoOptimized: I/O optimized instance. Instance: instance. DedicatedHost: dedicated host. Disk: disk.	DedicatedHost
DedicatedHostGenerations	object
DedicatedHostGeneration	array	The list of supported dedicated host generations.
	string	The supported dedicated host generation.	ddh-6
AvailableInstanceTypes	object
InstanceTypes	array	The list of all instance types that can be created in the current zone.
	string	The instance type that can be created in the current zone.	ecs.g6.xlarge
AvailableDiskCategories	object
DiskCategories	array	The collection of disk categories that can be created.
	string	The disk category that can be created. Valid values: cloud: basic disk. cloud_ssd: standard SSD. cloud_efficiency: ultra disk. cloud_essd: enterprise SSD.	cloud
AvailableDedicatedHostTypes	object
DedicatedHostType	array	The list of supported dedicated host types.
	string	The supported dedicated host type.	ddh.g6
AvailableVolumeCategories	object
VolumeCategories	array	The list of supported shared storage types.
	string	The supported shared storage type.	san_efficiency

Exemples

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Zones": {
    "Zone": [
      {
        "ZoneId": "cn-hangzhou-g",
        "ZoneType": "AvailabilityZone",
        "LocalName": "华东 1 可用区 G",
        "AvailableResources": {
          "ResourcesInfo": [
            {
              "IoOptimized": true,
              "SystemDiskCategories": {
                "supportedSystemDiskCategory": [
                  "cloud_essd"
                ]
              },
              "InstanceGenerations": {
                "supportedInstanceGeneration": [
                  "ecs-6"
                ]
              },
              "DataDiskCategories": {
                "supportedDataDiskCategory": [
                  "cloud_essd"
                ]
              },
              "InstanceTypes": {
                "supportedInstanceType": [
                  "ecs.g5.large"
                ]
              },
              "InstanceTypeFamilies": {
                "supportedInstanceTypeFamily": [
                  "ecs.r7t"
                ]
              },
              "NetworkTypes": {
                "supportedNetworkCategory": [
                  "vpc"
                ]
              }
            }
          ]
        },
        "AvailableResourceCreation": {
          "ResourceTypes": [
            "DedicatedHost"
          ]
        },
        "DedicatedHostGenerations": {
          "DedicatedHostGeneration": [
            "ddh-6"
          ]
        },
        "AvailableInstanceTypes": {
          "InstanceTypes": [
            "ecs.g6.xlarge"
          ]
        },
        "AvailableDiskCategories": {
          "DiskCategories": [
            "cloud"
          ]
        },
        "AvailableDedicatedHostTypes": {
          "DedicatedHostType": [
            "ddh.g6"
          ]
        },
        "AvailableVolumeCategories": {
          "VolumeCategories": [
            "san_efficiency"
          ]
        }
      }
    ]
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidSpotStrategy	The specified SpotStrategy is not valid.	The specified SpotStrategy parameter is invalid.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	The specified region ID does not exist.
404	InvalidRegion.NotFound	The specified parameter RegionId is not valid.
404	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records.
404	InvalidAcceptLanguage.NotFound	Only Chinese (zh-CN), English (en-US), and Japanese (ja) are allowed.	Your selected language is invalid. Only Chinese, English, and Japanese are supported.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.