This topic describes the OceanBase Migration Service (OMS) API operation of obtaining the status of a migration project.
Description
You can call this operation to obtain the status of a data migration project based on the specified parameters.
Call description
Prerequisites
This operation is applicable to OMS V3.3.0-CE.
Request path
GET /api/omsp/v2/migrations/{projectId}/progress
Request parameters
Parameter |
Type |
Description |
|---|---|---|
| projectId | string | The ID of the data migration project. |
Response parameters
Parameter |
Type |
Description |
|---|---|---|
| success | boolean | Indicates whether the call is successful. |
| code | string | The status code. |
| message | string | The description. |
| advice | string | The advice. |
| requestId | string | The request ID. |
| pageNumber | integer[int32] | The current page number. |
| pageSize | integer[int32] | The number of records per page. |
| totalCount | integer[int64] | The total number of records. |
| cost | string | The time spent on processing the request. |
| data | Object | For more information, see Parameters in data. |
Parameters in data
Parameter |
Type |
Description |
|---|---|---|
| status | string | The status of the data migration project. Valid values: INIT, RUNNING, SUSPEND, FAILED, FINISHED, RELEASING, RELEASED, and DELETED. |
| importance | string | The alert level. Valid values: HIGH, MEDIUM, LOW, and IGNORE. |
| enableStructMigration | boolean | Indicates whether structure migration is enabled. |
| enableFullMigration | boolean | Indicates whether full data migration is enabled. |
| enableIncrSync | boolean | Indicates whether incremental synchronization is enabled. |
| enableReverseIncrSync | boolean | Indicates whether reverse incremental synchronization is enabled. |
| currentStep | string | The current step, excluding full verification. |
| structMigrationProgress | integer[int32] | The progress of structure migration in percentage. Value range: 0 to 100. |
| fullMigrationProgress | integer[int32] | The progress of full migration in percentage. Value range: 0 to 100. |
| incrSyncCheckpoint | integer[int64] | The checkpoint for incremental synchronization. Unit: seconds. |
| reverseIncrSyncCheckpoint | integer[int64] | The checkpoint for reverse incremental synchronization. Unit: seconds. |
Sample response
{
"success":true
"code":"success"
"message":"sbjve****"
"advice":"ikxwe****"
"requestId":"817dfA6B-****."
"pageNumber":194
"pageSize":4176
"totalCount":6755
"cost":"xgojy****"
"data":{
"status":"INIT"
"importance":"HIGH"
"enableStructMigration":true
"enableFullMigration":true
"enableIncrSync":true
"enableReverseIncrSync":false
"currentStep":"PRE_CHECK"
"structMigrationProgress":5151
"fullMigrationProgress":8897
"incrSyncCheckpoint":3628
"reverseIncrSyncCheckpoint":6165
}
}