DescribeAvailableResource - Elastic Compute Service - Centre de documentation Alibaba Cloud

Consulte l'état des stocks de ressources dans une zone spécifiée. Cette opération est principalement utilisée pour vérifier si les ressources cibles, telles que les types d'instances et les types de disques système, sont disponibles dans une zone spécifique avant de créer des instances (RunInstances) ou de modifier les spécifications d'instance (ModifyInstanceSpec).

Description de l'opération

Le paramètre DestinationResource présente une logique et des exigences différentes selon sa valeur. Dans la liste ordonnée suivante, une valeur de rang inférieur nécessite la définition de davantage de paramètres. Vous ne pouvez pas utiliser une valeur de rang inférieur pour filtrer les ressources d'une catégorie de rang supérieur.

Ordre des valeurs : Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk.
Exemples :
- Si DestinationResource est défini sur DataDisk :
  - Si ResourceType est défini sur disk, l'opération interroge les types de disques de données qui ne sont pas associés à un type d'instance ECS spécifique. Dans ce cas, le paramètre InstanceType est facultatif.
  - Si ResourceType est défini sur instance, l'opération interroge les types de disques de données qui peuvent être attachés à une instance ECS. Étant donné que les types d'instances imposent des restrictions sur les disques de données, vous devez spécifier à la fois InstanceType et DataDiskCategory.
- Si DestinationResource est défini sur SystemDisk et ResourceType sur instance, vous devez spécifier le paramètre InstanceType car les types d'instances ECS imposent des restrictions sur les disques système.
- Si DestinationResource est défini sur InstanceType, spécifiez les paramètres IoOptimized et InstanceType.
- Interroger le stock de ecs.g5.large dans toutes les zones d'une région spécifiée : RegionId=ap-southeast-1 &DestinationResource=InstanceType &IoOptimized=optimized &InstanceType=ecs.g5.large.
- Interroger les zones d'une région spécifiée où ecs.g5.large est disponible : RegionId=ap-southeast-1 &DestinationResource=Zone &IoOptimized=optimized &InstanceType=ecs.g5.large.

Interroger les zones de la région China (Hangzhou) où le type d'instance ecs.g5.large est disponible.

"RegionId": "cn-hangzhou",
"DestinationResource": "Zone",
"InstanceType": "ecs.g5.large"

Interroger le stock du type d'instance ecs.g5.large dans toutes les zones de la région China (Hangzhou).

"RegionId": "cn-hangzhou",
"DestinationResource": "InstanceType",
"InstanceType": "ecs.g5.large"

[Achat d'un disque de données uniquement] Interroger le stock du type de disque de données cloud_efficiency dans la zone B de la région China (Hangzhou).

"RegionId": "cn-hangzhou",
"ZoneId": "cn-hangzhou-b",
"ResourceType": "disk",
"DestinationResource": "DataDisk"

[Achat d'une instance ECS et d'un disque système] Interroger le stock du type d'instance ecs.g7.large avec le type de disque système cloud_essd dans la zone B de la région China (Hangzhou).

"RegionId": "cn-hangzhou",
"ZoneId": "cn-hangzhou-b",
"ResourceType": "instance",
"InstanceType": "ecs.g7.large",
"DestinationResource": "SystemDisk",
"SystemDiskCategory": "cloud_essd"

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 de destination. Vous pouvez appeler DescribeRegions pour obtenir la liste des régions la plus récente.	cn-hangzhou
InstanceChargeType	string	Non	Le mode de facturation de la ressource. Pour plus d'informations, consultez Présentation de la facturation. Valeurs valides : PrePaid : abonnement. PostPaid : paiement à l'usage. Valeur par défaut : PostPaid.	PrePaid
SpotStrategy	string	Non	La stratégie d'enchères pour les instances à paiement à l'usage. Valeurs valides : NoSpot : instance à paiement à l'usage standard. SpotWithPriceLimit : instance spot avec une limite de prix maximale. SpotAsPriceGo : instance spot facturée au prix du marché avec le prix à l'usage comme limite supérieure. Valeur par défaut : NoSpot. Ce paramètre prend effet uniquement lorsque InstanceChargeType est défini sur PostPaid.	NoSpot
SpotDuration	integer	Non	La période de protection de l'instance spot. Unité : heures. Valeur par défaut : 1. Valeurs valides : 1 : après la création d'une instance spot, Alibaba Cloud garantit que l'instance n'est pas libérée automatiquement dans l'heure qui suit. Après 1 heure, le système compare le prix de l'enchère au prix du marché et vérifie le stock pour déterminer s'il faut conserver ou libérer automatiquement l'instance. 0 : après la création d'une instance spot, Alibaba Cloud ne garantit pas que l'instance s'exécute pendant 1 heure. Le système compare le prix de l'enchère au prix du marché et vérifie le stock pour déterminer s'il faut conserver ou libérer automatiquement l'instance. Alibaba Cloud envoie une notification d'événement système ECS 5 minutes avant la libération de l'instance. Les instances spot sont facturées à la seconde. Sélectionnez une période de protection appropriée en fonction de la durée d'exécution prévue de la tâche. Remarque Ce paramètre prend effet uniquement lorsque InstanceChargeType est défini sur PostPaid et SpotStrategy sur SpotWithPriceLimit ou SpotAsPriceGo.	1
DestinationResource	string	Oui	Le type de ressource à interroger. Valeurs valides : Zone : zone. IoOptimized : optimisé pour les E/S. InstanceType : type d'instance. Network : type de réseau. ddh : hôte dédié. SystemDisk : disque système. DataDisk : disque de données. Remarque Lorsque DestinationResource est défini sur SystemDisk, vous devez spécifier InstanceType car les disques système sont soumis à des restrictions liées aux types d'instances. Pour plus d'informations sur la définition du paramètre DestinationResource, consultez la section description de l'opération de cette rubrique.	InstanceType
ZoneId	string	Non	L'identifiant de la zone. Valeur par défaut : null. L'opération renvoie les ressources qui correspondent aux conditions de requête dans toutes les zones de la région spécifiée (RegionId).	cn-hangzhou-e
IoOptimized	string	Non	Indique si l'instance est une instance optimisée pour les E/S. Valeurs valides : none : instance non optimisée pour les E/S. optimized : instance optimisée pour les E/S. Valeur par défaut : optimized.	optimized
DedicatedHostId	string	Non	L'identifiant de l'hôte dédié.	dh-bp165p6xk2tlw61e****
InstanceType	string	Non	Le type d'instance. Pour plus d'informations, consultez Famille d'instances. Vous pouvez également appeler DescribeInstanceTypes pour obtenir la liste des types d'instances la plus récente. Pour plus d'informations sur la définition du paramètre InstanceType, consultez la section description de l'opération au début de cette rubrique.	ecs.g5.large
SystemDiskCategory	string	Non	La catégorie du disque système. Valeurs valides : cloud : disque de base. cloud_efficiency : disque ultra. cloud_ssd : SSD standard. ephemeral_ssd : SSD local. cloud_essd : SSD d'entreprise (ESSD). cloud_auto : disque ESSD AutoPL. Description de la valeur par défaut : Si InstanceType est défini sur un type d'instance obsolète, la valeur par défaut est cloud. Dans les autres cas, la valeur par défaut est cloud_efficiency. Remarque Lorsque ResourceType est défini sur instance et DestinationResource sur DataDisk, le paramètre SystemDiskCategory est requis. Si vous ne spécifiez pas ce paramètre, la valeur par défaut s'applique.	cloud_ssd
DataDiskCategory	string	Non	La catégorie du disque de données. Valeurs valides : cloud : disque de base. cloud_efficiency : disque ultra. cloud_ssd : SSD standard. ephemeral_ssd : SSD local. cloud_essd : SSD d'entreprise (ESSD). cloud_auto : disque ESSD AutoPL.	cloud_ssd
NetworkCategory	string	Non	Le type de réseau. Valeurs valides : vpc : cloud privé virtuel (VPC). classic : réseau classique. Le réseau classique est obsolète. Pour plus d'informations, consultez Avis d'obsolescence.	vpc
Cores	integer	Non	Le nombre de cœurs vCPU du type d'instance. Pour les valeurs valides, consultez Famille d'instances. Ce paramètre prend effet uniquement lorsque DestinationResource est défini sur InstanceType.	2
Memory	number	Non	La taille de la mémoire du type d'instance. Unité : Gio. Pour les valeurs valides, consultez Famille d'instances. Ce paramètre prend effet uniquement lorsque DestinationResource est défini sur InstanceType.	8.0
ResourceType	string	Non	Le type de ressource. Valeurs valides : instance : instance ECS. disk : disque cloud. reservedinstance : instance réservée. ddh : hôte dédié.	instance
Scope	string	Non	La portée de l'instance réservée. Valeurs valides : Region : régionale. Zone : zonale.	Region

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	0041D94C-FB92-4C49-B115-259DA1C*****
AvailableZones	object
AvailableZone	array<object>	La collection d'informations sur le stock des zones.
	array<object>	Les informations sur le stock de la zone.
ZoneId	string	The zone ID.	cn-hangzhou-e
Status	string	The status of the zone. Valid values: Available: Resources are available for sale. This indicates that the zone has resources available for sale, not limited to the specific resource being queried. SoldOut: Resources are sold out. This indicates that no resources are available for sale in the zone.	Available
StatusCategory	string	The detailed status of the zone based on inventory. Valid values: WithStock: Resources are in stock and will be replenished. ClosedWithStock: Resources are in stock but will not be replenished. WithoutStock: Resources are sold out but will be replenished. Use instance types with the WithStock status. ClosedWithoutStock: Resources are sold out and will not be replenished. Use instance types with the WithStock status.	WithStock
RegionId	string	The region ID.	cn-hangzhou
AvailableResources	object
AvailableResource	array<object>	The array of available resources that can be created.
	array<object>	The collection of available resources that can be created.
Type	string	The type of the resource. Valid values: Zone: zone. IoOptimized: I/O optimized. InstanceType: instance type. SystemDisk: system disk. DataDisk: data disk. Network: network type. ddh: dedicated host.	InstanceType
SupportedResources	object
SupportedResource	array<object>	The array of supported resources that can be created.
	object	The information about supported resources that can be created.
Status	string	The status of the specific resource type. Valid values: Available: Resources are available for sale. SoldOut: Resources are sold out.	Available
Value	string	The resource value.	ecs.d1ne.xlarge
Max	integer	The maximum disk capacity. Remarque This parameter takes effect only when DestinationResource is set to `SystemDisk` or `DataDisk`.	2048
Unit	string	The unit of the disk capacity. Remarque This parameter takes effect only when DestinationResource is set to `SystemDisk` or `DataDisk`.	GiB
StatusCategory	string	The detailed status of the resource based on inventory. Valid values: WithStock: Resources are in stock and will be replenished. ClosedWithStock: Resources are in stock but will not be replenished. WithoutStock: Resources are sold out but will be replenished. Use instance types with the WithStock status. ClosedWithoutStock: Resources are sold out and will not be replenished. Use instance types with the WithStock status.	WithStock
Min	integer	The minimum disk capacity. Remarque This parameter takes effect only when DestinationResource is set to `SystemDisk` or `DataDisk`.	20

Exemples

JSON format

{
  "RequestId": "0041D94C-FB92-4C49-B115-259DA1C*****",
  "AvailableZones": {
    "AvailableZone": [
      {
        "ZoneId": "cn-hangzhou-e",
        "Status": "Available",
        "StatusCategory": "WithStock",
        "RegionId": "cn-hangzhou",
        "AvailableResources": {
          "AvailableResource": [
            {
              "Type": "InstanceType",
              "SupportedResources": {
                "SupportedResource": [
                  {
                    "Status": "Available",
                    "Value": "ecs.d1ne.xlarge",
                    "Max": 2048,
                    "Unit": "GiB",
                    "StatusCategory": "WithStock",
                    "Min": 20
                  }
                ]
              }
            }
          ]
        }
      }
    ]
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	Invalid.InstanceChargeType	The specified InstanceChargeType is not valid.	The specified InstanceChargeType parameter is invalid.
400	Invalid.Param	The input parameter DestinationResource that is mandatory for processing this request is not supplied.	The specified DestinationResource parameter is invalid.
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.	The specified RegionId parameter is invalid.
403	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.
403	InvalidParam.TypeAndCpuMem.Conflict	The specified 'InstanceType' and 'Cores','Memory' are not blank at the same time.	You cannot specify the instance type, number of vCPUs, and memory size at the same time.
403	InvalidParam.Cores	The specified parameter 'Cores' should be empty.	The specified parameter 'Cores' should be empty.
403	InvalidParam.Memory	The specified parameter 'Memory' should be empty.	The specified parameter 'Memory' should be empty.
403	InvalidParameter.Scope	The specified parameter Scope is invalid.	The specified parameter Scope is invalid.
403	OperationDenied.RegionIdNotSupported	The region does not support preemptible instances.
403	OperationDenied.FlavorNotSupported	The flavor does not support preemptible instances.
403	OperationDenied.TimestampNotSupported	Preemptible instances are not for sale for current time.
403	InvalidParameter.ResourceOwnerId	The specified parameter ResourceOwnerId is not available anymore.
404	Invalid.RegionId	The specified RegionId does not exist.	The specified RegionId parameter is invalid.
404	Unavailable.Regions	The available region does not exist.
404	Invalid.ResourceType	The ResourceType provided does not exist in our records.	The specified resource type is invalid.
404	Invalid.DestinationResource	The specified DestinationResource is not valid.	The specified DestinationResource parameter is invalid.
404	Invalid.IoOptimized	The specified IoOptimized is not valid.	The specified IoOptimized parameter is invalid.
404	Invalid.NetworkCategory	The specified NetworkCategory is not valid.	The specified NetworkCategory parameter is invalid.
404	Invalid.SpotStrategy	The specified SpotStrategy is not valid.	The specified SpotStrategy parameter is invalid.
404	Invalid.NetworkType	The specified NetworkType is not valid.	The specified NetworkType parameter is invalid.
404	InvalidResourceId.NotFound	The specified ResourceId is not found in our records.	The specified resource does not exist. Check whether the resource ID is correct.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	Region information error
404	InvalidDedicatedHostId.NotFound	The specified Dedicated Host does not exist.	The specified dedicated host does not exist.

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

Notes de version

Consultez Notes de version pour la liste complète.