gcs_client.constants module

gcs_client.constants.ACL_AUTH_READ = 'authenticatedRead'

Project team/Object owners get OWNER access, and allAuthenticatedUsers get READER access.

gcs_client.constants.ACL_OWNER_FULL = 'bucketOwnerFullControl'

Object owner gets OWNER access, and project team owners get OWNER access.

gcs_client.constants.ACL_OWNER_READ = 'bucketOwnerRead'

Object owner gets OWNER access, and project team owners get READER access.

gcs_client.constants.ACL_PRIVATE = 'private'

Project team/Object owners get OWNER access.

gcs_client.constants.ACL_PROJECT_PRIVATE = 'projectPrivate'

Object owner gets OWNER access, and project team members get access according to their roles.

gcs_client.constants.ACL_PUBLIC_R = 'publicRead'

Project team owners get OWNER access, and allUsers get READER access.

gcs_client.constants.ACL_PUBLIC_RW = 'publicRead'

Project team/Object owners get OWNER access, and allUsers get WRITER access.

gcs_client.constants.PROJECTION_FULL = 'full'

Full projection: Include all properties....

gcs_client.constants.PROJECTION_SIMPLE = 'noAcl'

Simple projection: Exclude the ACL property.

gcs_client.constants.SCOPE_CLOUD = 'CLOUD'

Cloud permissions: For buckets, they have the predefined project-private ACL applied when they are created. Buckets are always owned by the project-owners group. For objects, they have the predefined project-private ACL applied when they are uploaded. Objects are always owned by the original requester who uploaded the object.

gcs_client.constants.SCOPE_OWNER = 'OWNER'

Owner permissions: For buckets gives a user READER and WRITER permissions on the bucket. It also lets a user read and write bucket metadata, including ACLs. For objects, gives a user READER access. It also lets a user read and write object metadata, including ACLs.

gcs_client.constants.SCOPE_READER = 'READER'

Reader permissions lets a user download an object’s data and list a bucket’s contents.

gcs_client.constants.SCOPE_WRITER = 'WRITER'

Writer permissions: For buckets lets a user list, create, overwrite, and delete objects in a bucket. You cannot apply this permission to objects.

gcs_client.constants.STORAGE_DURABLE = 'DURABLE_REDUCED_AVAILABILITY'

Durable Reduced Availability (DRA) class: Lower availability than Standard Storage and lower cost per GB stored. Use cases: Applications that are particularly cost-sensitive, or for which some unavailability is acceptable such as batch jobs and some types of data backup.

gcs_client.constants.STORAGE_NEARLINE = 'NEARLINE'

Cloud Storage Nearline class: Slightly lower availability and slightly higher latency (time to first byte is typically 2 - 5 seconds) than Standard Storage but with a lower cost. Use cases: Data you do not expect to access frequently (i.e., no more than once per month). Typically this is backup data for disaster recovery, or so called “cold” storage that is archived and may or may not be needed at some future time.

gcs_client.constants.STORAGE_STANDARD = 'STANDARD'

Standard Storage class: High availability, low latency (time to first byte is typically tens of milliseconds). Use cases: Storing data that requires low latency access or data that is frequently accessed (“hot” objects), such as serving website content, interactive workloads, or gaming and mobile applications.