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

Observações de uso

O valor de DestinationResource determina a necessidade de especificar parâmetros adicionais. Ao escolher um valor na cadeia abaixo para DestinationResource, quanto mais à direita ele estiver posicionado, maior será o número de parâmetros obrigatórios.

Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk
Exemplos:
- DestinationResource definido como DataDisk.
  - Se ResourceType for disk para consultar categorias de disco de dados independentes dos tipos de instância ECS, não é necessário especificar InstanceType.
  - Se ResourceType for instance para consultar categorias de discos de dados adquiridos junto com instâncias ECS, especifique InstanceType e SystemDiskCategory devido às limitações específicas de cada tipo de instância para discos de sistema e de dados.
- Quando DestinationResource for SystemDisk e ResourceType for instance, especifique InstanceType por causa das restrições de disco de sistema associadas ao tipo de instância.
- Para DestinationResource igual a InstanceType, recomenda-se definir IoOptimized e InstanceType.
- Para consultar os recursos ecs.g5.large disponíveis em todas as zonas da região China (Hangzhou), defina RegionId como cn-hangzhou, DestinationResource como InstanceType, IoOptimized como optimized e InstanceType como ecs.g5.large.
- Para identificar as zonas da região China (Hangzhou) que possuem recursos ecs.g5.large disponíveis, configure RegionId como cn-hangzhou, DestinationResource como Zone, IoOptimized como optimized e InstanceType como ecs.g5.large.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeAvailableResource	A operação a ser executada. Defina o valor como DescribeAvailableResource.
RegionId	String	Sim	cn-hangzhou	O ID da região. Chame a operação DescribeRegions para obter a lista mais recente de regiões.
InstanceChargeType	String	Não	PrePaid	O método de faturamento do recurso. Para mais informações, consulte Visão geral de faturamento. Valores válidos: PrePaid: assinatura PostPaid: pagamento conforme o uso Valor padrão: PostPaid.
SpotStrategy	String	Não	NoSpot	A política de lance para a instância de pagamento conforme o uso. Valores válidos: NoSpot: A instância é do tipo pagamento conforme o uso. SpotWithPriceLimit: A instância é criada como preemptível, permitindo especificar o preço máximo por hora. SpotAsPriceGo: A instância é criada como preemptível com preço baseado no valor de mercado no momento da compra. Esse valor pode equivaler ao preço de uma instância de pagamento conforme o uso. Valor padrão: NoSpot. Este parâmetro só tem efeito quando InstanceChargeType for definido como PostPaid.
SpotDuration	Integer	Não	1	O período de proteção da instância preemptível. Unidade: horas. Valor padrão: 1. Valores válidos: 1: Após a criação da instância preemptível, o Alibaba Cloud garante que ela não será liberada automaticamente dentro de 1 hora. Terminado esse período de proteção, o sistema compara o preço do lance com o preço de mercado e verifica o estoque de recursos para decidir se mantém ou libera a instância. 0: Após a criação da instância preemptível, o Alibaba Cloud não garante que ela funcionará por 1 hora. O sistema compara o preço do lance com o preço de mercado e verifica o estoque de recursos para decidir se mantém ou libera a instância. O Alibaba Cloud envia eventos de sistema ECS para notificá-lo 5 minutos antes da liberação da instância. Instâncias preemptíveis são faturadas por segundo. Recomendamos definir um período de proteção adequado às necessidades do seu negócio. Nota Este parâmetro entra em vigor se SpotStrategy for definido como SpotWithPriceLimit ou SpotAsPriceGo.
DestinationResource	String	Sim	InstanceType	O tipo de recurso. Valores válidos: Zone: zona. IoOptimized: recurso otimizado para I/O. InstanceType: tipo de instância. SystemDisk: disco de sistema. DataDisk: disco de dados. Network: tipo de rede. ddh: host dedicado. Para mais detalhes sobre como especificar DestinationResource, consulte a seção "Observações de uso" deste tópico.
ZoneId	String	Não	cn-hangzhou-e	O ID da zona. Por padrão, este parâmetro fica vazio. Isso indica que o sistema retorna recursos correspondentes às demais condições em todas as zonas da região especificada por `RegionId`.
IoOptimized	String	Não	optimized	Indica se a instância é otimizada para I/O. Valores válidos: none: A instância não é otimizada para I/O. optimized: A instância é otimizada para I/O. Valor padrão: optimized.
DedicatedHostId	String	Não	dh-bp165p6xk2tlw61e****	O ID do host dedicado.
InstanceType	String	Não	ecs.g5.large	O tipo de instância. Para mais informações, consulte Visão geral das famílias de instâncias. Também é possível chamar a operação DescribeInstanceTypes para obter a lista mais recente de tipos de instância. Para mais detalhes sobre como especificar InstanceType, consulte a seção Observações de uso deste tópico.
SystemDiskCategory	String	Não	cloud_ssd	A categoria do disco de sistema. Valores válidos: cloud: disco básico. cloud_efficiency: ultra disco cloud_ssd: SSD padrão. ephemeral_ssd: SSD local. cloud_essd: ESSD. cloud_auto: disco ESSD AutoPL. Valor padrão: cloud_efficiency. Nota Se ResourceType for instance e DestinationResource for DataDisk, especifique SystemDiskCategory. Caso contrário, o valor padrão será utilizado.
DataDiskCategory	String	Não	cloud_ssd	O tipo do disco de dados. Valores válidos: cloud: disco básico. cloud_efficiency: ultra disco cloud_ssd: SSD padrão. ephemeral_ssd: SSD local. cloud_essd: ESSD. cloud_auto: disco ESSD AutoPL.
NetworkCategory	String	Não	vpc	O tipo de rede. Valores válidos: vpc: virtual private cloud (VPC). classic: rede clássica.
Cores	Integer	Não	2	O número de vCPUs do tipo de instância. Para mais informações, consulte Visão geral das famílias de instâncias. Este parâmetro só tem efeito quando DestinationResource for definido como InstanceType.
Memory	Float	Não	8.0	O tamanho da memória do tipo de instância. Unidade: GiB. Para mais informações, consulte Visão geral das famílias de instâncias. Este parâmetro só tem efeito quando DestinationResource for definido como InstanceType.
ResourceType	String	Não	instance	O tipo de recurso. Valores válidos: instance: instância ECS. disk: disco em nuvem. reservedinstance: instância reservada. ddh: host dedicado.
Scope	String	Não	Region	O escopo da instância reservada. Valores válidos: Region: regional. Zone: zonal

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	0041D94C-FB92-4C49-B115-259DA1C*	O ID da solicitação.
AvailableZones	Array of AvailableZone		As zonas consultadas.
AvailableZone
ZoneId	String	cn-hangzhou-e	O ID da zona.
Status	String	Available	O status dos recursos na zona. Valores válidos: Available SoldOut
StatusCategory	String	WithStock	A categoria do recurso baseada no nível de estoque. Valores válidos: WithStock: Recursos suficientes. ClosedWithStock: Recursos insuficientes. Recomendamos utilizar outros recursos com estoque disponível. WithoutStock: Recursos esgotados, mas serão repostos. Recomendamos utilizar outros recursos com estoque disponível. ClosedWithoutStock: Recursos esgotados e sem previsão de reposição. Recomendamos utilizar outros recursos com estoque disponível.
RegionId	String	cn-hangzhou	O ID da região.
AvailableResources	Array of AvailableResource		Os recursos disponíveis na zona.
AvailableResource
Type	String	InstanceType	O tipo de recurso. Valores válidos: Zone: zona. IoOptimized: recurso otimizado para I/O. InstanceType: tipo de instância. SystemDisk: disco de sistema. DataDisk: disco de dados. Network: tipo de rede. ddh: host dedicado.
SupportedResources	Array of SupportedResource		Os recursos consultados.
SupportedResource
Status	String	Available	O status do recurso. Valores válidos: Available SoldOut
Value	String	ecs.d1ne.xlarge	O tipo de recurso.
Max	Integer	2048	A capacidade máxima do disco. Este parâmetro só tem efeito quando DestinationResource for definido como SystemDisk ou DataDisk.
Unit	String	GiB	A unidade da capacidade do disco. Este parâmetro só tem efeito quando DestinationResource for definido como SystemDisk ou DataDisk.
StatusCategory	String	WithStock	A categoria do recurso baseada no nível de estoque. Valores válidos: WithStock: Recursos suficientes. ClosedWithStock: Recursos insuficientes. Recomendamos utilizar outros recursos com estoque disponível. WithoutStock: Recursos esgotados, mas serão repostos. Recomendamos utilizar outros recursos com estoque disponível. ClosedWithoutStock: Recursos esgotados e sem previsão de reposição. Recomendamos utilizar outros recursos com estoque disponível.
Min	Integer	20	A capacidade mínima do disco. Este parâmetro só tem efeito quando DestinationResource for definido como SystemDisk ou DataDisk.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DescribeAvailableResource
&RegionId=cn-hangzhou
&DestinationResource=InstanceType
&IoOptimized=optimized
&InstanceType=ecs.g5.large
&<Common request parameters>

Exemplos de respostas de sucesso

XML formato

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

<DescribeAvailableResourceResponse>
    <RequestId>0041D94C-FB92-4C49-B115-259DA1C*****</RequestId>
    <AvailableZones>
        <AvailableZone>
            <Status>Available</Status>
            <RegionId>cn-hangzhou</RegionId>
            <AvailableResources>
                <AvailableResource>
                    <Type>InstanceType</Type>
                    <SupportedResources>
                        <SupportedResource>
                            <Status>Available</Status>
                            <Value>ecs.g5.large</Value>
                            <StatusCategory>WithStock</StatusCategory>
                        </SupportedResource>
                    </SupportedResources>
                </AvailableResource>
            </AvailableResources>
            <ZoneId>cn-hangzhou-i</ZoneId>
            <StatusCategory>WithStock</StatusCategory>
        </AvailableZone>
    </AvailableZones>
</DescribeAvailableResourceResponse>

JSON formato

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

{
  "RequestId" : "0041D94C-FB92-4C49-B115-259DA1C*****",
  "AvailableZones" : {
    "AvailableZone" : [ {
      "Status" : "Available",
      "RegionId" : "cn-hangzhou",
      "AvailableResources" : {
        "AvailableResource" : [ {
          "Type" : "InstanceType",
          "SupportedResources" : {
            "SupportedResource" : [ {
              "Status" : "Available",
              "Value" : "ecs.g5.large",
              "StatusCategory" : "WithStock"
            } ]
          }
        } ]
      },
      "ZoneId" : "cn-hangzhou-i",
      "StatusCategory" : "WithStock"
    } ]
  }
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	Invalid.InstanceChargeType	The specified InstanceChargeType is not valid.	Valor inválido para InstanceChargeType.
400	Invalid.Param	The input parameter DestinationResource that is mandatory for processing this request is not supplied.	Valor inválido para DestinationResource.
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.	Valor inválido para RegionId.
403	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.	Valor inválido para DedicatedHostId.
404	Invalid.RegionId	The specified RegionId does not exist.	Valor inválido para RegionId.
404	Unavailable.Regions	The available regions does not exists	Valor inválido para RegionId.
404	Invalid.ResourceType	The ResourceType provided does not exist in our records.	Valor inválido para ResourceType.
404	Invalid.DestinationResource	The specified DestinationResource is not valid.	Valor inválido para DestinationResource.
404	Invalid.IoOptimized	The specified IoOptimized is not valid.	Valor inválido para IoOptimized.
404	Invalid.NetworkCategory	The specified NetworkCategory is not valid.	Valor inválido para NetworkCategory.
404	Invalid.SpotStrategy	The specified SpotStrategy is not valid.	Valor inválido para SpotStrategy.
404	Invalid.NetworkType	The specified NetworkType is not valid.	Valor inválido para NetworkType.
404	InvalidResourceId.NotFound	The specified ResourceId is not found in our records	Valor inválido para ResourceId. Verifique se o recurso existe.

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