全部产品
Search

搜索本产品

    云消息队列 RocketMQ 版：UpdateDisasterRecoveryPlan - 修改备份计划

    文档中心

    云消息队列 RocketMQ 版：UpdateDisasterRecoveryPlan - 修改备份计划

    更新时间：Aug 28, 2026

    修改备份计划。

    调试

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

    调试

    授权信息

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

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

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

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

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

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

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

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

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    rocketmq:UpdateDisasterRecoveryPlan

    update

    *Instance

    acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}

    		 无 无

    请求语法

    PATCH /disaster_recovery/{planId} HTTP/1.1

    路径参数

    名称

    类型

    必填

    描述

    示例值
    planId

    integer

    是

    备份计划 id

    1300000016

    请求参数

    名称

    类型

    必填

    描述

    示例值
    body

    object

    否

    请求体。

    planName

    string

    否

    计划名称

    xxx
    planDesc

    string

    否

    计划描述

    xxx
    planType

    string

    否

    备份任务类，不支持修改。参数取值如下：

    • ACTIVE_PASSIVE：单向备份

    • ACTIVE_ACTIVE：双向备份

    枚举值：

    • ACTIVE_ACTIVE :

      单向备份

    • ACTIVE_PASSIVE :

      双向备份

    ACTIVE_PASSIVE
    instances

    array<object>

    否

    备份计划参与实例。不支持修改实例，只支持修改实例下面 messageProperty 消息过滤条件，auth 认证方式

    array<object>

    否

    备份计划参与实例

    instanceType

    string

    否

    实例类型：

    • ALIYUN_ROCKETMQ ：阿里云实例

    • EXTERNAL_ROCKETMQ ：外部实例，开源实例，开源集群

    枚举值：

    • ALIYUN_ROCKETMQ :

      阿里云实例

    • EXTERNAL_ROCKETMQ :

      外部实例

    ALIYUN_ROCKETMQ
    regionId

    string

    否

    实例所在区域

    cn-hangzhou
    instanceId

    string

    否

    实例 ID

    rmq-cn-83l3r0xxxx
    instanceRole

    string

    否

    实例角色，主或者备

    • ACTIVE：主

    • PASSIVE：备

    枚举值：

    • PASSIVE :

      备

    • ACTIVE :

      主

    ACTIVE
    authType

    string

    否

    认证方式

    • NO_AUTH：无需认证

    • ACL_AUTH：acl 认证

    枚举值：

    • NO_AUTH :

      无须认证

    • ACL_AUTH :

      acl 认证

    NO_AUTH
    username

    string

    否

    认证用户名，authType 为 ACL_AUTH 时必填

    xxx
    password

    string

    否

    认证密码，authType 为 ACL_AUTH 时必填

    xxx
    endpointUrl

    string

    否

    接入点地址，instanceType 实例类型为 ALIYUN_ROCKETMQ 无须填写，EXTERNAL_ROCKETMQ 需要填写

    xxx
    networkType

    string

    否

    网络类型，instanceType 实例类型为 ALIYUN_ROCKETMQ 无须填写，EXTERNAL_ROCKETMQ 需要填写 参数取值如下：

    • TCP_INTERNET：tcp 公网

    • TCP_VPC：tcp 专有网络

    枚举值：

    • TCP_VPC :

      tcp 专有网络

    • TCP_INTERNET :

      tcp 公网

    TCP_INTERNET
    vpcId

    string

    否

    创建实例所关联的专有网络的 ID，nstanceType 实例类型仅为 EXTERNAL_ROCKETMQ，networkType 为 TCP_VPC 时需要填写

    vpc-wz9qt50xhtj9krb******

    vSwitchId

    string

    否

    实例所关联的交换机 ID，nstanceType 实例类型仅为 EXTERNAL_ROCKETMQ，networkType 为 TCP_VPC 时需要填写

    vsw-uf6gwtbn6etadpv******

    messageProperty

    object

    否

    消息过滤属性，消息同步到目标集群时，会自动添加上该属性，用于消息消费时进行 SQL 过滤。

    propertyKey

    string

    否

    属性 key

    aaa
    propertyValue

    string

    否

    属性 value

    bbb
    securityGroupId

    string

    否

    安全组 id，nstanceType 实例类型仅为 EXTERNAL_ROCKETMQ，networkType 为 TCP_VPC 时需要填写

    sg-bp17hpmgz9******

    consumerGroupId

    string

    否

    消费者组 ID，用于从源实例拉取消息。

    重要 自建实例必须填写，阿里云实例会自动生成。

    GID_DS_XXX_YYY
    autoSyncCheckpoint

    boolean

    否

    是否开启消费进度自动同步。

    说明

    只有在开启消费进度同步时有效。即 syncCheckpointEnabled字段值为 true。

    枚举值：

    • true :

      开启

    • false :

      关闭

    true
    syncCheckpointEnabled

    boolean

    否

    同步消费进度开关

    枚举值：

    • true :

      开启

    • false :

      关闭

    true

    返回参数

    名称

    类型

    描述

    示例值

    object

    Result

    requestId

    string

    请求 ID

    A07B41BD-6DD3-5349-9E76-00303Dxxxx
    success

    boolean

    是否成功

    true
    data

    boolean

    返回结果

    true
    code

    string

    错误码

    DisasterRecoveryPlanStatus.Error
    message

    string

    错误信息

    The current status of the disaster recovery plan does not support this operation.
    httpStatusCode

    integer

    HTTP 状态码

    200
    dynamicCode

    string

    动态错误码

    InstanceId
    dynamicMessage

    string

    动态错误信息

    instanceId
    accessDeniedDetail

    string

    访问拒绝详细信息，有且仅有在因 RAM 无权限拒绝用户访问的场景

    xxx

    示例

    正常返回示例

    JSON格式

    {
  "requestId": "A07B41BD-6DD3-5349-9E76-00303Dxxxx",
  "success": true,
  "data": true,
  "code": "DisasterRecoveryPlanStatus.Error",
  "message": "The current status of the disaster recovery plan does not support this operation.",
  "httpStatusCode": 200,
  "dynamicCode": "InstanceId",
  "dynamicMessage": "instanceId",
  "accessDeniedDetail": "xxx"
}

    错误码

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

    变更历史

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