ModifyAutoSnapshotPolicyEx_云服务器 ECS_API文档

2014-05-26

获取元数据获取 SDK

找不到 API ? 点击反馈吧

插件下载了解更多

VS Code 插件反馈

安装插件之前，确保已安装 VS Code

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.

JetBrains 插件反馈

安装插件之前，确保已安装 JetBrains IDE

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

调用该接口时，您需要注意：

不支持修改系统策略。
修改自动快照策略后，之前已应用该策略的云盘随即执行修改后的自动快照策略。
已启用快照跨地域复制且在未配置加密参数场景下，加密快照默认使用目的端服务密钥进行加密拷贝。

流控信息

请求速率为1000/60(s)。更多流控信息，请前往配额中心查看

授权信息

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

请求参数

字段名称	字段详情
regionIdstring	自动快照策略所在的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。示例值:cn-hangzhou
autoSnapshotPolicyIdstring	目标自动快照策略 ID。您可以调用 DescribeAutoSnapshotPolicyEx 查看您可用的自动快照策略。示例值:sp-bp12m37ccmxvbmi5****
autoSnapshotPolicyNamestring	自动快照策略的名称。如果参数为空则代表不修改。示例值:SPTestName
timePointsstring	自动快照的创建时间点。使用 UTC +8 时间，单位为小时。取值范围为 0~23，代表 00:00 至 23:00 共 24 个时间点，如 1 表示 01:00。展开详情示例值:["0", "1"]
repeatWeekdaysstring	自动快照的重复日期，单位为天，周期为星期。取值范围为 1~7，如 1 表示周一。展开详情示例值:["1", "7"]
retentionDaysinteger<int32>	自动快照的保留时间，单位为天。取值范围：展开详情示例值:30
EnableCrossRegionCopyboolean	是否允许自动跨地域复制。展开详情示例值:false
TargetCopyRegionsstring	跨地域复制快照的目标地域。目前支持设置一个目标地域。示例值:["cn-hangzhou"]
CopiedSnapshotsRetentionDaysinteger<int32>	跨地域复制快照的保留时间，单位为天。取值范围：展开详情示例值:30
CopyEncryptionConfigurationobject	快照跨地域复制加密参数对象

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

返回示例

错误返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

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	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	Abs.InvalidAction.RegionNotSupport	This region does not support this action.	诊断
403	InvalidOperation.PolicyTypeUnsupported	The current policy type does not support this operation. Only custom policies are permitted.	诊断
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.	诊断
404	ParameterInvalid	The specified automatic snapshot policy does not exist.	诊断
404	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist.	诊断

变更历史

	变更时间	变更内容概要	操作
	2025-03-19	变更错误码400 变更错误码403
	2024-11-05	变更错误码403
	2024-03-21	变更错误码400
	2024-02-29	变更请求参数CopyEncryptionConfiguration
	2024-02-28	变更请求参数CopyEncryptionConfiguration
	2024-02-28	新增错误码400 变更错误码403 变更错误码404 新增请求参数CopyEncryptionConfiguration

相关示例

自动快照策略

2022-03-24