Grants default owner permission to files in the bucket.

Parameters¶ ↑

entity

The entity holding the permission, in one of the following forms: (String)

• user-userId

• user-email

• group-groupId

• group-email

• domain-domain

• project-team-projectId

• allUsers

• allAuthenticatedUsers

Examples¶ ↑

Access to a bucket can be granted to a user by appending +“user-”+ to the email address:

require "gcloud"

gcloud = Gcloud.new
storage = gcloud.storage

bucket = storage.bucket "my-bucket"

email = "heidi@example.net"
bucket.default_acl.add_owner "user-#{email}"

Access to a bucket can be granted to a group by appending +“group-”+ to the email address:

require "gcloud"

gcloud = Gcloud.new
storage = gcloud.storage

bucket = storage.bucket "my-bucket"

email = "authors@example.net"
bucket.default_acl.add_owner "group-#{email}"

Grants default reader permission to files in the bucket.

Parameters¶ ↑

entity

The entity holding the permission, in one of the following forms: (String)

• user-userId

• user-email

• group-groupId

• group-email

• domain-domain

• project-team-projectId

• allUsers

• allAuthenticatedUsers

Examples¶ ↑

Access to a bucket can be granted to a user by appending +“user-”+ to the email address:

require "gcloud"

gcloud = Gcloud.new
storage = gcloud.storage

bucket = storage.bucket "my-bucket"

email = "heidi@example.net"
bucket.default_acl.add_reader "user-#{email}"

Access to a bucket can be granted to a group by appending +“group-”+ to the email address:

require "gcloud"

gcloud = Gcloud.new
storage = gcloud.storage

bucket = storage.bucket "my-bucket"

email = "authors@example.net"
bucket.default_acl.add_reader "group-#{email}"

Grants default writer permission to files in the bucket.

Parameters¶ ↑

entity

The entity holding the permission, in one of the following forms: (String)

• user-userId

• user-email

• group-groupId

• group-email

• domain-domain

• project-team-projectId

• allUsers

• allAuthenticatedUsers

Examples¶ ↑

Access to a bucket can be granted to a user by appending +“user-”+ to the email address:

require "gcloud"

gcloud = Gcloud.new
storage = gcloud.storage

bucket = storage.bucket "my-bucket"

email = "heidi@example.net"
bucket.default_acl.add_writer "user-#{email}"

Access to a bucket can be granted to a group by appending +“group-”+ to the email address:

require "gcloud"

gcloud = Gcloud.new
storage = gcloud.storage

bucket = storage.bucket "my-bucket"

email = "authors@example.net"
bucket.default_acl.add_writer "group-#{email}"

Convenience method to apply the default authenticatedRead predefined ACL rule to files in the bucket.

Example¶ ↑

require "gcloud"

gcloud = Gcloud.new
storage = gcloud.storage

bucket = storage.bucket "my-bucket"

bucket.acl.auth!

Permenently deletes the entity from the bucket's default access control list for files.

Parameters¶ ↑

entity

The entity holding the permission, in one of the following forms: (String)

• user-userId

• user-email

• group-groupId

• group-email

• domain-domain

• project-team-projectId

• allUsers

• allAuthenticatedUsers

Example¶ ↑

require "gcloud"

gcloud = Gcloud.new
storage = gcloud.storage

bucket = storage.bucket "my-bucket"

email = "heidi@example.net"
bucket.default_acl.delete "user-#{email}"

Convenience method to apply the default bucketOwnerFullControl predefined ACL rule to files in the bucket.

Example¶ ↑

require "gcloud"

gcloud = Gcloud.new
storage = gcloud.storage

bucket = storage.bucket "my-bucket"

bucket.acl.owner_full!

Convenience method to apply the default bucketOwnerRead predefined ACL rule to files in the bucket.

Example¶ ↑

require "gcloud"

gcloud = Gcloud.new
storage = gcloud.storage

bucket = storage.bucket "my-bucket"

bucket.acl.owner_read!

Lists the default owners for files in the bucket.

Returns¶ ↑

Array of Strings

Example¶ ↑

require "gcloud"

gcloud = Gcloud.new
storage = gcloud.storage

bucket = storage.bucket "my-bucket"

bucket.default_acl.owners.each { |owner| puts owner }

Convenience method to apply the default private predefined ACL rule to files in the bucket.

Example¶ ↑

require "gcloud"

gcloud = Gcloud.new
storage = gcloud.storage

bucket = storage.bucket "my-bucket"

bucket.acl.private!

Convenience method to apply the default projectPrivate predefined ACL rule to files in the bucket.

Example¶ ↑

require "gcloud"

gcloud = Gcloud.new
storage = gcloud.storage

bucket = storage.bucket "my-bucket"

bucket.acl.project_private!

Convenience method to apply the default publicRead predefined ACL rule to files in the bucket.

Example¶ ↑

require "gcloud"

gcloud = Gcloud.new
storage = gcloud.storage

bucket = storage.bucket "my-bucket"

bucket.acl.public!

Lists the default readers for files in the bucket.

Returns¶ ↑

Array of Strings

Example¶ ↑

require "gcloud"

gcloud = Gcloud.new
storage = gcloud.storage

bucket = storage.bucket "my-bucket"

bucket.default_acl.readers.each { |reader| puts reader }

Reloads all Default Access Control List data for the bucket.

Example¶ ↑

require "gcloud"

gcloud = Gcloud.new
storage = gcloud.storage

bucket = storage.bucket "my-bucket"

bucket.default_acl.refresh!

Lists the default writers for files in the bucket.

Returns¶ ↑

Array of Strings

Example¶ ↑

require "gcloud"

gcloud = Gcloud.new
storage = gcloud.storage

bucket = storage.bucket "my-bucket"

bucket.default_acl.writers.each { |writer| puts writer }