gcloud storage batch-operations jobs create accepts --set-object-acls-from-file

Introduced 2026-06-02 · score 0.95

HOW TO USE IT

When creating a batch job to update object ACLs, provide a local YAML or JSON ACL updates file with `--set-object-acls-from-file`. Specify a job ID, object source, and exactly one transformation; the source may be bucket based or project based.

WHY THIS HELPS

When creating a Cloud Storage batch-operation job that sets object ACLs from a file, provide that file to the create command.

REQUIREMENTS AND LIMITATIONS

• <job-id> (required): Batch job ID or fully qualified identifier.
• --bucket (required): Bucket containing target objects; select exactly one of --bucket or --bucket-list for a bucket source.
• --manifest-location (required): Absolute gs:// path to a CSV manifest; choose this or --included-object-prefixes for a bucket source.
• --set-object-acls-from-file (required): Path to a local YAML or JSON file containing object ACL updates; provide exactly one transformation option.
• grants[].entity: Entity receiving an ACL grant; each entry pairs an entity and role.
• grants[].role: Role assigned to the corresponding entity.
• grants[].remove_entities: Entities whose ACL grants are removed.
• Prerequisite: The ACL updates input must be a local YAML or JSON file. The bucket manifest, if used, must be a CSV in Cloud Storage with ProjectId, BucketId, and Name per row; generation is optional.

FIRST-PARTY EVIDENCE

• https://docs.cloud.google.com/sdk/docs/release-notes#57100_2026-06-02
• https://docs.cloud.google.com/sdk/gcloud/reference/storage/batch-operations/jobs/create

Check the installed version and the source before using it. Entry JSON

Report a problem with this card