Todos los productos
Search
Centro de documentos

:GetFolder

Última actualización: Sep 04, 2026

Consulta los detalles de una carpeta.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda llamar a 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í

GetFolder

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

ProjectId

Long

No

10000

El ID del espacio de trabajo de DataWorks. Inicie sesión en la consola de DataWorks y vaya a la página Workspace Management para obtener el ID del espacio de trabajo. Configure este parámetro o el parámetro ProjectIdentifier para determinar el espacio de trabajo de DataWorks al que se aplica la operación.

ProjectIdentifier

String

No

dw_project

El nombre del espacio de trabajo de DataWorks. Inicie sesión en la consola de DataWorks y vaya a la página Workspace Management para obtener el nombre del espacio de trabajo. Configure este parámetro o el parámetro ProjectId para determinar el espacio de trabajo de DataWorks al que se aplica la operación.

FolderId

String

No

273****

El ID de la carpeta. Configure este parámetro o el parámetro FolderPath. Llame a la operación ListFolders para consultar el ID.

FolderPath

String

No

Workflow/1/MaxCompute/ods

La ruta de la carpeta. Configure este parámetro o el parámetro FolderId. Llame a la operación ListFolders para consultar la ruta.

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. Puede solucionar problemas con base en este ID.

ErrorCode

String

Invalid.Tenant.ConnectionNotExists

El código de error.

Success

Boolean

true

Indica si la solicitud fue exitosa.

Data

Object

Los detalles de la carpeta.

FolderPath

String

Workflow/1/MaxCompute/ods

La ruta de la carpeta.

FolderId

String

2735****

El ID de la carpeta.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?Action=GetFolder
&FolderId=273****
&FolderPath=Workflow/1/MaxCompute/ods
&RegionId=cn-zhangjiakou
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<RequestId>0000-ABCD-EFG****</RequestId>
<HttpStatusCode>200</HttpStatusCode>
<Data>
    <FolderPath>Workflow/1/MaxCompute/ods</FolderPath>
    <FolderId>2735****</FolderId>
</Data>
<ErrorCode>Invalid.Tenant.ConnectionNotExists</ErrorCode>
<ErrorMessage>The connection does not exist.</ErrorMessage>
<Success>true</Success>

Formato JSON

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

{
  "RequestId" : "0000-ABCD-EFG****",
  "HttpStatusCode" : 200,
  "Data" : {
    "FolderPath" : "Workflow/1/MaxCompute/ods",
    "FolderId" : "2735****"
  },
  "ErrorCode" : "Invalid.Tenant.ConnectionNotExists",
  "ErrorMessage" : "The connection does not exist.",
  "Success" : true
}

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 excedido el límite superior.

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.