Todos los productos
Search
Centro de documentos

:GetDeployment

Última actualización: Sep 04, 2026

Consulta la información de un paquete de despliegue.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que ejecute esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

Action

String

Sí

GetDeployment

La operación que desea ejecutar. Establezca el valor en GetDeployment.

ProjectId

Long

No

10000

El ID del espacio de trabajo de DataWorks. Haga clic en el icono Workspace Manage en la esquina superior derecha de la página DataStudio para ir a la página Work space y consultar el ID del espacio de trabajo.

ProjectIdentifier

String

No

dw_project

El identificador único del espacio de trabajo de DataWorks. Haga clic en el identificador en la esquina superior izquierda de la página DataStudio para cambiar a otro espacio de trabajo.

Debe configurar este parámetro o el parámetro ProjectId para determinar el espacio de trabajo de DataWorks al que se aplica la operación.

DeploymentId

Long

Sí

3000001

El ID del paquete de despliegue. Se genera un ID de paquete de despliegue cuando ejecuta la operación SubmitFile o DeployFile.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

HttpStatusCode

Integer

200

El código de estado HTTP.

ErrorMessage

String

The connection does not exist.

El mensaje de error.

RequestId

String

0000-ABCD-EFG****

El ID de la solicitud.

ErrorCode

String

Invalid.Tenant.ConnectionNotExists

El código de error.

Success

Boolean

true

Indica si la solicitud se completó correctamente.

Data

Object

Los datos devueltos.

Deployment

Object

Los detalles del paquete de despliegue.

Status

Integer

1

El estado del paquete de despliegue. Valores válidos: 0, 1 y 2. El valor 0 indica que el paquete de despliegue está listo. El valor 1 indica que el despliegue se completó correctamente. El valor 2 indica que el despliegue falló.

ErrorMessage

String

Success

El mensaje de error devuelto cuando falla el paquete de despliegue. En este caso, el valor del parámetro Status es 2.

FromEnvironment

Integer

0

El entorno desde el cual se desplegó el paquete. Valores válidos: 0 y 1. El valor 0 indica el entorno local. El valor 1 indica el entorno de desarrollo.

ToEnvironment

Integer

1

El entorno al que se desplegó el archivo. Valores válidos: 1 y 2. El valor 1 indica el entorno de desarrollo. El valor 2 indica el entorno de producción.

CheckingStatus

Integer

7

El estado de verificación de uno o más archivos en el paquete de despliegue. Si el valor del parámetro ToEnvironment es 1, los archivos solo pueden desplegarse en el entorno de producción cuando el valor del parámetro Status es 1 y el parámetro CheckingStatus está vacío. Valores válidos:

  • 7: verificación fallida

  • 8: verificando

CreateTime

Long

1593877765000

La hora en que se creó el paquete de despliegue. Este valor es una marca de tiempo UNIX que representa el número de milisegundos transcurridos desde el 1 de enero de 1970, 00:00:00 UTC.

HandlerId

String

2003****

El ID de la cuenta de Alibaba Cloud del usuario que ejecutó el paquete de despliegue.

CreatorId

String

20030****

El ID de la cuenta de Alibaba Cloud del usuario que creó el paquete de despliegue.

ExecuteTime

Long

1593877765000

La hora en que se desplegó el paquete. Este valor es una marca de tiempo UNIX que representa el número de milisegundos transcurridos desde el 1 de enero de 1970, 00:00:00 UTC.

Name

String

ods_user_info_d-2020-07-04_20030****

El nombre del paquete de despliegue. El valor coincide con el nombre del paquete específico que se muestra en la página Deployment Packages en Deploy.

DeployedItems

Array of DeployedItem

Los elementos desplegados.

FileId

Long

507642378

El ID del archivo.

FileVersion

Long

7

La versión del archivo.

Status

Integer

1

El estado. Valores válidos:

  • UNPUBLISHED(0): no desplegado

  • SUCCESS(1): desplegado

  • ERROR(2): despliegue con errores

  • CLONED(3): clonado

  • DEPLOY_ERROR(4): despliegue con errores

  • CLONING(5): clonando

  • REJECT(6): solicitud de despliegue rechazada

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?Action=GetDeployment
&ProjectId=10000
&ProjectIdentifier=dw_project
&DeploymentId=3000001
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<GetDeploymentResponse>
    <HttpStatusCode>200</HttpStatusCode>
    <ErrorMessage>The connection does not exist.</ErrorMessage>
    <RequestId>0000-ABCD-EFG****</RequestId>
    <ErrorCode>Invalid.Tenant.ConnectionNotExists</ErrorCode>
    <Success>true</Success>
    <Data>
        <Deployment>
            <Status>1</Status>
            <ErrorMessage>Success</ErrorMessage>
            <FromEnvironment>0</FromEnvironment>
            <ToEnvironment>1</ToEnvironment>
            <CheckingStatus>7</CheckingStatus>
            <CreateTime>1593877765000</CreateTime>
            <HandlerId>2003****</HandlerId>
            <CreatorId>20030****</CreatorId>
            <ExecuteTime>1593877765000</ExecuteTime>
            <Name>ods_user_info_d-2020-07-04_20030****</Name>
        </Deployment>
        <DeployedItems>
            <FileId>507642378</FileId>
            <FileVersion>7</FileVersion>
            <Status>1</Status>
        </DeployedItems>
    </Data>
</GetDeploymentResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "HttpStatusCode" : 200,
  "ErrorMessage" : "The connection does not exist.",
  "RequestId" : "0000-ABCD-EFG****",
  "ErrorCode" : "Invalid.Tenant.ConnectionNotExists",
  "Success" : true,
  "Data" : {
    "Deployment" : {
      "Status" : 1,
      "ErrorMessage": "Success",
      "FromEnvironment" : 0,
      "ToEnvironment" : 1,
      "CheckingStatus" : 7,
      "CreateTime" : 1593877765000,
      "HandlerId" : "2003****",
      "CreatorId" : "20030****",
      "ExecuteTime" : 1593877765000,
      "Name" : "ods_user_info_d-2020-07-04_20030****"
    },
    "DeployedItems" : {
      "FileId" : 507642378,
      "FileVersion" : 7,
      "Status" : 1
    }
  }
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

429

Throttling.Api

The request for this resource has exceeded your available limit.

El número de solicitudes para el recurso ha superado el límite permitido.

429

Throttling.System

The DataWorks system is busy. Try again later.

El sistema de DataWorks está ocupado. Inténtelo de nuevo más tarde.

429

Throttling.User

Your request is too frequent. Try again later.

Se han enviado demasiadas solicitudes en un periodo corto. Inténtelo de nuevo más tarde.

500

InternalError.System

An internal system error occurred. Try again later.

Ocurrió un error interno del sistema. Inténtelo de nuevo más tarde.

500

InternalError.UserId.Missing

An internal system error occurred. Try again later.

Ocurrió un error interno del sistema. Inténtelo de nuevo más tarde.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.