1. Packages
  2. Google Cloud (GCP) Classic
  3. API Docs
  4. compute
  5. RegionBackendBucket
Viewing docs for Google Cloud v9.15.0
published on Thursday, Mar 12, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-gcp

gcp.compute.RegionBackendBucket

gcp logo
Viewing docs for Google Cloud v9.15.0
published on Thursday, Mar 12, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-gcp

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

    A regional 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.

    Regional backend buckets are used with:

    • Regional internal Application Load Balancers
    • Regional external Application Load Balancers

    Note: Regional backend buckets have important limitations:

    • Cloud CDN cannot be enabled
    • Only public buckets are supported (private bucket access is not available)
    • Only GET requests are supported
    • The bucket must be in the same region as the load balancer
    • Single-region buckets only (multi-region and dual-region buckets are not supported)

    To get more information about RegionBackendBucket, see:

    Example Usage

    Region Backend Bucket Basic

    import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";

const imageBackendBucket = new gcp.storage.Bucket("image_backend", {
    name: "region-image-store-bucket",
    location: "US-CENTRAL1",
    forceDestroy: true,
    uniformBucketLevelAccess: true,
});
const imageBackend = new gcp.compute.RegionBackendBucket("image_backend", {
    name: "region-image-backend-bucket",
    region: "us-central1",
    bucketName: imageBackendBucket.name,
    description: "Regional backend bucket example",
    loadBalancingScheme: "INTERNAL_MANAGED",
});

    import pulumi
import pulumi_gcp as gcp

image_backend_bucket = gcp.storage.Bucket("image_backend",
    name="region-image-store-bucket",
    location="US-CENTRAL1",
    force_destroy=True,
    uniform_bucket_level_access=True)
image_backend = gcp.compute.RegionBackendBucket("image_backend",
    name="region-image-backend-bucket",
    region="us-central1",
    bucket_name=image_backend_bucket.name,
    description="Regional backend bucket example",
    load_balancing_scheme="INTERNAL_MANAGED")

    package main

import (
	"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/compute"
	"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/storage"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		imageBackendBucket, err := storage.NewBucket(ctx, "image_backend", &storage.BucketArgs{
			Name:                     pulumi.String("region-image-store-bucket"),
			Location:                 pulumi.String("US-CENTRAL1"),
			ForceDestroy:             pulumi.Bool(true),
			UniformBucketLevelAccess: pulumi.Bool(true),
		})
		if err != nil {
			return err
		}
		_, err = compute.NewRegionBackendBucket(ctx, "image_backend", &compute.RegionBackendBucketArgs{
			Name:                pulumi.String("region-image-backend-bucket"),
			Region:              pulumi.String("us-central1"),
			BucketName:          imageBackendBucket.Name,
			Description:         pulumi.String("Regional backend bucket example"),
			LoadBalancingScheme: pulumi.String("INTERNAL_MANAGED"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;

return await Deployment.RunAsync(() => 
{
    var imageBackendBucket = new Gcp.Storage.Bucket("image_backend", new()
    {
        Name = "region-image-store-bucket",
        Location = "US-CENTRAL1",
        ForceDestroy = true,
        UniformBucketLevelAccess = true,
    });

    var imageBackend = new Gcp.Compute.RegionBackendBucket("image_backend", new()
    {
        Name = "region-image-backend-bucket",
        Region = "us-central1",
        BucketName = imageBackendBucket.Name,
        Description = "Regional backend bucket example",
        LoadBalancingScheme = "INTERNAL_MANAGED",
    });

});

    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.RegionBackendBucket;
import com.pulumi.gcp.compute.RegionBackendBucketArgs;
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()
            .name("region-image-store-bucket")
            .location("US-CENTRAL1")
            .forceDestroy(true)
            .uniformBucketLevelAccess(true)
            .build());

        var imageBackend = new RegionBackendBucket("imageBackend", RegionBackendBucketArgs.builder()
            .name("region-image-backend-bucket")
            .region("us-central1")
            .bucketName(imageBackendBucket.name())
            .description("Regional backend bucket example")
            .loadBalancingScheme("INTERNAL_MANAGED")
            .build());

    }
}

    resources:
  imageBackend:
    type: gcp:compute:RegionBackendBucket
    name: image_backend
    properties:
      name: region-image-backend-bucket
      region: us-central1
      bucketName: ${imageBackendBucket.name}
      description: Regional backend bucket example
      loadBalancingScheme: INTERNAL_MANAGED
  imageBackendBucket:
    type: gcp:storage:Bucket
    name: image_backend
    properties:
      name: region-image-store-bucket
      location: US-CENTRAL1
      forceDestroy: true
      uniformBucketLevelAccess: true

    Region Backend Bucket Internal Lb

    import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";

const internalBackendBucket = new gcp.storage.Bucket("internal_backend", {
    name: "regional-internal-bucket",
    location: "US-CENTRAL1",
    forceDestroy: true,
    uniformBucketLevelAccess: true,
    website: {
        mainPageSuffix: "index.html",
        notFoundPage: "404.html",
    },
});
const internalBackend = new gcp.compute.RegionBackendBucket("internal_backend", {
    name: "regional-internal-backend",
    region: "us-central1",
    bucketName: internalBackendBucket.name,
    loadBalancingScheme: "INTERNAL_MANAGED",
    description: "Regional internal backend bucket for static content",
});
const index = new gcp.storage.BucketObject("index", {
    name: "index.html",
    bucket: internalBackendBucket.name,
    content: "<html><body><h1>Regional Internal LB Backend Bucket</h1></body></html>",
});

    import pulumi
import pulumi_gcp as gcp

internal_backend_bucket = gcp.storage.Bucket("internal_backend",
    name="regional-internal-bucket",
    location="US-CENTRAL1",
    force_destroy=True,
    uniform_bucket_level_access=True,
    website={
        "main_page_suffix": "index.html",
        "not_found_page": "404.html",
    })
internal_backend = gcp.compute.RegionBackendBucket("internal_backend",
    name="regional-internal-backend",
    region="us-central1",
    bucket_name=internal_backend_bucket.name,
    load_balancing_scheme="INTERNAL_MANAGED",
    description="Regional internal backend bucket for static content")
index = gcp.storage.BucketObject("index",
    name="index.html",
    bucket=internal_backend_bucket.name,
    content="<html><body><h1>Regional Internal LB Backend Bucket</h1></body></html>")

    package main

import (
	"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/compute"
	"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/storage"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		internalBackendBucket, err := storage.NewBucket(ctx, "internal_backend", &storage.BucketArgs{
			Name:                     pulumi.String("regional-internal-bucket"),
			Location:                 pulumi.String("US-CENTRAL1"),
			ForceDestroy:             pulumi.Bool(true),
			UniformBucketLevelAccess: pulumi.Bool(true),
			Website: &storage.BucketWebsiteArgs{
				MainPageSuffix: pulumi.String("index.html"),
				NotFoundPage:   pulumi.String("404.html"),
			},
		})
		if err != nil {
			return err
		}
		_, err = compute.NewRegionBackendBucket(ctx, "internal_backend", &compute.RegionBackendBucketArgs{
			Name:                pulumi.String("regional-internal-backend"),
			Region:              pulumi.String("us-central1"),
			BucketName:          internalBackendBucket.Name,
			LoadBalancingScheme: pulumi.String("INTERNAL_MANAGED"),
			Description:         pulumi.String("Regional internal backend bucket for static content"),
		})
		if err != nil {
			return err
		}
		_, err = storage.NewBucketObject(ctx, "index", &storage.BucketObjectArgs{
			Name:    pulumi.String("index.html"),
			Bucket:  internalBackendBucket.Name,
			Content: pulumi.String("<html><body><h1>Regional Internal LB Backend Bucket</h1></body></html>"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;

return await Deployment.RunAsync(() => 
{
    var internalBackendBucket = new Gcp.Storage.Bucket("internal_backend", new()
    {
        Name = "regional-internal-bucket",
        Location = "US-CENTRAL1",
        ForceDestroy = true,
        UniformBucketLevelAccess = true,
        Website = new Gcp.Storage.Inputs.BucketWebsiteArgs
        {
            MainPageSuffix = "index.html",
            NotFoundPage = "404.html",
        },
    });

    var internalBackend = new Gcp.Compute.RegionBackendBucket("internal_backend", new()
    {
        Name = "regional-internal-backend",
        Region = "us-central1",
        BucketName = internalBackendBucket.Name,
        LoadBalancingScheme = "INTERNAL_MANAGED",
        Description = "Regional internal backend bucket for static content",
    });

    var index = new Gcp.Storage.BucketObject("index", new()
    {
        Name = "index.html",
        Bucket = internalBackendBucket.Name,
        Content = "<html><body><h1>Regional Internal LB Backend Bucket</h1></body></html>",
    });

});

    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.storage.inputs.BucketWebsiteArgs;
import com.pulumi.gcp.compute.RegionBackendBucket;
import com.pulumi.gcp.compute.RegionBackendBucketArgs;
import com.pulumi.gcp.storage.BucketObject;
import com.pulumi.gcp.storage.BucketObjectArgs;
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 internalBackendBucket = new Bucket("internalBackendBucket", BucketArgs.builder()
            .name("regional-internal-bucket")
            .location("US-CENTRAL1")
            .forceDestroy(true)
            .uniformBucketLevelAccess(true)
            .website(BucketWebsiteArgs.builder()
                .mainPageSuffix("index.html")
                .notFoundPage("404.html")
                .build())
            .build());

        var internalBackend = new RegionBackendBucket("internalBackend", RegionBackendBucketArgs.builder()
            .name("regional-internal-backend")
            .region("us-central1")
            .bucketName(internalBackendBucket.name())
            .loadBalancingScheme("INTERNAL_MANAGED")
            .description("Regional internal backend bucket for static content")
            .build());

        var index = new BucketObject("index", BucketObjectArgs.builder()
            .name("index.html")
            .bucket(internalBackendBucket.name())
            .content("<html><body><h1>Regional Internal LB Backend Bucket</h1></body></html>")
            .build());

    }
}

    resources:
  internalBackend:
    type: gcp:compute:RegionBackendBucket
    name: internal_backend
    properties:
      name: regional-internal-backend
      region: us-central1
      bucketName: ${internalBackendBucket.name}
      loadBalancingScheme: INTERNAL_MANAGED
      description: Regional internal backend bucket for static content
  internalBackendBucket:
    type: gcp:storage:Bucket
    name: internal_backend
    properties:
      name: regional-internal-bucket
      location: US-CENTRAL1
      forceDestroy: true
      uniformBucketLevelAccess: true
      website:
        mainPageSuffix: index.html
        notFoundPage: 404.html
  index:
    type: gcp:storage:BucketObject
    properties:
      name: index.html
      bucket: ${internalBackendBucket.name}
      content: <html><body><h1>Regional Internal LB Backend Bucket</h1></body></html>

    Region Backend Bucket External Lb

    import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";

const externalBackendBucket = new gcp.storage.Bucket("external_backend", {
    name: "regional-external-bucket",
    location: "US-EAST1",
    forceDestroy: true,
    uniformBucketLevelAccess: true,
    website: {
        mainPageSuffix: "index.html",
        notFoundPage: "404.html",
    },
});
const externalBackend = new gcp.compute.RegionBackendBucket("external_backend", {
    name: "regional-external-backend",
    region: "us-east1",
    bucketName: externalBackendBucket.name,
    loadBalancingScheme: "EXTERNAL_MANAGED",
    description: "Regional external backend bucket for static content",
});
const index = new gcp.storage.BucketObject("index", {
    name: "index.html",
    bucket: externalBackendBucket.name,
    content: "<html><body><h1>Regional External LB Backend Bucket</h1></body></html>",
});
const staticAsset = new gcp.storage.BucketObject("static_asset", {
    name: "assets/style.css",
    bucket: externalBackendBucket.name,
    content: "body { font-family: Arial, sans-serif; }",
});

    import pulumi
import pulumi_gcp as gcp

external_backend_bucket = gcp.storage.Bucket("external_backend",
    name="regional-external-bucket",
    location="US-EAST1",
    force_destroy=True,
    uniform_bucket_level_access=True,
    website={
        "main_page_suffix": "index.html",
        "not_found_page": "404.html",
    })
external_backend = gcp.compute.RegionBackendBucket("external_backend",
    name="regional-external-backend",
    region="us-east1",
    bucket_name=external_backend_bucket.name,
    load_balancing_scheme="EXTERNAL_MANAGED",
    description="Regional external backend bucket for static content")
index = gcp.storage.BucketObject("index",
    name="index.html",
    bucket=external_backend_bucket.name,
    content="<html><body><h1>Regional External LB Backend Bucket</h1></body></html>")
static_asset = gcp.storage.BucketObject("static_asset",
    name="assets/style.css",
    bucket=external_backend_bucket.name,
    content="body { font-family: Arial, sans-serif; }")

    package main

import (
	"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/compute"
	"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/storage"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		externalBackendBucket, err := storage.NewBucket(ctx, "external_backend", &storage.BucketArgs{
			Name:                     pulumi.String("regional-external-bucket"),
			Location:                 pulumi.String("US-EAST1"),
			ForceDestroy:             pulumi.Bool(true),
			UniformBucketLevelAccess: pulumi.Bool(true),
			Website: &storage.BucketWebsiteArgs{
				MainPageSuffix: pulumi.String("index.html"),
				NotFoundPage:   pulumi.String("404.html"),
			},
		})
		if err != nil {
			return err
		}
		_, err = compute.NewRegionBackendBucket(ctx, "external_backend", &compute.RegionBackendBucketArgs{
			Name:                pulumi.String("regional-external-backend"),
			Region:              pulumi.String("us-east1"),
			BucketName:          externalBackendBucket.Name,
			LoadBalancingScheme: pulumi.String("EXTERNAL_MANAGED"),
			Description:         pulumi.String("Regional external backend bucket for static content"),
		})
		if err != nil {
			return err
		}
		_, err = storage.NewBucketObject(ctx, "index", &storage.BucketObjectArgs{
			Name:    pulumi.String("index.html"),
			Bucket:  externalBackendBucket.Name,
			Content: pulumi.String("<html><body><h1>Regional External LB Backend Bucket</h1></body></html>"),
		})
		if err != nil {
			return err
		}
		_, err = storage.NewBucketObject(ctx, "static_asset", &storage.BucketObjectArgs{
			Name:    pulumi.String("assets/style.css"),
			Bucket:  externalBackendBucket.Name,
			Content: pulumi.String("body { font-family: Arial, sans-serif; }"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;

return await Deployment.RunAsync(() => 
{
    var externalBackendBucket = new Gcp.Storage.Bucket("external_backend", new()
    {
        Name = "regional-external-bucket",
        Location = "US-EAST1",
        ForceDestroy = true,
        UniformBucketLevelAccess = true,
        Website = new Gcp.Storage.Inputs.BucketWebsiteArgs
        {
            MainPageSuffix = "index.html",
            NotFoundPage = "404.html",
        },
    });

    var externalBackend = new Gcp.Compute.RegionBackendBucket("external_backend", new()
    {
        Name = "regional-external-backend",
        Region = "us-east1",
        BucketName = externalBackendBucket.Name,
        LoadBalancingScheme = "EXTERNAL_MANAGED",
        Description = "Regional external backend bucket for static content",
    });

    var index = new Gcp.Storage.BucketObject("index", new()
    {
        Name = "index.html",
        Bucket = externalBackendBucket.Name,
        Content = "<html><body><h1>Regional External LB Backend Bucket</h1></body></html>",
    });

    var staticAsset = new Gcp.Storage.BucketObject("static_asset", new()
    {
        Name = "assets/style.css",
        Bucket = externalBackendBucket.Name,
        Content = "body { font-family: Arial, sans-serif; }",
    });

});

    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.storage.inputs.BucketWebsiteArgs;
import com.pulumi.gcp.compute.RegionBackendBucket;
import com.pulumi.gcp.compute.RegionBackendBucketArgs;
import com.pulumi.gcp.storage.BucketObject;
import com.pulumi.gcp.storage.BucketObjectArgs;
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 externalBackendBucket = new Bucket("externalBackendBucket", BucketArgs.builder()
            .name("regional-external-bucket")
            .location("US-EAST1")
            .forceDestroy(true)
            .uniformBucketLevelAccess(true)
            .website(BucketWebsiteArgs.builder()
                .mainPageSuffix("index.html")
                .notFoundPage("404.html")
                .build())
            .build());

        var externalBackend = new RegionBackendBucket("externalBackend", RegionBackendBucketArgs.builder()
            .name("regional-external-backend")
            .region("us-east1")
            .bucketName(externalBackendBucket.name())
            .loadBalancingScheme("EXTERNAL_MANAGED")
            .description("Regional external backend bucket for static content")
            .build());

        var index = new BucketObject("index", BucketObjectArgs.builder()
            .name("index.html")
            .bucket(externalBackendBucket.name())
            .content("<html><body><h1>Regional External LB Backend Bucket</h1></body></html>")
            .build());

        var staticAsset = new BucketObject("staticAsset", BucketObjectArgs.builder()
            .name("assets/style.css")
            .bucket(externalBackendBucket.name())
            .content("body { font-family: Arial, sans-serif; }")
            .build());

    }
}

    resources:
  externalBackend:
    type: gcp:compute:RegionBackendBucket
    name: external_backend
    properties:
      name: regional-external-backend
      region: us-east1
      bucketName: ${externalBackendBucket.name}
      loadBalancingScheme: EXTERNAL_MANAGED
      description: Regional external backend bucket for static content
  externalBackendBucket:
    type: gcp:storage:Bucket
    name: external_backend
    properties:
      name: regional-external-bucket
      location: US-EAST1
      forceDestroy: true
      uniformBucketLevelAccess: true
      website:
        mainPageSuffix: index.html
        notFoundPage: 404.html
  index:
    type: gcp:storage:BucketObject
    properties:
      name: index.html
      bucket: ${externalBackendBucket.name}
      content: <html><body><h1>Regional External LB Backend Bucket</h1></body></html>
  staticAsset:
    type: gcp:storage:BucketObject
    name: static_asset
    properties:
      name: assets/style.css
      bucket: ${externalBackendBucket.name}
      content: 'body { font-family: Arial, sans-serif; }'

    Create RegionBackendBucket Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new RegionBackendBucket(name: string, args: RegionBackendBucketArgs, opts?: CustomResourceOptions);
    @overload
def RegionBackendBucket(resource_name: str,
                        args: RegionBackendBucketArgs,
                        opts: Optional[ResourceOptions] = None)

@overload
def RegionBackendBucket(resource_name: str,
                        opts: Optional[ResourceOptions] = None,
                        bucket_name: Optional[str] = None,
                        region: Optional[str] = None,
                        description: Optional[str] = None,
                        load_balancing_scheme: Optional[str] = None,
                        name: Optional[str] = None,
                        project: Optional[str] = None)
    func NewRegionBackendBucket(ctx *Context, name string, args RegionBackendBucketArgs, opts ...ResourceOption) (*RegionBackendBucket, error)
    public RegionBackendBucket(string name, RegionBackendBucketArgs args, CustomResourceOptions? opts = null)
    public RegionBackendBucket(String name, RegionBackendBucketArgs args)
public RegionBackendBucket(String name, RegionBackendBucketArgs args, CustomResourceOptions options)

    type: gcp:compute:RegionBackendBucket
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args RegionBackendBucketArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args RegionBackendBucketArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args RegionBackendBucketArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args RegionBackendBucketArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args RegionBackendBucketArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var regionBackendBucketResource = new Gcp.Compute.RegionBackendBucket("regionBackendBucketResource", new()
{
    BucketName = "string",
    Region = "string",
    Description = "string",
    LoadBalancingScheme = "string",
    Name = "string",
    Project = "string",
});

    example, err := compute.NewRegionBackendBucket(ctx, "regionBackendBucketResource", &compute.RegionBackendBucketArgs{
	BucketName:          pulumi.String("string"),
	Region:              pulumi.String("string"),
	Description:         pulumi.String("string"),
	LoadBalancingScheme: pulumi.String("string"),
	Name:                pulumi.String("string"),
	Project:             pulumi.String("string"),
})

    var regionBackendBucketResource = new RegionBackendBucket("regionBackendBucketResource", RegionBackendBucketArgs.builder()
    .bucketName("string")
    .region("string")
    .description("string")
    .loadBalancingScheme("string")
    .name("string")
    .project("string")
    .build());

    region_backend_bucket_resource = gcp.compute.RegionBackendBucket("regionBackendBucketResource",
    bucket_name="string",
    region="string",
    description="string",
    load_balancing_scheme="string",
    name="string",
    project="string")

    const regionBackendBucketResource = new gcp.compute.RegionBackendBucket("regionBackendBucketResource", {
    bucketName: "string",
    region: "string",
    description: "string",
    loadBalancingScheme: "string",
    name: "string",
    project: "string",
});

    type: gcp:compute:RegionBackendBucket
properties:
    bucketName: string
    description: string
    loadBalancingScheme: string
    name: string
    project: string
    region: string

    RegionBackendBucket Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The RegionBackendBucket resource accepts the following input properties:

    BucketName string
    Cloud Storage bucket name. The bucket must be in the same region as this backend bucket.
    Region string
    The region where the backend bucket resides.
    Description string
    An optional textual description of the resource; provided by the client when the resource is created.
    LoadBalancingScheme string
    Specifies the load balancer type this backend bucket will be used with. Possible values:

    • 'INTERNAL_MANAGED': for regional internal Application Load Balancers
    • 'EXTERNAL_MANAGED': for regional external Application Load Balancers This field is required for regional backend buckets. Possible values are: INTERNAL_MANAGED, EXTERNAL_MANAGED.
    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? 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.
    Project string
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    BucketName string
    Cloud Storage bucket name. The bucket must be in the same region as this backend bucket.
    Region string
    The region where the backend bucket resides.
    Description string
    An optional textual description of the resource; provided by the client when the resource is created.
    LoadBalancingScheme string
    Specifies the load balancer type this backend bucket will be used with. Possible values:

    • 'INTERNAL_MANAGED': for regional internal Application Load Balancers
    • 'EXTERNAL_MANAGED': for regional external Application Load Balancers This field is required for regional backend buckets. Possible values are: INTERNAL_MANAGED, EXTERNAL_MANAGED.
    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? 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.
    Project string
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    bucketName String
    Cloud Storage bucket name. The bucket must be in the same region as this backend bucket.
    region String
    The region where the backend bucket resides.
    description String
    An optional textual description of the resource; provided by the client when the resource is created.
    loadBalancingScheme String
    Specifies the load balancer type this backend bucket will be used with. Possible values:

    • 'INTERNAL_MANAGED': for regional internal Application Load Balancers
    • 'EXTERNAL_MANAGED': for regional external Application Load Balancers This field is required for regional backend buckets. Possible values are: INTERNAL_MANAGED, EXTERNAL_MANAGED.
    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? 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.
    project String
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    bucketName string
    Cloud Storage bucket name. The bucket must be in the same region as this backend bucket.
    region string
    The region where the backend bucket resides.
    description string
    An optional textual description of the resource; provided by the client when the resource is created.
    loadBalancingScheme string
    Specifies the load balancer type this backend bucket will be used with. Possible values:

    • 'INTERNAL_MANAGED': for regional internal Application Load Balancers
    • 'EXTERNAL_MANAGED': for regional external Application Load Balancers This field is required for regional backend buckets. Possible values are: INTERNAL_MANAGED, EXTERNAL_MANAGED.
    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? 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.
    project string
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    bucket_name str
    Cloud Storage bucket name. The bucket must be in the same region as this backend bucket.
    region str
    The region where the backend bucket resides.
    description str
    An optional textual description of the resource; provided by the client when the resource is created.
    load_balancing_scheme str
    Specifies the load balancer type this backend bucket will be used with. Possible values:

    • 'INTERNAL_MANAGED': for regional internal Application Load Balancers
    • 'EXTERNAL_MANAGED': for regional external Application Load Balancers This field is required for regional backend buckets. Possible values are: INTERNAL_MANAGED, EXTERNAL_MANAGED.
    name str
    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.
    project str
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    bucketName String
    Cloud Storage bucket name. The bucket must be in the same region as this backend bucket.
    region String
    The region where the backend bucket resides.
    description String
    An optional textual description of the resource; provided by the client when the resource is created.
    loadBalancingScheme String
    Specifies the load balancer type this backend bucket will be used with. Possible values:

    • 'INTERNAL_MANAGED': for regional internal Application Load Balancers
    • 'EXTERNAL_MANAGED': for regional external Application Load Balancers This field is required for regional backend buckets. Possible values are: INTERNAL_MANAGED, EXTERNAL_MANAGED.
    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? 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.
    project String
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the RegionBackendBucket resource produces the following output properties:

    CreationTimestamp string
    Creation timestamp in RFC3339 text format.
    Id string
    The provider-assigned unique ID for this managed resource.
    SelfLink string
    The URI of the created resource.
    CreationTimestamp string
    Creation timestamp in RFC3339 text format.
    Id string
    The provider-assigned unique ID for this managed resource.
    SelfLink string
    The URI of the created resource.
    creationTimestamp String
    Creation timestamp in RFC3339 text format.
    id String
    The provider-assigned unique ID for this managed resource.
    selfLink String
    The URI of the created resource.
    creationTimestamp string
    Creation timestamp in RFC3339 text format.
    id string
    The provider-assigned unique ID for this managed resource.
    selfLink string
    The URI of the created resource.
    creation_timestamp str
    Creation timestamp in RFC3339 text format.
    id str
    The provider-assigned unique ID for this managed resource.
    self_link str
    The URI of the created resource.
    creationTimestamp String
    Creation timestamp in RFC3339 text format.
    id String
    The provider-assigned unique ID for this managed resource.
    selfLink String
    The URI of the created resource.

    Look up Existing RegionBackendBucket Resource

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

    public static get(name: string, id: Input<ID>, state?: RegionBackendBucketState, opts?: CustomResourceOptions): RegionBackendBucket
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        bucket_name: Optional[str] = None,
        creation_timestamp: Optional[str] = None,
        description: Optional[str] = None,
        load_balancing_scheme: Optional[str] = None,
        name: Optional[str] = None,
        project: Optional[str] = None,
        region: Optional[str] = None,
        self_link: Optional[str] = None) -> RegionBackendBucket
    func GetRegionBackendBucket(ctx *Context, name string, id IDInput, state *RegionBackendBucketState, opts ...ResourceOption) (*RegionBackendBucket, error)
    public static RegionBackendBucket Get(string name, Input<string> id, RegionBackendBucketState? state, CustomResourceOptions? opts = null)
    public static RegionBackendBucket get(String name, Output<String> id, RegionBackendBucketState state, CustomResourceOptions options)
    resources:  _:    type: gcp:compute:RegionBackendBucket    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    BucketName string
    Cloud Storage bucket name. The bucket must be in the same region as this backend bucket.
    CreationTimestamp string
    Creation timestamp in RFC3339 text format.
    Description string
    An optional textual description of the resource; provided by the client when the resource is created.
    LoadBalancingScheme string
    Specifies the load balancer type this backend bucket will be used with. Possible values:

    • 'INTERNAL_MANAGED': for regional internal Application Load Balancers
    • 'EXTERNAL_MANAGED': for regional external Application Load Balancers This field is required for regional backend buckets. Possible values are: INTERNAL_MANAGED, EXTERNAL_MANAGED.
    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? 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.
    Project string
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    Region string
    The region where the backend bucket resides.
    SelfLink string
    The URI of the created resource.
    BucketName string
    Cloud Storage bucket name. The bucket must be in the same region as this backend bucket.
    CreationTimestamp string
    Creation timestamp in RFC3339 text format.
    Description string
    An optional textual description of the resource; provided by the client when the resource is created.
    LoadBalancingScheme string
    Specifies the load balancer type this backend bucket will be used with. Possible values:

    • 'INTERNAL_MANAGED': for regional internal Application Load Balancers
    • 'EXTERNAL_MANAGED': for regional external Application Load Balancers This field is required for regional backend buckets. Possible values are: INTERNAL_MANAGED, EXTERNAL_MANAGED.
    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? 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.
    Project string
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    Region string
    The region where the backend bucket resides.
    SelfLink string
    The URI of the created resource.
    bucketName String
    Cloud Storage bucket name. The bucket must be in the same region as this backend bucket.
    creationTimestamp String
    Creation timestamp in RFC3339 text format.
    description String
    An optional textual description of the resource; provided by the client when the resource is created.
    loadBalancingScheme String
    Specifies the load balancer type this backend bucket will be used with. Possible values:

    • 'INTERNAL_MANAGED': for regional internal Application Load Balancers
    • 'EXTERNAL_MANAGED': for regional external Application Load Balancers This field is required for regional backend buckets. Possible values are: INTERNAL_MANAGED, EXTERNAL_MANAGED.
    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? 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.
    project String
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    region String
    The region where the backend bucket resides.
    selfLink String
    The URI of the created resource.
    bucketName string
    Cloud Storage bucket name. The bucket must be in the same region as this backend bucket.
    creationTimestamp string
    Creation timestamp in RFC3339 text format.
    description string
    An optional textual description of the resource; provided by the client when the resource is created.
    loadBalancingScheme string
    Specifies the load balancer type this backend bucket will be used with. Possible values:

    • 'INTERNAL_MANAGED': for regional internal Application Load Balancers
    • 'EXTERNAL_MANAGED': for regional external Application Load Balancers This field is required for regional backend buckets. Possible values are: INTERNAL_MANAGED, EXTERNAL_MANAGED.
    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? 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.
    project string
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    region string
    The region where the backend bucket resides.
    selfLink string
    The URI of the created resource.
    bucket_name str
    Cloud Storage bucket name. The bucket must be in the same region as this backend bucket.
    creation_timestamp str
    Creation timestamp in RFC3339 text format.
    description str
    An optional textual description of the resource; provided by the client when the resource is created.
    load_balancing_scheme str
    Specifies the load balancer type this backend bucket will be used with. Possible values:

    • 'INTERNAL_MANAGED': for regional internal Application Load Balancers
    • 'EXTERNAL_MANAGED': for regional external Application Load Balancers This field is required for regional backend buckets. Possible values are: INTERNAL_MANAGED, EXTERNAL_MANAGED.
    name str
    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.
    project str
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    region str
    The region where the backend bucket resides.
    self_link str
    The URI of the created resource.
    bucketName String
    Cloud Storage bucket name. The bucket must be in the same region as this backend bucket.
    creationTimestamp String
    Creation timestamp in RFC3339 text format.
    description String
    An optional textual description of the resource; provided by the client when the resource is created.
    loadBalancingScheme String
    Specifies the load balancer type this backend bucket will be used with. Possible values:

    • 'INTERNAL_MANAGED': for regional internal Application Load Balancers
    • 'EXTERNAL_MANAGED': for regional external Application Load Balancers This field is required for regional backend buckets. Possible values are: INTERNAL_MANAGED, EXTERNAL_MANAGED.
    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? 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.
    project String
    The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
    region String
    The region where the backend bucket resides.
    selfLink String
    The URI of the created resource.

    Import

    RegionBackendBucket can be imported using any of these accepted formats:

    • projects/{{project}}/regions/{{region}}/backendBuckets/{{name}}
    • {{project}}/{{region}}/{{name}}
    • {{region}}/{{name}}
    • {{name}}

    When using the pulumi import command, RegionBackendBucket can be imported using one of the formats above. For example:

    $ pulumi import gcp:compute/regionBackendBucket:RegionBackendBucket default projects/{{project}}/regions/{{region}}/backendBuckets/{{name}}
$ pulumi import gcp:compute/regionBackendBucket:RegionBackendBucket default {{project}}/{{region}}/{{name}}
$ pulumi import gcp:compute/regionBackendBucket:RegionBackendBucket default {{region}}/{{name}}
$ pulumi import gcp:compute/regionBackendBucket:RegionBackendBucket default {{name}}

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    Google Cloud (GCP) Classic pulumi/pulumi-gcp
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the google-beta Terraform Provider.
    gcp logo
    Viewing docs for Google Cloud v9.15.0
    published on Thursday, Mar 12, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-gcp
      Try Pulumi Cloud free. Your team will thank you.