Antes de conceder um papel de gerenciamento de identidade e acesso (IAM, na sigla em inglês) a um usuário para um recurso, talvez você queira saber quais papéis estão disponíveis para um determinado recurso.
Como entender quais papéis são atribuíveis
Um papel será concedido em um recurso ou sobre ele se contiver permissões para esse tipo de recurso. Por exemplo, o papel storage.admin
concede permissões às APIs storage.buckets.get
e storage.objects.get
. Por isso, pode ser concedido nos tipos de recursos buckets de armazenamento e Objetos de armazenamento.
Os papéis também podem ser concedidos "acima" dos tipos de recursos com permissões definidas. Em outras palavras, os papéis para recursos de nível inferior podem ser concedidos em um recurso que está mais acima na hierarquia de recursos do Google Cloud. Por exemplo, o papel storage.admin
também pode ser concedido nos níveis do projeto ou da organização, além dos buckets do Storage.
As permissões concedidas por um papel afetam somente recursos no nível especificado ou abaixo, e não recursos de nível superior ou pares. Além disso, quando um papel é concedido em um recurso, somente as permissões aplicáveis ao recurso fornecido são concedidas, independentemente do nome, da descrição ou de outras permissões do papel. Por exemplo, atribuir o papel resourcemanager.organizationAdmin
(que concede a permissão resourcemanager.projects.list
) a um usuário no nível do projeto concede somente a ele permissões para esse projeto específico. O usuário não terá permissão para listar ou administrar todos os projetos na organização.
Da mesma maneira, atribuir o papel compute.admin
a uma instância específica do Compute Engine só concede permissões para essa instância, não para outras no projeto.
Como listar papéis atribuíveis
Antes de listar os papéis que você pode conceder, verifique se o serviço foi ativado no projeto. Se um serviço não foi ativado, os papéis dele não serão retornados.
Console
No Console do Cloud, acesse a página IAM.
Clique no menu suspenso "Selecionar um projeto" na parte superior da página.
Selecione o projeto ou a organização dos papéis que você quer ver.
Clique em Adicionar.
Insira o e-mail ou domínio do membro em Membros.
O menu suspenso Selecionar um papel exibe todos os papéis que você pode conceder ao membro neste recurso, inclusive os personalizados.
gcloud
Use o comando gcloud iam list-grantable-roles
para retornar uma lista de todos os papéis que podem ser aplicados a determinado recurso.
gcloud iam list-grantable-roles full-resource-name
Dependendo do recurso escolhido, um grande número de papéis pode ser retornado. Para limitar os resultados, especifique uma expressão de filtro.
A resposta será similar a esta:
description: Full control of all Compute Engine resources.
name: roles/compute.admin
title: Compute Admin
---
description: Full control of Compute Engine instance resources.
name: roles/compute.instanceAdmin
title: Compute Instance Admin
# Additional results here...
REST
O
método
roles.queryGrantableRoles
retorna uma lista de todos os papéis que podem ser concedidos em um recurso.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
full-resource-name
: um URI que consiste no nome do serviço e no caminho para o recurso. Veja exemplos em Nomes de recursos completos.
Método HTTP e URL:
POST https://iam.googleapis.com/v1/roles:queryGrantableRoles
Corpo JSON da solicitação:
{ "fullResourceName": "full-resource-name" }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{ "roles": [ { "name": "roles/compute.admin", "title": "Compute Admin", "description": "Full control of all Compute Engine resources." }, { "name": "roles/compute.instanceAdmin", "title": "Compute Instance Admin (beta)", "description": "Full control of Compute Engine instance resources." } ] }
C#
Antes de testar este exemplo, siga as instruções de configuração do C# no Guia de início rápido do IAM: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API IAM para C#.
Go
Antes de testar este exemplo, siga as instruções de configuração do Go no Guia de início rápido do IAM: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API IAM para Go.
Java
Antes de testar este exemplo, siga as instruções de configuração do Java no Guia de início rápido do IAM: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API IAM para Java.
Python
Antes de testar este exemplo, siga as instruções de configuração do Python no Guia de início rápido do IAM: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API IAM para Python.
Nos exemplos acima, o nome completo do recurso é um URI sem esquema, consistindo em um nome de serviço de API compatível com DNS e um caminho de recurso.
Por exemplo, para retornar todos os papéis que possam ser atribuídos em um projeto, use:
//cloudresourcemanager.googleapis.com/projects/project-id
Os recursos de nível inferior têm um nome totalmente qualificado mais detalhado. Por exemplo, use o seguinte comando para retornar todos os papéis que podem ser atribuídos em uma instância do Compute Engine:
//compute.googleapis.com/projects/project-id/zones/zone-name/instances/instance-id
A seguir
- Conheça os papéis de IAM disponíveis.
- Saiba como conceder, alterar e revogar o acesso de um membro.
- Veja exemplos de nomes de recursos para diferentes tipos de recursos.