backend_buckets

Creates, updates, deletes, gets or lists a backend_buckets resource.

Overview

Name	backend_buckets
Type	Resource
Id	google.compute.backend_buckets

Fields

The following fields are returned by SELECT queries:

get

Successful response

Name	Datatype	Description
id	string (uint64)	[Output Only] Unique identifier for the resource; defined by the server.
name	string	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 [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. (pattern: a-z?)
bucketName	string	Cloud Storage bucket name.
cdnPolicy	object	Cloud CDN configuration for this BackendBucket. (id: BackendBucketCdnPolicy)
compressionMode	string	Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header.
creationTimestamp	string	[Output Only] Creation timestamp in RFC3339 text format.
customResponseHeaders	array	Headers that the Application Load Balancer should add to proxied responses.
description	string	An optional textual description of the resource; provided by the client when the resource is created.
edgeSecurityPolicy	string	[Output Only] The resource URL for the edge security policy associated with this backend bucket.
enableCdn	boolean	If true, enable Cloud CDN for this BackendBucket.
kind	string	Type of the resource. (default: compute#backendBucket)
loadBalancingScheme	string	The value can only be INTERNAL_MANAGED for cross-region internal layer 7 load balancer. If loadBalancingScheme is not specified, the backend bucket can be used by classic global external load balancers, or global application external load balancers, or both.
params	object	Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload. (id: BackendBucketParams)
selfLink	string	[Output Only] Server-defined URL for the resource.
usedBy	array	[Output Only] List of resources referencing that backend bucket.

list

Successful response

Name	Datatype	Description
id	string	[Output Only] Unique identifier for the resource; defined by the server.
items	array	A list of BackendBucket resources.
kind	string	Type of resource. (default: compute#backendBucketList)
nextPageToken	string	[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
selfLink	string	[Output Only] Server-defined URL for this resource.
warning	object	[Output Only] Informational warning message.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	project, backendBucket		Returns the specified BackendBucket resource.
list	select	project	filter, maxResults, orderBy, pageToken, returnPartialSuccess	Retrieves the list of BackendBucket resources available to the specified project.
insert	insert	project	requestId	Creates a BackendBucket resource in the specified project using the data included in the request.
patch	update	project, backendBucket	requestId	Updates the specified BackendBucket resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
update	replace	project, backendBucket	requestId	Updates the specified BackendBucket resource with the data included in the request.
delete	delete	project, backendBucket	requestId	Deletes the specified BackendBucket resource.
add_signed_url_key	exec	project, backendBucket	requestId	Adds a key for validating requests with signed URLs for this backend bucket.
delete_signed_url_key	exec	project, backendBucket, keyName	requestId	Deletes a key for validating requests with signed URLs for this backend bucket.
set_edge_security_policy	exec	project, backendBucket	requestId	Sets the edge security policy for the specified backend bucket.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
backendBucket	string
keyName	string
project	string
filter	string
maxResults	integer (uint32)
orderBy	string
pageToken	string
requestId	string
returnPartialSuccess	boolean

SELECT examples

get

Returns the specified BackendBucket resource.

SELECT
id,
name,
bucketName,
cdnPolicy,
compressionMode,
creationTimestamp,
customResponseHeaders,
description,
edgeSecurityPolicy,
enableCdn,
kind,
loadBalancingScheme,
params,
selfLink,
usedBy
FROM google.compute.backend_buckets
WHERE project = '{{ project }}' -- required
AND backendBucket = '{{ backendBucket }}' -- required;

list

Retrieves the list of BackendBucket resources available to the specified project.

SELECT
id,
items,
kind,
nextPageToken,
selfLink,
warning
FROM google.compute.backend_buckets
WHERE project = '{{ project }}' -- required
AND filter = '{{ filter }}'
AND maxResults = '{{ maxResults }}'
AND orderBy = '{{ orderBy }}'
AND pageToken = '{{ pageToken }}'
AND returnPartialSuccess = '{{ returnPartialSuccess }}';

INSERT examples

insert

Creates a BackendBucket resource in the specified project using the data included in the request.

INSERT INTO google.compute.backend_buckets (
data__kind,
data__id,
data__creationTimestamp,
data__name,
data__description,
data__selfLink,
data__bucketName,
data__enableCdn,
data__cdnPolicy,
data__customResponseHeaders,
data__edgeSecurityPolicy,
data__compressionMode,
data__loadBalancingScheme,
data__params,
data__usedBy,
project,
requestId
)
SELECT 
'{{ kind }}',
'{{ id }}',
'{{ creationTimestamp }}',
'{{ name }}',
'{{ description }}',
'{{ selfLink }}',
'{{ bucketName }}',
{{ enableCdn }},
'{{ cdnPolicy }}',
'{{ customResponseHeaders }}',
'{{ edgeSecurityPolicy }}',
'{{ compressionMode }}',
'{{ loadBalancingScheme }}',
'{{ params }}',
'{{ usedBy }}',
'{{ project }}',
'{{ requestId }}'
RETURNING
id,
name,
clientOperationId,
creationTimestamp,
description,
endTime,
error,
httpErrorMessage,
httpErrorStatusCode,
insertTime,
instancesBulkInsertOperationMetadata,
kind,
operationGroupId,
operationType,
progress,
region,
selfLink,
setCommonInstanceMetadataOperationMetadata,
startTime,
status,
statusMessage,
targetId,
targetLink,
user,
warnings,
zone
;

Manifest

# Description fields are for documentation purposes
- name: backend_buckets
  props:
    - name: project
      value: string
      description: Required parameter for the backend_buckets resource.
    - name: kind
      value: string
      description: >
        Type of the resource.
        
      default: compute#backendBucket
    - name: id
      value: string
      description: >
        [Output Only] Unique identifier for the resource; defined by the server.
        
    - name: creationTimestamp
      value: string
      description: >
        [Output Only] Creation timestamp in RFC3339 text format.
        
    - name: name
      value: string
      description: >
        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 `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
        
    - name: description
      value: string
      description: >
        An optional textual description of the resource; provided by the client when the resource is created.
        
    - name: selfLink
      value: string
      description: >
        [Output Only] Server-defined URL for the resource.
        
    - name: bucketName
      value: string
      description: >
        Cloud Storage bucket name.
        
    - name: enableCdn
      value: boolean
      description: >
        If true, enable Cloud CDN for this BackendBucket.
        
    - name: cdnPolicy
      value: object
      description: >
        Cloud CDN configuration for this BackendBucket.
        
    - name: customResponseHeaders
      value: array
      description: >
        Headers that the Application Load Balancer should add to proxied responses.
        
    - name: edgeSecurityPolicy
      value: string
      description: >
        [Output Only] The resource URL for the edge security policy associated with this backend bucket.
        
    - name: compressionMode
      value: string
      description: >
        Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header.
        
      valid_values: ['AUTOMATIC', 'DISABLED']
    - name: loadBalancingScheme
      value: string
      description: >
        The value can only be INTERNAL_MANAGED for cross-region internal layer 7 load balancer. If loadBalancingScheme is not specified, the backend bucket can be used by classic global external load balancers, or global application external load balancers, or both.
        
      valid_values: ['INTERNAL_MANAGED']
    - name: params
      value: object
      description: >
        Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload.
        
    - name: usedBy
      value: array
      description: >
        [Output Only] List of resources referencing that backend bucket.
        
    - name: requestId
      value: string

UPDATE examples

patch

Updates the specified BackendBucket resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.

UPDATE google.compute.backend_buckets
SET 
data__kind = '{{ kind }}',
data__id = '{{ id }}',
data__creationTimestamp = '{{ creationTimestamp }}',
data__name = '{{ name }}',
data__description = '{{ description }}',
data__selfLink = '{{ selfLink }}',
data__bucketName = '{{ bucketName }}',
data__enableCdn = {{ enableCdn }},
data__cdnPolicy = '{{ cdnPolicy }}',
data__customResponseHeaders = '{{ customResponseHeaders }}',
data__edgeSecurityPolicy = '{{ edgeSecurityPolicy }}',
data__compressionMode = '{{ compressionMode }}',
data__loadBalancingScheme = '{{ loadBalancingScheme }}',
data__params = '{{ params }}',
data__usedBy = '{{ usedBy }}'
WHERE 
project = '{{ project }}' --required
AND backendBucket = '{{ backendBucket }}' --required
AND requestId = '{{ requestId}}'
RETURNING
id,
name,
clientOperationId,
creationTimestamp,
description,
endTime,
error,
httpErrorMessage,
httpErrorStatusCode,
insertTime,
instancesBulkInsertOperationMetadata,
kind,
operationGroupId,
operationType,
progress,
region,
selfLink,
setCommonInstanceMetadataOperationMetadata,
startTime,
status,
statusMessage,
targetId,
targetLink,
user,
warnings,
zone;

REPLACE examples

update

Updates the specified BackendBucket resource with the data included in the request.

REPLACE google.compute.backend_buckets
SET 
data__kind = '{{ kind }}',
data__id = '{{ id }}',
data__creationTimestamp = '{{ creationTimestamp }}',
data__name = '{{ name }}',
data__description = '{{ description }}',
data__selfLink = '{{ selfLink }}',
data__bucketName = '{{ bucketName }}',
data__enableCdn = {{ enableCdn }},
data__cdnPolicy = '{{ cdnPolicy }}',
data__customResponseHeaders = '{{ customResponseHeaders }}',
data__edgeSecurityPolicy = '{{ edgeSecurityPolicy }}',
data__compressionMode = '{{ compressionMode }}',
data__loadBalancingScheme = '{{ loadBalancingScheme }}',
data__params = '{{ params }}',
data__usedBy = '{{ usedBy }}'
WHERE 
project = '{{ project }}' --required
AND backendBucket = '{{ backendBucket }}' --required
AND requestId = '{{ requestId}}'
RETURNING
id,
name,
clientOperationId,
creationTimestamp,
description,
endTime,
error,
httpErrorMessage,
httpErrorStatusCode,
insertTime,
instancesBulkInsertOperationMetadata,
kind,
operationGroupId,
operationType,
progress,
region,
selfLink,
setCommonInstanceMetadataOperationMetadata,
startTime,
status,
statusMessage,
targetId,
targetLink,
user,
warnings,
zone;

DELETE examples

delete

Deletes the specified BackendBucket resource.

DELETE FROM google.compute.backend_buckets
WHERE project = '{{ project }}' --required
AND backendBucket = '{{ backendBucket }}' --required
AND requestId = '{{ requestId }}';

Lifecycle Methods

add_signed_url_key

Adds a key for validating requests with signed URLs for this backend bucket.

EXEC google.compute.backend_buckets.add_signed_url_key 
@project='{{ project }}' --required, 
@backendBucket='{{ backendBucket }}' --required, 
@requestId='{{ requestId }}' 
@@json=
'{
"keyName": "{{ keyName }}", 
"keyValue": "{{ keyValue }}"
}';

delete_signed_url_key

Deletes a key for validating requests with signed URLs for this backend bucket.

EXEC google.compute.backend_buckets.delete_signed_url_key 
@project='{{ project }}' --required, 
@backendBucket='{{ backendBucket }}' --required, 
@keyName='{{ keyName }}' --required, 
@requestId='{{ requestId }}';

set_edge_security_policy

Sets the edge security policy for the specified backend bucket.

EXEC google.compute.backend_buckets.set_edge_security_policy 
@project='{{ project }}' --required, 
@backendBucket='{{ backendBucket }}' --required, 
@requestId='{{ requestId }}' 
@@json=
'{
"securityPolicy": "{{ securityPolicy }}"
}';