DescribeProject_云数据库 OceanBase 版_API文档-阿里云OpenAPI开发者门户

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作
暂无数据

请求参数

字段名称	字段详情
Idstring	数据迁移或数据同步任务的 ID。示例值:np_fe****

返回参数

字段名称	字段详情
Successboolean	是否调用成功。示例值:true
ErrorDetailobject	错误详情。
Codestring	错误码（旧）。示例值:INNER_ERROR
Messagestring	错误描述。示例值:A system error occurred.
Advicestring	建议。示例值:Contact the administrator.
RequestIdstring	请求 ID。示例值:473469C7-XXXX-XXXX-B3DB-A3DC0DE3C83E
PageNumberinteger<int32>	页序号，分页查询时生效。示例值:1
PageSizeinteger<int32>	页大小，分页查询时生效。示例值:10
TotalCountinteger<int64>	总数，分页查询时生效。注意请注意，该值为 Long 类型，在某些语言中可能存在精度丢失的风险，请小心使用。示例值:2
Coststring	请求耗时，单位为秒。示例值:1
Dataobject	数据

返回说明

StepInfo 数据结构

不同步骤的 StepInfo 参数返回不同的字段。

TRANSFER_APP_SWITCH（正向切换）

参数类型描述
checkpointSampleTimestamp long 位点采集时间。格式为 Unix timestamp，单位为秒。

参数	类型	描述
checkpointSampleTimestamp	long	位点采集时间。格式为 Unix timestamp，单位为秒。

INCR_TRANSFER（增量同步）

参数	类型	描述
incrTimestampCheckpoint	long	位点时间。格式为 Unix timestamp，单位为秒。
checkpointSampleTimestamp	long	位点采集时间。格式为 Unix timestamp，单位为秒。
enableIncrStatistics	boolean	是否开启 DML/DDL 统计。

FULL_VERIFIER（全量校验）和 FULL_TRANSFER（全量迁移）

参数	类型	描述
processedRecords	long	已完成迁移行数/实际行数。
capacity	long	预估总行数。
srcRps	long	源端读取 RPS，单位为记录数/秒。
srcRt	string	源端读取 RT，单位为毫秒/条。
srcIops	long	源端读取流量，单位为字节数/秒。
dstRps	long	目标端读取/写入 RPS，单位为记录数/秒。
dstRt	long	目标端读取/写入 RT，单位为毫秒/条。
dstIops	long	目标端读取/写入流量，单位为字节数/秒。
srcRpsRef	long	源端读取 RPS 的基准值。
dstRpsRef	long	目标端读取/写入 RPS 的基准值。
dstRtRef	long	目标端读取/写入 RT 基准值。

附录

Kafka

{
    "connExtraAttributes":{
        "endpoint":"xxx.xxx.xxx.1:2883",
        "username":null,
        "enableSSL":null,
        "enableSASL":null,
        "saslMechanism":null,
        "disableIdentificationAlgorithm":false
    }
}

参数	类型	描述
endpoint	string	服务地址。
username	string	用户名。当您选择认证方式为 PLAIN、SCRAM-SHA-256 和 SCRAM-SHA-512 时，该参数必填。
enableSSL	boolean	是否开启 SSL 认证。如果开启，则需要上传授信证书。
enableSASL	boolean	是否开启 SASL 认证。
saslMechanism	KafkaSaslMechanisnEnum	加密方式，包括 PLAIN、SCRAM-SHA-256、SCRAM-SHA-512 和 KERBEROS。
disableIdentificationAlgorithm	boolean	SSL 加密时，是否开启主机名验证。

DataHub

{
    "connExtraAttributes":{
        "endpoint":"xxx.xxx.xxx.1:2883",
        "project":"detx***"
    }
}

参数	类型	描述
endpoint	string	服务地址。
project	string	任务的名称。

RocketMQ

{
    "connExtraAttributes":{
        "endpoint":"xxx.xxx.xxx.1:2883",
        "endpointType":null,
        "version":null
    }
}

参数	类型	描述
endpoint	string	服务地址。
endpointType	CloudRocketMQEndpoint.Type	服务地址的类型。
version	CloudRocketMQInst.Version	RocketMQ 的版本。

OceanBase

{
    "connExtraAttributes":{
        "cluster":"xgez***",
        "tenant":"gexr**",
        "isLogicSource":false,
        "useLogProxy":true,
        "drcUser":"tes***",
        "configUrl":"http://xxx.xxx.xxx.1:2883/service****",
        "logProxyIp":"xxx.xxx.xxx.2",
        "logProxyPort":2883,
        "noUserAuth":false
    }
}

参数	类型	描述
cluster	string	集群的名称。
tenant	string	租户的名称。
isLogicSource	boolean	是否为逻辑数据源。
useLogProxy	boolean	是否使用 LogProxy。
drcUser	string	drc_user 的配置。
configUrl	string	用于获取 OceanBase 数据库底层服务器的真实地址。
logProxyIp	string	LogProxy 服务的 IP 地址。
logProxyPort	integer	LogProxy 服务的端口。
noUserAuth	boolean	对于同步 DataWorks 的接口，数据源是 OMS 自动生成的。如果没有用户账号和密码，则不能连接用户的 OceanBase 数据库。

TiDB

{
    "connExtraAttributes":{
        "kafkaId":"e_edz****",
        "kafkaTopic":"test**",
        "kafkaName":"denz***"
    }
}

参数	类型	描述
kafkaId	string	绑定的 Kafka 数据源的 ID。
kafkaTopic	string	绑定的 Kafka Topic 的名称。
kafkaName	string	绑定的 Kafka 数据源的名称。

返回示例

变更历史

	变更时间	变更内容概要	操作
	2024-06-26	变更返回参数
	2024-04-08	变更返回参数
	2024-03-20	变更返回参数