Todos os produtos
Search
Central de documentação

DataWorks:SetDataSourceShare

Última atualização: Oct 27, 2026

Compartilha uma fonte de dados de destino com um workspace do DataWorks especificado ou com usuários especificados.

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

Sim

O ID do workspace do DataWorks ao qual a fonte de dados de destino pertence. Você pode chamar a operação ListProjects para obter o ID do workspace.

10000

DatasourceName

string

Sim

O nome da fonte de dados de destino a ser compartilhada.

mysql_name

EnvType

string

Não

O ambiente ao qual a fonte de dados de destino pertence. Valores válidos:

  • 0: ambiente de desenvolvimento.

  • 1: ambiente de produção.

1

ProjectPermissions

string

Não

O workspace do DataWorks com o qual você deseja compartilhar a fonte de dados de destino. Após o compartilhamento da fonte de dados, todos os membros do workspace podem visualizar ou usar a fonte de dados de destino. Use o formato de array JSON. Exemplo: [{"projectId":1000,"permission":"WRITE","sharedName":"PX_DATAHUB1.shared_name"}]. Descrição do parâmetro:

  • projectId: o ID do workspace com o qual você deseja compartilhar a fonte de dados de destino.

  • permission: o modo de permissão. Valores válidos: READ e WRITE. READ indica que todos os membros do workspace especificado podem apenas ler dados da fonte de dados de destino, mas não podem modificar os dados. WRITE indica que todos os membros do workspace especificado podem modificar dados na fonte de dados de destino.

  • sharedName: o nome da fonte de dados a ser compartilhada.

[{"projectId":1000,"permission":"WRITE","sharedName":"PX_DATAHUB1.shared_name"}]

UserPermissions

string

Não

Os usuários com os quais você deseja compartilhar a fonte de dados de destino. Após o compartilhamento da fonte de dados, os usuários especificados podem visualizar ou usar a fonte de dados de destino. Use o formato de array JSON. Exemplo: [{"projectId":10000,"users":[{"userId":"276184575345452131","permission":"WRITE"}],"sharedName":"PX_DATAHUB1.shared_name"}]. Descrição do parâmetro:

  • projectId: o ID do workspace do DataWorks. Isso indica que os usuários com os quais você deseja compartilhar a fonte de dados de destino podem visualizar ou usar a fonte de dados de destino apenas neste workspace.

  • userId: o ID do usuário com o qual você deseja compartilhar a fonte de dados de destino.

  • permission: o modo de permissão. Valores válidos: READ e WRITE. READ indica que o usuário especificado pode apenas ler dados da fonte de dados de destino, mas não pode modificar os dados. WRITE indica que o usuário especificado pode modificar dados na fonte de dados de destino.

  • sharedName: o nome da fonte de dados a ser compartilhada.

Se ProjectPermissions e UserPermissions estiverem vazios, esta operação não fará nenhuma modificação. Se nenhum deles estiver vazio, tanto UserPermissions quanto ProjectPermissions entrarão em vigor.

[{"projectId":10000,"users":[{"userId":"276184575345452131","permission":"WRITE"}],"sharedName":"PX_DATAHUB1.shared_name"}]

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Success

boolean

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

  • true: A solicitação foi bem-sucedida.

  • false: A solicitação falhou.

true

RequestId

string

O ID exclusivo da solicitação. Você pode usar o ID para localizar logs e solucionar problemas quando ocorrer um erro.

0000-ABCD-EFG

Data

object

Os dados retornados para o compartilhamento da fonte de dados de destino.

Status

string

O status do resultado do compartilhamento da fonte de dados de destino. Valores válidos:

  • success: A fonte de dados de destino foi compartilhada.

  • fail: Falha ao compartilhar a fonte de dados de destino. Você pode verificar o parâmetro Message para localizar a causa da falha.

success

Message

string

A descrição da causa da falha ao compartilhar a fonte de dados de destino. Se a fonte de dados de destino for compartilhada, o valor deste parâmetro estará vazio.

datasource is wrong

Exemplos

Resposta de sucesso

JSON formato

{
  "Success": true,
  "RequestId": "0000-ABCD-EFG\t",
  "Data": {
    "Status": "success",
    "Message": "datasource is wrong"
  }
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 Invalid.DI.Parameter The parameter is invalid. Ocorreu um erro de parâmetro.
500 InternalError.DI.Parameter A DI internal error occurred. Ocorreu um erro interno de negócio no Data Integration.
403 Forbidden.DI.NoPrivilege No access. Você não tem as permissões de acesso.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.