Consulta de registros de atribuição de permissões
Função
Essa API é usada para consultar registros de atribuição de permissões de uma conta especificada.
A API pode ser chamada usando o ponto de extremidade global e pontos de extremidade específicos da região. Para pontos de extremidade do IAM, consulte Regiões e pontos de extremidade.
URI
GET /v3.0/OS-PERMISSION/role-assignments
Parâmetros de solicitação
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
X-Auth-Token |
Sim |
String |
Consulte Gerenciamento de permissões. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
domain_id |
Sim |
String |
ID da conta. Para obter detalhes sobre como conseguir o ID de domínio, consulte Obtenção de informações de conta, usuário do IAM, grupo, projeto, região e agência. |
role_id |
Não |
String |
ID da política. |
subject |
Não |
String |
Diretor. O valor pode ser user, group ou agency. Esse parâmetro é exclusivo com subject.user_id, subject.group_id e subject.agency_id. |
subject.user_id |
Não |
String |
ID do usuário do IAM. Para obter detalhes sobre como obter o ID, consulte Obtenção de informações de conta, usuário do IAM, grupo, projeto, região e agência. |
subject.group_id |
Não |
String |
ID do grupo de usuários. Para obter detalhes sobre como obter o ID, consulte Obtenção de informações de conta, usuário do IAM, grupo, projeto, região e agência. |
subject.agency_id |
Não |
String |
Identidade da agência. Para obter detalhes sobre como conseguir o ID de domínio, clique em Obtenção de informações de conta, usuário do IAM, grupo, projeto, região e agência |
scope |
Não |
String |
Âmbito da autorização. O valor pode ser project, domain ou enterprise_project. Esse parâmetro é mutuamente exclusivo com scope.project_id, scope.domain_id e scope.enterprise_projects_id.
NOTA:
|
scope.project_id |
Não |
String |
ID do projeto. Para obter detalhes sobre como conseguir o ID de domínio, consulte Obtenção de informações de conta, usuário do IAM, grupo, projeto, região e agência. |
scope.domain_id |
Não |
String |
ID da conta. Para obter detalhes sobre como conseguir o ID de domínio, consulte Obtenção de informações de conta, usuário do IAM, grupo, projeto, região e agência. |
scope.enterprise_projects_id |
Não |
String |
ID do projeto empresarial. Para obter detalhes sobre como obter a ID de projeto empresarial, consulte Como obter uma ID de projeto empresarial? |
is_inherited |
Não |
Boolean |
Se incluir todos os registros de autorização com base no projeto. O valor padrão é false. Esse parâmetro é válido somente quando scope é definido como domain ou scope.domain_id é especificado. true: consultar todos os registros de autorização baseados em projeto. false: consultar registros de autorização de serviço global. |
include_group |
Não |
Boolean |
Se incluir registros de autorização baseados em grupo de usuários. O valor padrão é true. Este parâmetro é válido somente quando subject é definido como user ou subject.user_id é especificado. true: consultar registros de autorização de usuários do IAM e grupos de usuários aos quais os usuários do IAM pertencem. false: consultar apenas registros de autorização de usuários do IAM. |
page |
Não |
String |
Número da página para a consulta de paginação. O valor mínimo é 1. Este parâmetro deve ser usado com per_page. |
per_page |
Não |
String |
Número de registros de dados a serem exibidos em cada página durante a consulta de paginação. O valor varia de 1 a 50. Este parâmetro deve ser especificado com page. |
Parâmetros de resposta
Parâmetro |
Tipo |
Descrição |
---|---|---|
total_num |
Long |
Número total de registros de autorização retornados. |
Array of RoleAssignmentBody objects |
Informações de autorização. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
RoleUserAssignmentId object |
Usuário autorizado. |
|
RoleAssignmentId object |
Política de autorização. |
|
RoleGroupAssignmentId object |
Grupo de usuários autorizado. |
|
RoleAgencyAssignmentId object |
Agência de autorização. |
|
RoleAssignmentScope object |
Âmbito da autorização. |
|
is_inherited |
Boolean |
Se a autorização é baseada em todos os projetos. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
RoleProjectAssignmentId object |
Autorização baseada em projeto IAM. |
|
RoleDomainAssignmentId object |
Autorização baseada em serviços globais ou em todos os projetos. |
|
RoleEnterpriseProjectAssignmentId object |
Autorização baseada em projetos corporativos. |
Exemplo de solicitação
GET https://iam.myhuaweicloud.com/v3.0/OS-PERMISSION/role-assignments?{domain_id}
Exemplo de resposta
Código de status: 200
{ "role_assignments":{ "group":{ "id":"07609e7eb200250a3f7dc003cb7a4e2d" }, "is_inherited":true, "role":{ "id":"11e5c42d20cc349a2b9e2f8afd253f50c" }, "scope":{ "domain":{ "id":"d78cbac186b744899480f25bd022f468" } } }, "total_num":1 }
Códigos de status
Código de status |
Descrição |
---|---|
200 |
A solicitação foi bem-sucedida. |
400 |
Parâmetros inválidos. |
401 |
Autenticação falhou. |
403 |
Acesso negado. |
Códigos de erro
Para obter detalhes, consulte Códigos de erro.