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

Depuração

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

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeSpotPriceHistory	A operação a ser executada. Defina o valor como DescribeSpotPriceHistory.
RegionId	String	Sim	cn-hangzhou	O ID da região da instância. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
ZoneId	String	Não	cn-hangzhou-g	O ID da zona da instância.
NetworkType	String	Sim	vpc	O tipo de rede da instância preemptível. Valores válidos: classic vpc
InstanceType	String	Sim	ecs.t1.xsmall	O tipo da instância.
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 de uma instância preemptível, o Alibaba Cloud garante que a instância não seja liberada automaticamente dentro de 1 hora. Quando o período de proteção de 1 hora termina, 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 manter ou liberar a instância. 0: Após a criação de uma instância preemptível, o Alibaba Cloud não garante que a instância execute 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 manter ou liberar a instância. O Alibaba Cloud envia eventos de sistema do Elastic Compute Service (ECS) para notificá-lo 5 minutos antes da liberação da instância. A cobrança das instâncias preemptíveis é feita por segundo. Recomendamos que você especifique um período de proteção com base nos requisitos do seu negócio. Nota Se você definir SpotStrategy como SpotWithPriceLimit ou SpotAsPriceGo, este parâmetro entrará em vigor.
IoOptimized	String	Não	optimized	Especifica se a instância é otimizada para E/S. Valores válidos: optimized: A instância é otimizada para E/S. none: A instância não é otimizada para E/S. Para famílias de instâncias da geração I, o valor padrão é none. Para outras famílias de instâncias, o valor padrão é optimized.
StartTime	String	Não	2017-08-22T08:45:08Z	O início do intervalo de tempo a ser consultado. Especifique a hora no padrão ISO 8601 no formato `yyyy-MM-ddTHH:mm:ssZ`. A hora deve estar em UTC. Por padrão, este parâmetro está vazio. Isso indica que será usada a hora 3 horas anterior à hora especificada por EndTime.
EndTime	String	Não	2017-08-22T08:45:08Z	A hora final da consulta. Especifique a hora no padrão ISO 8601 no formato `yyyy-MM-ddTHH:mm:ssZ`. A hora deve estar em UTC. Por padrão, este parâmetro está vazio. Isso indica que a hora atual será usada.
OSType	String	Não	linux	O tipo da plataforma do sistema operacional. Valores válidos: linux windows
Offset	Integer	Não	0	A linha a partir da qual a consulta começa. Valor padrão: 0.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.
Currency	String	CNY	A unidade monetária do preço. Site da China do Alibaba Cloud (aliyun.com): CNY Site Internacional do Alibaba Cloud (alibabacloud.com): USD.
NextOffset	Integer	1000	A linha inicial da próxima página. Corresponde ao valor de `Offset`.
SpotPrices	Array of SpotPriceType		Os detalhes dos preços spot.
SpotPriceType
IoOptimized	String	optimized	Indica se a instância preemptível é otimizada para E/S.
ZoneId	String	cn-hangzhou-c	O ID da zona da instância preemptível.
SpotPrice	Float	0.036	O preço spot da instância preemptível.
Timestamp	String	2019-11-19T06:00:00Z	A hora correspondente ao preço spot consultado. A hora segue o padrão ISO 8601 no formato `YYYY-MM-DDThh:mm:ss`. A hora é exibida em UTC.
NetworkType	String	vpc	O tipo de rede da instância preemptível.
InstanceType	String	ecs.g5.large	O tipo da instância preemptível.
OriginPrice	Float	0.354	O preço de uma instância de pagamento conforme o uso com a mesma configuração da instância preemptível especificada.

Exemplos

Solicitações de exemplo

https://ecs.aliyuncs.com/?Action=DescribeSpotPriceHistory
&NetworkType=vpc
&RegionId=cn-hangzhou
&InstanceType=ecs.g5.large
&StartTime=2019-11-19T00:00:00Z
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<DescribeSpotPriceHistoryResponse>
    <RequestId>5E2D59BA-4EB0-45C4-A0D7-D98C1A4B320B</RequestId>
    <SpotPrices>
        <SpotPriceType>
            <IoOptimized>optimized</IoOptimized>
            <OriginPrice>0.354</OriginPrice>
            <NetworkType>vpc</NetworkType>
            <ZoneId>cn-hangzhou-g</ZoneId>
            <Timestamp>2019-11-19T06:00:00Z</Timestamp>
            <SpotPrice>0.036</SpotPrice>
            <InstanceType>ecs.g5.large</InstanceType>
        </SpotPriceType>
        <SpotPriceType>
            <IoOptimized>optimized</IoOptimized>
            <OriginPrice>0.354</OriginPrice>
            <NetworkType>vpc</NetworkType>
            <ZoneId>cn-hangzhou-g</ZoneId>
            <Timestamp>2019-11-19T07:00:00Z</Timestamp>
            <SpotPrice>0.036</SpotPrice>
            <InstanceType>ecs.g5.large</InstanceType>
        </SpotPriceType>
    </SpotPrices>
    <Currency>CNY</Currency>
</DescribeSpotPriceHistoryResponse>

Formato JSON

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

{
  "RequestId" : "5E2D59BA-4EB0-45C4-A0D7-D98C1A4B320B",
  "SpotPrices" : {
    "SpotPriceType" : [ {
      "IoOptimized" : "optimized",
      "OriginPrice" : 0.354,
      "NetworkType" : "vpc",
      "ZoneId" : "cn-hangzhou-g",
      "Timestamp" : "2019-11-19T06:00:00Z",
      "SpotPrice" : 0.036,
      "InstanceType" : "ecs.g5.large"
    }, {
      "IoOptimized" : "optimized",
      "OriginPrice" : 0.354,
      "NetworkType" : "vpc",
      "ZoneId" : "cn-hangzhou-g",
      "Timestamp" : "2019-11-19T07:00:00Z",
      "SpotPrice" : 0.036,
      "InstanceType" : "ecs.g5.large"
    } ]
  },
  "Currency" : "CNY"
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	MissingParameter	%s	Um parâmetro obrigatório não foi especificado.
400	UnsupportedParameter	%s	Um parâmetro especificado não é suportado.
400	InvalidParameter	%s	Valor de parâmetro inválido.
400	InvalidInstanceID.Malformed	%s	Formato de InstanceId inválido.
400	InvalidParams.StartTime	%s	Valor de StartTime 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 preemptível é inválido.
400	InvalidParams.NetworkType	%s	Valor de NetworkType inválido.
400	InvalidParams.IoOptimized	%s	Valor de IoOptimized inválido.
400	InvalidParams.OSType	%s	O parâmetro OSType especificado é inválido.
400	Abs.IoOptimized.ValueNotSupported	%s	O atributo de otimização de E/S da instância é inválido. Verifique se o valor especificado para IoOptimized é válido.
400	InvalidZoneId.NotFound	The specified zone does not exist.	Valor de ZoneId inválido.
400	InvalidParams.ZoneId	%s	Valor de ZoneId inválido.
400	InvalidParams.RegionId	%s	Valor de RegionId inválido.
400	InvalidParams.InstanceType	%s	Valor de InstanceType inválido.
400	InvalidParams.PageSize	%s	Valor de PageSize inválido.
400	InvalidParams.Offset	%s	Valor de Offset inválido.
400	InvalidInstanceType.ValueNotSupported	%s	O tipo de instância não suporta esta operação.
400	DependencyViolation.IoOptimized	The specified instancetype must be IoOptimized instance.	O tipo de instância especificado deve ser otimizado para E/S.
400	InvalidSpotDuration	The specified SpotDuration is not valid.	Valor de SpotDuration inválido.
403	InvalidUserType.NotSupported	%s	A conta não suporta esta operação.
403	Abs.InvalidAccount.NotFound	%s	Sua conta Alibaba Cloud não existe ou seu par AccessKey expirou.
403	Forbedden.NotSupportRAM	%s	Usuários do Resource Access Management (RAM) não têm permissões para executar esta operação.
403	Forbbiden.SubUser	%s	Você não tem permissão para acessar o recurso. Entre em contato com o proprietário da conta Alibaba Cloud para solicitar as permissões necessárias.

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