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

Consulta os preços históricos de instâncias spot. Você pode consultar dados de preços dos últimos 30 dias. Os dados de preços históricos ajudam você a definir um preço máximo razoável para uma instância spot.

Descrição da operação

Apenas instâncias spot com otimização de E/S são suportadas.
Os dados retornados por esta operação podem ser paginados. Se a resposta contiver o parâmetro NextOffset, defina o parâmetro de solicitação Offset com o valor de NextOffset para consultar a próxima página de dados.

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 da instância. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente. DescribeRegions	cn-hangzhou
RegionId	string	Sim	O ID da região da instância. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente. DescribeRegions	cn-hangzhou
ZoneId	string	Não	O ID da zona.	cn-hangzhou-g
NetworkType	string	Sim	O tipo de rede da instância spot. Valores válidos: vpc: virtual private cloud (VPC). classic: rede clássica. Este recurso foi descontinuado. Para mais informações, consulte Aviso de descontinuação. Aviso de descontinuação	vpc
InstanceType	string	Sim	O tipo de instância.	ecs.t1.xsmall
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 inventário de recursos 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 inventário de recursos 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. Especifique um período de proteção adequado com base na duração esperada da execução da tarefa. Nota Este parâmetro só entra em vigor quando SpotStrategy é definido como SpotWithPriceLimit ou SpotAsPriceGo.	1
IoOptimized	string	Não	Especifica se a instância spot é otimizada para E/S. Valores válidos: optimized: A instância spot é uma instância com otimização de E/S. none: A instância spot não é uma instância com otimização de E/S. Valor padrão para famílias de instâncias da Geração I: none. Valor padrão para outras famílias de instâncias: optimized.	optimized
StartTime	string	Não	O início do intervalo de tempo para consultar os preços históricos das instâncias spot. O intervalo de tempo máximo entre a hora de início e a hora de término é de 30 dias. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC. Valor padrão: null, que indica 3 horas antes da hora de término. ISO 8601	2017-08-22T08:45:08Z
EndTime	string	Não	O fim do intervalo de tempo para consultar os preços históricos das instâncias spot. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC. Valor padrão: null, que indica a hora atual. ISO 8601	2017-08-22T08:45:08Z
OSType	string	Não	O tipo da plataforma do sistema operacional. Valores válidos: linux. windows.	linux
Offset	integer	Não	A linha a partir da qual a consulta começa. Valor padrão: 0.	0

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Currency	string	A unidade monetária do preço. Site da China: CNY. Site internacional: USD.	CNY
NextOffset	integer	A linha inicial da próxima página. Defina o parâmetro Offset com este valor para consultar a próxima página de dados.	1000
SpotPrices	object
SpotPriceType	array<object>	Os detalhes dos preços spot.
	object
IoOptimized	string	Detalhes sobre o histórico de preços da instância spot.	optimized
ZoneId	string	O ID da solicitação.	cn-hangzhou-c
SpotPrice	number	O preço de uma instância pós-paga que possui as mesmas configurações da instância spot.	0.036
Timestamp	string	A unidade monetária do preço. Site da China do Alibaba Cloud (aliyun.com): CNY. Site internacional do Alibaba Cloud (alibabacloud.com): USD.	2019-11-19T06:00:00Z
NetworkType	string	Consulta o histórico de preços de uma instância spot nos últimos 30 dias.	vpc
InstanceType	string	O tipo de instância da instância spot.	ecs.g5.large
OriginPrice	number	O preço de uma instância pós-paga que possui a mesma configuração da instância spot especificada.	0.354

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Currency": "CNY",
  "NextOffset": 1000,
  "SpotPrices": {
    "SpotPriceType": [
      {
        "IoOptimized": "optimized",
        "ZoneId": "cn-hangzhou-c",
        "SpotPrice": 0.036,
        "Timestamp": "2019-11-19T06:00:00Z",
        "NetworkType": "vpc",
        "InstanceType": "ecs.g5.large",
        "OriginPrice": 0.354
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	MissingParameter	%s	Pelo menos um dos parâmetros especificados deve ser fornecido. Eles não podem estar todos vazios.
400	UnsupportedParameter	%s	O parâmetro especificado não é suportado.
400	InvalidParameter	%s	A combinação de parâmetros especificada é inválida.
400	InvalidInstanceID.Malformed	%s
400	InvalidParams.StartTime	%s	O parâmetro StartTime especificado é inválido.
400	InvalidParams.EndTime	%s	O parâmetro EndTime especificado é inválido.
400	Abs.Abs.InvalidSpotInstanceUID	%s	O formato do ID da instância spot é inválido.
400	InvalidParams.NetworkType	%s	O parâmetro NetworkType especificado é inválido.
400	InvalidParams.IoOptimized	%s	O parâmetro IoOptimized especificado é inválido.
400	InvalidParams.OSType	%s	O parâmetro OSType especificado é inválido.
400	Abs.IoOptimized.ValueNotSupported	%s	O atributo de otimização de I/O da instância é inválido. Verifique se as configurações do parâmetro estão corretas.
400	InvalidZoneId.NotFound	The specified zone does not exist.	O ID da zona especificado não existe.
400	InvalidParams.ZoneId	%s	O parâmetro ZoneId especificado é inválido.
400	InvalidParams.RegionId	%s	O parâmetro RegionId especificado é inválido.
400	InvalidParams.InstanceType	%s	O parâmetro InstanceType especificado é inválido.
400	InvalidParams.PageSize	%s	O parâmetro PageSize especificado é inválido.
400	InvalidParams.Offset	%s	O parâmetro Offset especificado é inválido.
400	InvalidInstanceType.ValueNotSupported	%s	O tipo de instância especificado não suporta o tipo de disco em nuvem de dados anexado à instância atual.
400	DependencyViolation.IoOptimized	The specified instancetype must be IoOptimized instance.	O tipo de instância especificado deve ser uma instância otimizada para I/O. Verifique se o tipo de instância está correto.
400	InvalidSpotDuration	The specified SpotDuration is not valid.	O parâmetro SpotDuration especificado é inválido.
400	OperationDenied.QueryFail	Query spot price fail, please retry later.
403	InvalidUserType.NotSupported	%s	O parâmetro de tipo de usuário é inválido.
403	Abs.InvalidAccount.NotFound	%s	Sua conta Alibaba Cloud não existe ou sua AccessKey expirou.
403	Forbedden.NotSupportRAM	%s	Usuários Resource Access Management (RAM) não têm suporte para executar esta operação.
403	Forbbiden.SubUser	%s	Sua conta não tem permissões para realizar operações neste recurso. Solicite as permissões necessárias à conta Alibaba Cloud.
403	OperationDenied.RegionIdNotSupported	region not support spot duration instance.
403	OperationDenied.FlavorNotSupported	flavor not support spot duration instance.
403	OperationDenied.TimestampNotSupported	timestamp not support spot duration instance.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.