pulumi-gcp-kotlin/com.pulumi.gcp.compute.kotlin/BackendBucketArgs

BackendBucketArgs

data class BackendBucketArgs(val bucketName: Output<String>? = null, val cdnPolicy: Output<BackendBucketCdnPolicyArgs>? = null, val compressionMode: Output<String>? = null, val customResponseHeaders: Output<List<String>>? = null, val description: Output<String>? = null, val edgeSecurityPolicy: Output<String>? = null, val enableCdn: Output<Boolean>? = null, val name: Output<String>? = null, val project: Output<String>? = null) : ConvertibleToJava<BackendBucketArgs>

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:

Example Usage

Backend Bucket Basic

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.storage.Bucket;
import com.pulumi.gcp.storage.BucketArgs;
import com.pulumi.gcp.compute.BackendBucket;
import com.pulumi.gcp.compute.BackendBucketArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var imageBucket = new Bucket("imageBucket", BucketArgs.builder()
            .location("EU")
            .build());
        var imageBackend = new BackendBucket("imageBackend", BackendBucketArgs.builder()
            .description("Contains beautiful images")
            .bucketName(imageBucket.name())
            .enableCdn(true)
            .build());
    }
}
Content copied to clipboard

Backend Bucket Security Policy

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.storage.Bucket;
import com.pulumi.gcp.storage.BucketArgs;
import com.pulumi.gcp.compute.SecurityPolicy;
import com.pulumi.gcp.compute.SecurityPolicyArgs;
import com.pulumi.gcp.compute.BackendBucket;
import com.pulumi.gcp.compute.BackendBucketArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var imageBackendBucket = new Bucket("imageBackendBucket", BucketArgs.builder()
            .location("EU")
            .build());
        var policy = new SecurityPolicy("policy", SecurityPolicyArgs.builder()
            .description("basic security policy")
            .type("CLOUD_ARMOR_EDGE")
            .build());
        var imageBackendBackendBucket = new BackendBucket("imageBackendBackendBucket", BackendBucketArgs.builder()
            .description("Contains beautiful images")
            .bucketName(imageBackendBucket.name())
            .enableCdn(true)
            .edgeSecurityPolicy(policy.id())
            .build());
    }
}
Content copied to clipboard

Backend Bucket Query String Whitelist

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.storage.Bucket;
import com.pulumi.gcp.storage.BucketArgs;
import com.pulumi.gcp.compute.BackendBucket;
import com.pulumi.gcp.compute.BackendBucketArgs;
import com.pulumi.gcp.compute.inputs.BackendBucketCdnPolicyArgs;
import com.pulumi.gcp.compute.inputs.BackendBucketCdnPolicyCacheKeyPolicyArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var imageBucket = new Bucket("imageBucket", BucketArgs.builder()
            .location("EU")
            .build());
        var imageBackend = new BackendBucket("imageBackend", BackendBucketArgs.builder()
            .description("Contains beautiful images")
            .bucketName(imageBucket.name())
            .enableCdn(true)
            .cdnPolicy(BackendBucketCdnPolicyArgs.builder()
                .cacheKeyPolicy(BackendBucketCdnPolicyCacheKeyPolicyArgs.builder()
                    .queryStringWhitelists("image-version")
                    .build())
                .build())
            .build());
    }
}
Content copied to clipboard

Backend Bucket Include Http Headers

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.storage.Bucket;
import com.pulumi.gcp.storage.BucketArgs;
import com.pulumi.gcp.compute.BackendBucket;
import com.pulumi.gcp.compute.BackendBucketArgs;
import com.pulumi.gcp.compute.inputs.BackendBucketCdnPolicyArgs;
import com.pulumi.gcp.compute.inputs.BackendBucketCdnPolicyCacheKeyPolicyArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var imageBucket = new Bucket("imageBucket", BucketArgs.builder()
            .location("EU")
            .build());
        var imageBackend = new BackendBucket("imageBackend", BackendBucketArgs.builder()
            .description("Contains beautiful images")
            .bucketName(imageBucket.name())
            .enableCdn(true)
            .cdnPolicy(BackendBucketCdnPolicyArgs.builder()
                .cacheKeyPolicy(BackendBucketCdnPolicyCacheKeyPolicyArgs.builder()
                    .includeHttpHeaders("X-My-Header-Field")
                    .build())
                .build())
            .build());
    }
}
Content copied to clipboard

Import

BackendBucket can be imported using any of these accepted formats

$ pulumi import gcp:compute/backendBucket:BackendBucket default projects/{{project}}/global/backendBuckets/{{name}}
Content copied to clipboard
$ pulumi import gcp:compute/backendBucket:BackendBucket default {{project}}/{{name}}
Content copied to clipboard
$ pulumi import gcp:compute/backendBucket:BackendBucket default {{name}}
Content copied to clipboard

Constructors

Link copied to clipboard
constructor(bucketName: Output<String>? = null, cdnPolicy: Output<BackendBucketCdnPolicyArgs>? = null, compressionMode: Output<String>? = null, customResponseHeaders: Output<List<String>>? = null, description: Output<String>? = null, edgeSecurityPolicy: Output<String>? = null, enableCdn: Output<Boolean>? = null, name: Output<String>? = null, project: Output<String>? = null)

Properties

Link copied to clipboard
val bucketName: Output<String>? = null

Cloud Storage bucket name.

Link copied to clipboard
val cdnPolicy: Output<BackendBucketCdnPolicyArgs>? = null

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

Link copied to clipboard
val compressionMode: Output<String>? = null

Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header. Possible values are: AUTOMATIC, DISABLED.

Link copied to clipboard
val customResponseHeaders: Output<List<String>>? = null

Headers that the HTTP/S load balancer should add to proxied responses.

Link copied to clipboard
val description: Output<String>? = null

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

Link copied to clipboard
val edgeSecurityPolicy: Output<String>? = null

The security policy associated with this backend bucket.

Link copied to clipboard
val enableCdn: Output<Boolean>? = null

If true, enable Cloud CDN for this BackendBucket.

Link copied to clipboard
val name: Output<String>? = null

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.

Link copied to clipboard
val project: Output<String>? = null

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

Functions

Link copied to clipboard
open override fun toJava(): BackendBucketArgs