查詢搶佔式執行個體近 30 天內的曆史價格。

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:DescribeSpotPriceHistory
RegionId String 執行個體所屬的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
ZoneId String 可用性區域 ID。
NetworkType String 搶佔式執行個體網路類型。取值範圍:
  • classic:表示搶佔式執行個體的網路類型為經典網路
  • vpc:表示搶佔式執行個體的網路類型為專有網路
InstanceType String 執行個體規格。
IoOptimized String 是否為 I/O 優化執行個體。取值範圍:
  • optimized:表示搶佔式執行個體為 I/O 優化執行個體
  • none:表示搶佔式執行個體為非 I/O 優化執行個體

系列 I 執行個體預設值:none

系列 II 執行個體預設值:optimized系列 III 執行個體預設值:optimized

StartTime String 查詢搶佔式執行個體曆史價格的起始時間。按照 ISO8601 標準表示,需要使用 UTC 時間,格式為 YYYY-MM-DDTHH:MM:SSZ 。預設為空,空代表結束時間前 3 天,最大值不得超過指定的結束時間 30 天。
EndTime String 查詢搶佔式執行個體曆史價格的結束時間。按照 ISO8601 標準表示,需要使用 UTC 時間,格式為 YYYY-MM-DDTHH:MM:SSZ 。

預設為空,空表示目前時間。

Offset Integer 查詢開始行。

預設值:0

返回參數

名稱 類型 描述
NextOffset Integer 下一頁開始行,查詢下一頁的資料,參數 Offset 的指定值為該值
SpotPrices SpotPriceType 搶佔價格詳情

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=DescribeSpotHistory
&RegionId=cn-hangzhou
&ZoneId=cn-hanghzhou-c
&NetworkType=vpc
&InstanceType=ecs.t1.xsmall
&IoOptimized=none
&UtcStartTime=2017-08-22T08:45:08Z...
&<公共請求參數>
返回樣本

XML 格式

<DescribeSpotPriceHistoryResponse>
    <RequestId>xxxxxxxxxxxxxx</RequestId>
    <NextOffset>1000</NextOffset>
    <SpotPrices>
        <SpotPriceType>
            <IoOptimized>none</IoOptimized>
            <OriginPrice>0.028</OriginPrice>
            <NetworkType>classic</NetworkType>
            <Timestamp>2017-09-18T11:00:00Z</Timestamp>
            <ZoneId>cn-hangzhou-c</ZoneId>
            <SpotPrice>0.006</SpotPrice>
            <InstanceType>ecs.t1.xsmall</InstanceType>
        </SpotPriceType>
        <SpotPriceType>
            <IoOptimized>none</IoOptimized>
            <OriginPrice>0.028</OriginPrice>
            <NetworkType>classic</NetworkType>
            <Timestamp>2017-09-18T12:00:00Z</Timestamp>
            <ZoneId>cn-hangzhou-c</ZoneId>
            <SpotPrice>0.006</SpotPrice>
            <InstanceType>ecs.t1.xsmall</InstanceType>
    </SpotPriceType>
</SpotPrices>
</DescribeSpotPriceHistoryResponse>
JSON 格式
{
    "RequestId":"xxxxxxxxxxxxxx",
    "NextOffset":1000,
    "SpotPrices":
    {
        "SpotPriceType":[
        {
            "IoOptimized":"none",
            "OriginPrice":0.028,
            "NetworkType":"classic",
            "Timestamp":"2017-09-18T11:00:00Z",
            "ZoneId":"cn-hangzhou-c","SpotPrice":0.006,
            "InstanceType":"ecs.t1.xsmall"
            }
        ]
    }
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
InvalidParams.EndTime The format of the specified parameter EndTime is invalid. 400 參數 EndTime 格式應遵循 ISO8601 標準表示。
InvalidParams.InstanceType The specified parameter InstanceType is required. 400 參數 InstanceType 不得為空。
InvalidParams.IoOptimized The value of specified parameter IoOptimized is invalid. 400 參數 IoOptimized 的取值有誤。
InvalidParams.NetworkType The value of specified parameter NetworkType is invalid. 400 參數 NetworkType 的取值有誤。
InvalidParams.RegionId The specified parameter RegionId is required. 400 參數 RegionId 不得為空。
InvalidParams.StartTime The format of the specified parameter StartTime is invalid. 400 參數 StartTime 格式應遵循 ISO8601 標準表示。
InvalidParams.ZoneId The specified parameter ZoneId is required. 400 參數 ZoneId 不得為空。