DescribeEvaluateAndImportTask - PolarDB - Alibaba Cloud Documentation Center

Queries the list of PolarDB-X assessment import tasks. (single)

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

polardbx:DescribeEvaluateAndImportTask

none

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The region where the instance resides.	cn-hangzhou
SlinkTaskId	string	No	The ID of the link task.	etx-szr2rr6i*****

Response elements

Element	Type	Description	Example
	object
RequestId	string	The request ID.	73559800-****-11ec-bd40-99cfcff3fe1e
Message	string	The response message. This parameter is empty when the request succeeds. When the request fails, an exception message is returned, such as an error code.	Success
Data	object	The returned result.
Bid	string	The business ID of the import task.	26842
Creator	string	The creator of the import task.	346650
Deleted	boolean	Indicates whether the import task is successful.	false
GmtCreated	integer	The timestamp when the task was created.	2025-06-08T15:00Z
GmtModified	integer	The modification time in timestamp format.	1605080537000
Id	integer	The task ID.	76251
RegionId	string	The region ID.	cn-hangzhou
SlinkDstResId	string	The instance ID of the destination.	pxc-hzrehc60jz5zye
SlinkDstUserName	string	The username for the data connection of the destination.	dts_dtdba
SlinkSrcResId	string	The instance ID of the source.	drdshbga69378w4p
SlinkSrcUserName	string	The username for the data connection of the source.	dtdba
SlinkStage	string	The stage of the synchronization.	DATA_IMPORT_RUNNING
SlinkStatus	string	The running status of the synchronization.	IMPORT_RUNNING
SlinkTaskId	string	The slink task ID.	etx-szr2rr6i*****
SlinkType	string	The synchronization type.	evaluate_import
SlinkSrcDb	string	The name of the slink source database.	fr_import
SlinkDstDb	string	The name of the slink destination database.	fr_import
SlinkTaskDesc	string	The description of the slink task.	drdsprod_to_2.0
Context	string	The summary information.	"{\"structureImportResult\":{\"status\":\"finish\",\"finishedNum\":382,\"totalNum\":382,\"percentage\":100},\"switchTips\":\"Forward switchover is allowed only when the forward synchronization latency is low\",\"autoTableSuggestionSwitch\":false,\"structureAlterationMap\":{},\"acceptFilterMap\":{\"fr_import\":[\"dy_dr_new\"],\"e3plus_drp_prod_new\":[],\"qbtong_prod\":[],\"e3plus_account_prod\":[],\"e3plus_drp_prod\":[]},\"structChunkMap\":{},\"count\":1,\"requestId\":\"9380D025-C9B1-51D6-A4B9-733C4879CC4A\"}",
SlinkSrcResType	string	The resource type of the source.	POLARX1
Success	boolean	Indicates whether the request was successful.	true

Examples

Success response

JSON format

{
  "RequestId": "73559800-****-11ec-bd40-99cfcff3fe1e",
  "Message": "Success",
  "Data": {
    "Bid": "26842",
    "Creator": "346650",
    "Deleted": false,
    "GmtCreated": 0,
    "GmtModified": 1605080537000,
    "Id": 76251,
    "RegionId": "cn-hangzhou",
    "SlinkDstResId": "pxc-hzrehc60jz5zye",
    "SlinkDstUserName": "dts_dtdba",
    "SlinkSrcResId": "drdshbga69378w4p",
    "SlinkSrcUserName": "dtdba",
    "SlinkStage": "DATA_IMPORT_RUNNING",
    "SlinkStatus": "IMPORT_RUNNING",
    "SlinkTaskId": "etx-szr2rr6i*****",
    "SlinkType": "evaluate_import",
    "SlinkSrcDb": "fr_import",
    "SlinkDstDb": "fr_import",
    "SlinkTaskDesc": "drdsprod_to_2.0",
    "Context": "\"{\\\"structureImportResult\\\":{\\\"status\\\":\\\"finish\\\",\\\"finishedNum\\\":382,\\\"totalNum\\\":382,\\\"percentage\\\":100},\\\"switchTips\\\":\\\"正向同步延迟较小时才允许开始正向切换\\\",\\\"autoTableSuggestionSwitch\\\":false,\\\"structureAlterationMap\\\":{},\\\"acceptFilterMap\\\":{\\\"fr_import\\\":[\\\"dy_dr_new\\\"],\\\"e3plus_drp_prod_new\\\":[],\\\"qbtong_prod\\\":[],\\\"e3plus_account_prod\\\":[],\\\"e3plus_drp_prod\\\":[]},\\\"structChunkMap\\\":{},\\\"count\\\":1,\\\"requestId\\\":\\\"9380D025-C9B1-51D6-A4B9-733C4879CC4A\\\"}\",",
    "SlinkSrcResType": "POLARX1"
  },
  "Success": true
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.