Default request referring to version v1 of the Cloud Storage JSON API. This contains the host and root path used as a starting point for constructing service requests.

View your data across Google Cloud Platform services

View and manage your data across Google Cloud Platform services

View your data in Google Cloud Storage

Manage your data in Google Cloud Storage

Manage your data and permissions in Google Cloud Storage

The owner of the object. This will always be the uploader of the object.

See: objectOwner smart constructor.

Creates a value of ObjectOwner with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• ooEntity
• ooEntityId

The entity, in the form user-userId.

The ID for the entity.

Set of properties to return. Defaults to noAcl, unless the object resource specifies the acl property, when it defaults to full.

The bucket's versioning configuration.

See: bucketVersioning smart constructor.

Creates a value of BucketVersioning with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• bvEnabled

While set to true, versioning is fully enabled for this bucket.

Apply a predefined set of default object access controls to this bucket.

Apply a predefined set of access controls to the destination object.

Apply a predefined set of access controls to this bucket.

A list of buckets.

See: buckets smart constructor.

Creates a value of Buckets with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• bNextPageToken
• bKind
• bItems

The continuation token, used to page through large result sets. Provide this value in a subsequent request to return the next page of results.

The kind of item this is. For lists of buckets, this is always storage#buckets.

The list of items.

The bucket's logging configuration, which defines the destination bucket and optional name prefix for the current bucket's logs.

See: bucketLogging smart constructor.

Creates a value of BucketLogging with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• blLogBucket
• blLogObjectPrefix

The destination bucket where the current bucket's logs should be placed.

A prefix for log object names.

User-provided metadata, in key/value pairs.

See: objectMetadata smart constructor.

Creates a value of ObjectMetadata with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• omAddtional

An individual metadata entry.

Apply a predefined set of access controls to this object.

The condition(s) under which the action will be taken.

See: bucketLifecycleRuleItemCondition smart constructor.

Creates a value of BucketLifecycleRuleItemCondition with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• blricAge
• blricIsLive
• blricNumNewerVersions
• blricCreatedBefore

Age of an object (in days). This condition is satisfied when an object reaches the specified age.

Relevant only for versioned objects. If the value is true, this condition matches live objects; if the value is false, it matches archived objects.

Relevant only for versioned objects. If the value is N, this condition is satisfied when there are at least N versions (including the live version) newer than this version of the object.

A date in RFC 3339 format with only the date part (for instance, "2013-01-15"). This condition is satisfied when an object is created before midnight of the specified date in UTC.

Apply a predefined set of access controls to the destination object.

The bucket's lifecycle configuration. See lifecycle management for more information.

See: bucketLifecycle smart constructor.

Creates a value of BucketLifecycle with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• blRule

A lifecycle management rule, which is made of an action to take and the condition(s) under which the action will be taken.

An notification channel used to watch for resource changes.

See: channel smart constructor.

Creates a value of Channel with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• cResourceURI
• cResourceId
• cKind
• cExpiration
• cToken
• cAddress
• cPayload
• cParams
• cId
• cType

A version-specific identifier for the watched resource.

An opaque ID that identifies the resource being watched on this channel. Stable across different API versions.

Identifies this as a notification channel used to watch for changes to a resource. Value: the fixed string "api#channel".

Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds. Optional.

An arbitrary string delivered to the target address with each notification delivered over this channel. Optional.

The address where notifications are delivered for this channel.

A Boolean value to indicate whether payload is wanted. Optional.

Additional parameters controlling delivery channel behavior. Optional.

A UUID or similar unique string that identifies this channel.

The type of delivery mechanism used for this channel.

Creates a value of BucketLifecycleRuleItem with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• blriAction
• blriCondition

The action to take.

The condition(s) under which the action will be taken.

Set of properties to return. Defaults to noAcl.

Creates a value of BucketCORSItem with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• bciMaxAgeSeconds
• bciOrigin
• bciResponseHeader
• bciMethod

The value, in seconds, to return in the Access-Control-Max-Age header used in preflight responses.

The list of Origins eligible to receive CORS response headers. Note: "*" is permitted in the list of origins, and means "any Origin".

The list of HTTP headers other than the simple response headers to give permission for the user-agent to share across domains.

The list of HTTP methods on which to include CORS response headers, (GET, OPTIONS, POST, etc) Note: "*" is permitted in the list of methods, and means "any method".

The project team associated with the entity, if any.

See: objectAccessControlProjectTeam smart constructor.

Creates a value of ObjectAccessControlProjectTeam with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• oacptProjectNumber
• oacptTeam

The project number.

The team. Can be owners, editors, or viewers.

A bucket.

See: bucket smart constructor.

Creates a value of Bucket with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• bucEtag
• bucLocation
• bucKind
• bucWebsite
• bucProjectNumber
• bucLifecycle
• bucOwner
• bucSelfLink
• bucName
• bucStorageClass
• bucVersioning
• bucCORS
• bucTimeCreated
• bucId
• bucUpdated
• bucDefaultObjectACL
• bucMetageneration
• bucLogging
• bucACL

HTTP 1.1 Entity tag for the bucket.

The location of the bucket. Object data for objects in the bucket resides in physical storage within this region. Defaults to US. See the developer's guide for the authoritative list.

The kind of item this is. For buckets, this is always storage#bucket.

The bucket's website configuration.

The project number of the project the bucket belongs to.

The bucket's lifecycle configuration. See lifecycle management for more information.

The owner of the bucket. This is always the project team's owner group.

The URI of this bucket.

The name of the bucket.

The bucket's storage class. This defines how objects in the bucket are stored and determines the SLA and the cost of storage. Values include STANDARD, NEARLINE and DURABLE_REDUCED_AVAILABILITY. Defaults to STANDARD. For more information, see storage classes.

The bucket's versioning configuration.

The bucket's Cross-Origin Resource Sharing (CORS) configuration.

The creation time of the bucket in RFC 3339 format.

The ID of the bucket.

The modification time of the bucket in RFC 3339 format.

Default access controls to apply to new objects when no ACL is provided.

The metadata generation of this bucket.

The bucket's logging configuration, which defines the destination bucket and optional name prefix for the current bucket's logs.

Access controls on the bucket.

Set of properties to return. Defaults to noAcl.

A list of objects.

See: objects smart constructor.

Creates a value of Objects with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• oNextPageToken
• oKind
• oItems
• oPrefixes

The continuation token, used to page through large result sets. Provide this value in a subsequent request to return the next page of results.

The kind of item this is. For lists of objects, this is always storage#objects.

The list of items.

The list of prefixes of objects matching-but-not-listed up to and including the requested delimiter.

Set of properties to return. Defaults to full.

An access-control list.

See: bucketAccessControls smart constructor.

Creates a value of BucketAccessControls with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• bacKind
• bacItems

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

The list of items.

Set of properties to return. Defaults to full.

A Compose request.

See: composeRequest smart constructor.

Creates a value of ComposeRequest with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• crDestination
• crKind
• crSourceObjects

Properties of the resulting object.

The kind of item this is.

The list of source objects that will be concatenated into a single object.

Apply a predefined set of access controls to this object.

Set of properties to return. Defaults to noAcl.

Apply a predefined set of default object access controls to this bucket.

Apply a predefined set of access controls to this bucket.

Apply a predefined set of access controls to the destination object.

Apply a predefined set of access controls to this object.

The owner of the bucket. This is always the project team's owner group.

See: bucketOwner smart constructor.

Creates a value of BucketOwner with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• boEntity
• boEntityId

The entity, in the form project-owner-projectId.

The ID for the entity.

Creates a value of ComposeRequestSourceObjectsItem with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• crsoiName
• crsoiObjectPreconditions
• crsoiGeneration

The source object's name. The source object's bucket is implicitly the destination bucket.

Conditions that must be met for this operation to execute.

The generation of this object to use as the source.

Set of properties to return. Defaults to noAcl, unless the bucket resource specifies acl or defaultObjectAcl properties, when it defaults to full.

Additional parameters controlling delivery channel behavior. Optional.

See: channelParams smart constructor.

Creates a value of ChannelParams with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• cpAddtional

Declares a new parameter by name.

Set of properties to return. Defaults to noAcl.

Set of properties to return. Defaults to full.

An object.

See: object' smart constructor.

Creates a value of Object with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• objEtag
• objSize
• objKind
• objTimeDeleted
• objCrc32c
• objBucket
• objOwner
• objSelfLink
• objMediaLink
• objComponentCount
• objName
• objStorageClass
• objContentEncoding
• objMetadata
• objTimeCreated
• objId
• objUpdated
• objContentLanguage
• objCacheControl
• objMetageneration
• objGeneration
• objACL
• objContentDisPosition
• objMD5Hash
• objContentType

HTTP 1.1 Entity tag for the object.

Content-Length of the data in bytes.

The kind of item this is. For objects, this is always storage#object.

The deletion time of the object in RFC 3339 format. Will be returned if and only if this version of the object has been deleted.

CRC32c checksum, as described in RFC 4960, Appendix B; encoded using base64 in big-endian byte order. For more information about using the CRC32c checksum, see Hashes and ETags: Best Practices.

The name of the bucket containing this object.

The owner of the object. This will always be the uploader of the object.

The link to this object.

Media download link.

Number of underlying components that make up this object. Components are accumulated by compose operations.

The name of this object. Required if not specified by URL parameter.

Storage class of the object.

Content-Encoding of the object data.

User-provided metadata, in key/value pairs.

The creation time of the object in RFC 3339 format.

The ID of the object.

The modification time of the object metadata in RFC 3339 format.

Content-Language of the object data.

Cache-Control directive for the object data.

The version of the metadata for this object at this generation. Used for preconditions and for detecting changes in metadata. A metageneration number is only meaningful in the context of a particular generation of a particular object.

The content generation of this object. Used for object versioning.

Access controls on the object.

Content-Disposition of the object data.

MD5 hash of the data; encoded using base64. For more information about using the MD5 hash, see Hashes and ETags: Best Practices.

Content-Type of the object data.

Set of properties to return. Defaults to full.

Conditions that must be met for this operation to execute.

See: composeRequestSourceObjectsItemObjectPreconditions smart constructor.

Creates a value of ComposeRequestSourceObjectsItemObjectPreconditions with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• crsoiopIfGenerationMatch

Only perform the composition if the generation of the source object that would be used matches this value. If this value and a generation are both specified, they must be the same value or the call will fail.

The project team associated with the entity, if any.

See: bucketAccessControlProjectTeam smart constructor.

Creates a value of BucketAccessControlProjectTeam with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• bacptProjectNumber
• bacptTeam

The project number.

The team. Can be owners, editors, or viewers.

An access-control list.

See: objectAccessControls smart constructor.

Creates a value of ObjectAccessControls with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• oacKind
• oacItems

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

The list of items.

The bucket's website configuration.

See: bucketWebsite smart constructor.

Creates a value of BucketWebsite with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• bwMainPageSuffix
• bwNotFoundPage

Behaves as the bucket's directory index where missing objects are treated as potential directories.

The custom object to return when a requested resource is not found.

An access-control entry.

See: bucketAccessControl smart constructor.

Creates a value of BucketAccessControl with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• bacaEmail
• bacaEtag
• bacaKind
• bacaDomain
• bacaBucket
• bacaRole
• bacaSelfLink
• bacaId
• bacaProjectTeam
• bacaEntity
• bacaEntityId

The email address associated with the entity, if any.

HTTP 1.1 Entity tag for the access-control entry.

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

The domain associated with the entity, if any.

The name of the bucket.

The access permission for the entity. Can be READER, WRITER, or OWNER.

The link to this access-control entry.

The ID of the access-control entry.

The project team associated with the entity, if any.

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.

The ID for the entity, if any.

The action to take.

See: bucketLifecycleRuleItemAction smart constructor.

Creates a value of BucketLifecycleRuleItemAction with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• blriaType

Type of the action. Currently, only Delete is supported.

Set of properties to return. Defaults to noAcl.

Apply a predefined set of default object access controls to this bucket.

Apply a predefined set of access controls to this bucket.

An access-control entry.

See: objectAccessControl smart constructor.

Creates a value of ObjectAccessControl with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• oacaEmail
• oacaEtag
• oacaKind
• oacaDomain
• oacaBucket
• oacaRole
• oacaSelfLink
• oacaObject
• oacaId
• oacaProjectTeam
• oacaEntity
• oacaGeneration
• oacaEntityId

The email address associated with the entity, if any.

HTTP 1.1 Entity tag for the access-control entry.

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