CreateAutoSnapshotPolicy_云服务器 ECS_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

调用该接口之前,请认真阅读创建自动快照策略

调用该接口时,您需要注意:

  • 一个阿里云账户在一个地域最多能创建 100 条自动快照策略。 当某块云盘的自动快照数量达到额度上限,系统在创建新的快照任务时,会删除由自动快照策略所生成的时间最早的自动快照点。

  • 当 ECS 实例存在停止或者重启任务时,系统不会执行自动快照策略。

  • 已启用快照跨地域复制且在未配置加密参数场景下,加密快照默认使用目的端服务密钥进行加密拷贝。跨地域复制快照的注意事项,请参见复制快照

创建自动快照策略后,需要调用 ApplyAutoSnapshotPolicy 将策略应用到目标云盘。如果您需要调整自动快照策略的内容,请调用 ModifyAutoSnapshotPolicyEx

流控信息

请求速率为1000/60(s)。

授权信息

当前云产品暂无权限信息透出。

请求参数

字段名称字段详情
regionIdstring

自动快照策略所属的地域。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

示例值:cn-hangzhou
autoSnapshotPolicyNamestring

自动快照策略的名称。长度为 2~128 个英文或中文字符。必须以大小写字母或中文开头,不能以 http://或 https://开头。可以包含数字、半角冒号(:)、下划线(_)或者短划线(-)。展开详情

示例值:TestName
timePointsstring

自动快照的创建时间点。使用 UTC +8 时间,单位为小时。取值范围:0~23,代表 00:00 至 23:00 共 24 个时间点,例如 1 表示 01:00。格式说明:展开详情

示例值:["0", "1", … "23"]
repeatWeekdaysstring

自动快照的重复日期,单位为天,周期为星期。取值范围:1~7,例如 1 表示周一。格式说明:展开详情

示例值:["1","2"]
retentionDaysinteger<int32>

自动快照的保留时间,单位为天。取值范围:展开详情

示例值:30
EnableCrossRegionCopyboolean

是否允许自动跨地域复制。展开详情

示例值:false
TargetCopyRegionsstring

跨地域复制快照的目标地域。目前支持设置一个目标地域。

示例值:["cn-hangzhou"]
StorageLocationArnstring
说明 该参数暂未开放使用。
示例值:null
CopiedSnapshotsRetentionDaysinteger<int32>

跨地域复制快照的保留时间,单位为天。取值范围:展开详情

示例值:30
Tagarray<object>

自动快照策略标签列表。

子级条数 <= 20
ResourceGroupIdstring

资源组 ID。

示例值:rg-aek2kkmhmhs****参考取值来源:
    DescribeSnapshotGroups
CopyEncryptionConfigurationobject

快照异地备份加密参数对象

返回参数

字段名称字段详情
AutoSnapshotPolicyIdstring

自动快照策略 ID。

示例值:sp-bp12m37ccmxvbmi5****
RequestIdstring

请求 ID。

示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
DiskCategory.OperationNotSupported
The type of the specified disk does not support creating a snapshot.诊断
400
InvalidSnapshotPolicyName.Malformed
The specified autoSnapshotPolicyName is wrongly formed.诊断
400
Duplicate.TagKey
The Tag.N.Key contain duplicate key.诊断
400
InvalidTagKey.Malformed
The specified Tag.n.Key is not valid.诊断
400
InvalidTagValue.Malformed
The specified Tag.n.Value is not valid.诊断
400
InvalidParameter.EncryptedIllegal
The specified parameter Encrypted must be true when kmsKeyId is not empty.诊断
400
InvalidParameter.KmsNotEnabled
Failed to perform this operation because KMS is not activated.诊断
400
InvalidParameter.Encrypted.KmsNotEnable
Failed to perform this operation because KMS is not activated.诊断
400
InvalidParam.EncryptedMismatch
Creating encrypted disks with shared encrypted image requires replacing encryption keys.诊断
403
ParameterInvalid
The specified RegionId parameter is invalid.诊断
403
AutoSnapshotPolicy.QuotaExceed
The maximum number of automatic snapshot policy has been reached.诊断
403
InvalidAccountStatus.NotEnoughBalance
Your account does not have enough balance.诊断
403
InvalidAccountStatus.SnapshotServiceUnavailable
Snapshot service has not been opened yet.诊断
403
InvalidParameter.TargetCopyRegions
The specified TargetCopyRegions is invalid.诊断
403
InvalidParameter.CopiedSnapshotsRetentionDays
The specified CopiedSnapshotsRetentionDays is invalid.诊断
403
InvalidParameter.KMSKeyId.KMSUnauthorized
ECS service have no right to access your KMS.诊断
403
InvalidOperation.KMSKeyIdNotFound
The specified KMSKeyId not found, %s.诊断
403
Abs.InvalidAction.RegionNotSupport
This region does not support this action.诊断
403
InvalidParameter.KMSKeyId.CMKNotEnabled
The CMK (Customer Master Key) must be in an active state.诊断
403
InvalidParameter.KMSKeyId.CMKUnauthorized
The CMK(Customer Master Key) lacks authorization to add tags to the ECS service.诊断

变更历史

变更时间变更内容概要操作
2025-03-19
变更错误码400
变更错误码403
2024-03-21
变更错误码400
2024-02-28
变更错误码400
变更错误码403
新增请求参数CopyEncryptionConfiguration
删除返回参数
2022-10-19
新增请求参数StorageLocationArn
  • 1
  • 2
  • 10 条/页

相关示例