Todos os produtos
Search
Central de documentação

DataWorks:ListFolders

Última atualização: Jun 29, 2026

Consulta uma lista de pastas.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ProjectId

integer

Não

O ID do espaço de trabalho do DataWorks. Você pode fazer login no console do DataWorks e acessar a página Espaço de Trabalho para consultar o ID. Você deve especificar este parâmetro ou o parâmetro ProjectIdentifier para identificar o espaço de trabalho do DataWorks ao chamar esta operação.

10000

ProjectIdentifier

string

Não

O nome do espaço de trabalho do DataWorks. Você pode fazer login no console do DataWorks e acessar a página Espaço de Trabalho para consultar o nome do espaço de trabalho. Você deve especificar este parâmetro ou o parâmetro ProjectId para identificar o espaço de trabalho do DataWorks ao chamar esta operação.

dw_project

ParentFolderPath

string

Sim

O caminho da pasta pai.

Business_process/my_first_business_process/MaxCompute

PageNumber

integer

Sim

O número da página da solicitação. Usado para paginação.

1

PageSize

integer

Sim

O número de registros por página. Valor padrão: 10. Valor máximo: 100.

10

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A resposta.

HttpStatusCode

integer

O código de status HTTP.

200

ErrorMessage

string

A mensagem de erro.

The connection does not exist.

RequestId

string

O ID da solicitação. Usado para solução de problemas.

0000-ABCD-****

ErrorCode

string

O código de erro.

Invalid.Tenant.ConnectionNotExists

Success

boolean

Indica se a solicitação foi bem-sucedida. Valores válidos:

  • true: sucesso.

  • false: falha.

true

Data

object

A lista de pastas que atendem às condições.

PageNumber

integer

O número da página atual.

1

PageSize

integer

O número de registros na página atual.

10

TotalCount

integer

O número total de registros que atendem às condições de consulta.

13

Folders

array<object>

A lista de pastas.

object

Os detalhes da pasta.

FolderPath

string

The folder path.

Business_process/my_first_business_process/MaxCompute/ods_layer

FolderId

string

The folder ID.

2735c2****

Exemplos

Resposta de sucesso

JSON formato

{
  "HttpStatusCode": 200,
  "ErrorMessage": "The connection does not exist.",
  "RequestId": "0000-ABCD-****",
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Success": true,
  "Data": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 13,
    "Folders": [
      {
        "FolderPath": "Business_process/my_first_business_process/MaxCompute/ods_layer",
        "FolderId": "2735c2****"
      }
    ]
  }
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

500 InternalError.System An internal system error occurred. Try again later.
500 InternalError.UserId.Missing An internal system error occurred. Try again later.
403 Forbidden.Access Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition. No permission, please authorize
429 Throttling.Api The request for this resource has exceeded your available limit.
429 Throttling.System The DataWorks system is busy. Try again later.
429 Throttling.User Your request is too frequent. Try again later.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.