All Products
Search

This Product

    MaxCompute:GetMmsTask

    Document Center

    MaxCompute:GetMmsTask

    Last Updated:Oct 22, 2025

    Retrieves the details of a specific migration task.

    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

    odps:GetMmsTask

    get

    *project

    acs:odps:{#regionId}:{#accountId}:mmsdatasource/{#sourceId}

    None

    None

    Request syntax

    GET /api/v1/mms/datasources/{sourceId}/tasks/{taskId} HTTP/1.1

    Path Parameters

    Parameter

    Type

    Required

    Description

    Example

    sourceId

    integer

    Yes

    The data source ID.

    2000015

    taskId

    integer

    Yes

    The migration task ID.

    7680

    Request parameters

    Parameter

    Type

    Required

    Description

    Example

    No parameters required.

    Response elements

    Element

    Type

    Description

    Example

    object

    ApiRes

    requestId

    string

    The request ID.

    73207140-0FD5-588A-B11A-3CE093924196

    data

    object

    The migration task object.

    id

    integer

    The migration task ID.

    7680

    jobId

    integer

    The migration job ID.

    87

    sourceId

    integer

    The data source ID.

    2000015

    dbId

    integer

    The source database ID.

    23

    tableId

    integer

    The source table ID.

    2323

    jobName

    string

    The migration job name.

    test_odps_spark

    sourceName

    string

    The data source name.

    demo

    srcDbName

    string

    The source database name.

    mms_test

    srcSchemaName

    string

    The name of the source schema. This refers to the schema in a Layer 3 namespace.

    default

    srcTableName

    string

    The source table name.

    table_1

    dstDbName

    string

    The destination MaxCompute project.

    mms_target

    dstSchemaName

    string

    The destination MaxCompute schema.

    default

    dstTableName

    string

    The destination MaxCompute table.

    table_1

    type

    string

    The task type.

    BIGQUERY

    status

    string

    The migration task status.

    Valid values:

    • INIT :

      The task is not started.

    • SCHEMA_DONE :

      The schema migration succeeded.

    • SCHEMA_DOING :

      The schema is being migrated.

    • SCHEMA_FAILED :

      The schema migration failed.

    • DATA_DOING :

      The data is being migrated.

    • DATA_DONE :

      The data migration succeeded.

    • DATA_FAILED :

      The data migration failed.

    DATA_DOING

    running

    boolean

    Indicates if the task is running.

    true

    stopped

    boolean

    Indicates if the task is stopped.

    false

    retriedTimes

    integer

    The number of times the task has been retried.

    1

    startTime

    string

    The start time of the task.

    2024-10-25 06:21:01

    endTime

    string

    The end time of the task.

    2024-10-25 07:21:01

    createTime

    string

    The creation time of the task.

    2024-10-25 04:21:01

    Examples

    Success response

    JSON format

    {
  "requestId": "73207140-0FD5-588A-B11A-3CE093924196",
  "data": {
    "id": 7680,
    "jobId": 87,
    "sourceId": 2000015,
    "dbId": 23,
    "tableId": 2323,
    "jobName": "test_odps_spark",
    "sourceName": "demo",
    "srcDbName": "mms_test",
    "srcSchemaName": "default",
    "srcTableName": "table_1",
    "dstDbName": "mms_target",
    "dstSchemaName": "default",
    "dstTableName": "table_1",
    "type": "BIGQUERY",
    "status": "DATA_DOING",
    "running": true,
    "stopped": false,
    "retriedTimes": 1,
    "startTime": "2024-10-25 06:21:01\n",
    "endTime": "2024-10-25 07:21:01\n",
    "createTime": "2024-10-25 04:21:01\n"
  }
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.