Resource: BackendBucket
Represents a Cloud Storage Bucket resource.
This Cloud Storage bucket resource is referenced by a URL map of a load balancer. For more information, read Backend Buckets.
JSON representation | |
---|---|
{ "id": string, "creationTimestamp": string, "name": string, "description": string, "selfLink": string, "bucketName": string, "enableCdn": boolean, "cdnPolicy": { "signedUrlKeyNames": [ string ], "signedUrlCacheMaxAgeSec": string, "cacheMode": enum, "defaultTtl": integer, "maxTtl": integer, "clientTtl": integer }, "customResponseHeaders": [ string ], "kind": string } |
Fields | |
---|---|
id |
[Output Only] Unique identifier for the resource; defined by the server. |
creationTimestamp |
[Output Only] Creation timestamp in RFC3339 text format. |
name |
Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression |
description |
An optional textual description of the resource; provided by the client when the resource is created. |
selfLink |
[Output Only] Server-defined URL for the resource. |
bucketName |
Cloud Storage bucket name. |
enableCdn |
If true, enable Cloud CDN for this |
cdnPolicy |
Cloud CDN configuration for this |
cdnPolicy.signedUrlKeyNames[] |
[Output Only] Names of the keys for signing request URLs. |
cdnPolicy.signedUrlCacheMaxAgeSec |
Maximum number of seconds the response to a signed URL request will be considered fresh. After this time period, the response will be revalidated before being served. Defaults to 1hr (3600s). When serving responses to signed URL requests, Cloud CDN will internally behave as though all responses from this backend had a |
cdnPolicy.cacheMode |
Specifies the cache setting for all responses from this backend. The possible values are: |
cdnPolicy.defaultTtl |
Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-max-age). Setting a TTL of "0" means "always revalidate". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to |
cdnPolicy.maxTtl |
Specifies the maximum allowed TTL for cached content served by this origin. Cache directives that attempt to set a max-age or s-maxage higher than this, or an Expires header more than maxTTL seconds in the future will be capped at the value of maxTTL, as if it were the value of an s-maxage Cache-Control directive. Headers sent to the client will not be modified. Setting a TTL of "0" means "always revalidate". The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL. |
cdnPolicy.clientTtl |
Specifies a separate client (e.g. browser client) TTL, separate from the TTL for Cloud CDN's edge caches. Leaving this empty will use the same cache TTL for both Cloud CDN and the client-facing response. The maximum allowed value is 86400s (1 day). |
customResponseHeaders[] |
Headers that the HTTP/S load balancer should add to proxied responses. |
kind |
Type of the resource. |
Methods |
|
---|---|
|
Adds a key for validating requests with signed URLs for this backend bucket. |
|
Deletes the specified BackendBucket resource. |
|
Deletes a key for validating requests with signed URLs for this backend bucket. |
|
Returns the specified BackendBucket resource. |
|
Creates a BackendBucket resource in the specified project using the data included in the request. |
|
Retrieves the list of BackendBucket resources available to the specified project. |
|
Updates the specified BackendBucket resource with the data included in the request. |
|
Updates the specified BackendBucket resource with the data included in the request. |