调用ModifySnapshotAttribute修改一份快照的名称、描述或关闭快照极速可用功能。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ModifySnapshotAttribute

系统规定参数。取值：ModifySnapshotAttribute
SnapshotId String 是 s-bp199lyny9bb47pa****

快照ID。
SnapshotName String 否 testSnapshotName

快照的显示名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头，不能以http://和https://开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。

为防止和自动快照的名称冲突，不能以auto开头。
Description String 否 testDescription

快照的描述。长度为2~256个英文或中文字符，不能以http://和https://开头。
DisableInstantAccess Boolean 否 false

关闭快照极速可用功能。取值范围：

  • true：关闭快照极速可用。
  • false：不关闭快照极速可用。

默认值：false

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

https://ecs.aliyuncs.com/?Action=ModifySnapshotAttribute
&SnapshotId=s-bp199lyny9bb47pa****
&SnapshotName=testSnapshotName
&Description=testDescription
&<公共请求参数>

正常返回示例

XML 格式 

<ModifySnapshotAttributeResponse>
            <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
</ModifySnapshotAttributeResponse>

JSON 格式 

{
	"RequestId":"C8B26B44-0189-443E-9816-D951F59623A9"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidDescription.Malformed The specified description is wrongly formed. 指定的资源描述格式不合法。长度为2-256个字符，不能以http://和https://开头。
400 InvalidSnapshotName.Malformed The specified SnapshotName is wrongly formed. 快照名称格式不合法。
400 NoAttributeToModify No attribute to be modified in this request. 没有任何属性被修改。
404 InvalidSnapshotId.NotFound The specified SnapshotId does not exist. 指定的快照不存在，请您检查快照是否正确。

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