Consulta de registros de asignación de permisos
Función
Esta API se utiliza para consultar registros de asignación de permisos de una cuenta especificada.
Se puede invocar a la API utilizando tanto el punto de conexión global como los puntos de conexión específicos de la región. Para los puntos de conexión de IAM, consulte Regiones y puntos de conexión.
URI
GET /v3.0/OS-PERMISSION/role-assignments
Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
domain_id | Sí | String | ID de cuenta. Para obtener más información sobre cómo obtener el ID de cuenta, consulte Obtención de información de cuenta, usuario de IAM, grupo, proyecto, región y delegación. |
role_id | No | String | ID de política. |
subject | No | String | Principal. El valor puede ser user, group o agency. Este parámetro es exclusivo para subject.user_id, subject.group_id y subject.agency_id. |
subject.user_id | No | String | ID del usuario de IAM. Para obtener más información sobre cómo obtener el ID, consulte Obtención de información de cuenta, usuario de IAM, grupo, proyecto, región y delegación. |
subject.group_id | No | String | ID del grupo de usuarios. Para obtener más información sobre cómo obtener el ID, consulte Obtención de información de cuenta, usuario de IAM, grupo, proyecto, región y delegación. |
subject.agency_id | No | String | ID de delegación. Para obtener detalles sobre cómo obtener la identificación de la delegación, consulte Obtención de información de cuenta, usuario de IAM, grupo, proyecto, región y delegación. |
scope | No | String | Ámbito de autorización. El valor puede ser project, domain o enterprise_project. Este parámetro es mutuamente excluyente con scope.project_id, scope.domain_id y scope.enterprise_projects_id. NOTA:
|
scope.project_id | No | String | ID del proyecto. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de información de cuenta, usuario de IAM, grupo, proyecto, región y delegación. |
scope.domain_id | No | String | ID de cuenta. Para obtener más información sobre cómo obtener el ID de cuenta, consulte Obtención de información de cuenta, usuario de IAM, grupo, proyecto, región y delegación. |
scope.enterprise_projects_id | No | String | ID del proyecto de empresa autorizado. Para obtener más información sobre cómo obtener el ID, consulte ¿Cómo obtengo un ID de Proyecto empresarial? |
is_inherited | No | Boolean | Si se deben incluir todos los registros de autorización basados en proyectos. El valor predeterminado es false. Este parámetro sólo es válido cuando scope se establece en domain o scope.domain_id se especifica. true: Consultar todos los registros de autorización basados en proyectos. false: Consultar registros de autorización de servicio global. |
include_group | No | Boolean | Si se incluyen registros de autorización basados en grupos de usuarios. El valor predeterminado es true. Este parámetro sólo es válido cuando subject se establece en user o subject.user_id se especifica. true: Consultar registros de autorización de usuarios y grupos de usuarios de IAM a los que pertenecen los usuarios de IAM. false: Solo consultar los registros de autorización de los usuarios de IAM. |
page | No | String | Número de página para consulta de paginación. El valor mínimo es 1. Este parámetro debe usarse junto con per_page. |
per_page | No | String | Número de registros de datos que se mostrarán en cada página durante la consulta de paginación. El valor varía de 1 a 50. Este parámetro debe especificarse junto con page. |
Parámetros de solicitud
Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
X-Auth-Token | Sí | String | Credencial de acceso emitida a un usuario para que porte su identidad y permisos. Para obtener más información sobre los permisos requeridos por el token, consulte Gestión de permisos. |
Parámetros de respuesta
Parámetro | Tipo | Descripción |
|---|---|---|
total_num | Long | Número total de registros de autorización devueltos. |
Array of RoleAssignmentBody objects | Información de autorización. |
Parámetro | Tipo | Descripción |
|---|---|---|
RoleUserAssignmentId object | Usuario autorizado. | |
RoleAssignmentId object | Política de autorización. | |
RoleGroupAssignmentId object | Grupo de usuarios autorizado. | |
RoleAgencyAssignmentId object | Delegación de autorización. | |
RoleAssignmentScope object | Ámbito de autorización. | |
is_inherited | Boolean | Si la autorización se basa en todos los proyectos. |
Parámetro | Tipo | Descripción |
|---|---|---|
RoleProjectAssignmentId object | Autorización basada en proyectos de IAM. | |
RoleDomainAssignmentId object | Autorización basada en servicios globales o en todos los proyectos. | |
RoleEnterpriseProjectAssignmentId object | Autorización basada en proyectos empresariales. |
Solicitud de ejemplo
Solicitud de consulta de registros de asignación de permisos
GET https://iam.myhuaweicloud.com/v3.0/OS-PERMISSION/role-assignments?{domain_id} Ejemplo de respuesta
Código de estado: 200
{
"role_assignments":{
"group":{
"id":"07609e7eb200250a3f7dc003cb7a4e2d"
},
"is_inherited":true,
"role":{
"id":"11e5c42d20cc349a2b9e2f8afd253f50c"
},
"scope":{
"domain":{
"id":"d78cbac186b744899480f25bd022f468"
}
}
},
"total_num":1
} Códigos de estado
Código de estado | Descripción |
|---|---|
200 | La solicitud se ha realizado correctamente. |
400 | Parámetros no válidos. |
401 | Error de autenticación. |
403 | Acceso denegado. |
Códigos de error
Para obtener más información, consulte Códigos de error.
