DescribeResourcesModification - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeResourcesModification	Operação a executar. Defina o valor como DescribeResourcesModification.
RegionId	String	Sim	cn-hangzhou	ID da região. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
ResourceId	String	Sim	i-bp67acfmxazb4p****	ID do recurso. Por exemplo, se DestinationResource for InstanceType, interprete este parâmetro como InstanceId.
MigrateAcrossZone	Boolean	Não	true	Indica se há suporte para upgrades de tipo de instância entre zonas. Valores válidos: true false Valor padrão: false. Se MigrateAcrossZone for true e você fizer upgrade do tipo de uma instância Elastic Compute Service (ECS) com base nas informações retornadas, observe os seguintes pontos: Instâncias na rede clássica: Para tipos de instância descontinuados: ao fazer upgrade de uma instância não otimizada para I/O para uma otimizada para I/O, o endereço IP privado, os nomes dos dispositivos de disco e os códigos de autorização de software mudam. Em instâncias Linux, discos básicos (cloud) aparecem como xvd* (ex.: xvda, xvdb); ultra disks (cloud_efficiency) e SSDs padrão (cloud_ssd) aparecem como vd* (ex.: vda, vdb). Para famílias de instâncias disponíveis para compra: alterar o tipo de instância modifica o endereço IP privado. Instâncias em Virtual Private Clouds (VPCs): Para tipos de instância descontinuados, ao fazer upgrade de uma instância não otimizada para I/O para uma otimizada para I/O, os nomes dos dispositivos de disco e os códigos de autorização de software mudam. Em instâncias Linux, discos básicos (cloud) aparecem como xvd* (ex.: xvda, xvdb); ultra disks (cloud_efficiency) e SSDs padrão (cloud_ssd) aparecem como vd* (ex.: vda, vdb).
DestinationResource	String	Sim	InstanceType	Tipo de recurso de destino. Valores válidos: InstanceType SystemDisk
OperationType	String	Não	Upgrade	Operação de alteração das configurações de recursos. Valores válidos para recursos por assinatura: Upgrade: faz upgrade de recursos. Downgrade: faz downgrade de recursos. RenewDowngrade: renova e faz downgrade de recursos. RenewModify: renova uma instância expirada e altera suas configurações. Defina como Upgrade para recursos de pagamento conforme o uso. Valor padrão: Upgrade.
InstanceType	String	Não	ecs.g5.large	Tipo da ENI N. Valores válidos de N: 1 e 2. Se N for 1, configure uma ENI primária ou secundária. Se N for 2, configure obrigatoriamente uma ENI primária e uma secundária. Valores válidos: Primary e Secondary. Valor padrão: Secondary. Para mais informações, consulte Visão geral das famílias de instâncias ou chame a operação DescribeInstanceTypes para obter a lista atualizada de tipos de instância. Este parâmetro é obrigatório quando DestinationResource for SystemDisk.
Cores	Integer	Não	2	Número de vCPUs do tipo de instância. Para detalhes sobre os valores, consulte Visão geral das famílias de instâncias. Este parâmetro só tem efeito quando DestinationResource for InstanceType.
Memory	Float	Não suportado	8.0	Tamanho da memória do tipo de instância. Unidade: GiB. Para detalhes sobre os valores, consulte Visão geral das famílias de instâncias. Este parâmetro só tem efeito quando DestinationResource for InstanceType.
ZoneId	String	Não	cn-hangzhou-e	ID da zona.
Conditions.N	String	Não	DiskCategory	Condição. Ao especificar este parâmetro, o sistema consulta os tipos de recurso para os quais a alteração é possível após o cumprimento da condição. Defina como DiskCategory para indicar uma alteração de categoria de disco. Nesse caso, o sistema consulta os tipos de instância disponíveis após a mudança de categoria do disco.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID da solicitação.
AvailableZones	Array of AvailableZone		Informações sobre as zonas consultadas.
AvailableZone
ZoneId	String	cn-hangzhou-e	ID da zona.
Status	String	Available	Status do recurso. Valores válidos: Available SoldOut
StatusCategory	String	WithStock	Categoria do recurso baseada na disponibilidade de estoque. Valores válidos: WithStock: recursos com estoque suficiente ClosedWithStock: recursos com estoque insuficiente WithoutStock: recursos sem estoque
RegionId	String	cn-hangzhou	ID da região.
AvailableResources	Array of AvailableResource		Recursos disponíveis na zona.
AvailableResource
Type	String	InstanceType	Tipo de recurso. Valores válidos: Zone IoOptimized InstanceType SystemDisk DataDisk Network
SupportedResources	Array of SupportedResource		Informações sobre os recursos.
SupportedResource
Status	String	Available	Status do recurso. Valores válidos: Available SoldOut
Value	String	ecs.g5.large	Tipo de recurso.
Max	Integer	2048	Capacidade máxima do disco. Este parâmetro só tem efeito quando o parâmetro de solicitação DestinationResource for SystemDisk.
Unit	String	GiB	Unidade da capacidade do disco. Este parâmetro só tem efeito quando o parâmetro de solicitação DestinationResource for SystemDisk.
StatusCategory	String	WithStock	Categoria do recurso baseada na disponibilidade de estoque. Valores válidos: WithStock: recursos com estoque suficiente ClosedWithStock: recursos com estoque insuficiente WithoutStock: recursos sem estoque
Min	Integer	20	Capacidade mínima do disco. Este parâmetro só tem efeito quando o parâmetro de solicitação DestinationResource for SystemDisk.
ConditionSupportedResources	Array of ConditionSupportedResource		Tipos de recurso para os quais a alteração é possível após o cumprimento das condições especificadas. Se as condições forem atendidas, altere o recurso atual para um item desta lista.
ConditionSupportedResource
Conditions	Array of Condition		Condições.
Condition
Key	String	DiskCategory	Nome da condição. Valor válido: DiskCategory, que indica uma alteração de categoria de disco.
Status	String	Available	Status de estoque do recurso. Valores válidos: Available SoldOut
Value	String	ecs.g5.large	Tipo de recurso.
Max	Integer	2048	Capacidade máxima do disco. Este parâmetro só tem efeito quando o parâmetro de solicitação DestinationResource for SystemDisk.
Unit	String	GiB	Unidade da capacidade do disco. Este parâmetro só tem efeito quando o parâmetro de solicitação DestinationResource for SystemDisk.
StatusCategory	String	WithStock	Categoria do recurso baseada na disponibilidade de estoque. Valores válidos: WithStock: recursos com estoque suficiente ClosedWithStock: recursos com estoque insuficiente WithoutStock: recursos sem estoque
Min	Integer	20	Capacidade mínima do disco. Este parâmetro só tem efeito quando o parâmetro de solicitação DestinationResource for SystemDisk.

Exemplos

Exemplos de solicitações

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>

Exemplos de respostas de sucesso

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 erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Invalid.OperationType	The specified operationType is not valid.	Valor de OperationType inválido.
400	Invalid.Param	The input parameter DestinationResource that is mandatory for processing this request is not supplied.	Valor de DestinationResource inválido.
400	Invalid.InstanceChargeType	The specified InstanceChargeType is not valid.	Valor de InstanceChargeType inválido.
403	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist in our records.	O host dedicado especificado não existe na região atual.
404	Invalid.RegionId	The specified RegionId does not exist.	Valor de RegionId inválido.
404	Invalid.ResourceType	The ResourceType provided does not exist in our records.	Valor de ResourceType inválido.
404	Invalid.DestinationResource	The specified DestinationResource is not valid.	Valor de DestinationResource inválido.
404	Invalid.IoOptimized	The specified IoOptimized is not valid.	Valor de IoOptimized inválido.
404	Invalid.NetworkCategory	The specified NetworkCategory is not valid.	Valor de NetworkCategory inválido.
404	Invalid.SpotStrategy	The specified SpotStrategy is not valid.	Valor de SpotStrategy inválido.
404	Invalid.ResourceId	The specified ResourceId is not valid.	Valor de ResourceId inválido.
404	Invalid.InstancePayType	The specified InstancePayType is not valid.	Valor de InstanceChargeType inválido.
404	OperationDenied	The specified operation is denied as this instanceType is not support.	O tipo de instância não suporta a operação.
404	InvalidInstanceId.NotFound	The specified InstanceId provided does not exist in our records.	O ID da instância especificado não existe. Verifique se o ID da instância está correto.
404	InvalidResourceId.NotFound	The specified ResourceId is not found in our records.	O parâmetro ResourceId especificado não existe. Verifique se o ID do recurso está correto.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.