调用DescribeCloudMigrationPrecheckResult接口查询一键上云前检查报告-阿里云帮助中心

前提条件

已调用CreateCloudMigrationPrecheckTask接口创建RDS PostgreSQL一键上云前检查任务。

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DescribeCloudMigrationPrecheckResult	系统规定参数。取值：DescribeCloudMigrationPrecheckResult。
DBInstanceName	String	是	pgm-bp102g323jd4****	目标实例ID。可调用DescribeDBInstances接口查询。
TaskId	Long	否	439946016	任务ID。调用CreateCloudMigrationPrecheckTask接口创建一键上云前检查任务时响应消息中获取。
TaskName	String	否	slf7w7wj3g	任务名称。调用CreateCloudMigrationPrecheckTask接口创建一键上云前检查任务时响应消息中获取
SourceIpAddress	String	否	172.2.XX.XX	自建PostgreSQL数据库的内网IP或公网IP。 ECS自建PostgreSQL数据库一键上云场景，配置ECS实例的私网IP。获取方法请参见查看IP地址。 IDC自建PostgreSQL数据库一键上云场景，配置为IDC的内网IP。公网PostgreSQL数据库一键上云场景，配置为PostgreSQL的公网IP。
SourcePort	Long	否	5432	自建PostgreSQL数据库的端口。可通过netstat -a \| grep PGSQL命令查看。
PageSize	Long	是	10	每页最大记录数。
PageNumber	Long	是	1	页数。

返回数据


名称	类型	示例值	描述
TotalSize	Integer	1	查询结果统计。
RequestId	String	7E4A6E1B-789B-5F16-9736-39AA57FC7374	请求ID。
Items	Array of migrateCloudTaskList		一键上云检查报告列表。
GmtCreated	String	2022-02-25T06:57:41Z	任务创建时间。
GmtModified	String	2022-02-25T06:58:00Z	任务修改时间。
TaskId	Long	440420798	任务ID。
TaskName	String	lxbv6rtxno8	任务名称。
SourceCategory	String	ecsonvpc	自建PostgreSQL的类型。 idcOnVpc：线下IDC自建PostgreSQL（IDC与VPC打通） ecsOnVpc：阿里云ECS自建PostgreSQL internet：公网PostgreSQL
SourceIpAddress	String	172.2.XX.XX	自建PostgreSQL数据库的内网IP。
SourcePort	Long	5432	自建PostgreSQL数据库的端口。
SourceAccount	String	migratetest	用户名。
SourcePassword	String	123456	密码。
TargetEip	String	null	预留参数，查询结果为空。
TargetInstanceName	String	pgm-bp102g323jd4****	目标实例ID。
Detail	String	[Check rds empty]\nCheck rds databases: success\n[Check source connectivity]\nCheck ip connectable: success\nCheck port connectable: success\nCheck database connectable: success\nCheck account replication privilege: success\nCheck account createrole privilege: success\nCheck account monitor privilege: success\n[Check source version]\nCheck major version consistent: success\n[Check source glibc version]\nCheck source glibc version compatible: warning(warning:source glibc version is not compatible with rds pg)\n[Check disk size]\nCheck disk size enough: success\n[Check wal keep size]\nCheck wal keep size large enough: success\n[Check spec params]\nCheck if spec params too large: success\n [Check triggers]\nCheck triggers compatible: success\n[Check user functions]\nCheck user functions compatible: success\nMigrate check success	上云前检查报告内容。
PageNumber	Long	1	页数。
PageSize	Long	10	每页最大记录数

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescribeCloudMigrationPrecheckResult
&DBInstanceName=pgm-bp102g323jd4****
&TaskId=439946016
&TaskName=slf7w7wj3g
&SourceIpAddress=172.2.XX.XX
&SourcePort=5432
&PageSize=10
&PageNumber=1
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeCloudMigrationPrecheckResultResponse>
    <TotalSize>1</TotalSize>
    <RequestId>7E4A6E1B-789B-5F16-9736-39AA57FC7374</RequestId>
    <Items>
        <GmtCreated>2022-02-25T06:57:41Z</GmtCreated>
        <GmtModified>2022-02-25T06:58:00Z</GmtModified>
        <TaskId>440420798</TaskId>
        <TaskName>lxbv6rtxno8</TaskName>
        <SourceCategory>ecsonvpc</SourceCategory>
        <SourceIpAddress>172.2.XX.XX</SourceIpAddress>
        <SourcePort>5432</SourcePort>
        <SourceAccount>migratetest</SourceAccount>
        <SourcePassword>123456</SourcePassword>
        <TargetInstanceName>pgm-bp102g323jd4****</TargetInstanceName>
        <Detail>[Check rds empty]\nCheck rds databases: success\n[Check source connectivity]\nCheck ip connectable: success\nCheck port connectable: success\nCheck database connectable: success\nCheck account replication privilege: success\nCheck account createrole privilege: success\nCheck account monitor privilege: success\n[Check source version]\nCheck major version consistent: success\n[Check source glibc version]\nCheck source glibc version compatible: warning(warning:source glibc version is not compatible with rds pg)\n[Check disk size]\nCheck disk size enough: success\n[Check wal keep size]\nCheck wal keep size large enough: success\n[Check spec params]\nCheck if spec params too large: success\n [Check triggers]\nCheck triggers compatible: success\n[Check user functions]\nCheck user functions compatible: success\n*Migrate check success*</Detail>
    </Items>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
</DescribeCloudMigrationPrecheckResultResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalSize" : 1,
  "RequestId" : "7E4A6E1B-789B-5F16-9736-39AA57FC7374",
  "Items" : {
    "GmtCreated" : "2022-02-25T06:57:41Z",
    "GmtModified" : "2022-02-25T06:58:00Z",
    "TaskId" : 440420798,
    "TaskName" : "lxbv6rtxno8",
    "SourceCategory" : "ecsonvpc",
    "SourceIpAddress" : "172.2.XX.XX",
    "SourcePort" : 5432,
    "SourceAccount" : "migratetest",
    "SourcePassword" : 123456,
    "TargetInstanceName" : "pgm-bp102g323jd4****",
    "Detail" : "[Check rds empty]\\nCheck rds databases: success\\n[Check source connectivity]\\nCheck ip connectable: success\\nCheck port connectable: success\\nCheck database connectable: success\\nCheck account replication privilege: success\\nCheck account createrole privilege: success\\nCheck account monitor privilege: success\\n[Check source version]\\nCheck major version consistent: success\\n[Check source glibc version]\\nCheck source glibc version compatible: warning(warning:source glibc version is not compatible with rds pg)\\n[Check disk size]\\nCheck disk size enough: success\\n[Check wal keep size]\\nCheck wal keep size large enough: success\\n[Check spec params]\\nCheck if spec params too large: success\\n [Check triggers]\\nCheck triggers compatible: success\\n[Check user functions]\\nCheck user functions compatible: success\\n*Migrate check success*"
  },
  "PageNumber" : 1,
  "PageSize" : 10
}

错误码


HttpCode	错误码	错误信息	描述
404	InvalidDBInstanceName.NotFound	The database instance does not exist.	数据库实例名称不存在。请确认数据名称是否正确。

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