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

Consulta o inventário de tipos de instância ou tipos de disco do sistema em uma zona antes de alterar o tipo de instância ou o tipo de disco do sistema de uma instância.

Descrição da operação

Os exemplos a seguir descrevem cenários comuns de alteração:

Exemplo 1: Consultar os tipos de instância para os quais a instância atual pode ser alterada

Consulte os tipos de instância para os quais a instância i-bp67acfmxazb4p**** pode ser alterada e o inventário dos tipos de instância correspondentes na zona em que a instância reside.

http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
&RegionId=ap-southeast-1
&ResourceId=i-bp67acfmxazb4p****
&DestinationResource=InstanceType
&OperationType=Upgrade
&Parâmetros comuns de solicitação

Exemplo 2: Consultar os tipos de instância disponíveis após alterar o tipo de disco da instância atual

Consulte os tipos de instância para os quais a instância i-bp67acfmxazb4p**** pode ser alterada após a alteração do tipo de disco e o inventário dos tipos de instância correspondentes na zona em que a instância reside.

http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
&RegionId=ap-southeast-1
&ResourceId=i-bp67acfmxazb4p****
&DestinationResource=InstanceType
&OperationType=Upgrade
&Conditions.0=DiskCategory
&Parâmetros comuns de solicitação

Exemplo 3: Consultar o tipo de disco exigido pelo tipo de instância de destino

Consulte o tipo de disco exigido pelo tipo de instância de destino (por exemplo, ecs.g7.large). A instância atual i-bp67acfmxazb4p**** deve ser alterada para este tipo de disco antes de poder ser alterada para o tipo de instância de destino. Consulte também o inventário do tipo de disco na zona em que a instância reside.

Nota

O tipo de instância de destino deve ser obtido usando o Exemplo 2.

http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
&RegionId=ap-southeast-1
&ResourceId=i-bp67acfmxazb4p****
&DestinationResource=SystemDisk
&OperationType=Upgrade
&InstanceType=ecs.g7.large
&Parâmetros comuns de solicitação

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:DescribeResourcesModification

get

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região da instância cuja configuração você deseja alterar. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
ResourceId	string	Sim	O ID da instância (InstanceId) da instância cujo tipo de instância ou tipo de disco do sistema você deseja alterar.	i-bp67acfmxazb4p****
MigrateAcrossZone	boolean	Não	Especifica se há suporte para alterações de tipo de instância entre clusters. Valores válidos: true: Com suporte. false: Sem suporte. Valor padrão: false. Se o parâmetro MigrateAcrossZone estiver definido como true e você fizer upgrade ou downgrade da instância do Elastic Compute Service com base nas informações retornadas, observe os seguintes itens: Instâncias do tipo VPC: Para tipos de instância descontinuados, quando uma instância não otimizada para I/O é alterada para uma instância otimizada para I/O, os nomes dos dispositivos de disco e os códigos de autorização de software do servidor são alterados. Para instâncias Linux, os discos básicos (cloud) são identificados como xvda ou xvdb. Os ultra discos (cloud_efficiency) e os SSDs padrão (cloud_ssd) são identificados como vda ou vdb.	true
DestinationResource	string	Sim	O tipo do recurso a ser alterado. Valores válidos: InstanceType: tipo de instância. SystemDisk: tipo de disco do sistema. Se você definir este parâmetro como SystemDisk, também deverá especificar o parâmetro InstanceType para indicar o tipo de disco exigido pelo tipo de instância de destino.	InstanceType
OperationType	string	Não	O tipo da operação de Upgrade/Downgrade. Valores válidos para recursos por assinatura: Upgrade: faz upgrade de recursos. Downgrade: faz downgrade de recursos. RenewDowngrade: faz downgrade de recursos na renovação. RenewModify: renovação com alteração de especificação para instâncias expiradas. Valor válido para recursos pós-pagos: Upgrade. Valor padrão: Upgrade.	Upgrade
InstanceType	string	Não	O tipo de instância de destino. Para obter mais informações, consulte Família de instâncias. Você também pode chamar DescribeInstanceTypes para consultar a lista de tipos de instância mais recente. Se DestinationResource estiver definido como SystemDisk, você também deverá especificar o parâmetro InstanceType para indicar o tipo de disco exigido pelo tipo de instância de destino.	ecs.g7.large
Cores	integer	Não	O número de núcleos de vCPU do tipo de instância de destino. Para obter os valores válidos, consulte Família de instâncias. Este parâmetro só entra em vigor quando DestinationResource está definido como InstanceType.	2
Memory	number	Não	O tamanho da memória do tipo de instância de destino. Unidade: GiB. Para obter os valores válidos, consulte Família de instâncias. Este parâmetro só entra em vigor quando DestinationResource está definido como InstanceType.	8.0
ZoneId	string	Não	O ID da zona de destino. Especifique este parâmetro quando desejar alterar o tipo de instância entre zonas.	cn-hangzhou-e
Conditions	array	Não	A lista de condições.
	string	Não	Apenas DiskCategory é suportado, o que indica a consulta dos tipos de instância disponíveis após a alteração do tipo de disco da instância atual. Este parâmetro só entra em vigor quando DestinationResource está definido como InstanceType.	DiskCategory

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
AvailableZones	object
AvailableZone	array<object>	A coleção de objetos AvailableZone que contêm informações da zona.
	array<object>
ZoneId	string	O ID da zona.	cn-hangzhou-e
Status	string	O estado do recurso. Valores válidos: Available SoldOut.	Available
StatusCategory	string	A categoria do recurso com base no status de estoque. Valores válidos: WithStock: recursos que estão com estoque suficiente ClosedWithStock: recursos que estão com estoque insuficiente WithoutStock: recursos que estão sem estoque.	WithStock
RegionId	string	O ID da região.	cn-hangzhou
AvailableResources	object
AvailableResource	array<object>	Os recursos que estão disponíveis na zona.
	array<object>
Type	string	O tipo de recurso. Valores válidos: InstanceType SystemDisk.	InstanceType
SupportedResources	object
SupportedResource	array<object>	As informações sobre os recursos suportados.
	object
Status	string	O estado do recurso. Valores válidos: Available SoldOut.	Available
Value	string	O tipo de recurso.	ecs.g7.large
Max	integer	A capacidade máxima do disco. Este parâmetro entra em vigor apenas quando o parâmetro de solicitação DestinationResource é definido como SystemDisk.	2048
Unit	string	A unidade da capacidade do disco. Este parâmetro entra em vigor apenas quando o parâmetro de solicitação DestinationResource é definido como SystemDisk.	GiB
StatusCategory	string	A categoria do recurso com base no status de estoque. Valores válidos: WithStock: recursos que estão com estoque suficiente ClosedWithStock: recursos que estão com estoque insuficiente WithoutStock: recursos que estão sem estoque.	WithStock
Min	integer	A capacidade mínima do disco. Este parâmetro entra em vigor apenas quando o parâmetro de solicitação DestinationResource é definido como SystemDisk.	20
ConditionSupportedResources	object
ConditionSupportedResource	array<object>	Os tipos de recurso para os quais os recursos podem ser alterados após os recursos atenderem às condições especificadas. Se as condições forem atendidas, você pode alterar o recurso atual para um recurso na lista.
	array<object>	Os tipos de recurso para os quais os recursos podem ser alterados após os recursos atenderem às condições especificadas.
Conditions	object
Condition	array<object>	As condições.
	object	As condições.
Key	string	O nome da condição. Valor válido: DiskCategory, que indica uma alteração na categoria do disco.	DiskCategory
Status	string	O estado de estoque do recurso. Valores válidos: Available SoldOut.	Available
Value	string	O tipo de recurso.	ecs.g5.large
Max	integer	A capacidade máxima do disco. Este parâmetro entra em vigor apenas quando o parâmetro de solicitação DestinationResource é definido como SystemDisk.	2048
Unit	string	A unidade da capacidade do disco. Este parâmetro entra em vigor apenas quando o parâmetro de solicitação DestinationResource é definido como SystemDisk.	GiB
StatusCategory	string	A categoria do recurso com base no status de estoque. Valores válidos: WithStock: recursos que estão com estoque suficiente ClosedWithStock: recursos que estão com estoque insuficiente WithoutStock: recursos que estão sem estoque.	WithStock
Min	integer	A capacidade mínima do disco. Este parâmetro entra em vigor apenas quando o parâmetro de solicitação DestinationResource é definido como SystemDisk.	20

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "AvailableZones": {
    "AvailableZone": [
      {
        "ZoneId": "cn-hangzhou-e",
        "Status": "Available",
        "StatusCategory": "WithStock",
        "RegionId": "cn-hangzhou",
        "AvailableResources": {
          "AvailableResource": [
            {
              "Type": "InstanceType",
              "SupportedResources": {
                "SupportedResource": [
                  {
                    "Status": "Available",
                    "Value": "ecs.g7.large",
                    "Max": 2048,
                    "Unit": "GiB",
                    "StatusCategory": "WithStock",
                    "Min": 20
                  }
                ]
              },
              "ConditionSupportedResources": {
                "ConditionSupportedResource": [
                  {
                    "Conditions": {
                      "Condition": [
                        {
                          "Key": "DiskCategory"
                        }
                      ]
                    },
                    "Status": "Available",
                    "Value": "ecs.g5.large",
                    "Max": 2048,
                    "Unit": "GiB",
                    "StatusCategory": "WithStock",
                    "Min": 20
                  }
                ]
              }
            }
          ]
        }
      }
    ]
  }
}

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.	O parâmetro operationType especificado é inválido.
400	Invalid.Param	The input parameter DestinationResource that is mandatory for processing this request is not supplied.	O tipo de recurso de destino é inválido.
400	Invalid.InstanceChargeType	The specified InstanceChargeType is not valid.	O parâmetro InstanceChargeType especificado é inválido.
400	InvalidCondition.Malformed	The specified Condition is not valid.
403	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist in our records.	O host dedicado especificado não existe.
403	InvalidParam.TypeAndCpuMem.Conflict	The specified 'InstanceType' and 'Cores','Memory' are not blank at the same time.	Você não pode especificar o tipo de instância, o número de vCPUs e o tamanho da memória ao mesmo tempo.
403	InvalidParam.Cores	The specified parameter 'Cores' should be empty.	O parâmetro Cores especificado deve estar vazio ou não ser informado.
403	InvalidParam.Memory	The specified parameter 'Memory' should be empty.	O parâmetro Memory especificado deve estar vazio ou não ser especificado.
403	InvalidParameter.ResourceOwnerId	The specified parameter ResourceOwnerId is not available anymore.
404	Invalid.RegionId	The specified RegionId does not exist.	O parâmetro de região é inválido.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	As informações da região são inválidas.
404	Unavailable.Regions	The available regions does not exists.	O parâmetro de região é inválido.
404	Invalid.ResourceType	The ResourceType provided does not exist in our records.	O tipo de recurso é inválido.
404	Invalid.DestinationResource	The specified DestinationResource is not valid.	O recurso de destino especificado é inválido.
404	Invalid.IoOptimized	The specified IoOptimized is not valid.	O parâmetro IoOptimized especificado é inválido.
404	Invalid.NetworkCategory	The specified NetworkCategory is not valid.	O parâmetro NetworkCategory especificado é inválido.
404	Invalid.SpotStrategy	The specified SpotStrategy is not valid.	O parâmetro de estratégia de licitação é inválido.
404	Invalid.ResourceId	The specified ResourceId is not valid.	O parâmetro ResourceId especificado é inválido.
404	Invalid.InstancePayType	The specified InstancePayType is not valid.	O parâmetro InstanceChargeType especificado é inválido.
404	Invalid.OperationType	The specified OperationType is not valid.	O parâmetro operationType especificado é inválido.
404	OperationDenied	The specified operation is denied as this instanceType is not support.	O EIP especificado está indisponível ou não autorizado.
404	InvalidInstanceId.NotFound	The specified InstanceId provided does not exist in our records.	O ID da instância especificado é inválido.
404	InvalidResourceId.NotFound	The specified ResourceId is not found in our records.	O recurso especificado não existe. Verifique se o parâmetro ResourceId está correto.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.