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

Consulta o status de estoque de recursos em uma zona especificada. Esta operação é usada principalmente para verificar se os recursos de destino, como tipos de instância e tipos de disco do sistema, estão disponíveis em uma zona específica antes de criar instâncias (RunInstances) ou modificar as especificações da instância (ModifyInstanceSpec).

Descrição da operação

O parâmetro DestinationResource possui lógica e requisitos diferentes dependendo do seu valor. Na lista ordenada a seguir, um valor de classificação inferior exige que mais parâmetros sejam definidos. Você não pode usar um valor de classificação inferior para filtrar recursos de uma categoria de classificação superior.

Ordem dos valores: Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk
Exemplos:
- Se DestinationResource estiver definido como DataDisk:
  - Se ResourceType estiver definido como disk, a operação consulta os tipos de disco de dados que não estão associados a um tipo de instância ECS específico. Nesse caso, o parâmetro InstanceType é opcional.
  - Se ResourceType estiver definido como instance, a operação consulta os tipos de disco de dados que podem ser anexados a uma instância ECS. Como os tipos de instância impõem restrições aos discos de dados, você deve especificar tanto InstanceType quanto DataDiskCategory.
- Se DestinationResource estiver definido como SystemDisk e ResourceType estiver definido como instance, você deve especificar o parâmetro InstanceType porque os tipos de instância ECS impõem restrições aos discos do sistema.
- Se DestinationResource estiver definido como InstanceType, especifique os parâmetros IoOptimized e InstanceType.
- Consultar o estoque de ecs.g5.large em todas as zonas de uma região especificada: RegionId=ap-southeast-1 &DestinationResource=InstanceType &IoOptimized=optimized &InstanceType=ecs.g5.large.
- Consultar as zonas em uma região especificada onde ecs.g5.large está disponível: RegionId=ap-southeast-1 &DestinationResource=Zone &IoOptimized=optimized &InstanceType=ecs.g5.large.

Consultar as zonas na região da China (Hangzhou) onde o tipo de instância ecs.g5.large está disponível.

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

Consultar o estoque do tipo de instância ecs.g5.large em todas as zonas na região da China (Hangzhou).

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

[Comprar apenas um disco de dados] Consultar o estoque do tipo de disco de dados cloud_efficiency na Zona B da região da China (Hangzhou).

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

[Comprar uma instância ECS e um disco do sistema] Consultar o estoque do tipo de instância ecs.g7.large com o tipo de disco do sistema cloud_essd na Zona B da região da China (Hangzhou).

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

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região de destino. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
InstanceChargeType	string	Não	O método de cobrança do recurso. Para mais informações, consulte Visão geral da cobrança. Valores válidos: PrePaid: assinatura. PostPaid: pay-as-you-go. Valor padrão: PostPaid.	PrePaid
SpotStrategy	string	Não	A política de lance para instâncias pay-as-you-go. Valores válidos: NoSpot: uma instância pay-as-you-go regular. SpotWithPriceLimit: uma instância spot com um limite de preço máximo. SpotAsPriceGo: uma instância spot com preço de mercado, tendo o preço pay-as-you-go como limite superior. Valor padrão: NoSpot. Este parâmetro entra em vigor apenas quando InstanceChargeType está definido como PostPaid.	NoSpot
SpotDuration	integer	Não	O período de proteção da instância spot. Unidade: horas. Valor padrão: 1. Valores válidos: 1: Após a criação de uma instância spot, o Alibaba Cloud garante que a instância não seja liberada automaticamente dentro de 1 hora. Após 1 hora, o sistema compara o preço do lance com o preço de mercado e verifica o estoque para determinar se deve reter ou liberar automaticamente a instância. 0: Após a criação de uma instância spot, o Alibaba Cloud não garante que a instância seja executada por 1 hora. O sistema compara o preço do lance com o preço de mercado e verifica o estoque para determinar se deve reter ou liberar automaticamente a instância. O Alibaba Cloud envia uma notificação de evento do sistema ECS 5 minutos antes de a instância ser liberada. As instâncias spot são cobradas por segundo. Selecione um período de proteção apropriado com base na duração esperada da execução da tarefa. Nota Este parâmetro entra em vigor apenas quando InstanceChargeType está definido como PostPaid e SpotStrategy está definido como SpotWithPriceLimit ou SpotAsPriceGo.	1
DestinationResource	string	Sim	O tipo de recurso a ser consultado. Valores válidos: Zone: zona. IoOptimized: otimizado para I/O. InstanceType: tipo de instância. Network: tipo de rede. ddh: host dedicado. SystemDisk: disco do sistema. DataDisk: disco de dados. Nota Quando DestinationResource está definido como SystemDisk, você deve especificar InstanceType porque os discos do sistema são restritos pelos tipos de instância. Para mais informações sobre como definir o parâmetro DestinationResource, consulte a seção descrição da operação deste tópico.	InstanceType
ZoneId	string	Não	O ID da zona. Valor padrão: nulo. A operação retorna recursos que correspondem às condições de consulta em todas as zonas da região especificada (RegionId).	cn-hangzhou-e
IoOptimized	string	Não	Especifica se a instância é uma instância otimizada para I/O. Valores válidos: none: instância não otimizada para I/O. optimized: instância otimizada para I/O. Valor padrão: optimized.	optimized
DedicatedHostId	string	Não	O ID do host dedicado.	dh-bp165p6xk2tlw61e****
InstanceType	string	Não	O tipo de instância. Para mais informações, consulte Família de instâncias. Você também pode invocar DescribeInstanceTypes para consultar a lista de tipos de instância mais recente. Para mais informações sobre como definir o parâmetro InstanceType, consulte a seção descrição da operação no início deste tópico.	ecs.g5.large
SystemDiskCategory	string	Não	A categoria do disco do sistema. Valores válidos: cloud: disco básico. cloud_efficiency: disco ultra. cloud_ssd: SSD padrão. ephemeral_ssd: SSD local. cloud_essd: SSD empresarial (ESSD). cloud_auto: disco ESSD AutoPL. Descrição do valor padrão: Se InstanceType estiver definido como um tipo de instância descontinuado, o valor padrão é cloud. Em outros casos, o valor padrão é cloud_efficiency. Nota Quando ResourceType está definido como instance e DestinationResource está definido como DataDisk, o parâmetro SystemDiskCategory é obrigatório. Se você não especificar este parâmetro, o valor padrão entrará em vigor.	cloud_ssd
DataDiskCategory	string	Não	A categoria do disco de dados. Valores válidos: cloud: disco básico. cloud_efficiency: disco ultra. cloud_ssd: SSD padrão. ephemeral_ssd: SSD local. cloud_essd: SSD empresarial (ESSD). cloud_auto: disco ESSD AutoPL.	cloud_ssd
NetworkCategory	string	Não	O tipo de rede. Valores válidos: vpc: virtual private cloud (VPC). classic: rede clássica. A rede clássica foi descontinuada. Para mais informações, consulte Aviso de descontinuação.	vpc
Cores	integer	Não	O número de núcleos de vCPU do tipo de instância. Para valores válidos, consulte Família de instâncias. Este parâmetro entra em vigor apenas quando DestinationResource está definido como InstanceType.	2
Memory	number	Não	O tamanho da memória do tipo de instância. Unidade: GiB. Para valores válidos, consulte Família de instâncias. Este parâmetro entra em vigor apenas quando DestinationResource está definido como InstanceType.	8.0
ResourceType	string	Não	O tipo do recurso. Valores válidos: instance: instância ECS. disk: disco em nuvem. reservedinstance: instância reservada. ddh: host dedicado.	instance
Scope	string	Não	O escopo da instância reservada. Valores válidos: Region: regional. Zone: zonal.	Region

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	0041D94C-FB92-4C49-B115-259DA1C*****
AvailableZones	object
AvailableZone	array<object>	A coleção de informações de estoque da zona.
	array<object>	As informações de estoque da zona.
ZoneId	string	O ID da zona.	cn-hangzhou-e
Status	string	O status da zona de disponibilidade. Valores possíveis: Available: A zona de disponibilidade possui recursos à venda. Isso indica que pelo menos um tipo de recurso está disponível na zona, mas não necessariamente o específico que você solicitou. SoldOut: Todos os recursos na zona de disponibilidade estão esgotados.	Available
StatusCategory	string	O status detalhado do inventário da zona de disponibilidade. Valores possíveis: WithStock: O recurso está em estoque e será reabastecido continuamente. ClosedWithStock: O recurso está em estoque, mas não será reabastecido. WithoutStock: O recurso está esgotado, mas será reabastecido. Recomendamos escolher uma especificação de produto com o status WithStock. ClosedWithoutStock: O recurso está esgotado e não será reabastecido. Recomendamos escolher uma especificação de produto com o status WithStock.	WithStock
RegionId	string	O ID da região.	cn-hangzhou
AvailableResources	object
AvailableResource	array<object>	Uma matriz de recursos específicos que você pode criar.
	array<object>	Uma coleção de recursos específicos que você pode criar.
Type	string	O tipo de recurso. Valores possíveis: Zone: zona de disponibilidade. IoOptimized: otimizado para I/O. InstanceType: tipo de instância. SystemDisk: disco do sistema. DataDisk: disco de dados. Network: tipo de rede. ddh: host dedicado.	InstanceType
SupportedResources	object
SupportedResource	array<object>	Uma matriz de recursos suportados específicos que você pode criar.
	object	Informações sobre um recurso suportado específico que você pode criar.
Status	string	O status do recurso. Valores possíveis: Available: O recurso está disponível para compra. SoldOut: O recurso está esgotado.	Available
Value	string	O valor do recurso.	ecs.d1ne.xlarge
Max	integer	A capacidade máxima do disco em nuvem. Nota Este parâmetro é válido apenas quando o parâmetro `DestinationResource` está definido como `SystemDisk` ou `DataDisk`.	2048
Unit	string	A unidade de medida para a capacidade do disco em nuvem. Nota Este parâmetro é válido apenas quando o parâmetro `DestinationResource` está definido como `SystemDisk` ou `DataDisk`.	GiB
StatusCategory	string	O status detalhado do inventário do recurso. Valores possíveis: WithStock: O recurso está em estoque e será reabastecido continuamente. ClosedWithStock: O recurso está em estoque, mas não será reabastecido. WithoutStock: O recurso está esgotado, mas será reabastecido. Recomendamos escolher uma especificação de produto com o status WithStock. ClosedWithoutStock: O recurso está esgotado e não será reabastecido. Recomendamos escolher uma especificação de produto com o status WithStock.	WithStock
Min	integer	A capacidade mínima do disco em nuvem. Nota Este parâmetro é válido apenas quando o parâmetro `DestinationResource` está definido como `SystemDisk` ou `DataDisk`.	20

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Invalid.InstanceChargeType	The specified InstanceChargeType is not valid.	O parâmetro InstanceChargeType 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	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.
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.	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.Scope	The specified parameter Scope is invalid.	O parâmetro Scope especificado é inválido.
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.	O parâmetro de região é inválido.
404	Unavailable.Regions	The available region does not exist.
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.NetworkType	The specified NetworkType is not valid.	O parâmetro NetworkType 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.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	As informações da região são inválidas.
404	InvalidDedicatedHostId.NotFound	The specified Dedicated Host does not exist.	O host dedicado especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.