You need to enable JavaScript to run this app.
Elastic Compute Service

Elastic Compute Service

Copy page
Download PDF
Instances
GetScheduledInstanceLatestReleaseAt - Queries the latest release time of Elastic Scheduled Instances-Segmented
Copy page
Download PDF
GetScheduledInstanceLatestReleaseAt - Queries the latest release time of Elastic Scheduled Instances-Segmented
Call the GetScheduledInstanceLatestReleaseAt operation to query the latest release time of Elastic Scheduled Instances-Segmented.​
Note​
The Elastic Scheduled Instances-Segmented type is currently in Beta. If you need a trial, contact the account manager to apply.​
Debugging​
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
​
Request parameters​
The table below lists only the request parameters specific to this operation and some common parameters. For more information, refer to Common parameters.​
Action string required Sample value: GetScheduledInstanceLatestReleaseAt​
The operation that you want to perform. Valid value: GetScheduledInstanceLatestReleaseAt.​
​
Version string required Sample value: 2020-04-01​
The version of the API. Valid value: 2020-04-01.​
​
DeliveryType string Optional Sample value: Reserve​
The delivery type of Elastic Scheduled Instances-Segmented. Valid values.​
  • Reserve (default): Scheduled delivery​
  • Immediate: Immediate delivery​
tip​
This parameter takes effect only when ElasticScheduledInstanceType is set to Segmented.​
​
InstanceTypeId string required Sample value: ecs.g1ie.xlarge​
The instance type ID.​
​
StartDeliveryAt string Optional Sample value: 2023-03-29T17:50:00+08:00​
The start time for scheduled delivery of Elastic Scheduled Instances-Segmented.​
​
VolumeType string required Sample value: ESSD_PL0​
The volume type. Value:​
  • ESSD_PL0: ESSD PL0​
  • ESSD_FlexPL: ESSD FlexPL​
​
ZoneId string required Sample value: cn-beijing2-b​
The ID of the availability zone where the instance resides. Valid values:​
  • cn-beijing2-b​
  • cn-datong-a​
If other values are passed in, the common error code InvalidActionOrVersion is returned.​
​
​
​
Response parameters​
Only the response parameters specific to this operation are listed below. For more information, refer to the response structure.​
LatestReleaseAt string Sample value: 2023-03-29T17:50:00+08:00​
The latest release time of instances.​
​
​
​
Sample request​
​
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​
​
Sample response​
​
{​
"ResponseMetadata": {​
"RequestId": "202106111445100102252431000052****",​
"Action": "GetScheduledInstanceLatestReleaseAt",​
"Version": "2020-04-01",​
"Service": "ecs",​
"Region": "cn-beijing"​
},​
"Result": {​
"LatestReleaseAt": 2023-03-29T17:50:00+08:00​
}​
}​
​
Error codes​
The table below lists the business-related error codes of the operation. For more information, refer to Common error codes.​
​
Status code​
Error code​
Error message​
Description​
400​
InvalidDeliveryTimeIntervalForCreateScheduledInstance.Unsupported​
The specified delivery time interval does not support creation of scheduled instances.​
The specified delivery time period is unavailable for ESI creation.​
400​
InvalidDeliveryType.Malformed​
The specified DeliveryType is malformed.​
The specified delivery type is invalid.​
400​
InvalidDeliveryTypeForCreateScheduledInstanceNow.Unsupported​
The specified delivery type does not support creation of scheduled instances at the current time.​
The specified delivery method is unavailable for ESI creation.​
400​
InvalidStartDeliveryAt.Malformed​
The specified StartDeliveryAt is malformed.​
The specified delivery start time is invalid.​
400​
MissingParameter.InstanceTypeId​
The required parameter InstanceTypeId is not supplied.​
The ID of the instance type cannot be empty.​
400​
MissingParameter.VolumeType​
The required parameter VolumeType is not supplied.​
The volume type cannot be empty.​
400​
MissingParameter.ZoneId​
The required parameter ZoneId is not supplied.​
Availability zone ID cannot be empty.​
404​
InvalidActionOrVersion​
Could not find operation %s for version %s.​
The operation does not exist.​
404​
InvalidInstanceType.NotFound​
The specified InstanceType does not exist.​
The specified instance type does not exist.​
404​
InvalidZone.NotFound​
The specified zone does not exist.​
The specified availability zone does not exist.​
500​
InternalError​
An internal error has occurred.​
An internal error occurred. Please try again. If multiple attempts fail, submit a ticket.​
​
​
Last updated: 2026.04.17 10:57:32