Todos os produtos
Search
Central de documentação

:GrantUserPermission

Última atualização: Jul 08, 2026

Concede permissões em uma instância, banco de dados ou tabela a um usuário.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim GrantUserPermission

A operação que você deseja executar. Defina o valor como GrantUserPermission.

Tid Long Sim 3***

O ID do locatário.

Nota Para visualizar o ID do locatário, passe o ponteiro do mouse sobre a foto de perfil no canto superior direito do console do Data Management (DMS). Para mais informações, consulte a seção "Visualizar informações sobre o locatário atual" do tópico Gerenciar locatários do DMS.
UserId String Sim 51****

O ID do usuário. Chame a operação GetUser ou ListUsers para consultar o ID do usuário.

Nota O ID do usuário é diferente do ID da sua conta Alibaba Cloud.
DsType String Sim DATABASE

As permissões em um tipo específico de objeto que você deseja conceder ao usuário. Valores válidos:

  • INSTANCE: permissões em instâncias
  • DATABASE: permissões em bancos de dados físicos
  • LOGIC_DATABASE: permissões em bancos de dados lógicos
  • TABLE: permissões em tabelas físicas
  • LOGIC_TABLE: permissões em tabelas lógicas
InstanceId Long Não 174****

O ID da instância. Especifique este parâmetro se estiver concedendo permissões em uma instância ao usuário. Chame a operação ListInstances ou GetInstance para consultar o ID da instância.

DbId String Sim 1***

O ID do banco de dados. Chame a operação ListDatabases para consultar o ID de um banco de dados físico e a operação ListLogicDatabases para consultar o ID de um banco de dados lógico.

Nota O valor do parâmetro DatabaseId corresponde ao valor do parâmetro DbId.
Logic Boolean Não false

Indica se o banco de dados é lógico. Este parâmetro é obrigatório ao conceder permissões em um banco de dados ao usuário. Valores válidos:

  • true: o banco de dados é lógico.
  • false: o banco de dados é físico.
TableId String Não 132***

O ID da tabela. Especifique este parâmetro caso esteja concedendo permissões em uma tabela ao usuário. Utilize a operação ListTables para obter o ID da tabela.

TableName String Não table_name

O nome da tabela. Informe este parâmetro quando for conceder permissões em uma tabela ao usuário.

PermTypes String Sim QUERY

O tipo de permissão. Separe múltiplos tipos de permissão com vírgulas (,). Valores válidos:

  • QUERY: permissões de consulta
  • EXPORT: permissões de exportação
  • CORRECT: permissões de alteração
ExpireDate String Sim 2021-12-12 00:00:00

A data de expiração das permissões.

RegionId String Não cn-hangzhou

O ID da região onde o DMS está ativado. Para mais informações sobre os valores válidos deste parâmetro, consulte Parâmetro RegionID.

Nota Defina este parâmetro com o ID da região mais próxima das suas aplicações.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
RequestId String A99CD576-1E18-4E86-931E-C3CCE56DC030

O ID da solicitação.

ErrorCode String UnknownError

O código de erro.

ErrorMessage String UnknownError

A mensagem de erro.

Success Boolean true

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

  • true: a solicitação foi bem-sucedida.
  • false: a solicitação falhou.

Exemplos

Exemplos de solicitações

http(s)://dms-enterprise.aliyuncs.com/?Action=GrantUserPermission
&UserId=12345
&DsType=DATABASE
&InstanceId=13124
&DbId=1234
&Logic=false
&TableId=1324245
&TableName=table_name
&PermTypes=QUERY
&ExpireDate=2019-12-12 00:00:00
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<GrantUserPermissionResponse>
    <RequestId>A99CD576-1E18-4E86-931E-C3CCE56DC030</RequestId>
    <Success>true</Success>
</GrantUserPermissionResponse>

Formato JSON

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

{
  "RequestId" : "A99CD576-1E18-4E86-931E-C3CCE56DC030",
  "Success" : true
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros de API.