DescribeResourcesModification - - Centre de documentation Alibaba Cloud

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	DescribeResourcesModification	L'opération à effectuer. Définissez la valeur sur DescribeResourcesModification.
RegionId	String	Oui	cn-hangzhou	ID de la région. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
ResourceId	String	Oui	i-bp67acfmxazb4p****	ID de la ressource. Par exemple, si DestinationResource est défini sur InstanceType, ce paramètre correspond à l'InstanceId.
MigrateAcrossZone	Boolean	Non	true	Indique si les mises à niveau de type d'instance entre zones sont prises en charge. Valeurs possibles : true false Valeur par défaut : false. Si MigrateAcrossZone est défini sur true et que vous mettez à niveau le type d'instance d'une instance Elastic Compute Service (ECS) sur la base des informations renvoyées, tenez compte des points suivants : Instances situées dans le réseau classique : Pour les types d'instance retirés, la mise à niveau d'une instance non optimisée pour les E/S vers une instance optimisée pour les E/S entraîne la modification de l'adresse IP privée, des noms de périphériques de disque et des codes d'autorisation logicielle de l'instance. Pour les instances Linux, les disques de base (cloud) sont identifiés par xvd* (par exemple xvda et xvdb), tandis que les disques ultra (cloud_efficiency) et les SSD standard (cloud_ssd) sont identifiés par vd* (par exemple vda et vdb). Pour les familles d'instances disponibles à l'achat, la modification du type d'instance entraîne la modification de l'adresse IP privée de l'instance. Instances situées dans des VPC : Pour les types d'instance retirés, la mise à niveau d'une instance non optimisée pour les E/S vers une instance optimisée pour les E/S entraîne la modification des noms de périphériques de disque et des codes d'autorisation logicielle de l'instance. Pour les instances Linux, les disques de base (cloud) sont identifiés par xvd* (par exemple xvda et xvdb), tandis que les disques ultra (cloud_efficiency) et les SSD standard (cloud_ssd) sont identifiés par vd* (par exemple vda et vdb).
DestinationResource	String	Oui	InstanceType	Type de ressource cible. Valeurs possibles : InstanceType SystemDisk
OperationType	String	Non	Upgrade	Opération de modification des configurations de ressources. Valeurs possibles pour les ressources par abonnement : Upgrade : met à niveau les ressources. Downgrade : rétrograde les ressources. RenewDowngrade : renouvelle et rétrograde les ressources. RenewModify : renouvelle une instance expirée et modifie sa configuration. Définissez la valeur sur Upgrade pour les ressources à la demande. Valeur par défaut : Upgrade.
InstanceType	String	Non	ecs.g5.large	Type d'ENI N. Valeurs possibles pour N : 1 et 2. Si N vaut 1, vous pouvez configurer une ENI principale ou secondaire. Si N vaut 2, vous devez configurer une ENI principale et une ENI secondaire. Valeurs possibles : Primary et Secondary. Valeur par défaut : Secondary. Pour plus d'informations, consultez la page Présentation des familles d'instances ou appelez l'opération DescribeInstanceTypes pour obtenir la liste des types d'instance la plus récente. Ce paramètre est requis lorsque DestinationResource est défini sur SystemDisk.
Cores	Integer	Non	2	Nombre de vCPU du type d'instance. Pour connaître les valeurs, consultez la page Présentation des familles d'instances. Ce paramètre ne s'applique que si DestinationResource est défini sur InstanceType.
Memory	Float	Non pris en charge	8.0	Taille de la mémoire du type d'instance. Unité : GiB. Pour connaître les valeurs, consultez la page Présentation des familles d'instances. Ce paramètre ne s'applique que si DestinationResource est défini sur InstanceType.
ZoneId	String	Non	cn-hangzhou-e	ID de la zone.
Conditions.N	String	Non	DiskCategory	Condition. Si vous spécifiez ce paramètre, le système interroge les types de ressources vers lesquels la ressource peut être modifiée une fois la condition spécifiée remplie. Définissez la valeur sur DiskCategory, ce qui indique un changement de catégorie de disque. Lorsque vous définissez ce paramètre sur DiskCategory, le système interroge les types d'instance vers lesquels l'instance peut être modifiée après un changement de catégorie de disque.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID de la requête.
AvailableZones	Array of AvailableZone		Informations sur les zones interrogées.
AvailableZone
ZoneId	String	cn-hangzhou-e	ID de la zone.
Status	String	Available	État de la ressource. Valeurs possibles : Available SoldOut
StatusCategory	String	WithStock	Catégorie de la ressource selon l'état du stock. Valeurs possibles : WithStock : ressources en stock suffisant ClosedWithStock : ressources en stock insuffisant WithoutStock : ressources en rupture de stock
RegionId	String	cn-hangzhou	ID de la région.
AvailableResources	Array of AvailableResource		Ressources disponibles dans la zone.
AvailableResource
Type	String	InstanceType	Type de ressource. Valeurs possibles : Zone IoOptimized InstanceType SystemDisk DataDisk Network
SupportedResources	Array of SupportedResource		Informations sur les ressources.
SupportedResource
Status	String	Available	État de la ressource. Valeurs possibles : Available SoldOut
Value	String	ecs.g5.large	Type de ressource.
Max	Integer	2048	Capacité maximale du disque. Ce paramètre ne s'applique que si le paramètre de requête DestinationResource est défini sur SystemDisk.
Unit	String	GiB	Unité de la capacité du disque. Ce paramètre ne s'applique que si le paramètre de requête DestinationResource est défini sur SystemDisk.
StatusCategory	String	WithStock	Catégorie de la ressource selon l'état du stock. Valeurs possibles : WithStock : ressources en stock suffisant ClosedWithStock : ressources en stock insuffisant WithoutStock : ressources en rupture de stock
Min	Integer	20	Capacité minimale du disque. Ce paramètre ne s'applique que si le paramètre de requête DestinationResource est défini sur SystemDisk.
ConditionSupportedResources	Array of ConditionSupportedResource		Types de ressources vers lesquels les ressources peuvent être modifiées une fois les conditions spécifiées remplies. Si les conditions sont remplies, vous pouvez modifier la ressource actuelle par une ressource de la liste.
ConditionSupportedResource
Conditions	Array of Condition		Conditions.
Condition
Key	String	DiskCategory	Nom de la condition. Valeur possible : DiskCategory, qui indique un changement de catégorie de disque.
Status	String	Available	État du stock de la ressource. Valeurs possibles : Available SoldOut
Value	String	ecs.g5.large	Type de ressource.
Max	Integer	2048	Capacité maximale du disque. Ce paramètre ne s'applique que si le paramètre de requête DestinationResource est défini sur SystemDisk.
Unit	String	GiB	Unité de la capacité du disque. Ce paramètre ne s'applique que si le paramètre de requête DestinationResource est défini sur SystemDisk.
StatusCategory	String	WithStock	Catégorie de la ressource selon l'état du stock. Valeurs possibles : WithStock : ressources en stock suffisant ClosedWithStock : ressources en stock insuffisant WithoutStock : ressources en rupture de stock
Min	Integer	20	Capacité minimale du disque. Ce paramètre ne s'applique que si le paramètre de requête DestinationResource est défini sur SystemDisk.

Exemples

Exemples de requêtes

http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
&DestinationResource=InstanceType
&RegionId=cn-hangzhou
&ResourceId=i-bp67acfmxazb4p****
&MigrateAcrossZone=true
&OperationType=Upgrade
&InstanceType=ecs.g5.large
&<Common request parameters>

Exemples de réponses réussies

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeResourcesModificationResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <AvailableZones>
        <ZoneId>cn-hangzhou-e</ZoneId>
        <Status>Available</Status>
        <StatusCategory>WithStock</StatusCategory>
        <RegionId>cn-hangzhou</RegionId>
        <AvailableResources>
            <Type>InstanceType</Type>
            <SupportedResources>
                <Status>Available</Status>
                <Value>ecs.g5.large</Value>
                <StatusCategory>WithStock</StatusCategory>
            </SupportedResources>
            <ConditionSupportedResources>
                <Conditions>
                    <Key>DiskCategory</Key>
                </Conditions>
                <Status>Available</Status>
                <Value>ecs.g5.large</Value>
                <StatusCategory>WithStock</StatusCategory>
            </ConditionSupportedResources>
        </AvailableResources>
    </AvailableZones>
</DescribeResourcesModificationResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "AvailableZones" : [ {
    "ZoneId" : "cn-hangzhou-e",
    "Status" : "Available",
    "StatusCategory" : "WithStock",
    "RegionId" : "cn-hangzhou",
    "AvailableResources" : [ {
      "Type" : "InstanceType",
      "SupportedResources" : [ {
        "Status" : "Available",
        "Value" : "ecs.g5.large",
        "StatusCategory" : "WithStock"
      } ],
      "ConditionSupportedResources" : [ {
        "Conditions" : [ {
          "Key" : "DiskCategory"
        } ],
        "Status" : "Available",
        "Value" : "ecs.g5.large",
        "StatusCategory" : "WithStock"
      } ]
    } ]
  } ]
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	Invalid.OperationType	The specified operationType is not valid.	Valeur OperationType non valide.
400	Invalid.Param	The input parameter DestinationResource that is mandatory for processing this request is not supplied.	Valeur DestinationResource non valide.
400	Invalid.InstanceChargeType	The specified InstanceChargeType is not valid.	Valeur InstanceChargeType non valide.
403	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist in our records.	L'hôte dédié spécifié n'existe pas dans la région actuelle.
404	Invalid.RegionId	The specified RegionId does not exist.	Valeur RegionId non valide.
404	Invalid.ResourceType	The ResourceType provided does not exist in our records.	Valeur ResourceType non valide.
404	Invalid.DestinationResource	The specified DestinationResource is not valid.	Valeur DestinationResource non valide.
404	Invalid.IoOptimized	The specified IoOptimized is not valid.	Valeur IoOptimized non valide.
404	Invalid.NetworkCategory	The specified NetworkCategory is not valid.	Valeur NetworkCategory non valide.
404	Invalid.SpotStrategy	The specified SpotStrategy is not valid.	Valeur SpotStrategy non valide.
404	Invalid.ResourceId	The specified ResourceId is not valid.	Valeur ResourceId non valide.
404	Invalid.InstancePayType	The specified InstancePayType is not valid.	Valeur InstanceChargeType non valide.
404	OperationDenied	The specified operation is denied as this instanceType is not support.	Le type d'instance ne prend pas en charge l'opération.
404	InvalidInstanceId.NotFound	The specified InstanceId provided does not exist in our records.	L'ID d'instance spécifié n'existe pas. Vérifiez si l'ID d'instance est correct.
404	InvalidResourceId.NotFound	The specified ResourceId is not found in our records.	Le paramètre ResourceId spécifié n'existe pas. Vérifiez si l'ID de ressource est correct.

Pour obtenir la liste des codes d'erreur, consultez la page Codes d'erreur de service.