全部产品
Search

搜索本产品

    云服务器 ECS：ModifySnapshotAttribute - 修改快照属性

    文档中心

    云服务器 ECS：ModifySnapshotAttribute - 修改快照属性

    更新时间：Aug 28, 2026

    修改一份快照的名称、描述或保留天数。

    调试

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

    调试

    授权信息

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

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    ecs:ModifySnapshotAttribute

    update

    *Snapshot

    acs:ecs:{#regionId}:{#accountId}:snapshot/{#snapshotId}

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    SnapshotId

    string

    是

    快照 ID。

    s-bp199lyny9bb47pa****
    SnapshotName

    string

    否

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

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

    testSnapshotName
    Description

    string

    否

    快照的描述。可为空，长度为最大 256 个英文或中文字符，不能以 http://和 https://开头。

    testDescription
    DisableInstantAccess

    boolean

    否

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

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

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

    默认值：false。

    说明

    该参数已弃用。ESSD 云盘标准快照已升级为默认极速可用，您无需额外配置，且不产生额外花销。

    false
    RetentionDays

    integer

    否

    快照保留天数。设置该值时，快照保留时间会从快照创建时间(按照 ISO 8601 标准表示，并使用 UTC +0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ)开始计算。取值范围：1~65536。

    说明

    快照保留时间仅支持延长，不支持缩短快照已有保留时间。

    10

    返回参数

    名称

    类型

    描述

    示例值

    object

    RequestId

    string

    请求 ID。

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    400 InvalidSnapshotName.Malformed The specified SnapshotName is wrongly formed. 快照名称格式不合法。
    400 NoAttributeToModify No attribute to be modified in this request.
    400 InvalidRetentionDays.Malformed The specified RetentionDays is not valid. 指定的保留天数无效。请检查 RetentionDays 参数值是否正确。
    400 InvalidOperation.DecreaseRetentionDaysUnsupported The requested operation to decrease retention days for the snapshot is not supported. 不支持缩短快照保留天数。
    400 InvalidSnapshotId.NotReady The specified snapshot has not completed yet. 指定的快照未完成。
    400 IncorrectDiskStatus.CreatingSnapshot A previous snapshot creation is in process. 当前磁盘有创建中的快照，请您等待创建完成再试。
    403 InvalidOperation.ResourceManagedByCloudProduct The current operation is not supported because the resource is managed by a cloud product. Please contact the relevant cloud product to confirm the reason. 此次操作不支持因为资源被云产品托管。请联系对应的云产品确认原因。
    403 InvalidOperation.DefaultFreeSnapshotNotSupport The specified snapshot is a default free snapshot and does not support this operation. 指定的快照是一个默认免费快照，不支持当前操作。
    404 InvalidDescription.Malformed The specified description is wrongly formed.
    404 InvalidSnapshotId.NotFound The specified SnapshotId does not exist.
    404 InvalidSnapshotDisableInstantAccess.Malformed The specified DisableInstantAccess is not valid!

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

    变更历史

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