Todos os produtos
Search
Central de documentação

:ListUserPermissions

Última atualização: Jul 08, 2026

Chama a operação ListUserPermissions para exibir as permissões de banco de dados e tabelas de um usuário específico.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. Use o OpenAPI Explorer para pesquisar operações de API, chamá-las e gerar dinamicamente códigos de exemplo do SDK.

Parâmetros da solicitação

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

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

PermType String Sim DATABASE

O tipo de permissão de recurso. Para valores e descrições, consulte a API ListDatabaseUserPermssions .

Tid Long Sim -1

O ID do locatário.

Nota O ID do locatário é obtido no avatar no canto superior direito do sistema. Para mais informações, consulte ID do Locatário e Locatário .
UserId String Sim 13435

O ID do usuário, correspondente ao ID do usuário na API GetUser. Observe que não se trata do Uid da Alibaba Cloud do usuário.

DatabaseName String Não db_name

Nome do banco de dados.

Logic Boolean Não false

Indica se o banco de dados é lógico. Valores válidos:

  • true
  • false
EnvType String Não dev

Tipo de ambiente ao qual o banco de dados pertence.

DbType String Não MySQL

Mecanismo de banco de dados disponível.

PageNumber Integer Não 1

Número da página retornada.

PageSize Integer Não 1

Quantidade de entradas por página.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
ErrorCode String UnknownError

Código de erro.

ErrorMessage String UnknownError

Mensagem de erro da falha.

RequestId String C51420E3-144A-4A94-B473-8662FCF4AD10

ID da solicitação.

Success Boolean true

Indica se a solicitação foi bem-sucedida.

TotalCount Long 6

Número total de registros que atendem às condições especificadas.

UserPermissions Array of UserPermission

Lista de informações de permissões do usuário.

UserPermission
Alias String instance_alias

Alias da instância.

ColumnName String column_name

Nome da coluna.

DbId String 1324

ID do banco de dados.

DbType String mysql

Tipo da instância de armazenamento do banco de dados DRDS.

DsType String DATABASE

Tipo do recurso de permissão.

EnvType String dev

Tipo de ambiente ao qual o banco de dados pertence.

InstanceId String 134

ID da instância.

Logic Boolean false

Indica se o banco de dados é lógico. Valores válidos:

  • true
  • false
PermDetails Array of PermDetail

Detalhes da permissão.

PermDetail
CreateDate String 2019-12-12 00:00:00

Data e hora em que a permissão foi concedida.

ExpireDate String 2020-12-12 00:00:00

Data e hora de expiração da autorização.

ExtraData String xxx

Dados adicionais (parâmetros reservados).

OriginFrom String xxx

Informações sobre a origem da concessão da permissão.

PermType String QUERY

Tipos de permissão.

UserAccessId String 1345

ID do registro de autorização.

SchemaName String test_db

Nome do banco de dados.

SearchName String test_db@xxx:3306

Nome de pesquisa do banco de dados.

TableId String 13434

ID da tabela.

TableName String test_table

Nome da tabela.

UserId String 423245

ID do usuário.

UserNickName String nick_name

Nome do usuário.

Exemplos

Exemplos de solicitações


     http(s)://[Endpoint]/? Action=ListUserPermissions&perftype=DATABASE &Tid=-1 &UserId=13435 &<common request parameters> 
   

Exemplos de respostas de sucesso

XML formato


     <UserPermissions> <UserPermission> <Logic>false</Logic> <UserNickName>xxx</UserNickName> <DsType>DATABASE</DsType> <Alias>xxx_ent_dev</Alias> <PermDetails> <PermDetail> <ExpireDate>2020-10-31 00:00:00</ExpireDate> <UserAccessId>390913</UserAccessId> <PermType>EXPORT</PermType> <OriginFrom>xxx</OriginFrom> <CreateDate>2019-11-21 15:07:45</CreateDate> </PermDetail> <PermDetail> <ExpireDate>2020-10-31 00:00:00</ExpireDate> <UserAccessId>390914</UserAccessId> <PermType>CORRECT</PermType> <OriginFrom>xxx</OriginFrom> <CreateDate>2019-11-21 15:07:45</CreateDate> </PermDetail> </PermDetails> <InstanceId>24671</InstanceId> <SearchName>xxx@xxx:3306</SearchName> <DbId>111369</DbId> <UserId>88658</UserId> <DbType>drds</DbType> <EnvType>dev</EnvType> <SchemaName>xxx_ent_dev</SchemaName> </UserPermission> </UserPermissions> <TotalCount>6</TotalCount> <RequestId>C51420E3-144A-4A94-B473-8662FCF4AD10</RequestId> <Success>true</Success> 
   

JSON Formato


     { "UserPermissions": { "UserPermission": [ { "Logic": false, "UserNickName": "xxx", "DsType": "DATABASE", "Alias": "xxx_ent_dev", "PermDetails": { "PermDetail": [ { "ExpireDate": "2020-10-31 00:00:00", "UserAccessId": "390913", "PermType": "EXPORT", "OriginFrom": "xxx", "CreateDate": "2019-11-21 15:07:45" }, { "ExpireDate": "2020-10-31 00:00:00", "UserAccessId": "390914", "PermType": "CORRECT", "OriginFrom": "xxx", "CreateDate": "2019-11-21 15:07:45" } ] }, "InstanceId": 24671, "SearchName": "xxx@xxx:3306", "DbId": 111369, "UserId": 88658, "DbType": "drds", "EnvType": "dev", "SchemaName": "xxx_ent_dev" } ] }, "TotalCount": 6, "RequestId": "C51420E3-144A-4A94-B473-8662FCF4AD10", "Success": true } 
   

Códigos de erro

Acesse o Centro de Erros. Para mais informações, consulte os códigos de erro.