Todos los productos
Search
Centro de documentos

DataWorks:CreateImportMigration

Última actualización: Oct 09, 2026

Crea una tarea de importación para importar un paquete de importación y exportación de DataWorks que contiene objetos como orígenes de datos, tareas y tablas.

Descripción de la operación

Nota: Esta operación implica la carga de archivos. El siguiente ejemplo muestra cómo llamar a esta operación:

    Config config = new Config();
    config.setAccessKeyId(accessId);
    config.setAccessKeySecret(accessKey);
    config.setEndpoint(popEndpoint);
    config.setRegionId(regionId);
    
    Client client = new Client(config);

    CreateImportMigrationAdvanceRequest request = new CreateImportMigrationAdvanceRequest();
    request.setName("test_migration_api_" + System.currentTimeMillis());
    request.setProjectId(123456L); 
    request.setPackageType("DATAWORKS_MODEL");
    request.setPackageFileObject(new FileInputStream("/home/admin/Downloads/test.zip"));

    RuntimeOptions runtime = new RuntimeOptions();
    CreateImportMigrationResponse response = client.createImportMigrationAdvance(request, runtime);
    ...

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

dataworks:*

update

*All Resource

*

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

ProjectId

integer

Sí

El ID del espacio de trabajo de DataWorks. Puede iniciar sesión en la consola de DataWorks e ir a la página Configuración del espacio de trabajo para obtener el ID del espacio de trabajo.

123456

Name

string

Sí

El nombre de la tarea de importación que se va a crear. El nombre debe ser único dentro del espacio de trabajo.

test_import_001

PackageType

string

Sí

El tipo del paquete de importación y exportación. Valores válidos:

  • DATAWORKS_MODEL: formato estándar

  • DATAWORKS_V2: Apsara Stack (V3.6.1 a V3.11)

  • DATAWORKS_V3: Apsara Stack (V3.12 y posteriores)

DATAWORKS_MODEL

PackageFile

string

Sí

La ruta del archivo del paquete de importación. Nota: Esta operación implica la carga de archivos. El siguiente ejemplo muestra cómo llamar a esta operación:

        Config config = new Config();
        config.setAccessKeyId(accessId);
        config.setAccessKeySecret(accessKey);
        config.setEndpoint(popEndpoint);
        config.setRegionId(regionId);

        Client client = new Client(config);

        CreateImportMigrationAdvanceRequest request = new CreateImportMigrationAdvanceRequest();
        request.setName("test_migration_api_" + System.currentTimeMillis());
        request.setProjectId(123456L); 
        request.setPackageType("DATAWORKS_MODEL");
        request.setPackageFileObject(new FileInputStream("/home/admin/Downloads/test.zip"));

        RuntimeOptions runtime = new RuntimeOptions();
        CreateImportMigrationResponse response = client.createImportMigrationAdvance(request, runtime);

Si pasa directamente la ruta del archivo, el valor del parámetro debe ser una URL válida de un objeto OSS dentro de la cuenta del solicitante, como https://{bucket}.oss-{region}.aliyuncs.com/{object_key}. Las URL de OSS entre cuentas se rechazan. Si utiliza el método Advance del SDK, puede cargar el archivo mediante un flujo de archivo local.

/home/admin/xxx/import.zip

ResourceGroupMap

string

No

La asignación entre los grupos de recursos de programación y los grupos de recursos de integración de datos. Tanto las claves como los valores en la asignación son identificadores de grupos de recursos. El formato es el siguiente:

{
    "SCHEDULER_RESOURCE_GROUP": {
        "xxx": "yyy"
    },
    "DI_RESOURCE_GROUP": {
        "ccc": "dfdd"
    }
}

{"SCHEDULER_RESOURCE_GROUP": {"xxx":"yyy"},"DI_RESOURCE_GROUP":{"ccc":"ddd"}}

WorkspaceMap

string

No

La asignación que se utiliza para cambiar los nombres de los espacios de trabajo de entrada y salida en el paquete de importación y exportación a los nombres de los espacios de trabajo asignados durante las operaciones de importación y exportación. Por ejemplo, durante una importación, los prefijos de los nombres de los espacios de trabajo de entrada y salida se reemplazan en función de la asignación.

{"test_workspace_src": "test_workspace_target"}

CalculateEngineMap

string

No

La asignación entre los motores de cálculo de origen y las instancias del motor de cálculo de destino en la tarea de importación. Los tipos de motor de cálculo incluyen ODPS, EMR, HADOOP_CDH y HOLOGRES.

{ "ODPS": { "zxy_8221431_engine": "wzp_kaifazheban_engine" }, "EMR": { "aaaa": "bbb" } }

CommitRule

string

No

Las reglas para el envío y la publicación automáticos de tareas durante la operación de importación. Los parámetros son los siguientes:

  • resourceAutoCommit: Especifica si se deben enviar los recursos automáticamente. true: sí. false: no.

  • resourceAutoDeploy: Especifica si se deben publicar los recursos automáticamente. true: sí. false: no.

  • functionAutoCommit: Especifica si se deben enviar las funciones automáticamente. true: sí. false: no.

  • functionAutoDeploy: Especifica si se deben publicar las funciones automáticamente. true: sí. false: no.

  • tableAutoCommitToDev: Especifica si se deben enviar las tablas al entorno de desarrollo automáticamente. true: sí. false: no.

  • tableAutoCommitToProd: Especifica si se deben enviar las tablas al entorno de producción automáticamente. true: sí. false: no.

  • ignoreLock: Especifica si se deben omitir los bloqueos automáticamente. true: sí. false: no. Si una tarea está bloqueada por otro usuario para su edición, puede forzar la actualización de la tarea actual al elegir omitir el bloqueo.

  • fileAutoCommit: Especifica si se deben enviar los archivos automáticamente. true: sí. false: no.

  • fileAutoDeploy: Especifica si se deben publicar los archivos automáticamente. true: sí. false: no.

{ "resourceAutoCommit": false, "resourceAutoDeploy": false, "functionAutoCommit": false, "functionAutoDeploy": false, "tableAutoCommitToDev": false, "tableAutoCommitToProd": false, "ignoreLock": false, "fileAutoCommit": false, "fileAutoDeploy": false }

Description

string

No

La descripción del paquete de importación y exportación.

test description

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Los datos de la respuesta.

HttpStatusCode

integer

El código de estado HTTP.

200

Data

integer

El ID del paquete de importación y exportación. Puede utilizar este ID como parámetro de entrada para ejecutar la tarea de importación o consultar el progreso de ejecución de la tarea de importación.

123456

ErrorMessage

string

El mensaje de error.

test error message

RequestId

string

El ID de la solicitud. Puede utilizar el ID para localizar los registros y solucionar problemas.

ADFASDFASDFA-ADFASDF-ASDFADSDF-AFFADS

ErrorCode

string

El código de error.

110001123456

Success

boolean

Indica si la llamada se realizó correctamente.

true

Ejemplos

Respuesta exitosa

JSON Formato

{
  "HttpStatusCode": 200,
  "Data": 123456,
  "ErrorMessage": "test error message",
  "RequestId": "ADFASDFASDFA-ADFASDF-ASDFADSDF-AFFADS",
  "ErrorCode": "110001123456",
  "Success": true
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.