You need to enable JavaScript to run this app.
导航

ModifySnapshotAttribute

最近更新时间2024.05.22 14:09:13

首次发布时间2022.04.28 10:05:44

调用ModifySnapshotAttribute接口修改快照属性,当前仅支持修改快照名称、描述信息和快照保留时间。

调试

请求参数

名称类型是否必填
示例值
描述
ActionStringModifySnapshotAttribute要执行的操作,取值:ModifySnapshotAttribute
SnapshotIdStringsnap-bp1s5fnvk4gn2tws0****需要修改的快照ID。
RetentionDaysInteger30延长快照保留时间。快照保留时间仅支持延长,不支持缩短。取值范围为N+1~65536,N为快照创建时设置的保留时间。

SnapshotName

String

test_modify

快照名称,命名规范如下:

  • 长度为1~128个字符。
  • 只能包含中文、字母、数字、下划线(_)、中划线(-)和英文句号(.)。
  • 为防止和自动快照的名称冲突,不能以“auto”开头。
DescriptionStringtestDescription快照描述信息,长度为0~255个字符。

返回数据

请求示例

GET /?Action=ModifySnapshotAttribute&Description=test+modify&SnapshotId=snap-31akybwsxi8rudc6****&SnapshotName=test_modify&Version=2020-04-01 HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
ServiceName: storage_ebs

返回示例

{
		"ResponseMetadata": {
				"RequestId": "20220308180931010225243139000DF***",
				"Action": "ModifySnapshotAttribute",
				"Version": "2020-04-01",
				"Service": "storage_ebs",
				"Region": "cn-beijing"
		},
		"Result": {}
}

错误码

HttpCode错误码错误信息
400InvalidSnapshotName快照名称格式不合法。
400InvalidDescription资源描述格式不合法。
400NotAllowed.PermanentSnapshot永久保留快照不支持延长快照保留时间。
400LessThanCurrent.RetentionDays延长快照保留时间时,设置的值需要大于快照保留时间当前值。
404SnapshotNotFound未找到快照。