ListDatabaseUserPermssions - Data Management - Centro de documentación de Alibaba Cloud

Consulta los permisos de los usuarios en una base de datos.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

dms:ListDatabaseUserPermssions

list

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Tid	integer	No	El ID del inquilino. Nota : Para ver el ID del inquilino, inicie sesión en la consola de Data Management (DMS) y pase el puntero sobre la foto de perfil en la esquina superior derecha. Para obtener más información, consulte Gestionar inquilinos de DMS.	-1
PermType	string	Sí	El tipo de permiso. Valores válidos: DATABASE: permisos en bases de datos TABLE: permisos en tablas COLUMN: permisos en campos	DATABASE
DbId	string	Sí	El ID de la base de datos.	123
Logic	boolean	No	Especifica si la base de datos es una base de datos lógica.	false
UserName	string	No	El apodo del usuario.	search_user_name
PageNumber	integer	No	El número de la página a devolver.	1
PageSize	integer	No	El número de entradas a devolver en cada página.	10

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
TotalCount	integer	El número total de entradas devueltas.	1
RequestId	string	El ID de la solicitud.	68075D06-7406-4887-83A7-F558A4D28C13
ErrorCode	string	El código de error devuelto si la solicitud falló.	UnknownError
ErrorMessage	string	El mensaje de error devuelto si la solicitud falló.	UnknownError
UserPermissions	object
UserPermission	array<object>	Los detalles de los permisos del usuario.
	array<object>
DbId	string	El ID de la base de datos.	1234
TableName	string	El nombre de la tabla.	table_name
UserId	string	El ID del usuario.	14324
SchemaName	string	El nombre de la base de datos.	xxx@xxxx:3306
Logic	boolean	Indica si la base de datos es una base de datos lógica.	false
UserNickName	string	El apodo del usuario.	user_nick_name
InstanceId	string	El ID de la instancia.	1443
PermDetails	object
PermDetail	array<object>	Los detalles de los permisos del usuario.
	object
OriginFrom	string	La descripción de la entidad que autoriza el permiso.	xxx grant
PermType	string	El tipo de permiso. Valores válidos: QUERY: los permisos de consulta EXPORT: los permisos de exportación CORRECT: los permisos de cambio	QUERY
ExpireDate	string	La hora en la que caducan los permisos.	2020-12-12 00:00:00
CreateDate	string	La hora en la que se creó el permiso.	2019-12-12 00:00:00
UserAccessId	string	El ID del registro de autorización.	13434
ExtraData	string	La información adicional. Este parámetro está reservado.	DEFAULT
EnvType	string	El tipo de entorno al que pertenece la base de datos.	product
ColumnName	string	El nombre de una columna.	column_name
DbType	string	El tipo de motor de base de datos.	mysql
DsType	string	El tipo de recursos sobre los que el usuario tiene permisos.	DATABASE
TableId	string	El ID de la tabla.	42345
SearchName	string	El nombre que se utiliza para buscar la base de datos.	xxx
Alias	string	El alias de la instancia de base de datos.	instance_alias
Success	boolean	Indica si la solicitud se realizó correctamente.	true

Ejemplos

Respuesta exitosa

JSON Formato

{
  "TotalCount": 1,
  "RequestId": "68075D06-7406-4887-83A7-F558A4D28C13",
  "ErrorCode": "UnknownError",
  "ErrorMessage": "UnknownError",
  "UserPermissions": {
    "UserPermission": [
      {
        "DbId": "1234",
        "TableName": "table_name",
        "UserId": "14324",
        "SchemaName": "xxx@xxxx:3306",
        "Logic": false,
        "UserNickName": "user_nick_name",
        "InstanceId": "1443",
        "PermDetails": {
          "PermDetail": [
            {
              "OriginFrom": "xxx grant",
              "PermType": "QUERY",
              "ExpireDate": "2020-12-12 00:00:00",
              "CreateDate": "2019-12-12 00:00:00",
              "UserAccessId": "13434",
              "ExtraData": "DEFAULT"
            }
          ]
        },
        "EnvType": "product",
        "ColumnName": "column_name",
        "DbType": "mysql",
        "DsType": "DATABASE",
        "TableId": "42345",
        "SearchName": "xxx",
        "Alias": "instance_alias"
      }
    ]
  },
  "Success": true
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.