ListUserPermissions - - Centre de documentation Alibaba Cloud

Consulte les autorisations d'un utilisateur sur les bases de données et les tables.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

dms:ListUserPermissions

list

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Tid	integer	Non	L'identifiant du locataire. Remarque Pour consulter l'identifiant du locataire, placez le pointeur sur la photo de profil dans le coin supérieur droit de la console Data Management (DMS). Pour plus d'informations, consultez la section « Afficher les informations sur le locataire actuel » de la rubrique Gérer les locataires DMS.	3***
PermType	string	Oui	Les autorisations sur un type spécifique de ressources que vous souhaitez interroger. Valeurs valides : DATABASE : autorisations sur les bases de données TABLE : autorisations sur les tables COLUMN : autorisations sur les champs INSTANCE : autorisations sur les instances	DATABASE
UserId	string	Oui	L'identifiant de l'utilisateur. Vous pouvez appeler l'opération GetUser ou ListUsers pour interroger l'identifiant de l'utilisateur. Remarque L'identifiant de l'utilisateur est différent de l'identifiant de votre compte Alibaba Cloud.	51****
DatabaseName	string	Non	Le nom de la base de données.	db_name
SearchKey	string	Non	Le mot-clé utilisé dans la requête. Par exemple, si vous souhaitez interroger les autorisations sur une instance, vous pouvez spécifier le point de terminaison de l'instance, tel que rm-bp144d5ky4l4r****.	rm-bp144d5ky4l4r****
Logic	boolean	Non	Indique si la base de données est une base de données logique. Valeurs valides : true : la base de données est une base de données logique. false : la base de données est une base de données physique.	false
EnvType	string	Non	Le type d'environnement auquel la base de données appartient. Valeurs valides : product : environnement de production dev : environnement de développement pre : environnement de staging test : environnement de test sit : environnement SIT uat : environnement de test d'acceptation utilisateur (UAT) pet : environnement de test de charge stag : environnement STAG	dev
DbType	string	Non	Le type de la base de données. Pour plus d'informations sur les valeurs valides de ce paramètre, consultez Paramètre DbType.	polardb
PageNumber	integer	Non	Le numéro de la page à renvoyer.	1
PageSize	integer	Non	Le nombre d'entrées à renvoyer sur chaque page.	5

Éléments de réponse

Élément	Type	Description	Exemple
	object
TotalCount	integer	Le nombre total d'entrées qui remplissent les conditions de la requête.	1
RequestId	string	L'identifiant de la requête.	C51420E3-144A-4A94-B473-8662FCF4AD10
ErrorCode	string	Le code d'erreur.	UnknownError
ErrorMessage	string	Le message d'erreur.	UnknownError
UserPermissions	object
UserPermission	array<object>	Les détails des autorisations dont dispose l'utilisateur.
	array<object>
DbId	string	The ID of the database.	1860****
TableName	string	The name of the table.	test_table
UserId	string	The ID of the user.	51****
SchemaName	string	The name of the database.	test_db
Logic	boolean	Indicates whether the database is a logical database. Valid values: true: The database is a logical database. false: The database is a physical database.	false
UserNickName	string	The nickname of the user.	nick_name
InstanceId	string	The ID of the instance.	174****
PermDetails	object
PermDetail	array<object>	The details of permissions.
	object
OriginFrom	string	The user who grants the permissions.	Xxx authorization
PermType	string	The type of the permissions. Valid values: QUERY: the query permissions EXPORT: the export permissions CORRECT: the change permissions	QUERY
ExpireDate	string	The time when the permissions expire.	2020-12-12 00:00:00
CreateDate	string	The time when the permissions were granted.	2019-12-12 00:00:00
UserAccessId	string	The ID of the authorization record.	758****
ExtraData	string	This parameter is reserved.	xxx
EnvType	string	The type of the environment to which the database belongs. Valid values: product: production environment dev: development environment pre: staging environment test: test environment sit: SIT environment uat: UAT environment pet: stress testing environment stag: STAG environment	dev
ColumnName	string	The name of the field.	column_name
DbType	string	The type of the database. For more information about the valid values of this parameter, see DbType parameter.	polardb
DsType	string	The permissions on a specific type of objects that are granted to the user. Valid values: DATABASE: permissions on physical databases LOGIC_DATABASE: permissions on logical databases TABLE: permissions on physical tables LOGIC_TABLE: permissions on logical tables	DATABASE
TableId	string	The ID of the table.	13434
SearchName	string	The name that is used to search for the database.	test_db@xxx:3306
Alias	string	The alias of the instance.	instance_alias
Host	string	The endpoint that is used to connect the database.	rm-bp144d5ky4l4r****
Port	integer	The port that is used to connect to the instance.	3306
Success	boolean	Indique si la requête a abouti. Valeurs valides : true : la requête a abouti. false : la requête a échoué.	true

Exemples

JSON format

{
  "TotalCount": 1,
  "RequestId": "C51420E3-144A-4A94-B473-8662FCF4AD10",
  "ErrorCode": "UnknownError",
  "ErrorMessage": "UnknownError",
  "UserPermissions": {
    "UserPermission": [
      {
        "DbId": "1860****",
        "TableName": "test_table",
        "UserId": "51****",
        "SchemaName": "test_db",
        "Logic": false,
        "UserNickName": "nick_name",
        "InstanceId": "174****",
        "PermDetails": {
          "PermDetail": [
            {
              "OriginFrom": "Xxx authorization",
              "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

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.