调用 DeleteScheduledInstance 接口取消预约。
不同类型的弹性预约实例,支持取消预约的情况不同,具体说明如下表所示。
说明
弹性预约实例-时段型正在邀测中,如需试用,请联系客户经理申请。
类型 | 是否支持取消预约 | |
---|---|---|
弹性预约实例(Esi) | 支持在弹性预约单创建后的30min内取消预约。 | |
弹性预约实例-时段型(Segmented) | 预约交付(Reserve) | 支持弹性预约单在待交付之前,即到达资源交付时间段起始时间之前,取消预约。 |
立即交付(Immediate) | 不支持取消预约。 |
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DeleteScheduledInstance | 要执行的操作,取值:DeleteScheduledInstance。 |
Version | String | 是 | 2020-04-01 | API的版本,取值:2020-04-01。 |
ClientToken | String | 否 | 333456899ff**** | 保证请求幂等性。由客户端自动生成一个参数值,确保不同请求间该参数值唯一,避免当调用API超时或服务器内部错误时,客户端多次重试导致重复性操作。 |
ScheduledInstanceId | String | 是 | esi-3thhlu8byl4bwbha**** | 弹性预约单ID。 |
本接口无特有的返回参数。更多信息请见返回结构。
GET /?Action=DeleteScheduledInstance&Version=2020-04-01&ScheduledInstanceId=esi-3thhlu8byl4bwbha**** HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing ServiceName: ecs
{ "ResponseMetadata": { "RequestId": "20240104191846FF4457331417A963****", "Action": "DeleteScheduledInstance", "Version": "2020-04-01", "Service": "ecs", "Region": "cn-beijing", "Error": { "Code": "InvalidDeliveryTypeForScheduledInstanceDeletion.Unsupported", "Message": "The specified DeliveryType cannot be used for scheduled instance deletion." } } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | IdempotentParameterMismatch | The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical. | 幂等参数不一致。 |
400 | InvalidClientToken.Malformed | The specified ClientToken is malformed. | 指定的ClientToken不合法。 |
400 | InvalidDeliveryTypeForScheduledInstanceDeletion.Unsupported | The specified DeliveryType cannot be used for scheduled instance deletion. | 立即交付方式的弹性预约单不支持取消预约。 |
400 | InvalidScheduledInstanceStatus | The specified scheduled instance is not in the correct status for the request. | 当前弹性预约单状态不支持此操作。 |
400 | MissingParameter.ScheduledInstanceId | The required parameter ScheduledInstanceId is not supplied. | 参数ScheduledInstanceId不能为空。 |
404 | InvalidScheduledInstance.NotFound | The specified scheduled instance does not exist. | 指定的弹性预约单不存在。 |
412 | IdempotentProcessing | The request uses the same client token as a previous one that is still in process. | 先前的幂等请求仍在处理中,请稍后重试。 |
412 | OperationDenied.LatestCancelTime | The specified operation is denied as your resource has exceeded the latest appointment cancellation time. | 指定的操作被拒绝,您的资源已超过最晚取消预约时间。 |
500 | InternalError | An internal error has occurred. | 内部错误,请重试。如果多次尝试失败,请提交工单。 |