Todos os produtos
Search
Central de documentação

DataWorks:GetDataServiceFolder

Última atualização: Oct 09, 2026

Consulta uma pasta de serviço de dados.

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

TenantId

integer

Não

[Deprecated] O ID do locatário. Para obter o ID do locatário, faça logon no console do DataWorks, acesse a página Data Studio, clique no nome de usuário atual no canto superior direito e escolha Menu > User Info.

10003

ProjectId

integer

Sim

O ID do espaço de trabalho.

Você pode obter esse ID a partir do parâmetro PageResult.ProjectList[].ProjectId na resposta da operação ListProjects.

Antes de chamar ListProjects para obter o ID do espaço de trabalho, certifique-se de que sua conta tenha a edição necessária do DataWorks e as permissões necessárias. O ID de exemplo é apenas para demonstração de formato.

10002

FolderId

integer

Sim

O ID da pasta.

Você pode obter esse ID a partir do parâmetro FolderPagingResult.Folders[].FolderId na resposta da operação ListDataServiceFolders.

10001

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os dados da resposta.

RequestId

string

O ID da solicitação.

0000-ABCD-EF****

Folder

object

Os detalhes da pasta.

ParentId

integer

O ID da pasta pai. O ID da pasta raiz em um fluxo de trabalho é 0, e o ID de uma pasta criada pelo usuário é maior que 0.

0

ModifiedTime

string

A hora de modificação da pasta.

O formato é yyyy-MM-dd'T'HH:mm:ssZ. Exemplo: 2020-09-24T18:37:51+0800. O deslocamento de fuso horário neste exemplo é +0800.

2020-09-24T18:37:51+0800

GroupId

string

O ID do fluxo de trabalho ao qual a pasta pertence.

ds_1234

FolderId

integer

O ID da pasta.

11

ProjectId

integer

O ID do espaço de trabalho.

10001

FolderName

string

O nome da pasta.

test1

CreatedTime

string

A hora de criação da pasta.

O formato é yyyy-MM-dd'T'HH:mm:ssZ. Exemplo: 2020-09-24T18:37:51+0800. O deslocamento de fuso horário neste exemplo é +0800.

2020-09-24T18:37:51+0800

TenantId

integer

O ID do locatário.

10002

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "0000-ABCD-EF****",
  "Folder": {
    "ParentId": 0,
    "ModifiedTime": "2020-09-24T18:37:51+0800",
    "GroupId": "ds_1234",
    "FolderId": 11,
    "ProjectId": 10001,
    "FolderName": "test1",
    "CreatedTime": "2020-09-24T18:37:51+0800",
    "TenantId": 10002
  }
}

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. Você não tem as permissões necessárias. Conceda as permissões primeiro.
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.