Storage.object Access Controls.list

Retrieves ACL entries on the specified object.

GET/b/{bucket}/o/{object}/acl

Use it in a workflow

Add a step and choose the Google Cloud Storage connector.
Pick the Storage.object Access Controls.list action (under objectAccessControls).
Fill in the fields below, then reference the result from later steps as {{storageObjectAccessControlsList.response.data}}.

Request

Path parameters

bucketstringrequired

Name of a bucket.

objectstringrequired

Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.

Query parameters

altstring

Data format for the response.

One ofjson

fieldsstring

Selector specifying which fields to include in a partial response.

keystring

API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.

oauth_tokenstring

OAuth 2.0 token for the current user.

prettyPrintboolean

Returns response with indentations and line breaks.

quotaUserstring

An opaque string that represents a user for quota purposes. Must not exceed 40 characters.

uploadTypestring

Upload protocol for media (e.g. "media", "multipart", "resumable").

userIpstring

Deprecated. Please use quotaUser instead.

generationstring

If present, selects a specific revision of this object (as opposed to the latest version, the default).

userProjectstring

The project to be billed for this request. Required for Requester Pays buckets.

Response

Returns 200 with an object. Read it in later steps with {{storageObjectAccessControlsList.response.data.<field>}}.

itemsarray<object>

The list of items.

bucketstring

The name of the bucket.

domainstring

The domain associated with the entity, if any.

emailstring

The email address associated with the entity, if any.

entitystring

The entity holding the permission, in one of the following forms: - user-userId - user-email - group-groupId - group-email - domain-domain - project-team-projectId - allUsers - allAuthenticatedUsers Examples: - The user liz@example.com would be user-liz@example.com. - The group example@googlegroups.com would be group-example@googlegroups.com. - To refer to all members of the Google Apps for Business domain example.com, the entity would be domain-example.com.

entityIdstring

The ID for the entity, if any.

etagstring

HTTP 1.1 Entity tag for the access-control entry.

generationstring (int64)

The content generation of the object, if applied to an object.

idstring

The ID of the access-control entry.

kindstring

The kind of item this is. For object access control entries, this is always storage#objectAccessControl.

Default "storage#objectAccessControl"

objectstring

The name of the object, if applied to an object.

projectTeamobject2 fields

The project team associated with the entity, if any.

rolestring

The access permission for the entity.

selfLinkstring

The link to this access-control entry.

kindstring

The kind of item this is. For lists of object access control entries, this is always storage#objectAccessControls.

Default "storage#objectAccessControls"

json

{
  "items": [
    {
      "bucket": "string",
      "domain": "string",
      "email": "string",
      "entity": "string",
      "entityId": "string",
      "etag": "string",
      "generation": "string",
      "id": "string",
      "kind": "storage#objectAccessControl",
      "object": "string",
      "projectTeam": {
        "projectNumber": "string",
        "team": "string"
      },
      "role": "string"
    }
  ],
  "kind": "storage#objectAccessControls"
}

Need more? See the Google Cloud Storage guide for connection setup and behaviour shared by every action.

Was this page helpful?