文档中心

云服务器

请输入

实例

GetScheduledInstanceLatestReleaseAt - 查询弹性预约实例-时段型的最晚释放时间

调用 GetScheduledInstanceLatestReleaseAt 接口查询弹性预约实例-时段型的最晚释放时间。

使用说明

弹性预约实例-时段型正在邀测中，如需试用，请联系客户经理申请。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：GetScheduledInstanceLatestReleaseAt

要执行的操作，取值：GetScheduledInstanceLatestReleaseAt。

Version string 必选示例值：2020-04-01

API的版本，取值：2020-04-01。

DeliveryType string 可选示例值：Reserve

弹性预约实例-时段型的交付类型，取值：

Reserve（默认）：预约交付

Immediate：立即交付

说明

仅在ElasticScheduledInstanceType取值为Segmented时生效。

InstanceTypeId string 必选示例值：ecs.g1ie.xlarge

实例规格ID。

StartDeliveryAt string 可选示例值：2023-03-29T17:50:00+08:00

预约交付的弹性预约实例-时段型的开始交付时间。

VolumeType string 必选示例值：ESSD_PL0

云盘的类型，取值：

ESSD_PL0：极速型SSD PL0

ESSD_FlexPL：极速型SSD FlexPL

ZoneId string 必选示例值：cn-beijing2-b

实例所在可用区ID，取值：

cn-beijing2-b

cn-datong-a

如果传入其它值，则返回公共错误码InvalidActionOrVersion。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

LatestReleaseAt string 示例值：2023-03-29T17:50:00+08:00

实例最晚释放时间。

请求示例

GET /?Action=GetScheduledInstanceLatestReleaseAt&Version=2020-04-01&InstanceTypeId=ecs.g1ie.xlarge&ZoneId=cn-beijing2-b&VolumeType=ESSD_PL0 HTTP/1.1​
Host: ecs.cn-beijing2.volcengineapi.com​
Region: cn-beijing2​
Service: ecs​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "202106111445100102252431000052****",​
        "Action": "GetScheduledInstanceLatestReleaseAt",​
        "Version": "2020-04-01",​
        "Service": "ecs",​
        "Region": "cn-beijing"​
    },​
    "Result": {​
        "LatestReleaseAt": 2023-03-29T17:50:00+08:00​
       }​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidDeliveryTimeIntervalForCreateScheduledInstance.Unsupported	The specified delivery time interval does not support creation of scheduled instances.	指定的交付时间段不支持创建弹性预约实例。
400	InvalidDeliveryType.Malformed	The specified DeliveryType is malformed.	指定的交付类型不合法。
400	InvalidDeliveryTypeForCreateScheduledInstanceNow.Unsupported	The specified delivery type does not support creation of scheduled instances at the current time.	指定的交付方式当前时间点不支持创建弹性预约实例。
400	InvalidStartDeliveryAt.Malformed	The specified StartDeliveryAt is malformed.	指定的交付开始时间不合法。
400	MissingParameter.InstanceTypeId	The required parameter InstanceTypeId is not supplied.	实例规格ID不能为空。
400	MissingParameter.VolumeType	The required parameter VolumeType is not supplied.	云盘类型不能为空。
400	MissingParameter.ZoneId	The required parameter ZoneId is not supplied.	可用区ID不能为空。
404	InvalidActionOrVersion	Could not find operation %s for version %s.	请求接口不存在。
404	InvalidInstanceType.NotFound	The specified InstanceType does not exist.	指定的实例规格不存在。
404	InvalidZone.NotFound	The specified zone does not exist.	指定的可用区不存在。
500	InternalError	An internal error has occurred.	内部错误，请重试。如果多次尝试失败，请提交工单。

最近更新时间：2025.09.04 16:59:42

这个页面对您有帮助吗？

有用

无用