ModifyDedicatedHostAutoReleaseTime - 为专有宿主机设定自动释放时间 - 云服务器 ECS

接口说明

到达设置的自动释放时间后，按量付费专有宿主机会被自动释放。请确保您已经不再使用该宿主机，并已按需备份应用数据。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作

访问级别

资源类型

条件关键字

关联操作

ecs:ModifyDedicatedHostAutoReleaseTime

update

*DedicatedHost

acs:ecs:{#regionId}:{#accountId}:ddh/{#ddhId}

无

名称	类型	必填	描述	示例值
RegionId	string	是	专有宿主机所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
DedicatedHostId	string	是	需要自动释放的专有宿主机 ID。	dh-bp165p6xk2tlw61e****
AutoReleaseTime	string	否	专有宿主机的自动释放时间。按照 ISO 8601 标准表示，并使用 UTC+0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。必须晚于当前时间起算的半小时及以后。必须早于当前时间起算的三年及以前。如果参数值中的秒（ss）不是 00，则自动取为 00。如果不输入`AutoReleaseTime`参数，表示取消自动释放，专有宿主机在预约时间点不再自动释放。	2019-06-04T13:35:00Z

正常返回示例

JSON格式

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE7****"
}

HTTP status code	错误码	错误信息	描述
400	MissingParameter	DedicatedHostId should not be null.	参数 DedicatedHostId 不能为空。
400	UnsupportedParameter	The parameters is unsupported.	指定的参数不合法。
400	InvalidAutoReleaseTime.Malformed	The specified parameter AutoReleaseTime is not valid.	指定的自动释放时间AutoReleaseTime无效。
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	内部错误，请重试。
403	ChargeTypeViolation	The operation is not permitted due to charge type of the dedicated host.
404	NoSuchResource	The specified resource is not found.	指定的资源不存在。

访问错误中心查看更多错误码。

更多信息，参考变更详情。