CreateDisasterRecoveryPlan - 创建备份计划

创建备份计划。

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
rocketmq:CreateDisasterRecoveryPlanupdate
*Instance
acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}

请求语法

POST /disaster_recovery HTTP/1.1

请求参数

名称类型必填描述示例值
bodyobject

请求体结构。

planNamestring

计划名称,必填

xxx
planDescstring

计划描述

xxx
planTypestring

备份计划类型,必填。请参见Global Replicator。 参数取值如下:

  • ACTIVE_PASSIVE:单向备份
  • ACTIVE_ACTIVE:双向备份
ACTIVE_ACTIVE
instancesarray<object>

备份计划参与实例。必填

instanceobject

备份计划参与实例

instanceTypestring

实例类型

  • ALIYUN_ROCKETMQ :阿里云实例
  • EXTERNAL_ROCKETMQ :外部实例,开源实例,开源集群
枚举值:
  • ALIYUN_ROCKETMQ阿里云mq实例
  • EXTERNAL_ROCKETMQ外部实例
ALIYUN_ROCKETMQ
regionIdstring

实例所在区域

cn-hangzhou
instanceIdstring

实例 ID,instanceType 实例类型为 EXTERNAL_ROCKETMQ 无须填写,ALIYUN_ROCKETMQ 必填

rmq-cn-******
instanceRolestring

实例角色,主或者备

  • ACTIVE:主
  • PASSIVE:备
PASSIVE
authTypestring

认证方式。instanceType 实例类型为 ALIYUN_ROCKETMQ,实例版本为 4.0 无须填写

  • NO_AUTH:无需认证
  • ACL_AUTH:acl 认证
枚举值:
  • NO_AUTH无须认证
  • ACL_AUTHacl认证
ACL_AUTH
usernamestring

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

xxx
passwordstring

认证密码,authType 为 ACL_AUTH 时必填。instanceType 实例类型为 ALIYUN_ROCKETMQ 无须填写

xxx
endpointUrlstring

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

xxx
networkTypestring

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

  • TCP_INTERNET:tcp 公网
  • TCP_VPC:tcp 专有网络
TCP_INTERNET
vpcIdstring

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

vpc-wz9qt50xhtj9krb******
vSwitchIdstring

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

vsw-uf6gwtbn6etadpv******
messagePropertyobject

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

propertyKeystring

属性 key

aaa
propertyValuestring

属性 value

bbb
securityGroupIdstring

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

sg-bp17hpmgz9******
consumerGroupIdstring

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

注意 自建实例必须填写,阿里云实例会自动生成。

GID_DS_XXX_YYY
autoSyncCheckpointboolean

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

说明 只有在开启消费进度同步时有效。即 syncCheckpointEnabled字段值为 true。
枚举值:
  • true开启
  • false关闭
true
syncCheckpointEnabledboolean

同步消费进度开关

枚举值:
  • true开启
  • false关闭
true

返回参数

名称类型描述示例值
object

Result

requestIdstring

请求 ID

C7E8AE3A-219B-52EE-BE32-4036F5xxxx
successboolean

是否成功

true
datalong

返回结果,备份计划 id

1234
codestring

错误码

200
messagestring

错误信息

xxx
httpStatusCodeinteger

HTTP 状态码

200
dynamicCodestring

动态错误码

InstanceId
dynamicMessagestring

动态错误信息

instanceId
accessDeniedDetailstring

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

xxx

示例

正常返回示例

JSON格式

{
  "requestId": "C7E8AE3A-219B-52EE-BE32-4036F5xxxx",
  "success": true,
  "data": 1234,
  "code": 200,
  "message": "xxx",
  "httpStatusCode": 200,
  "dynamicCode": "InstanceId",
  "dynamicMessage": "instanceId",
  "accessDeniedDetail": "xxx"
}

错误码

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