Class BackendBucket

Backend buckets allow you to use Google Cloud Storage buckets with HTTP(S) load balancing.

An HTTP(S) load balancer can direct traffic to specified URLs to a backend bucket rather than a backend service. It can send requests for static content to a Cloud Storage bucket and requests for dynamic content to a virtual machine instance.

To get more information about BackendBucket, see:

• API documentation
• How-to Guides
• Using a Cloud Storage bucket as a load balancer backend

Example Usage - Backend Bucket Basic

using Pulumi;
using Gcp = Pulumi.Gcp;

class MyStack : Stack
{
public MyStack()
{
    var imageBucket = new Gcp.Storage.Bucket("imageBucket", new Gcp.Storage.BucketArgs
    {
        Location = "EU",
    });
    var imageBackend = new Gcp.Compute.BackendBucket("imageBackend", new Gcp.Compute.BackendBucketArgs
    {
        Description = "Contains beautiful images",
        BucketName = imageBucket.Name,
        EnableCdn = true,
    });
}

}

Inheritance

System.Object

Resource

CustomResource

BackendBucket

Inherited Members

CustomResource.Id

Resource.GetResourceType()

Resource.GetResourceName()

Resource.Urn

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.ToString()

Namespace: Pulumi.Gcp.Compute

Assembly: Pulumi.Gcp.dll

Syntax

public class BackendBucket : CustomResource

Constructors

BackendBucket(String, BackendBucketArgs, CustomResourceOptions)

Create a BackendBucket resource with the given unique name, arguments, and options.

Declaration

public BackendBucket(string name, BackendBucketArgs args, CustomResourceOptions options = null)

Parameters

Type	Name	Description
System.String	name	The unique name of the resource
BackendBucketArgs	args	The arguments used to populate this resource's properties
CustomResourceOptions	options	A bag of options that control this resource's behavior

Properties

BucketName

Cloud Storage bucket name.

Declaration

public Output<string> BucketName { get; }

Property Value

Type	Description
Output<System.String>

CdnPolicy

Cloud CDN configuration for this Backend Bucket. Structure is documented below.

Declaration

public Output<BackendBucketCdnPolicy> CdnPolicy { get; }

Property Value

Type	Description
Output<BackendBucketCdnPolicy>

CreationTimestamp

Creation timestamp in RFC3339 text format.

Declaration

public Output<string> CreationTimestamp { get; }

Property Value

Type	Description
Output<System.String>

Description

An optional textual description of the resource; provided by the client when the resource is created.

Declaration

public Output<string> Description { get; }

Property Value

Type	Description
Output<System.String>

EnableCdn

If true, enable Cloud CDN for this BackendBucket.

Declaration

public Output<bool?> EnableCdn { get; }

Property Value

Type	Description
Output<System.Nullable<System.Boolean>>

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 a-z? 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.

Declaration

public Output<string> Name { get; }

Property Value

Type	Description
Output<System.String>

Project

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

Declaration

public Output<string> Project { get; }

Property Value

Type	Description
Output<System.String>

SelfLink

The URI of the created resource.

Declaration

public Output<string> SelfLink { get; }

Property Value

Type	Description
Output<System.String>

Methods

Get(String, Input<String>, BackendBucketState, CustomResourceOptions)

Get an existing BackendBucket resource's state with the given name, ID, and optional extra properties used to qualify the lookup.

Declaration

public static BackendBucket Get(string name, Input<string> id, BackendBucketState state = null, CustomResourceOptions options = null)

Parameters

Type	Name	Description
System.String	name	The unique name of the resulting resource.
Input<System.String>	id	The unique provider ID of the resource to lookup.
BackendBucketState	state	Any extra arguments used during the lookup.
CustomResourceOptions	options	A bag of options that control this resource's behavior

Returns

Type	Description
BackendBucket