younifyd
Menu

Storage.bucket Access Controls.list

Retrieves ACL entries on the specified bucket.

GET/b/{bucket}/acl

Use it in a workflow

  1. Add a step and choose the Google Cloud Storage connector.
  2. Pick the Storage.bucket Access Controls.list action (under bucketAccessControls).
  3. Fill in the fields below, then reference the result from later steps as {{storageBucketAccessControlsList.response.data}}.

Request

Path parameters

bucketstringrequired

Name of a bucket.

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.

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 {{storageBucketAccessControlsList.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.

idstring

The ID of the access-control entry.

kindstring

The kind of item this is. For bucket access control entries, this is always storage#bucketAccessControl.

Default "storage#bucketAccessControl"

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 bucket access control entries, this is always storage#bucketAccessControls.

Default "storage#bucketAccessControls"

json
{
  "items": [
    {
      "bucket": "string",
      "domain": "string",
      "email": "string",
      "entity": "string",
      "entityId": "string",
      "etag": "string",
      "id": "string",
      "kind": "storage#bucketAccessControl",
      "projectTeam": {
        "projectNumber": "string",
        "team": "string"
      },
      "role": "string",
      "selfLink": "string"
    }
  ],
  "kind": "storage#bucketAccessControls"
}

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