全部产品
Search

搜索本产品

    数据管理 DMS：ModifyStorageStrategy - 修改存储数据的生命周期

    文档中心

    数据管理 DMS：ModifyStorageStrategy - 修改存储数据的生命周期

    更新时间：Mar 19, 2026

    该接口用于修改备份计划中的存储数据的生命周期。

    调试

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

    调试

    授权信息

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

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

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

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

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

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

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

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

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    dbs:ModifyStorageStrategy

    update

    *BackupPlan

    acs:dbs:{#regionId}:{#accountId}:backupplan/{#BackupPlanId}

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    BackupPlanId

    string

    是

    备份计划 ID，可通过调用 DescribeBackupPlanList 接口获取该参数的值。

    dbsqdss5tmh****
    BackupRetentionPeriod

    integer

    是

    备份数据保留时间，单位为天，取值：0~1825。

    说明

    默认为 730（天）。

    730
    DuplicationInfrequentAccessPeriod

    integer

    是

    转为低频访问存储时间。需要小于归档冷备存储时间（DuplicationArchivePeriod 参数）。更多关于低频访问存储的说明，请参见存储类型介绍。

    说明

    默认为 180（天）。

    190
    DuplicationArchivePeriod

    integer

    是

    转为归档冷备存储时间。需要小于备份数据保留时间（BackupRetentionPeriod 参数）。更多关于归档存储的说明，请参见存储类型介绍。

    说明

    默认为 365（天）。

    366
    ClientToken

    string

    否

    任意字符串，用于保证请求的幂等性，防止重复提交请求。

    dbstest
    IncrementBackupRetentionPeriod

    string

    否

    365
    IncrementDuplicationInfrequentAccessPeriod

    string

    否

    365
    IncrementDuplicationArchivePeriod

    string

    否

    365
    LogBackupRetentionPeriod

    string

    否

    365
    LogDuplicationInfrequentAccessPeriod

    string

    否

    365
    LogDuplicationArchivePeriod

    string

    否

    365
    BackupStorageEncryptMethod

    string

    否

    encrypted

    返回参数

    名称

    类型

    描述

    示例值

    object

    返回参数详情。

    HttpStatusCode

    integer

    HTTP 状态码。

    200
    RequestId

    string

    请求 ID。

    E995F91F-6F89-503B-9F7D-502F58FD****
    ErrCode

    string

    错误码。

    Param.NotFound
    Success

    boolean

    请求是否成功，返回值如下：

    • true：请求成功

    • false：请求失败

    true
    ErrMessage

    string

    错误信息。

    findValidDBSJob error
    BackupPlanId

    string

    备份计划 ID。

    dbsqdss5tmh****
    NeedPrecheck

    boolean

    本次修改是否会触发预检查，返回值如下：

    • true：已触发预检查，且需要您手动调用 StartBackupPlan 接口，启动备份计划。

    • false：不会触发预检查。

    false

    示例

    正常返回示例

    JSON格式

    {
  "HttpStatusCode": 200,
  "RequestId": "E995F91F-6F89-503B-9F7D-502F58FD****",
  "ErrCode": "Param.NotFound",
  "Success": true,
  "ErrMessage": "findValidDBSJob error",
  "BackupPlanId": "dbsqdss5tmh****",
  "NeedPrecheck": false
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    403 Request.Forbidden Have no Permissions 当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作

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

    变更历史

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