Tous les produits
Search
Centre de documentation

:ListUserPermissions

Dernière mise à jour :Aug 09, 2026

Répertorie les autorisations d'un utilisateur spécifique sur une base de données ou une table.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter Type Required Example Description
Action String Yes ListUserPermissions

Opération à effectuer. Définissez la valeur sur ListUserPermissions.

Tid Long Yes 3***

ID du locataire (tenant).

Remarque Pour afficher l'ID du locataire, survolez la photo de profil dans le coin supérieur droit de la console Data Management (DMS). Pour plus d'informations, consultez la section « View information about the current tenant » de la rubrique Manage DMS tenants.
PermType String Yes DATABASE

Type de ressource dont vous souhaitez interroger les autorisations. Valeurs valides :

  • DATABASE : autorisations sur les bases de données
  • TABLE : autorisations sur les tables
  • COLUMN : autorisations sur les colonnes
  • INSTANCE : autorisations sur les instances
UserId String Yes 51****

ID de l'utilisateur. Appelez l'opération GetUser ou ListUsers pour obtenir l'ID de l'utilisateur.

Remarque L'ID utilisateur diffère de l'ID de votre compte Alibaba Cloud.
DatabaseName String No db_name

Nom de la base de données.

SearchKey String No rm-bp144d5ky4l4r****

Mot-clé de recherche. Par exemple, pour interroger les autorisations sur une instance, spécifiez son endpoint, tel que rm-bp144d5ky4l4r.

Logic Boolean No false

Indique si la base de données est logique. Valeurs valides :

  • true : base de données logique.
  • false : base de données physique.
EnvType String No dev

Type d'environnement de la base de données. Valeurs valides :

  • product : environnement de production
  • dev : environnement de développement
  • pre : environnement de préproduction
  • test : environnement de test
  • sit : environnement SIT
  • uat : environnement de recette utilisateur (UAT)
  • pet : environnement de test de charge
  • stag : environnement STAG
DbType String No polardb

Type de base de données. Pour connaître les valeurs valides de ce paramètre, consultez le paramètre DbType.

PageNumber Integer No 1

Numéro de la page à renvoyer.

PageSize Integer No 5

Nombre d'entrées par page.

RegionId String No cn-hangzhou

ID de la région où DMS est activé. Pour connaître les valeurs valides de ce paramètre, consultez le paramètre RegionID.

Remarque Définissez ce paramètre sur l'ID de la région la plus proche de vos applications.

Paramètres de réponse

Parameter Type Example Description
TotalCount Long 1

Nombre total d'entrées correspondant aux critères de requête.

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

ID de la requête.

ErrorCode String UnknownError

Code d'erreur.

ErrorMessage String UnknownError

Message d'erreur.

UserPermissions Array of UserPermission

Détails des autorisations de l'utilisateur.

UserPermission
DbId String 1860****

ID de la base de données.

TableName String test_table

Nom de la table.

UserId String 51****

ID de l'utilisateur.

SchemaName String test_db

Nom de la base de données.

Logic Boolean false

Indique si la base de données est logique. Valeurs valides :

  • true : base de données logique.
  • false : base de données physique.
UserNickName String nick_name

Pseudonyme de l'utilisateur.

InstanceId String 174****

ID de l'instance.

PermDetails Array of PermDetail

Détails des autorisations.

PermDetail
OriginFrom String Granted by xxx

Utilisateur ayant accordé les autorisations.

PermType String QUERY

Type d'autorisation. Valeurs valides :

  • QUERY : autorisation de requête
  • EXPORT : autorisation d'exportation
  • CORRECT : autorisation de modification
ExpireDate String 2020-12-12 00:00:00

Date d'expiration des autorisations.

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

Date d'octroi des autorisations.

UserAccessId String 758****

ID de l'enregistrement d'autorisation.

ExtraData String xxx

Paramètre réservé.

EnvType String dev

Type d'environnement de la base de données. Valeurs valides :

  • product : environnement de production
  • dev : environnement de développement
  • pre : environnement de préproduction
  • test : environnement de test
  • sit : environnement SIT
  • uat : environnement UAT
  • pet : environnement de test de charge
  • stag : environnement STAG
ColumnName String column_name

Nom de la colonne.

DbType String polardb

Type de base de données. Pour connaître les valeurs valides de ce paramètre, consultez le paramètre DbType.

DsType String DATABASE

Type d'objet sur lequel portent les autorisations accordées à l'utilisateur. Valeurs valides :

  • DATABASE : autorisations sur les bases de données physiques
  • LOGIC_DATABASE : autorisations sur les bases de données logiques
  • TABLE : autorisations sur les tables physiques
  • LOGIC_TABLE : autorisations sur les tables logiques
TableId String 13434

ID de la table.

SearchName String test_db@xxx:3306

Nom utilisé pour rechercher la base de données.

Alias String instance_alias

Alias de l'instance.

Host String rm-bp144d5ky4l4r****

Endpoint de connexion à la base de données.

Port Long 3306

Port de connexion à l'instance.

Success Boolean true

Indique si la requête a réussi. Valeurs valides :

  • true : la requête a réussi.
  • false : la requête a échoué.

Exemples

Exemple de requête

http(s)://dms-enterprise.aliyuncs.com/?Action=ListUserPermissions
&PermType=DATABASE
&UserId=51****
&DatabaseName=db_name
&SearchKey=rm-bp144d5ky4l4r****
&Logic=false
&EnvType=dev
&DbType=MySQL
&PageNumber=1
&PageSize=5
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<ListUserPermissionsResponse>
    <TotalCount>1</TotalCount>
    <RequestId>C51420E3-144A-4A94-B473-8662FCF4AD10</RequestId>
    <ErrorCode>UnknownError</ErrorCode>
    <ErrorMessage>UnknownError</ErrorMessage>
    <UserPermissions>
        <DbId>1860****</DbId>
        <TableName>test_table</TableName>
        <UserId>51****</UserId>
        <SchemaName>test_db</SchemaName>
        <Logic>false</Logic>
        <UserNickName>nick_name</UserNickName>
        <InstanceId>174****</InstanceId>
        <PermDetails>
            <OriginFrom>Granted by xxx</OriginFrom>
            <PermType>QUERY</PermType>
            <ExpireDate>2020-12-12 00:00:00</ExpireDate>
            <CreateDate>2019-12-12 00:00:00</CreateDate>
            <UserAccessId>758****</UserAccessId>
            <ExtraData>xxx</ExtraData>
        </PermDetails>
        <EnvType>dev</EnvType>
        <ColumnName>column_name</ColumnName>
        <DbType>polardb</DbType>
        <DsType>DATABASE</DsType>
        <TableId>13434</TableId>
        <SearchName>test_db@xxx:3306</SearchName>
        <Alias>instance_alias</Alias>
        <Host>rm-bp144d5ky4l4r****</Host>
        <Port>3306</Port>
    </UserPermissions>
    <Success>true</Success>
</ListUserPermissionsResponse>

Format JSON

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

{
  "TotalCount" : 1,
  "RequestId" : "C51420E3-144A-4A94-B473-8662FCF4AD10",
  "ErrorCode" : "UnknownError",
  "ErrorMessage" : "UnknownError",
  "UserPermissions" : [ {
    "DbId" : "1860****",
    "TableName" : "test_table",
    "UserId" : "51****",
    "SchemaName" : "test_db",
    "Logic" : false,
    "UserNickName" : "nick_name",
    "InstanceId" : "174****",
    "PermDetails" : [ {
      "OriginFrom" : "Granted by xxx",
      "PermType" : "QUERY",
      "ExpireDate" : "2020-12-12 00:00:00",
      "CreateDate" : "2019-12-12 00:00:00",
      "UserAccessId" : "758****",
      "ExtraData" : "xxx"
    } ],
    "EnvType" : "dev",
    "ColumnName" : "column_name",
    "DbType" : "polardb",
    "DsType" : "DATABASE",
    "TableId" : "13434",
    "SearchName" : "test_db@xxx:3306",
    "Alias" : "instance_alias",
    "Host" : "rm-bp144d5ky4l4r****",
    "Port" : 3306
  } ],
  "Success" : true
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.