backend_buckets

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

Overview

Name	backend_buckets
Type	Resource
Id	google.compute.backend_buckets

Fields

Name	Datatype	Description
id	string	[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.
description	string	An optional textual description of the resource; provided by the client when the resource is created.
bucketName	string	Cloud Storage bucket name.
cdnPolicy	object	Message containing Cloud CDN configuration for a backend bucket.
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.
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.
selfLink	string	[Output Only] Server-defined URL for the resource.
usedBy	array	[Output Only] List of resources referencing that backend bucket.

Methods

Name	Accessible by	Required Params	Description
get	SELECT	backendBucket, project	Returns the specified BackendBucket resource.
list	SELECT	project	Retrieves the list of BackendBucket resources available to the specified project.
insert	INSERT	project	Creates a BackendBucket resource in the specified project using the data included in the request.
delete	DELETE	backendBucket, project	Deletes the specified BackendBucket resource.
patch	UPDATE	backendBucket, project	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	backendBucket, project	Updates the specified BackendBucket resource with the data included in the request.
set_edge_security_policy	EXEC	backendBucket, project	Sets the edge security policy for the specified backend bucket.

SELECT examples

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

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

INSERT example

Use the following StackQL query and manifest file to create a new backend_buckets resource.

All Properties

/*+ create */
INSERT INTO google.compute.backend_buckets (
project,
name,
description,
bucketName,
enableCdn,
cdnPolicy,
customResponseHeaders,
edgeSecurityPolicy,
compressionMode,
usedBy
)
SELECT 
'{{ project }}',
'{{ name }}',
'{{ description }}',
'{{ bucketName }}',
{{ enableCdn }},
'{{ cdnPolicy }}',
'{{ customResponseHeaders }}',
'{{ edgeSecurityPolicy }}',
'{{ compressionMode }}',
'{{ usedBy }}'
;

Manifest

- name: your_resource_model_name
  props:
    - name: kind
      value: string
    - name: id
      value: string
    - name: creationTimestamp
      value: string
    - name: name
      value: string
    - name: description
      value: string
    - name: selfLink
      value: string
    - name: bucketName
      value: string
    - name: enableCdn
      value: boolean
    - name: cdnPolicy
      value:
        - name: signedUrlKeyNames
          value:
            - string
        - name: signedUrlCacheMaxAgeSec
          value: string
        - name: requestCoalescing
          value: boolean
        - name: cacheMode
          value: string
        - name: defaultTtl
          value: integer
        - name: maxTtl
          value: integer
        - name: clientTtl
          value: integer
        - name: negativeCaching
          value: boolean
        - name: negativeCachingPolicy
          value:
            - - name: code
                value: integer
              - name: ttl
                value: integer
        - name: bypassCacheOnRequestHeaders
          value:
            - - name: headerName
                value: string
        - name: serveWhileStale
          value: integer
        - name: cacheKeyPolicy
          value:
            - name: queryStringWhitelist
              value:
                - string
            - name: includeHttpHeaders
              value:
                - string
    - name: customResponseHeaders
      value:
        - string
    - name: edgeSecurityPolicy
      value: string
    - name: compressionMode
      value: string
    - name: usedBy
      value:
        - - name: reference
            value: string

UPDATE example

Updates a backend_buckets resource.

/*+ update */
UPDATE google.compute.backend_buckets
SET 
name = '{{ name }}',
description = '{{ description }}',
bucketName = '{{ bucketName }}',
enableCdn = true|false,
cdnPolicy = '{{ cdnPolicy }}',
customResponseHeaders = '{{ customResponseHeaders }}',
edgeSecurityPolicy = '{{ edgeSecurityPolicy }}',
compressionMode = '{{ compressionMode }}',
usedBy = '{{ usedBy }}'
WHERE 
backendBucket = '{{ backendBucket }}'
AND project = '{{ project }}';

REPLACE example

Replaces all fields in the specified backend_buckets resource.

/*+ update */
REPLACE google.compute.backend_buckets
SET 
name = '{{ name }}',
description = '{{ description }}',
bucketName = '{{ bucketName }}',
enableCdn = true|false,
cdnPolicy = '{{ cdnPolicy }}',
customResponseHeaders = '{{ customResponseHeaders }}',
edgeSecurityPolicy = '{{ edgeSecurityPolicy }}',
compressionMode = '{{ compressionMode }}',
usedBy = '{{ usedBy }}'
WHERE 
backendBucket = '{{ backendBucket }}'
AND project = '{{ project }}';

DELETE example

Deletes the specified backend_buckets resource.

/*+ delete */
DELETE FROM google.compute.backend_buckets
WHERE backendBucket = '{{ backendBucket }}'
AND project = '{{ project }}';