Todos os produtos
Search
Central de documentação

:ListInstanceUserPermissions

Última atualização: Jul 08, 2026

Consulta as permissões de um usuário em uma instância específica.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

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

Operação a ser executada. Defina o valor como ListInstanceUserPermissions.

Tid Long Sim 3***

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" no tópico Gerenciar locatários do DMS.
InstanceId String Sim 174****

ID da instância. Chame a operação ListInstances ou GetInstance para consultar esse ID.

UserName String Não test_nick_name

Apelido do usuário. Chame a operação ListUsers ou GetUser para obter essa informação.

Nota O valor do parâmetro NickName corresponde ao valor do parâmetro UserName.
PageNumber Integer Não 1

Número da página a retornar.

PageSize Integer Não 100

Quantidade de entradas por página.

RegionId String Não cn-hangzhou

ID da região onde o DMS está ativado. Para visualizar os valores válidos, 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
TotalCount Long 1

Total de entradas retornadas.

RequestId String 7D162AAE-6501-5691-BF14-D7018F662895

ID da solicitação.

ErrorCode String UnknownError

Código de erro.

ErrorMessage String UnknownError

Mensagem de erro.

UserPermissions Array of UserPermission

Permissões do usuário na instância.

UserPermission
UserId String 51****

ID do usuário.

UserNickName String test_nick_name

Apelido do usuário.

InstanceId String 174****

ID da instância.

PermDetails Array of PermDetail

Detalhes das permissões.

PermDetail
OriginFrom String Granted by XXX

Usuário que concedeu as permissões.

PermType String LOGIN

Tipo de permissão. Valores válidos:

  • LOGIN: permissões de logon
  • PERF: permissões de consulta na instância
ExpireDate String 2020-12-12 00:00:00

Data de expiração das permissões.

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

Data de concessão das permissões.

UserAccessId String 773****

ID do registro de autorização.

ExtraData String XXX

Parâmetro reservado.

Success Boolean true

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

  • true: solicitação bem-sucedida.
  • false: falha na solicitação.

Exemplos

Exemplos de solicitações

http(s)://dms-enterprise.aliyuncs.com/?Action=ListInstanceUserPermissions
&InstanceId=174****
&UserName=test_nick_name
&PageNumber=1
&PageSize=100
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ListInstanceUserPermissionsResponse>
    <TotalCount>1</TotalCount>
    <RequestId>7D162AAE-6501-5691-BF14-D7018F662895</RequestId>
    <ErrorCode>UnknownError</ErrorCode>
    <ErrorMessage>UnknownError</ErrorMessage>
    <UserPermissions>
        <UserId>51****</UserId>
        <UserNickName>test_nick_name</UserNickName>
        <InstanceId>174****</InstanceId>
        <PermDetails>
            <OriginFrom>Granted by XXX</OriginFrom>
            <PermType>LOGIN</PermType>
            <ExpireDate>2020-12-12 00:00:00</ExpireDate>
            <CreateDate>2019-12-12 00:00:00</CreateDate>
            <UserAccessId>773****</UserAccessId>
            <ExtraData>XXX</ExtraData>
        </PermDetails>
    </UserPermissions>
    <Success>true</Success>
</ListInstanceUserPermissionsResponse>

Formato JSON

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

{
  "TotalCount" : 1,
  "RequestId" : "7D162AAE-6501-5691-BF14-D7018F662895",
  "ErrorCode" : "UnknownError",
  "ErrorMessage" : "UnknownError",
  "UserPermissions" : [ {
    "UserId" : "51****",
    "UserNickName" : "test_nick_name",
    "InstanceId" : "174****",
    "PermDetails" : [ {
      "OriginFrom" : "Granted by XXX",
      "PermType" : "LOGIN",
      "ExpireDate" : "2020-12-12 00:00:00",
      "CreateDate" : "2019-12-12 00:00:00",
      "UserAccessId" : "773****",
      "ExtraData" : "XXX"
    } ]
  } ],
  "Success" : true
}

Códigos de erro

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