调用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\n*Migrate 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. 数据库实例名称不存在。请确认数据名称是否正确。

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