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

Descrição

Chame esta operação para consultar informações geradas para instâncias preemptíveis nos últimos 30 dias e selecione tipos de instância adequados com base nos resultados. As informações que você pode obter incluem:
- Taxa média de liberação de instâncias preemptíveis
- Porcentagem do preço médio da instância preemptível em relação ao preço da instância com pagamento conforme o uso
- Preço médio da instância preemptível calculado com base na porcentagem anterior
Esta operação aplica-se apenas a instâncias preemptíveis otimizadas para I/O localizadas em Virtual Private Clouds (VPCs).
Utilize um dos métodos abaixo para consultar informações geradas para instâncias preemptíveis nos últimos 30 dias:
- Defina os parâmetros Cores e Memory ou MinCores e MinMemory para consultar informações sobre tipos de instância que possuem o número especificado de vCPUs e tamanho de memória.
- Defina o parâmetro InstanceTypes.N para consultar informações dos tipos de instância especificados.
- Defina os parâmetros Cores e Memory ou MinCores e MinMemory e defina também o parâmetro InstanceTypeFamily ou InstanceFamilyLevel para consultar informações dos tipos de instância que possuem o número especificado de vCPUs e tamanho de memória dentro da família de instâncias ou no nível de família de instâncias especificado.

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

Parameter	Type	Required	Example	Description
Action	String	No	DescribeSpotAdvice	A operação a ser executada. Defina o valor como DescribeSpotAdvice.
RegionId	String	Yes	cn-hangzhou	O ID da região. Chame a operação DescribeRegions para consultar a lista mais recente de regiões.
Cores	Integer	No	2	O número de vCPUs do tipo de instância. Para obter informações sobre os valores válidos, consulte Famílias de instâncias.
Memory	Float	No	8.0	O tamanho da memória do tipo de instância. Unidade: GiB. Para obter informações sobre os valores válidos, consulte Famílias de instâncias.
MinCores	Integer	No	2	O número mínimo de vCPUs do tipo de instância. Para obter informações sobre os valores válidos, consulte Famílias de instâncias.
MinMemory	Float	No	8.0	O tamanho mínimo de memória do tipo de instância. Para obter informações sobre os valores válidos, consulte Famílias de instâncias.
ZoneId	String	No	cn-hangzhou-i	O ID da zona. Este parâmetro está vazio por padrão, o que indica que todas as zonas na região especificada serão consultadas.
InstanceTypes.N	RepeatList	No	ecs.c5.large	Tipo de instância N. Valores válidos de N: 1 a 10. Para obter informações sobre os valores válidos, consulte Famílias de instâncias.
InstanceTypeFamily	String	No	ecs.c5	A família de instâncias. Para obter informações sobre os valores válidos, consulte Famílias de instâncias.
InstanceFamilyLevel	String	No	EntryLevel	O nível da família de instâncias. Valores válidos: EntryLevel EnterpriseLevel CreditEntryLevel. Para obter mais informações, consulte Visão geral de instâncias com capacidade de burst. Este parâmetro está vazio por padrão, o que indica que famílias de instâncias de todos os níveis serão consultadas.
GpuSpec	String	No	NVIDIA T4	O tipo de GPU. Valores válidos: NVIDIA P4 NVIDIA T4 NVIDIA P100 NVIDIA V100 Este parâmetro está vazio por padrão, o que indica que todos os tipos de GPU serão consultados. Para obter mais informações, consulte Tipos de instância otimizados para computação acelerada por GPU.
GpuAmount	Integer	No	2	O número de GPUs por instância acelerada por GPU. Para obter informações sobre os valores válidos, consulte Tipos de instância otimizados para computação acelerada por GPU.

Parâmetros de resposta

Parameter	Type	Example	Description
AvailableSpotZones	Array of AvailableSpotZone		Detalhes sobre instâncias preemptíveis nas zonas da região especificada. Nota Os valores retornados são classificados com base nas porcentagens históricas dos preços médios das instâncias preemptíveis em relação aos preços das instâncias com pagamento conforme o uso para os tipos de instância.
AvailableSpotZone
AvailableSpotResources	Array of AvailableSpotResource		Detalhes sobre instâncias preemptíveis nos últimos 30 dias, incluindo taxas de liberação e porcentagens dos preços médios das instâncias preemptíveis em relação aos preços das instâncias com pagamento conforme o uso.
AvailableSpotResource
AverageSpotDiscount	Integer	20	A porcentagem do preço médio da instância preemptível em relação ao preço da instância com pagamento conforme o uso nos últimos 30 dias. Unidade: porcentagem (%). Valores válidos: 1 a 100. É possível calcular o preço médio da instância preemptível com base no valor retornado. Por exemplo, se o preço da instância com pagamento conforme o uso for 1 e o valor retornado deste parâmetro for 20, o preço médio da instância preemptível nos últimos 30 dias será 0,2.
InstanceType	String	ecs.c5.large	O tipo de instância.
InterruptRateDesc	String	0-3%	A faixa da taxa de liberação de instâncias preemptíveis nos últimos 30 dias, que corresponde ao valor de `InterruptionRate`. Valores válidos: 0-3% 3-5% 5-10% 10-100%
InterruptionRate	Float	0	A taxa média de liberação de instâncias preemptíveis nos últimos 30 dias. Unidade: porcentagem (%).
ZoneId	String	cn-hangzhou-i	O ID da zona.
RegionId	String	cn-hangzhou	O ID da região.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DescribeSpotAdvice
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-i
&InstanceTypes.1=ecs.c5.large
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<DescribeSpotAdviceResponse>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
      <AvailableSpotZones>
            <AvailableSpotZone>
                  <ZoneId>cn-hangzhou-i</ZoneId>
            </AvailableSpotZone>
            <AvailableSpotZone>
                  <AvailableSpotResources>
                        <AvailableSpotResource>
                              <InterruptRateDesc>0-3%</InterruptRateDesc>
                              <InstanceType>ecs.c5.large</InstanceType>
                              <AverageSpotDiscount>20</AverageSpotDiscount>
                              <InterruptionRate>0</InterruptionRate>
                        </AvailableSpotResource>
                  </AvailableSpotResources>
            </AvailableSpotZone>
      </AvailableSpotZones>
      <RegionId>cn-hangzhou</RegionId>
</DescribeSpotAdviceResponse>

Formato JSON

{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E", 
    "AvailableSpotZones": {
        "AvailableSpotZone": [
            {
                "ZoneId": "cn-hangzhou-i"
            }, 
            {
                "AvailableSpotResources": {
                    "AvailableSpotResource": [
                        {
                            "InterruptRateDesc": "0-3%", 
                            "InstanceType": "ecs.c5.large", 
                            "AverageSpotDiscount": "20", 
                            "InterruptionRate": "0"
                        }
                    ]
                }
            }
        ]
    }, 
    "RegionId": "cn-hangzhou"
}

Códigos de erro

HTTP status code	Error code	Error message	Description
404	Invalid.RegionId	The specified RegionId does not exist.	A mensagem de erro retornada porque o parâmetro RegionId especificado é inválido.
404	Unavailable.Regions	The available regions does not exists	A mensagem de erro retornada porque o parâmetro RegionId especificado é inválido.
400	Invalid.Param	The input parameter DestinationResource that is mandatory for processing this request is not supplied.	A mensagem de erro retornada porque o parâmetro DestinationResource especificado é inválido.
404	Invalid.ResourceType	The ResourceType provided does not exist in our records.	A mensagem de erro retornada porque o parâmetro ResourceType especificado é inválido.
404	Invalid.DestinationResource	The specified DestinationResource is not valid.	A mensagem de erro retornada porque o parâmetro DestinationResource especificado é inválido.
404	Invalid.IoOptimized	The specified IoOptimized is not valid.	A mensagem de erro retornada porque o parâmetro IoOptimized especificado é inválido.
404	Invalid.NetworkType	The specified NetworkType is not valid.	A mensagem de erro retornada porque o parâmetro NetworkType especificado é inválido.
403	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist in our records.	A mensagem de erro retornada porque o host dedicado especificado não existe na região atual.
403	InvalidParam.TypeAndCpuMem.Conflict	The specified 'InstanceType' and 'Cores','Memory' are not blank at the same time.	A mensagem de erro retornada porque os parâmetros InstanceTypes.N, Cores e Memory estão todos vazios.
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.	A mensagem de erro retornada porque o parâmetro RegionId especificado é inválido.

Para obter uma lista de códigos de erro, visite o API Error Center.