Autorisations IAM pour les commandes gcloud storage

Le tableau suivant recense les autorisations IAM (Identity and Access Management) requises pour exécuter les commandes gcloud storage. Les autorisations IAM sont regroupées pour constituer des rôles, qui sont attribués aux comptes principaux.

Reportez-vous aux sections situées sous le tableau pour plus d'informations sur l'utilisation des caractères génériques et des flags --recursive et --billing-project.

Commande	Flag	Autorisations IAM requises
batch-operations jobs create		storagebatchoperations.jobs.create
batch-operations jobs cancel		storagebatchoperations.jobs.cancel
batch-operations jobs delete		storagebatchoperations.jobs.delete
batch-operations jobs get		storagebatchoperations.jobs.get
batch-operations jobs list		storagebatchoperations.jobs.list
buckets add-iam-policy-binding		storage.buckets.get storage.buckets.getIamPolicy storage.buckets.setIamPolicy storage.buckets.update
buckets anywhere-caches create		storage.anywhereCaches.create
buckets anywhere-caches describe		storage.anywhereCaches.get
buckets anywhere-caches list		storage.anywhereCaches.list
buckets anywhere-caches update		storage.anywhereCaches.update
buckets anywhere-caches pause		storage.anywhereCaches.pause
buckets anywhere-caches resume		storage.anywhereCaches.resume
buckets anywhere-caches disable		storage.anywhereCaches.disable
buckets create		storage.buckets.create storage.buckets.setIpFilter^15
buckets delete		storage.buckets.delete
buckets describe		storage.buckets.get storage.buckets.getIamPolicy^1 storage.buckets.getIpFilter^16
buckets get-iam-policy		storage.buckets.get storage.buckets.getIamPolicy
buckets list		storage.buckets.list storage.buckets.getIamPolicy^1
buckets notifications create		storage.buckets.get storage.buckets.update pubsub.topics.get (pour le projet contenant le sujet Pub/Sub) pubsub.topics.create^3 (pour le projet contenant le sujet Pub/Sub) pubsub.topics.getIamPolicy (pour le projet contenant le sujet Pub/Sub) pubsub.topics.setIamPolicy^3 (pour le projet contenant le sujet Pub/Sub)
buckets notifications create	--skip-topic-setup	storage.buckets.get storage.buckets.update
buckets notifications delete		storage.buckets.get storage.buckets.update
buckets notifications describe		storage.buckets.get
buckets notifications list		storage.buckets.get
buckets relocate		storage.buckets.relocate
buckets remove-iam-policy-binding		storage.buckets.get storage.buckets.getIamPolicy storage.buckets.setIamPolicy storage.buckets.update
buckets set-iam-policy		storage.buckets.setIamPolicy storage.buckets.update
buckets update		storage.buckets.update storage.buckets.setIpFilter^15
buckets update	--no-requester-pays	storage.buckets.update resourcemanager.projects.createBillingAssignment^2
buckets update	--recovery-point-objective --rpo --[no-]uniform-bucket-level-access	storage.buckets.get storage.buckets.update
buckets update	--clear-pap --clear-public-access-prevention --[no-]pap --[no-]public-access-prevention	storage.buckets.get storage.buckets.update storage.buckets.setIamPolicy
cat		storage.objects.get storage.objects.list^13
cp		storage.objects.get (pour les objets sources) storage.objects.create (pour le bucket de destination) storage.objects.list^4 (pour le bucket de destination) storage.objects.delete^5 (pour le bucket de destination) storage.buckets.get^12 (pour le bucket de destination)
du		storage.objects.list
folders create		storage.folders.create
folders delete		storage.folders.delete
folders describe		storage.folders.get
folders list		storage.folders.list
folders rename		storage.folders.rename (pour le bucket source) storage.folders.create (pour le bucket de destination)
hash		storage.objects.get
hmac create		storage.hmacKeys.create
hmac delete		storage.hmacKeys.delete
hmac describe		storage.hmacKeys.get
hmac list		storage.hmacKeys.list
hmac update		storage.hmacKeys.update
insights dataset-configs create		storageinsights.datasetConfigs.create
insights dataset-configs create-link		storageinsights.datasetConfigs.linkDataset
insights dataset-configs delete		storageinsights.datasetConfigs.delete
insights dataset-configs delete-link		storageinsights.datasetConfigs.unlinkDataset
insights dataset-configs describe		storageinsights.datasetConfigs.get
insights dataset-configs list		storageinsights.datasetConfigs.list
insights dataset-configs update		storageinsights.datasetConfigs.update
insights inventory-reports create		storageinsights.reportConfigs.create
insights inventory-reports delete		storageinsights.reportConfigs.delete
insights inventory-reports details list		storageinsights.reportDetails.list
insights inventory-reports details describe		storageinsights.reportDetails.get
insights inventory-reports list		storageinsights.reportConfigs.list
insights inventory-reports update		storageinsights.reportConfigs.get storageinsights.reportConfigs.update
ls (pour la liste des buckets)		storage.buckets.list storage.buckets.getIamPolicy^6
ls (pour la création de listes d'objets)		storage.objects.get^7 storage.objects.list storage.objects.getIamPolicy^8
ls	--buckets	storage.buckets.get storage.buckets.getIamPolicy^6
storage intelligence-config enable		storage.intelligenceConfigs.update
storage-intelligence disable		storage.intelligenceConfigs.update
storage-intelligence describe		storage.intelligenceConfigs.get
storage-intelligence update		storage.intelligenceConfigs.update
mv		storage.objects.get (pour les objets sources) storage.objects.delete (pour le bucket source) storage.objects.create (pour le bucket de destination) storage.objects.list^4 (pour le bucket de destination) storage.objects.delete^5 (pour le bucket de destination) storage.buckets.get^12 (pour le bucket de destination)
objects compose		storage.objects.get storage.objects.create storage.objects.delete^9
objects describe		storage.objects.get storage.objects.getIamPolicy^8
objects list		storage.objects.list storage.objects.getIamPolicy^8
objects update		storage.objects.get storage.objects.list storage.objects.update
objects update	--storage-class --encryption-key --clear-encryption-key	storage.objects.get storage.objects.list storage.objects.create storage.objects.delete
objects update	--retention-mode --retain-until --clear-retention	storage.objects.get storage.objects.list storage.objects.update storage.objects.setRetention storage.objects.overrideUnlockedRetention^11
operations cancel		storage.bucketOperations.cancel
operations describe		storage.bucketOperations.get
operations list		storage.bucketOperations.list
restore		storage.objects.create storage.objects.delete^9 storage.objects.restore
restore	--async	storage.objects.create storage.objects.delete^14 storage.objects.restore storage.buckets.restore
rm		storage.buckets.delete storage.objects.delete storage.objects.list
rsync		storage.objects.list (pour le bucket source) storage.objects.get (pour les objets sources) storage.objects.list (pour le bucket de destination) storage.objects.get (pour le bucket de destination) storage.objects.create (pour le bucket de destination) storage.objects.delete^10 (pour le bucket de destination) storage.buckets.get^12 (pour le bucket de destination)
rsync	--dry-run	storage.objects.list (pour les buckets sources et de destination)
service-agent		resourceManager.projects.get
sign-url		Aucune. Toutefois, le compte de service dont la clé est utilisée au sein de cette commande doit être autorisé à effectuer la requête en cours d'encodage dans l'URL signée.

¹ Cette autorisation n'est requise que si vous souhaitez que les stratégies IAM soient incluses dans les détails.

² Cette autorisation n'est requise que si vous n'incluez pas de projet de facturation dans votre requête. Pour plus d'informations, consultez Exigences relatives à l'utilisation et aux accès sur la page "Paiements du demandeur".

³ Ces autorisations ne sont pas requises si le sujet existe déjà et que le compte de service approprié y a accès.

⁴ Cette autorisation n'est requise que lorsque la destination dans la commande contient un chemin d'accès à un objet.

⁵ Cette autorisation n'est requise que si vous utilisez des importations composites parallèles ou si vous n'utilisez pas le flag --no-clobber, mais que vous insérez un objet qui porte le même nom qu'un objet déjà présent dans le bucket.

⁶ Cette autorisation n'est requise que si vous souhaitez que les stratégies IAM soient incluses dans les détails.

⁷ Cette autorisation n'est requise que si vous utilisez le flag --fetch-encrypted-object-hashes.

⁸ Cette autorisation n'est requise que si vous souhaitez que les stratégies IAM soient incluses dans les détails. Elle ne s'applique pas aux buckets pour lesquels l'accès uniforme au niveau du bucket est activé.

⁹ Cette autorisation n'est requise que si l'opération crée un objet portant le même nom qu'un objet présent dans le bucket.

¹⁰ Cette autorisation n'est requise que si vous utilisez le flag --delete-unmatched-destination-objects ou si vous insérez un objet portant le même nom qu'un objet qui existe déjà dans le bucket, mais qui comporte des données différentes.

¹¹ Cette autorisation n'est requise que si la requête nécessite également l'utilisation du flag --override-unlocked-retention.

¹² Cette autorisation est requise pour effectuer des importations composites parallèles si la propriété storage/parallel_composite_upload_compatibility_check de la gcloud CLI est définie sur True.

¹³ Cette autorisation n'est requise que si vous souhaitez utiliser des expressions régulières pour récupérer des objets.

¹⁴ Cette autorisation n'est requise que si la requête inclut le flag --allow-overwrite et que l'opération crée un objet portant le même nom qu'un objet présent dans le bucket.

¹⁵ Cette autorisation n'est requise que si la requête inclut le flag --ip-filter-file pour créer, modifier ou supprimer les règles de filtrage par adresse IP sur un bucket.

¹⁶ Cette autorisation n'est requise que si vous souhaitez obtenir la configuration de filtrage par adresse IP du bucket dans la réponse.

Remarque : Les autorisations listées dans le tableau ci-dessus vous permettent d'utiliser les commandes. Certaines de ces commandes définissent des configurations de bucket qui ne fonctionneront pas sans autorisations supplémentaires. Par exemple, pour utiliser la commande buckets notification create, seules les autorisations storage.buckets.get et storage.buckets.update sont requises, mais vous devez disposer d'autorisations supplémentaires pour qu'elle fonctionne correctement.

Flag de niveau supérieur --billing-project

Si vous utilisez le flag global --billing-project pour spécifier un projet qui doit être facturé pour votre requête, vous devez disposer de l'autorisation serviceusage.services.use pour le projet que vous spécifiez. Le flag --billing-project est utilisé, par exemple, lors de l'accès à un bucket avec l'option Paiements du demandeur activée.

Caractères génériques et flags récursifs

Si vous utilisez des caractères génériques d'URI pour sélectionner plusieurs objets dans une commande, vous devez disposer d'une autorisation storage.objects.list pour le bucket contenant les objets. De même, si vous utilisez des caractères génériques d'URI pour sélectionner plusieurs buckets dans une commande, vous devez disposer d'une autorisation storage.buckets.list pour le ou les projets contenant les buckets.

Si vous utilisez le flag --recursive, vous devez disposer de l'autorisation storage.objects.list pour le bucket concerné, en plus des autorisations requises pour la commande spécifique que vous utilisez.

Étapes suivantes

• Attribuez des rôles IAM au niveau du projet et du bucket.
• Consultez la page Rôles IAM contenant des autorisations Cloud Storage.