DescribeResourcesModification - - Centro de documentación de Alibaba Cloud

Consulta los recursos disponibles en una zona específica al actualizar o reducir el tipo de instancia, o al reemplazar discos del sistema.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeResourcesModification	La operación que desea ejecutar. Establezca el valor en DescribeResourcesModification.
RegionId	String	Sí	cn-hangzhou	El ID de la región. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
ResourceId	String	Sí	i-bp67acfmxazb4p****	El ID del recurso. Por ejemplo, cuando DestinationResource se establece en InstanceType, este parámetro puede interpretarse como InstanceId.
MigrateAcrossZone	Boolean	No	true	Especifica si se admiten actualizaciones de tipo de instancia entre clústeres. Valores válidos: true false Valor predeterminado: false. Si MigrateAcrossZone se establece en true y actualiza el tipo de una instancia de Elastic Compute Service (ECS) con base en la información devuelta, tenga en cuenta lo siguiente: Instancias en la red clásica: Para retired instance types, al actualizar una instancia no optimizada para E/S a una optimizada para E/S, cambian la dirección IP privada, los nombres de los dispositivos de disco y los códigos de autorización de software de la instancia. En las instancias Linux, los discos básicos (cloud) se identifican como xvd* (por ejemplo, xvda y xvdb), mientras que los discos ultra (cloud_efficiency) y los SSD estándar (cloud_ssd) se identifican como vd* (por ejemplo, vda y vdb). Para instance families available for purchase, al cambiar el tipo de una instancia, cambia su dirección IP privada. Instancias en redes privadas virtuales (VPC): Para retired instance types, al actualizar una instancia no optimizada para E/S a una optimizada para E/S, cambian los nombres de los dispositivos de disco y los códigos de autorización de software de la instancia. En las instancias Linux, los discos básicos (cloud) se identifican como xvd* (por ejemplo, xvda y xvdb), mientras que los discos ultra (cloud_efficiency) y los SSD estándar (cloud_ssd) se identifican como vd* (por ejemplo, vda y vdb).
DestinationResource	String	Sí	InstanceType	El tipo de recurso de destino. Valores válidos: InstanceType SystemDisk
OperationType	String	No	Upgrade	La operación para cambiar la configuración de recursos. Valores válidos para recursos de suscripción: Upgrade: actualiza los recursos. Downgrade: reduce los recursos. RenewDowngrade: renueva y reduce los recursos. RenewModify: renueva una instancia vencida y cambia su configuración. Establezca el valor en Upgrade para recursos pay-as-you-go. Valor predeterminado: Upgrade.
InstanceType	String	No	ecs.g5.large	El tipo de ENI N. Valores válidos de N: 1 y 2. Si el valor de N es 1, se puede configurar una ENI principal o secundaria. Si el valor de N es 2, se deben configurar una ENI principal y una secundaria. Valores válidos: Primary y Secondary. Valor predeterminado: Secondary. Para obtener más información, consulte Overview of instance families o llame a la operación DescribeInstanceTypes para consultar la lista de tipos de instancia más reciente. Este parámetro es obligatorio cuando DestinationResource se establece en SystemDisk.
Cores	Integer	No	2	El número de vCPU del tipo de instancia. Para obtener información sobre los valores, consulte Overview of instance families. Este parámetro solo surte efecto cuando DestinationResource se establece en InstanceType.
Memory	Float	No compatible	8.0	El tamaño de memoria del tipo de instancia. Unidad: GiB. Para obtener información sobre los valores, consulte Overview of instance families. Este parámetro solo surte efecto cuando DestinationResource se establece en InstanceType.
ZoneId	String	No	cn-hangzhou-e	El ID de la zona.
Conditions.N	String	No	DiskCategory	La condición. Si especifica este parámetro, el sistema consulta los tipos de recurso a los que se puede cambiar el recurso una vez que cumple la condición especificada. Establezca el valor en DiskCategory, que indica un cambio de categoría de disco. Al establecer este parámetro en DiskCategory, el sistema consulta los tipos de instancia a los que se puede cambiar la instancia después de un cambio de categoría de disco.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	El ID de la solicitud.
AvailableZones	Array of AvailableZone		La información sobre las zonas consultadas.
AvailableZone
ZoneId	String	cn-hangzhou-e	El ID de la zona.
Status	String	Available	El estado del recurso. Valores válidos: Available SoldOut
StatusCategory	String	WithStock	La categoría del recurso según el estado de inventario. Valores válidos: WithStock: recursos con inventario suficiente ClosedWithStock: recursos con inventario insuficiente WithoutStock: recursos agotados
RegionId	String	cn-hangzhou	El ID de la región.
AvailableResources	Array of AvailableResource		Los recursos disponibles en la zona.
AvailableResource
Type	String	InstanceType	El tipo de recurso. Valores válidos: Zone IoOptimized InstanceType SystemDisk DataDisk Network
SupportedResources	Array of SupportedResource		La información sobre los recursos.
SupportedResource
Status	String	Available	El estado del recurso. Valores válidos: Available SoldOut
Value	String	ecs.g5.large	El tipo de recurso.
Max	Integer	2048	La capacidad máxima del disco. Este parámetro solo surte efecto cuando el parámetro de solicitud DestinationResource se establece en SystemDisk.
Unit	String	GiB	La unidad de la capacidad del disco. Este parámetro solo surte efecto cuando el parámetro de solicitud DestinationResource se establece en SystemDisk.
StatusCategory	String	WithStock	La categoría del recurso según el estado de inventario. Valores válidos: WithStock: recursos con inventario suficiente ClosedWithStock: recursos con inventario insuficiente WithoutStock: recursos agotados
Min	Integer	20	La capacidad mínima del disco. Este parámetro solo surte efecto cuando el parámetro de solicitud DestinationResource se establece en SystemDisk.
ConditionSupportedResources	Array of ConditionSupportedResource		Los tipos de recurso a los que se pueden cambiar los recursos una vez que cumplen las condiciones especificadas. Si se cumplen las condiciones, puede cambiar el recurso actual por uno de la lista.
ConditionSupportedResource
Conditions	Array of Condition		Las condiciones.
Condition
Key	String	DiskCategory	El nombre de la condición. Valor válido: DiskCategory, que indica un cambio de categoría de disco.
Status	String	Available	El estado de inventario del recurso. Valores válidos: Available SoldOut
Value	String	ecs.g5.large	El tipo de recurso.
Max	Integer	2048	La capacidad máxima del disco. Este parámetro solo surte efecto cuando el parámetro de solicitud DestinationResource se establece en SystemDisk.
Unit	String	GiB	La unidad de la capacidad del disco. Este parámetro solo surte efecto cuando el parámetro de solicitud DestinationResource se establece en SystemDisk.
StatusCategory	String	WithStock	La categoría del recurso según el estado de inventario. Valores válidos: WithStock: recursos con inventario suficiente ClosedWithStock: recursos con inventario insuficiente WithoutStock: recursos agotados
Min	Integer	20	La capacidad mínima del disco. Este parámetro solo surte efecto cuando el parámetro de solicitud DestinationResource se establece en SystemDisk.

Ejemplos

Solicitudes de ejemplo

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>

Respuestas exitosas de ejemplo

Formato XML

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>

Formato JSON

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"
      } ]
    } ]
  } ]
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	Invalid.OperationType	The specified operationType is not valid.	Valor de OperationType no válido.
400	Invalid.Param	The input parameter DestinationResource that is mandatory for processing this request is not supplied.	Valor de DestinationResource no válido.
400	Invalid.InstanceChargeType	The specified InstanceChargeType is not valid.	Valor de InstanceChargeType no válido.
403	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist in our records.	El host dedicado especificado no existe en la región actual.
404	Invalid.RegionId	The specified RegionId does not exist.	Valor de RegionId no válido.
404	Invalid.ResourceType	The ResourceType provided does not exist in our records.	Valor de ResourceType no válido.
404	Invalid.DestinationResource	The specified DestinationResource is not valid.	Valor de DestinationResource no válido.
404	Invalid.IoOptimized	The specified IoOptimized is not valid.	Valor de IoOptimized no válido.
404	Invalid.NetworkCategory	The specified NetworkCategory is not valid.	Valor de NetworkCategory no válido.
404	Invalid.SpotStrategy	The specified SpotStrategy is not valid.	Valor de SpotStrategy no válido.
404	Invalid.ResourceId	The specified ResourceId is not valid.	Valor de ResourceId no válido.
404	Invalid.InstancePayType	The specified InstancePayType is not valid.	Valor de InstanceChargeType no válido.
404	OperationDenied	The specified operation is denied as this instanceType is not support.	El tipo de instancia no admite la operación.
404	InvalidInstanceId.NotFound	The specified InstanceId provided does not exist in our records.	El ID de instancia especificado no existe. Compruebe si el ID de instancia es correcto.
404	InvalidResourceId.NotFound	The specified ResourceId is not found in our records.	El parámetro ResourceId especificado no existe. Compruebe si el ID de recurso es correcto.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.