Permissões de IAM para comandos gsutil

Esta tabela contém a lista de permissões do gerenciamento de identidade e acesso (IAM, na sigla em inglês) necessárias para executar cada comando gsutil do Cloud Storage em um recurso específico. As permissões do IAM são agrupadas para criar papéis. Você concede papéis a usuários e grupos.

Nessa página, você também encontra informações sobre:

• Uso de comandos adicionais que só se aplicam a buckets com acesso uniforme no nível do bucket desativado

• Usar caracteres curinga e flags recursivas.

• Uso da flag -u para especificar projetos para faturamento.

• Como usar a flag -m para executar operações em paralelo

Comando	Subcomando	Recurso afetado	Permissões de IAM obrigatórias
autoclass	get	Buckets	storage.buckets.get
autoclass	set	Buckets	storage.buckets.update
cat		Objetos	storage.objects.get
compose		Objetos	storage.objects.get storage.objects.create storage.objects.delete^1
config			Nenhum
cors	get	buckets	storage.buckets.get
cors	set	Buckets	storage.buckets.update
cp		Objetos	storage.objects.list^2 (para o bucket de destino) storage.objects.get (para os objetos de origem) storage.objects.create (para o bucket de destino) storage.objects.delete^3 (para o bucket de destino)
defstorageclass	get	Buckets	storage.buckets.get
defstorageclass	set	Buckets	storage.buckets.update
du		Objetos	storage.objects.get
hash		Objetos	storage.objects.get
help			Nenhum
hmacKeys	create	Chaves HMAC	storage.hmacKeys.create
hmacKeys	delete	Chaves HMAC	storage.hmacKeys.delete
hmacKeys	get	Chaves HMAC	storage.hmacKeys.get
hmacKeys	list	Chaves HMAC	storage.hmacKeys.list
hmacKeys	update	Chaves HMAC	storage.hmacKeys.update
iam	get	buckets	storage.buckets.get storage.buckets.getIamPolicy
iam	set ou ch	Buckets	storage.buckets.get storage.buckets.getIamPolicy storage.buckets.setIamPolicy storage.buckets.update
kms	authorize	Projetos	resourceManager.projects.get iam.serviceAccounts.create^4 cloudkms.cryptoKeys.setIamPolicy (para a chave do Cloud KMS sendo autorizada)
kms	encryption	Buckets	storage.buckets.get
kms	encryption -d	Buckets	storage.buckets.get storage.buckets.update
kms	encryption -k	Buckets, projetos^5	storage.buckets.get storage.buckets.update resourceManager.projects.get^5 cloudkms.cryptoKeys.setIamPolicy^5
kms	serviceaccount	Projetos	resourceManager.projects.get
label	get	buckets	storage.buckets.get
label	set/ch	buckets	storage.buckets.update
lifecycle	get	buckets	storage.buckets.get
lifecycle	set/ch	buckets	storage.buckets.update
logging	get	buckets	storage.buckets.get
logging	set	buckets	storage.buckets.update
ls		Projetos	storage.buckets.list storage.buckets.getIamPolicy^6
ls		Buckets, objetos	storage.objects.list storage.objects.getIamPolicy^7
ls -b		Buckets	storage.buckets.get storage.buckets.getIamPolicy^6
mb		Buckets	storage.buckets.create
mv		Objetos	storage.objects.list^2 (para o bucket de destino) storage.objects.get (para os objetos de origem) storage.objects.create (para o bucket de destino) storage.objects.delete (para o bucket de origem) storage.objects.delete^3 (para o bucket de destino)
notification	create	Buckets	storage.buckets.update pubsub.topics.get (para o projeto que contém o tópico do Pub/Sub) pubsub.topics.create^8 (para o projeto que contém o tópico do Pub/Sub) pubsub.topics.getIamPolicy (para o tópico do Pub/Sub que recebe notificações) pubsub.topics.setIamPolicy^8 (para o tópico do Pub/Sub que recebe notificações)
notification	create -s	Buckets	storage.buckets.update
notification	delete	buckets	storage.buckets.get storage.buckets.update
notification	list	buckets	storage.buckets.get
notification	watchbucket	buckets	storage.buckets.update
notification	stopchannel	buckets	storage.buckets.update
pap	get	buckets	storage.buckets.get
pap	set	Buckets	storage.buckets.get storage.buckets.update storage.buckets.setIamPolicy^10
perfdiag		Buckets	storage.buckets.get storage.objects.create storage.objects.delete storage.objects.list storage.objects.get
rb		buckets	storage.buckets.delete
requesterpays	get	buckets	storage.buckets.get
requesterpays	set on	buckets	storage.buckets.update
requesterpays	set off	Buckets	storage.buckets.update resourcemanager.projects.createBillingAssignment^9
retention	clear, event-default, lock ou set	buckets	storage.buckets.update
retention	event ou temp	Objetos	storage.objects.get storage.objects.list storage.objects.update
retention	get	Buckets	storage.buckets.get
rewrite -k		Objetos	storage.objects.list storage.objects.get storage.objects.create storage.objects.delete
rewrite -s		Objetos	storage.objects.list storage.objects.get storage.objects.create storage.objects.delete storage.objects.update
rm		Buckets	storage.buckets.delete storage.objects.delete storage.objects.list
rm		Objetos	storage.objects.delete storage.objects.list
rpo	get	buckets	storage.buckets.get
rpo	set	Buckets	storage.buckets.get storage.buckets.update
rsync		Objetos	storage.objects.get (para os objetos de origem e o bucket de destino) storage.objects.create (para o bucket de destino) storage.objects.delete^11 (para o bucket de destino) storage.objects.list (para os buckets de origem e destino)
rsync -n		Objetos	storage.objects.list (para os buckets de origem e destino)
setmeta		Objetos	storage.objects.get storage.objects.list storage.objects.update
signurl			Nenhum. No entanto, a conta de serviço cuja chave é usada como parte deste comando precisa ter permissão para executar a solicitação codificada no URL assinado.
stat		Objetos	storage.objects.get
test			Nenhum
ubla	set	buckets	storage.buckets.get storage.buckets.update
ubla	get	Buckets	storage.buckets.get
update			Nenhum
version			Nenhum
versioning	get	buckets	storage.buckets.get
versioning	set	buckets	storage.buckets.update
web	get	buckets	storage.buckets.get
web	set	Buckets	storage.buckets.update

¹Essa permissão só é obrigatória se o objeto composto tiver o mesmo nome que um objeto atual no bucket.

² Essa permissão é obrigatória somente quando o destino no comando contém um caminho de objeto.

³Essa permissão é obrigatória somente se você usa uploads compostos paralelos ou se não usa a sinalização -n, mas insere um objeto que tem o mesmo nome de um objeto que já existe no bucket.

⁴Essa permissão é obrigatória somente se você não tem uma conta de serviço do Cloud Storage associada ao projeto.

⁵Se você usa gsutil kms encryption -k e a conta de serviço do projeto não tem permissão para acessar a chave do Cloud KMS solicitada, a gsutil executará gsutil kms authorize para conceder à conta de serviço a permissão necessária.

⁶Essa permissão é obrigatória somente se você quiser incluir as políticas de IAM nos detalhes.

⁷Essa permissão é obrigatória somente se você quiser incluir as políticas de IAM nos detalhes e não se aplica a buckets com o acesso uniforme no nível do bucket ativado.

⁸Essas permissões não são obrigatórias se o tópico já existe e a conta de serviço relevante tem acesso a ele.

⁹Essa permissão só será obrigatória se você não incluir um projeto de faturamento na solicitação. Consulte Requisitos de uso e acesso dos pagamentos do solicitante para mais informações.

¹⁰Essa permissão não será necessária se o comando não alterar a configuração do bucket.

¹¹Essa permissão é obrigatória somente se você usar a sinalização -d ou se inserir um objeto com o mesmo nome de dados diferentes que Um objeto que já existe no bucket.

Observação: com as permissões listadas na tabela acima, é possível usar os comandos. Alguns comandos definem configurações de bucket que não funcionarão sem permissões extras. Por exemplo, para executar gsutil notification create, basta ter a permissão storage.buckets.update. No entanto, é necessário ter outras permissões para que o recurso funcione corretamente.

Métodos relacionados à ACL

A tabela a seguir lista as permissões de IAM necessárias para executar comandos gsutil que se aplicam especificamente ao gerenciamento de ACLs. Estes comandos se aplicam apenas a buckets com o acesso uniforme no nível do bucket desativado.

Comando	Subcomando	Recurso afetado	Permissões de IAM obrigatórias
acl	get	Buckets	storage.buckets.get storage.buckets.getIamPolicy
acl	set ou ch	Buckets	storage.buckets.get storage.buckets.getIamPolicy storage.buckets.setIamPolicy storage.buckets.update
acl	get	Objetos	storage.objects.get storage.objects.getIamPolicy
acl	set ou ch	Objetos	storage.objects.get storage.objects.getIamPolicy storage.objects.setIamPolicy storage.objects.update
cp -a ou cp -p		Objetos	storage.objects.list^a (para o bucket de destino) storage.objects.get (para os objetos de origem) storage.objects.create (para o bucket de destino) storage.objects.delete^b (para o bucket de destino) storage.objects.getIamPolicy (para os objetos de origem) storage.objects.setIamPolicy (para o bucket de destino)
defacl	get	Buckets	storage.buckets.get storage.buckets.getIamPolicy
defacl	set ou ch	Buckets	storage.buckets.get storage.buckets.getIamPolicy storage.buckets.setIamPolicy storage.buckets.update
iam	get	Objetos	storage.objects.get storage.objects.getIamPolicy
iam	set ou ch	Objetos	storage.objects.get storage.objects.getIamPolicy storage.objects.setIamPolicy storage.objects.update
mv -a ou mv -p		Objetos	storage.objects.list^a (para o bucket de destino) storage.objects.get (para os objetos de origem) storage.objects.create (para o bucket de destino) storage.objects.delete (para o bucket de origem) storage.objects.delete^b (para o bucket de destino) storage.objects.getIamPolicy (para os objetos de origem) storage.objects.setIamPolicy (para o bucket de destino)
rsync -a ou rsync -p		Objetos	storage.objects.get (para os objetos de origem e o bucket de destino) storage.objects.create (para o bucket de destino) storage.objects.delete^c (para o bucket de destino) storage.objects.list (para os buckets de origem e destino) storage.objects.getIamPolicy (para os objetos de origem) storage.objects.setIamPolicy (para o bucket de destino)

^a Essa permissão é obrigatória somente quando o destino no comando contém um caminho de objeto.

^bEssa permissão é obrigatória somente se você usa uploads compostos paralelos ou se não usa a sinalização -n, mas insere um objeto que tem o mesmo nome de um objeto que já existe no bucket.

^cEssa permissão é obrigatória somente se você usar a sinalização -d ou se inserir um objeto com o mesmo nome de dados diferentes, Um objeto que já existe no bucket.

Sinalização de nível superior -u

Se você usar a sinalização global -u para especificar um projeto que deverá ser faturado na solicitação, será necessário ter a permissão serviceusage.services.use no projeto especificado. A sinalização -u é usada, por exemplo, ao acessar um bucket com pagamentos do solicitante ativados.

Caracteres curinga e sinalizadores recursivos

Se você usar caracteres curinga de URI para selecionar vários objetos em um comando, será necessário ter a permissão storage.objects.list para o bucket que contém os objetos. Da mesma forma, se usar caracteres curinga de URI para selecionar vários buckets em um comando, será necessário ter a permissão storage.buckets.list nos projetos que contêm os buckets.

Se você usar as sinalizações recursivas (-r e -R), será necessário ter a permissão storage.objects.list no bucket pertinente, além das permissões obrigatórias do comando específico usado.

Sinalização de nível superior -m

Normalmente, ao executar um comando gsutil que afeta vários objetos ou buckets, esse comando falha no primeiro erro. No entanto, quando você usa a sinalização global -m, a gsutil registra todos os erros encontrados e continua a operação.

Por exemplo, você tenta executar um comando acl set em uma série de objetos, mas só tem permissão para fazer isso em alguns dos objetos. Se você não usar a sinalização -m, a gsutil aplicará as ACLs até alcançar um objeto sem permissão de aplicação de ACL. Nesse momento, a gsutil falhará. Se você usar a sinalização -m, a gsutil registrará os erros que surgirem quando tentar aplicar uma ACL a um objeto sem permissão, mas continuará a operação.

A seguir

• Atribua papéis do IAM no nível do projeto e do bucket.
• Consulte os papéis do IAM que contêm permissões do Cloud Storage.