published on Wednesday, Nov 18, 2026 by Pulumi
published on Wednesday, Nov 18, 2026 by Pulumi
A Boundary is a collection of projects defined by filtering criteria on an organization or a folder. Descendant projects are dynamically included in the Boundary based on the configured resource filter.
Membership is recomputed asynchronously, so the projects inside a Boundary are not necessarily settled by the time the apply returns.
To get more information about Boundary, see:
- API documentation
- How-to Guides
Example Usage
Resource Manager Boundary Basic
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
import * as time from "@pulumiverse/time";
const folder = new gcp.organizations.Folder("folder", {
displayName: "bnd-fldr",
parent: "organizations/123456789",
deletionProtection: false,
});
const folderEditor = new gcp.folder.IAMMember("folder_editor", {
folder: folder.folderId,
role: "roles/resourcemanager.editor",
member: "serviceAccount:my@service-account.com",
});
const wait60Seconds = new time.Sleep("wait_60_seconds", {createDuration: "60s"}, {
dependsOn: [folderEditor],
});
const boundary = new gcp.tags.TagKey("boundary", {
parent: "organizations/123456789",
shortName: "bndkey",
description: "Partitioning tag key used by boundaries under this folder.",
});
const boundaryTagValue = new gcp.tags.TagValue("boundary", {
parent: boundary.id,
shortName: "bndval",
description: "Tag value selecting the projects inside the boundary.",
});
const boundaryUpdated = new gcp.tags.TagValue("boundary_updated", {
parent: boundary.id,
shortName: "bndval-updated",
description: "Updated tag value selecting the projects inside the boundary.",
});
// A BoundaryConfig naming the partitioning tag key must exist on the parent
// before any Boundary can be created under it.
const boundaryBoundaryConfig = new gcp.resourcemanager.BoundaryConfig("boundary", {
parent: folder.name,
tagKey: boundary.namespacedName,
}, {
dependsOn: [wait60Seconds],
});
const boundaryBoundary = new gcp.resourcemanager.Boundary("boundary", {
parent: folder.name,
boundaryId: "bnd",
displayName: "Example boundary",
resourceFilter: {
tagFilter: {
tagKey: boundaryBoundaryConfig.tagKey,
tagValue: boundaryTagValue.shortName,
},
},
}, {
dependsOn: [boundaryBoundaryConfig],
});
import pulumi
import pulumi_gcp as gcp
import pulumiverse_time as time
folder = gcp.organizations.Folder("folder",
display_name="bnd-fldr",
parent="organizations/123456789",
deletion_protection=False)
folder_editor = gcp.folder.IAMMember("folder_editor",
folder=folder.folder_id,
role="roles/resourcemanager.editor",
member="serviceAccount:my@service-account.com")
wait60_seconds = time.Sleep("wait_60_seconds", create_duration="60s",
opts = pulumi.ResourceOptions(depends_on=[folder_editor]))
boundary = gcp.tags.TagKey("boundary",
parent="organizations/123456789",
short_name="bndkey",
description="Partitioning tag key used by boundaries under this folder.")
boundary_tag_value = gcp.tags.TagValue("boundary",
parent=boundary.id,
short_name="bndval",
description="Tag value selecting the projects inside the boundary.")
boundary_updated = gcp.tags.TagValue("boundary_updated",
parent=boundary.id,
short_name="bndval-updated",
description="Updated tag value selecting the projects inside the boundary.")
# A BoundaryConfig naming the partitioning tag key must exist on the parent
# before any Boundary can be created under it.
boundary_boundary_config = gcp.resourcemanager.BoundaryConfig("boundary",
parent=folder.name,
tag_key=boundary.namespaced_name,
opts = pulumi.ResourceOptions(depends_on=[wait60_seconds]))
boundary_boundary = gcp.resourcemanager.Boundary("boundary",
parent=folder.name,
boundary_id="bnd",
display_name="Example boundary",
resource_filter={
"tag_filter": {
"tag_key": boundary_boundary_config.tag_key,
"tag_value": boundary_tag_value.short_name,
},
},
opts = pulumi.ResourceOptions(depends_on=[boundary_boundary_config]))
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v10/go/gcp/folder"
"github.com/pulumi/pulumi-gcp/sdk/v10/go/gcp/organizations"
"github.com/pulumi/pulumi-gcp/sdk/v10/go/gcp/resourcemanager"
"github.com/pulumi/pulumi-gcp/sdk/v10/go/gcp/tags"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/pulumiverse/pulumi-time/sdk/go/time"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
folder2, err := organizations.NewFolder(ctx, "folder", &organizations.FolderArgs{
DisplayName: pulumi.String("bnd-fldr"),
Parent: pulumi.String("organizations/123456789"),
DeletionProtection: pulumi.Bool(false),
})
if err != nil {
return err
}
folderEditor, err := folder.NewIAMMember(ctx, "folder_editor", &folder.IAMMemberArgs{
Folder: folder2.FolderId,
Role: pulumi.String("roles/resourcemanager.editor"),
Member: pulumi.String("serviceAccount:my@service-account.com"),
})
if err != nil {
return err
}
wait60Seconds, err := time.NewSleep(ctx, "wait_60_seconds", &time.SleepArgs{
CreateDuration: pulumi.String("60s"),
}, pulumi.DependsOn([]pulumi.Resource{
folderEditor,
}))
if err != nil {
return err
}
boundary, err := tags.NewTagKey(ctx, "boundary", &tags.TagKeyArgs{
Parent: pulumi.String("organizations/123456789"),
ShortName: pulumi.String("bndkey"),
Description: pulumi.String("Partitioning tag key used by boundaries under this folder."),
})
if err != nil {
return err
}
boundaryTagValue, err := tags.NewTagValue(ctx, "boundary", &tags.TagValueArgs{
Parent: boundary.ID(),
ShortName: pulumi.String("bndval"),
Description: pulumi.String("Tag value selecting the projects inside the boundary."),
})
if err != nil {
return err
}
_, err = tags.NewTagValue(ctx, "boundary_updated", &tags.TagValueArgs{
Parent: boundary.ID(),
ShortName: pulumi.String("bndval-updated"),
Description: pulumi.String("Updated tag value selecting the projects inside the boundary."),
})
if err != nil {
return err
}
// A BoundaryConfig naming the partitioning tag key must exist on the parent
// before any Boundary can be created under it.
boundaryBoundaryConfig, err := resourcemanager.NewBoundaryConfig(ctx, "boundary", &resourcemanager.BoundaryConfigArgs{
Parent: folder2.Name,
TagKey: boundary.NamespacedName,
}, pulumi.DependsOn([]pulumi.Resource{
wait60Seconds,
}))
if err != nil {
return err
}
_, err = resourcemanager.NewBoundary(ctx, "boundary", &resourcemanager.BoundaryArgs{
Parent: folder2.Name,
BoundaryId: pulumi.String("bnd"),
DisplayName: pulumi.String("Example boundary"),
ResourceFilter: &resourcemanager.BoundaryResourceFilterArgs{
TagFilter: &resourcemanager.BoundaryResourceFilterTagFilterArgs{
TagKey: boundaryBoundaryConfig.TagKey,
TagValue: boundaryTagValue.ShortName,
},
},
}, pulumi.DependsOn([]pulumi.Resource{
boundaryBoundaryConfig,
}))
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
using Time = Pulumiverse.Time;
return await Deployment.RunAsync(() =>
{
var folder = new Gcp.Organizations.Folder("folder", new()
{
DisplayName = "bnd-fldr",
Parent = "organizations/123456789",
DeletionProtection = false,
});
var folderEditor = new Gcp.Folder.IAMMember("folder_editor", new()
{
Folder = folder.FolderId,
Role = "roles/resourcemanager.editor",
Member = "serviceAccount:my@service-account.com",
});
var wait60Seconds = new Time.Sleep("wait_60_seconds", new()
{
CreateDuration = "60s",
}, new CustomResourceOptions
{
DependsOn =
{
folderEditor,
},
});
var boundary = new Gcp.Tags.TagKey("boundary", new()
{
Parent = "organizations/123456789",
ShortName = "bndkey",
Description = "Partitioning tag key used by boundaries under this folder.",
});
var boundaryTagValue = new Gcp.Tags.TagValue("boundary", new()
{
Parent = boundary.Id,
ShortName = "bndval",
Description = "Tag value selecting the projects inside the boundary.",
});
var boundaryUpdated = new Gcp.Tags.TagValue("boundary_updated", new()
{
Parent = boundary.Id,
ShortName = "bndval-updated",
Description = "Updated tag value selecting the projects inside the boundary.",
});
// A BoundaryConfig naming the partitioning tag key must exist on the parent
// before any Boundary can be created under it.
var boundaryBoundaryConfig = new Gcp.ResourceManager.BoundaryConfig("boundary", new()
{
Parent = folder.Name,
TagKey = boundary.NamespacedName,
}, new CustomResourceOptions
{
DependsOn =
{
wait60Seconds,
},
});
var boundaryBoundary = new Gcp.ResourceManager.Boundary("boundary", new()
{
Parent = folder.Name,
BoundaryId = "bnd",
DisplayName = "Example boundary",
ResourceFilter = new Gcp.ResourceManager.Inputs.BoundaryResourceFilterArgs
{
TagFilter = new Gcp.ResourceManager.Inputs.BoundaryResourceFilterTagFilterArgs
{
TagKey = boundaryBoundaryConfig.TagKey,
TagValue = boundaryTagValue.ShortName,
},
},
}, new CustomResourceOptions
{
DependsOn =
{
boundaryBoundaryConfig,
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.organizations.Folder;
import com.pulumi.gcp.organizations.FolderArgs;
import com.pulumi.gcp.folder.IAMMember;
import com.pulumi.gcp.folder.IAMMemberArgs;
import com.pulumiverse.time.Sleep;
import com.pulumiverse.time.SleepArgs;
import com.pulumi.gcp.tags.TagKey;
import com.pulumi.gcp.tags.TagKeyArgs;
import com.pulumi.gcp.tags.TagValue;
import com.pulumi.gcp.tags.TagValueArgs;
import com.pulumi.gcp.resourcemanager.BoundaryConfig;
import com.pulumi.gcp.resourcemanager.BoundaryConfigArgs;
import com.pulumi.gcp.resourcemanager.Boundary;
import com.pulumi.gcp.resourcemanager.BoundaryArgs;
import com.pulumi.gcp.resourcemanager.inputs.BoundaryResourceFilterArgs;
import com.pulumi.gcp.resourcemanager.inputs.BoundaryResourceFilterTagFilterArgs;
import com.pulumi.resources.CustomResourceOptions;
import java.util.ArrayList;
import java.util.Arrays;
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 folder = new Folder("folder", FolderArgs.builder()
.displayName("bnd-fldr")
.parent("organizations/123456789")
.deletionProtection(false)
.build());
var folderEditor = new IAMMember("folderEditor", IAMMemberArgs.builder()
.folder(folder.folderId())
.role("roles/resourcemanager.editor")
.member("serviceAccount:my@service-account.com")
.build());
var wait60Seconds = new Sleep("wait60Seconds", SleepArgs.builder()
.createDuration("60s")
.build(), CustomResourceOptions.builder()
.dependsOn(folderEditor)
.build());
var boundary = new TagKey("boundary", TagKeyArgs.builder()
.parent("organizations/123456789")
.shortName("bndkey")
.description("Partitioning tag key used by boundaries under this folder.")
.build());
var boundaryTagValue = new TagValue("boundaryTagValue", TagValueArgs.builder()
.parent(boundary.id())
.shortName("bndval")
.description("Tag value selecting the projects inside the boundary.")
.build());
var boundaryUpdated = new TagValue("boundaryUpdated", TagValueArgs.builder()
.parent(boundary.id())
.shortName("bndval-updated")
.description("Updated tag value selecting the projects inside the boundary.")
.build());
// A BoundaryConfig naming the partitioning tag key must exist on the parent
// before any Boundary can be created under it.
var boundaryBoundaryConfig = new BoundaryConfig("boundaryBoundaryConfig", BoundaryConfigArgs.builder()
.parent(folder.name())
.tagKey(boundary.namespacedName())
.build(), CustomResourceOptions.builder()
.dependsOn(wait60Seconds)
.build());
var boundaryBoundary = new Boundary("boundaryBoundary", BoundaryArgs.builder()
.parent(folder.name())
.boundaryId("bnd")
.displayName("Example boundary")
.resourceFilter(BoundaryResourceFilterArgs.builder()
.tagFilter(BoundaryResourceFilterTagFilterArgs.builder()
.tagKey(boundaryBoundaryConfig.tagKey())
.tagValue(boundaryTagValue.shortName())
.build())
.build())
.build(), CustomResourceOptions.builder()
.dependsOn(boundaryBoundaryConfig)
.build());
}
}
resources:
folder:
type: gcp:organizations:Folder
properties:
displayName: bnd-fldr
parent: organizations/123456789
deletionProtection: false
folderEditor:
type: gcp:folder:IAMMember
name: folder_editor
properties:
folder: ${folder.folderId}
role: roles/resourcemanager.editor
member: serviceAccount:my@service-account.com
wait60Seconds:
type: time:Sleep
name: wait_60_seconds
properties:
createDuration: 60s
options:
dependsOn:
- ${folderEditor}
boundary:
type: gcp:tags:TagKey
properties:
parent: organizations/123456789
shortName: bndkey
description: Partitioning tag key used by boundaries under this folder.
boundaryTagValue:
type: gcp:tags:TagValue
name: boundary
properties:
parent: ${boundary.id}
shortName: bndval
description: Tag value selecting the projects inside the boundary.
boundaryUpdated:
type: gcp:tags:TagValue
name: boundary_updated
properties:
parent: ${boundary.id}
shortName: bndval-updated
description: Updated tag value selecting the projects inside the boundary.
# A BoundaryConfig naming the partitioning tag key must exist on the parent
# before any Boundary can be created under it.
boundaryBoundaryConfig:
type: gcp:resourcemanager:BoundaryConfig
name: boundary
properties:
parent: ${folder.name}
tagKey: ${boundary.namespacedName}
options:
dependsOn:
- ${wait60Seconds}
boundaryBoundary:
type: gcp:resourcemanager:Boundary
name: boundary
properties:
parent: ${folder.name}
boundaryId: bnd
displayName: Example boundary
resourceFilter:
tagFilter:
tagKey: ${boundaryBoundaryConfig.tagKey}
tagValue: ${boundaryTagValue.shortName}
options:
dependsOn:
- ${boundaryBoundaryConfig}
terraform {
required_providers {
gcp = {
source = "pulumi/gcp"
}
time = {
source = "pulumi/time"
}
}
}
resource "gcp_organizations_folder" "folder" {
lifecycle {
create_before_destroy = true
}
display_name = "bnd-fldr"
parent = "organizations/123456789"
deletion_protection = false
}
resource "gcp_folder_i_a_m_member" "folder_editor" {
lifecycle {
create_before_destroy = true
}
folder = gcp_organizations_folder.folder.folder_id
role = "roles/resourcemanager.editor"
member = "serviceAccount:my@service-account.com"
}
resource "time_sleep" "wait_60_seconds" {
depends_on = [gcp_folder_i_a_m_member.folder_editor]
lifecycle {
create_before_destroy = true
}
create_duration = "60s"
}
resource "gcp_tags_tag_key" "boundary" {
lifecycle {
create_before_destroy = true
}
parent = "organizations/123456789"
short_name = "bndkey"
description = "Partitioning tag key used by boundaries under this folder."
}
resource "gcp_tags_tag_value" "boundary" {
lifecycle {
create_before_destroy = true
}
parent = gcp_tags_tag_key.boundary.id
short_name = "bndval"
description = "Tag value selecting the projects inside the boundary."
}
resource "gcp_tags_tag_value" "boundary_updated" {
lifecycle {
create_before_destroy = true
}
parent = gcp_tags_tag_key.boundary.id
short_name = "bndval-updated"
description = "Updated tag value selecting the projects inside the boundary."
}
# A BoundaryConfig naming the partitioning tag key must exist on the parent
# before any Boundary can be created under it.
resource "gcp_resourcemanager_boundary_config" "boundary" {
depends_on = [time_sleep.wait_60_seconds]
lifecycle {
create_before_destroy = true
}
parent = gcp_organizations_folder.folder.name
tag_key = gcp_tags_tag_key.boundary.namespaced_name
}
resource "gcp_resourcemanager_boundary" "boundary" {
depends_on = [gcp_resourcemanager_boundary_config.boundary]
lifecycle {
create_before_destroy = true
}
parent = gcp_organizations_folder.folder.name
boundary_id = "bnd"
display_name = "Example boundary"
resource_filter = {
tag_filter = {
tag_key = gcp_resourcemanager_boundary_config.boundary.tag_key
tag_value = gcp_tags_tag_value.boundary.short_name
}
}
}
Create Boundary Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Boundary(name: string, args: BoundaryArgs, opts?: CustomResourceOptions);@overload
def Boundary(resource_name: str,
args: BoundaryArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Boundary(resource_name: str,
opts: Optional[ResourceOptions] = None,
boundary_id: Optional[str] = None,
parent: Optional[str] = None,
deletion_policy: Optional[str] = None,
display_name: Optional[str] = None,
resource_filter: Optional[BoundaryResourceFilterArgs] = None)func NewBoundary(ctx *Context, name string, args BoundaryArgs, opts ...ResourceOption) (*Boundary, error)public Boundary(string name, BoundaryArgs args, CustomResourceOptions? opts = null)
public Boundary(String name, BoundaryArgs args)
public Boundary(String name, BoundaryArgs args, CustomResourceOptions options)
type: gcp:resourcemanager:Boundary
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "gcp_resourcemanager_boundary" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args BoundaryArgs
- 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 BoundaryArgs
- 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 BoundaryArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args BoundaryArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args BoundaryArgs
- 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 gcpBoundaryResource = new Gcp.ResourceManager.Boundary("gcpBoundaryResource", new()
{
BoundaryId = "string",
Parent = "string",
DeletionPolicy = "string",
DisplayName = "string",
ResourceFilter = new Gcp.ResourceManager.Inputs.BoundaryResourceFilterArgs
{
TagFilter = new Gcp.ResourceManager.Inputs.BoundaryResourceFilterTagFilterArgs
{
TagKey = "string",
TagValue = "string",
},
},
});
example, err := resourcemanager.NewBoundary(ctx, "gcpBoundaryResource", &resourcemanager.BoundaryArgs{
BoundaryId: pulumi.String("string"),
Parent: pulumi.String("string"),
DeletionPolicy: pulumi.String("string"),
DisplayName: pulumi.String("string"),
ResourceFilter: &resourcemanager.BoundaryResourceFilterArgs{
TagFilter: &resourcemanager.BoundaryResourceFilterTagFilterArgs{
TagKey: pulumi.String("string"),
TagValue: pulumi.String("string"),
},
},
})
resource "gcp_resourcemanager_boundary" "gcpBoundaryResource" {
lifecycle {
create_before_destroy = true
}
boundary_id = "string"
parent = "string"
deletion_policy = "string"
display_name = "string"
resource_filter = {
tag_filter = {
tag_key = "string"
tag_value = "string"
}
}
}
var gcpBoundaryResource = new com.pulumi.gcp.resourcemanager.Boundary("gcpBoundaryResource", com.pulumi.gcp.resourcemanager.BoundaryArgs.builder()
.boundaryId("string")
.parent("string")
.deletionPolicy("string")
.displayName("string")
.resourceFilter(BoundaryResourceFilterArgs.builder()
.tagFilter(BoundaryResourceFilterTagFilterArgs.builder()
.tagKey("string")
.tagValue("string")
.build())
.build())
.build());
gcp_boundary_resource = gcp.resourcemanager.Boundary("gcpBoundaryResource",
boundary_id="string",
parent="string",
deletion_policy="string",
display_name="string",
resource_filter={
"tag_filter": {
"tag_key": "string",
"tag_value": "string",
},
})
const gcpBoundaryResource = new gcp.resourcemanager.Boundary("gcpBoundaryResource", {
boundaryId: "string",
parent: "string",
deletionPolicy: "string",
displayName: "string",
resourceFilter: {
tagFilter: {
tagKey: "string",
tagValue: "string",
},
},
});
type: gcp:resourcemanager:Boundary
properties:
boundaryId: string
deletionPolicy: string
displayName: string
parent: string
resourceFilter:
tagFilter:
tagKey: string
tagValue: string
Boundary 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 Boundary resource accepts the following input properties:
- Boundary
Id string - The user-assigned ID for the Boundary, which becomes the final component of the Boundary's resource name. Must be unique within the parent. Must be 6 to 30 lowercase ASCII letters, digits, or hyphens, must start with a letter, and may not end with a hyphen.
- Parent string
- The parent resource under which the Boundary is created. Must be of the
form
organizations/{organization_id}orfolders/{folder_id}. - Deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- Display
Name string - Human-readable display name of the Boundary. When present it must be between 4 and 30 characters. Allowed characters are lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point.
- Resource
Filter BoundaryResource Filter - The filter defining the criteria for descendant projects to be included
in the Boundary.
tagValueis the only part of the filter that can be changed after creation, and it cannot be cleared. Structure is documented below.
- Boundary
Id string - The user-assigned ID for the Boundary, which becomes the final component of the Boundary's resource name. Must be unique within the parent. Must be 6 to 30 lowercase ASCII letters, digits, or hyphens, must start with a letter, and may not end with a hyphen.
- Parent string
- The parent resource under which the Boundary is created. Must be of the
form
organizations/{organization_id}orfolders/{folder_id}. - Deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- Display
Name string - Human-readable display name of the Boundary. When present it must be between 4 and 30 characters. Allowed characters are lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point.
- Resource
Filter BoundaryResource Filter Args - The filter defining the criteria for descendant projects to be included
in the Boundary.
tagValueis the only part of the filter that can be changed after creation, and it cannot be cleared. Structure is documented below.
- boundary_
id string - The user-assigned ID for the Boundary, which becomes the final component of the Boundary's resource name. Must be unique within the parent. Must be 6 to 30 lowercase ASCII letters, digits, or hyphens, must start with a letter, and may not end with a hyphen.
- parent string
- The parent resource under which the Boundary is created. Must be of the
form
organizations/{organization_id}orfolders/{folder_id}. - deletion_
policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display_
name string - Human-readable display name of the Boundary. When present it must be between 4 and 30 characters. Allowed characters are lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point.
- resource_
filter object - The filter defining the criteria for descendant projects to be included
in the Boundary.
tagValueis the only part of the filter that can be changed after creation, and it cannot be cleared. Structure is documented below.
- boundary
Id String - The user-assigned ID for the Boundary, which becomes the final component of the Boundary's resource name. Must be unique within the parent. Must be 6 to 30 lowercase ASCII letters, digits, or hyphens, must start with a letter, and may not end with a hyphen.
- parent String
- The parent resource under which the Boundary is created. Must be of the
form
organizations/{organization_id}orfolders/{folder_id}. - deletion
Policy String - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display
Name String - Human-readable display name of the Boundary. When present it must be between 4 and 30 characters. Allowed characters are lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point.
- resource
Filter BoundaryResource Filter - The filter defining the criteria for descendant projects to be included
in the Boundary.
tagValueis the only part of the filter that can be changed after creation, and it cannot be cleared. Structure is documented below.
- boundary
Id string - The user-assigned ID for the Boundary, which becomes the final component of the Boundary's resource name. Must be unique within the parent. Must be 6 to 30 lowercase ASCII letters, digits, or hyphens, must start with a letter, and may not end with a hyphen.
- parent string
- The parent resource under which the Boundary is created. Must be of the
form
organizations/{organization_id}orfolders/{folder_id}. - deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display
Name string - Human-readable display name of the Boundary. When present it must be between 4 and 30 characters. Allowed characters are lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point.
- resource
Filter BoundaryResource Filter - The filter defining the criteria for descendant projects to be included
in the Boundary.
tagValueis the only part of the filter that can be changed after creation, and it cannot be cleared. Structure is documented below.
- boundary_
id str - The user-assigned ID for the Boundary, which becomes the final component of the Boundary's resource name. Must be unique within the parent. Must be 6 to 30 lowercase ASCII letters, digits, or hyphens, must start with a letter, and may not end with a hyphen.
- parent str
- The parent resource under which the Boundary is created. Must be of the
form
organizations/{organization_id}orfolders/{folder_id}. - deletion_
policy str - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display_
name str - Human-readable display name of the Boundary. When present it must be between 4 and 30 characters. Allowed characters are lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point.
- resource_
filter BoundaryResource Filter Args - The filter defining the criteria for descendant projects to be included
in the Boundary.
tagValueis the only part of the filter that can be changed after creation, and it cannot be cleared. Structure is documented below.
- boundary
Id String - The user-assigned ID for the Boundary, which becomes the final component of the Boundary's resource name. Must be unique within the parent. Must be 6 to 30 lowercase ASCII letters, digits, or hyphens, must start with a letter, and may not end with a hyphen.
- parent String
- The parent resource under which the Boundary is created. Must be of the
form
organizations/{organization_id}orfolders/{folder_id}. - deletion
Policy String - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display
Name String - Human-readable display name of the Boundary. When present it must be between 4 and 30 characters. Allowed characters are lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point.
- resource
Filter Property Map - The filter defining the criteria for descendant projects to be included
in the Boundary.
tagValueis the only part of the filter that can be changed after creation, and it cannot be cleared. Structure is documented below.
Outputs
All input properties are implicitly available as output properties. Additionally, the Boundary resource produces the following output properties:
- Create
Time string - The creation time of the Boundary.
- Etag string
- A checksum computed by the server based on the value of other fields. May be sent on update requests to ensure the client has an up-to-date value before proceeding.
- Id string
- The provider-assigned unique ID for this managed resource.
- Management
Project string - The Management Project associated with this Boundary, in the form
projects/{project_number}. This is populated by the service when the Boundary is associated with a CapabilityConfig; it cannot be set directly on the Boundary. To choose a management project, set it on thegcp.resourcemanager.CapabilityConfigresource instead. - Name string
- The unique resource name of the Boundary, in the form
organizations/{organization_id}/boundaries/{boundary_id}orfolders/{folder_id}/boundaries/{boundary_id}. - State string
- The lifecycle state of the Boundary. Possible values are
CREATINGandACTIVE. - Update
Time string - The most recent time this Boundary was modified.
- Create
Time string - The creation time of the Boundary.
- Etag string
- A checksum computed by the server based on the value of other fields. May be sent on update requests to ensure the client has an up-to-date value before proceeding.
- Id string
- The provider-assigned unique ID for this managed resource.
- Management
Project string - The Management Project associated with this Boundary, in the form
projects/{project_number}. This is populated by the service when the Boundary is associated with a CapabilityConfig; it cannot be set directly on the Boundary. To choose a management project, set it on thegcp.resourcemanager.CapabilityConfigresource instead. - Name string
- The unique resource name of the Boundary, in the form
organizations/{organization_id}/boundaries/{boundary_id}orfolders/{folder_id}/boundaries/{boundary_id}. - State string
- The lifecycle state of the Boundary. Possible values are
CREATINGandACTIVE. - Update
Time string - The most recent time this Boundary was modified.
- create_
time string - The creation time of the Boundary.
- etag string
- A checksum computed by the server based on the value of other fields. May be sent on update requests to ensure the client has an up-to-date value before proceeding.
- id string
- The provider-assigned unique ID for this managed resource.
- management_
project string - The Management Project associated with this Boundary, in the form
projects/{project_number}. This is populated by the service when the Boundary is associated with a CapabilityConfig; it cannot be set directly on the Boundary. To choose a management project, set it on thegcp.resourcemanager.CapabilityConfigresource instead. - name string
- The unique resource name of the Boundary, in the form
organizations/{organization_id}/boundaries/{boundary_id}orfolders/{folder_id}/boundaries/{boundary_id}. - state string
- The lifecycle state of the Boundary. Possible values are
CREATINGandACTIVE. - update_
time string - The most recent time this Boundary was modified.
- create
Time String - The creation time of the Boundary.
- etag String
- A checksum computed by the server based on the value of other fields. May be sent on update requests to ensure the client has an up-to-date value before proceeding.
- id String
- The provider-assigned unique ID for this managed resource.
- management
Project String - The Management Project associated with this Boundary, in the form
projects/{project_number}. This is populated by the service when the Boundary is associated with a CapabilityConfig; it cannot be set directly on the Boundary. To choose a management project, set it on thegcp.resourcemanager.CapabilityConfigresource instead. - name String
- The unique resource name of the Boundary, in the form
organizations/{organization_id}/boundaries/{boundary_id}orfolders/{folder_id}/boundaries/{boundary_id}. - state String
- The lifecycle state of the Boundary. Possible values are
CREATINGandACTIVE. - update
Time String - The most recent time this Boundary was modified.
- create
Time string - The creation time of the Boundary.
- etag string
- A checksum computed by the server based on the value of other fields. May be sent on update requests to ensure the client has an up-to-date value before proceeding.
- id string
- The provider-assigned unique ID for this managed resource.
- management
Project string - The Management Project associated with this Boundary, in the form
projects/{project_number}. This is populated by the service when the Boundary is associated with a CapabilityConfig; it cannot be set directly on the Boundary. To choose a management project, set it on thegcp.resourcemanager.CapabilityConfigresource instead. - name string
- The unique resource name of the Boundary, in the form
organizations/{organization_id}/boundaries/{boundary_id}orfolders/{folder_id}/boundaries/{boundary_id}. - state string
- The lifecycle state of the Boundary. Possible values are
CREATINGandACTIVE. - update
Time string - The most recent time this Boundary was modified.
- create_
time str - The creation time of the Boundary.
- etag str
- A checksum computed by the server based on the value of other fields. May be sent on update requests to ensure the client has an up-to-date value before proceeding.
- id str
- The provider-assigned unique ID for this managed resource.
- management_
project str - The Management Project associated with this Boundary, in the form
projects/{project_number}. This is populated by the service when the Boundary is associated with a CapabilityConfig; it cannot be set directly on the Boundary. To choose a management project, set it on thegcp.resourcemanager.CapabilityConfigresource instead. - name str
- The unique resource name of the Boundary, in the form
organizations/{organization_id}/boundaries/{boundary_id}orfolders/{folder_id}/boundaries/{boundary_id}. - state str
- The lifecycle state of the Boundary. Possible values are
CREATINGandACTIVE. - update_
time str - The most recent time this Boundary was modified.
- create
Time String - The creation time of the Boundary.
- etag String
- A checksum computed by the server based on the value of other fields. May be sent on update requests to ensure the client has an up-to-date value before proceeding.
- id String
- The provider-assigned unique ID for this managed resource.
- management
Project String - The Management Project associated with this Boundary, in the form
projects/{project_number}. This is populated by the service when the Boundary is associated with a CapabilityConfig; it cannot be set directly on the Boundary. To choose a management project, set it on thegcp.resourcemanager.CapabilityConfigresource instead. - name String
- The unique resource name of the Boundary, in the form
organizations/{organization_id}/boundaries/{boundary_id}orfolders/{folder_id}/boundaries/{boundary_id}. - state String
- The lifecycle state of the Boundary. Possible values are
CREATINGandACTIVE. - update
Time String - The most recent time this Boundary was modified.
Look up Existing Boundary Resource
Get an existing Boundary 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?: BoundaryState, opts?: CustomResourceOptions): Boundary@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
boundary_id: Optional[str] = None,
create_time: Optional[str] = None,
deletion_policy: Optional[str] = None,
display_name: Optional[str] = None,
etag: Optional[str] = None,
management_project: Optional[str] = None,
name: Optional[str] = None,
parent: Optional[str] = None,
resource_filter: Optional[BoundaryResourceFilterArgs] = None,
state: Optional[str] = None,
update_time: Optional[str] = None) -> Boundaryfunc GetBoundary(ctx *Context, name string, id IDInput, state *BoundaryState, opts ...ResourceOption) (*Boundary, error)public static Boundary Get(string name, Input<string> id, BoundaryState? state, CustomResourceOptions? opts = null)public static Boundary get(String name, Output<String> id, BoundaryState state, CustomResourceOptions options)resources: existingBoundary: type: gcp:resourcemanager:Boundary get: id: ${id}import {
to = gcp_resourcemanager_boundary.example
id = "${id}"
}
- name string
- The unique name of the resulting resource.
- id Input<ID>
- The unique provider ID of the resource to look up.
- state BoundaryState
- Known property values the provider needs, along with the ID, to find the resource. Usually not required.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resulting resource.
- id str
- The unique provider ID of the resource to look up.
- 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 resulting resource.
- id IDInput
- The unique provider ID of the resource to look up.
- state BoundaryState
- Known property values the provider needs, along with the ID, to find the resource. Usually not required.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resulting resource.
- id Input<string>
- The unique provider ID of the resource to look up.
- state BoundaryState
- Known property values the provider needs, along with the ID, to find the resource. Usually not required.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resulting resource.
- id Output<String>
- The unique provider ID of the resource to look up.
- state BoundaryState
- Known property values the provider needs, along with the ID, to find the resource. Usually not required.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
- Boundary
Id string - The user-assigned ID for the Boundary, which becomes the final component of the Boundary's resource name. Must be unique within the parent. Must be 6 to 30 lowercase ASCII letters, digits, or hyphens, must start with a letter, and may not end with a hyphen.
- Create
Time string - The creation time of the Boundary.
- Deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- Display
Name string - Human-readable display name of the Boundary. When present it must be between 4 and 30 characters. Allowed characters are lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point.
- Etag string
- A checksum computed by the server based on the value of other fields. May be sent on update requests to ensure the client has an up-to-date value before proceeding.
- Management
Project string - The Management Project associated with this Boundary, in the form
projects/{project_number}. This is populated by the service when the Boundary is associated with a CapabilityConfig; it cannot be set directly on the Boundary. To choose a management project, set it on thegcp.resourcemanager.CapabilityConfigresource instead. - Name string
- The unique resource name of the Boundary, in the form
organizations/{organization_id}/boundaries/{boundary_id}orfolders/{folder_id}/boundaries/{boundary_id}. - Parent string
- The parent resource under which the Boundary is created. Must be of the
form
organizations/{organization_id}orfolders/{folder_id}. - Resource
Filter BoundaryResource Filter - The filter defining the criteria for descendant projects to be included
in the Boundary.
tagValueis the only part of the filter that can be changed after creation, and it cannot be cleared. Structure is documented below. - State string
- The lifecycle state of the Boundary. Possible values are
CREATINGandACTIVE. - Update
Time string - The most recent time this Boundary was modified.
- Boundary
Id string - The user-assigned ID for the Boundary, which becomes the final component of the Boundary's resource name. Must be unique within the parent. Must be 6 to 30 lowercase ASCII letters, digits, or hyphens, must start with a letter, and may not end with a hyphen.
- Create
Time string - The creation time of the Boundary.
- Deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- Display
Name string - Human-readable display name of the Boundary. When present it must be between 4 and 30 characters. Allowed characters are lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point.
- Etag string
- A checksum computed by the server based on the value of other fields. May be sent on update requests to ensure the client has an up-to-date value before proceeding.
- Management
Project string - The Management Project associated with this Boundary, in the form
projects/{project_number}. This is populated by the service when the Boundary is associated with a CapabilityConfig; it cannot be set directly on the Boundary. To choose a management project, set it on thegcp.resourcemanager.CapabilityConfigresource instead. - Name string
- The unique resource name of the Boundary, in the form
organizations/{organization_id}/boundaries/{boundary_id}orfolders/{folder_id}/boundaries/{boundary_id}. - Parent string
- The parent resource under which the Boundary is created. Must be of the
form
organizations/{organization_id}orfolders/{folder_id}. - Resource
Filter BoundaryResource Filter Args - The filter defining the criteria for descendant projects to be included
in the Boundary.
tagValueis the only part of the filter that can be changed after creation, and it cannot be cleared. Structure is documented below. - State string
- The lifecycle state of the Boundary. Possible values are
CREATINGandACTIVE. - Update
Time string - The most recent time this Boundary was modified.
- boundary_
id string - The user-assigned ID for the Boundary, which becomes the final component of the Boundary's resource name. Must be unique within the parent. Must be 6 to 30 lowercase ASCII letters, digits, or hyphens, must start with a letter, and may not end with a hyphen.
- create_
time string - The creation time of the Boundary.
- deletion_
policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display_
name string - Human-readable display name of the Boundary. When present it must be between 4 and 30 characters. Allowed characters are lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point.
- etag string
- A checksum computed by the server based on the value of other fields. May be sent on update requests to ensure the client has an up-to-date value before proceeding.
- management_
project string - The Management Project associated with this Boundary, in the form
projects/{project_number}. This is populated by the service when the Boundary is associated with a CapabilityConfig; it cannot be set directly on the Boundary. To choose a management project, set it on thegcp.resourcemanager.CapabilityConfigresource instead. - name string
- The unique resource name of the Boundary, in the form
organizations/{organization_id}/boundaries/{boundary_id}orfolders/{folder_id}/boundaries/{boundary_id}. - parent string
- The parent resource under which the Boundary is created. Must be of the
form
organizations/{organization_id}orfolders/{folder_id}. - resource_
filter object - The filter defining the criteria for descendant projects to be included
in the Boundary.
tagValueis the only part of the filter that can be changed after creation, and it cannot be cleared. Structure is documented below. - state string
- The lifecycle state of the Boundary. Possible values are
CREATINGandACTIVE. - update_
time string - The most recent time this Boundary was modified.
- boundary
Id String - The user-assigned ID for the Boundary, which becomes the final component of the Boundary's resource name. Must be unique within the parent. Must be 6 to 30 lowercase ASCII letters, digits, or hyphens, must start with a letter, and may not end with a hyphen.
- create
Time String - The creation time of the Boundary.
- deletion
Policy String - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display
Name String - Human-readable display name of the Boundary. When present it must be between 4 and 30 characters. Allowed characters are lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point.
- etag String
- A checksum computed by the server based on the value of other fields. May be sent on update requests to ensure the client has an up-to-date value before proceeding.
- management
Project String - The Management Project associated with this Boundary, in the form
projects/{project_number}. This is populated by the service when the Boundary is associated with a CapabilityConfig; it cannot be set directly on the Boundary. To choose a management project, set it on thegcp.resourcemanager.CapabilityConfigresource instead. - name String
- The unique resource name of the Boundary, in the form
organizations/{organization_id}/boundaries/{boundary_id}orfolders/{folder_id}/boundaries/{boundary_id}. - parent String
- The parent resource under which the Boundary is created. Must be of the
form
organizations/{organization_id}orfolders/{folder_id}. - resource
Filter BoundaryResource Filter - The filter defining the criteria for descendant projects to be included
in the Boundary.
tagValueis the only part of the filter that can be changed after creation, and it cannot be cleared. Structure is documented below. - state String
- The lifecycle state of the Boundary. Possible values are
CREATINGandACTIVE. - update
Time String - The most recent time this Boundary was modified.
- boundary
Id string - The user-assigned ID for the Boundary, which becomes the final component of the Boundary's resource name. Must be unique within the parent. Must be 6 to 30 lowercase ASCII letters, digits, or hyphens, must start with a letter, and may not end with a hyphen.
- create
Time string - The creation time of the Boundary.
- deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display
Name string - Human-readable display name of the Boundary. When present it must be between 4 and 30 characters. Allowed characters are lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point.
- etag string
- A checksum computed by the server based on the value of other fields. May be sent on update requests to ensure the client has an up-to-date value before proceeding.
- management
Project string - The Management Project associated with this Boundary, in the form
projects/{project_number}. This is populated by the service when the Boundary is associated with a CapabilityConfig; it cannot be set directly on the Boundary. To choose a management project, set it on thegcp.resourcemanager.CapabilityConfigresource instead. - name string
- The unique resource name of the Boundary, in the form
organizations/{organization_id}/boundaries/{boundary_id}orfolders/{folder_id}/boundaries/{boundary_id}. - parent string
- The parent resource under which the Boundary is created. Must be of the
form
organizations/{organization_id}orfolders/{folder_id}. - resource
Filter BoundaryResource Filter - The filter defining the criteria for descendant projects to be included
in the Boundary.
tagValueis the only part of the filter that can be changed after creation, and it cannot be cleared. Structure is documented below. - state string
- The lifecycle state of the Boundary. Possible values are
CREATINGandACTIVE. - update
Time string - The most recent time this Boundary was modified.
- boundary_
id str - The user-assigned ID for the Boundary, which becomes the final component of the Boundary's resource name. Must be unique within the parent. Must be 6 to 30 lowercase ASCII letters, digits, or hyphens, must start with a letter, and may not end with a hyphen.
- create_
time str - The creation time of the Boundary.
- deletion_
policy str - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display_
name str - Human-readable display name of the Boundary. When present it must be between 4 and 30 characters. Allowed characters are lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point.
- etag str
- A checksum computed by the server based on the value of other fields. May be sent on update requests to ensure the client has an up-to-date value before proceeding.
- management_
project str - The Management Project associated with this Boundary, in the form
projects/{project_number}. This is populated by the service when the Boundary is associated with a CapabilityConfig; it cannot be set directly on the Boundary. To choose a management project, set it on thegcp.resourcemanager.CapabilityConfigresource instead. - name str
- The unique resource name of the Boundary, in the form
organizations/{organization_id}/boundaries/{boundary_id}orfolders/{folder_id}/boundaries/{boundary_id}. - parent str
- The parent resource under which the Boundary is created. Must be of the
form
organizations/{organization_id}orfolders/{folder_id}. - resource_
filter BoundaryResource Filter Args - The filter defining the criteria for descendant projects to be included
in the Boundary.
tagValueis the only part of the filter that can be changed after creation, and it cannot be cleared. Structure is documented below. - state str
- The lifecycle state of the Boundary. Possible values are
CREATINGandACTIVE. - update_
time str - The most recent time this Boundary was modified.
- boundary
Id String - The user-assigned ID for the Boundary, which becomes the final component of the Boundary's resource name. Must be unique within the parent. Must be 6 to 30 lowercase ASCII letters, digits, or hyphens, must start with a letter, and may not end with a hyphen.
- create
Time String - The creation time of the Boundary.
- deletion
Policy String - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- display
Name String - Human-readable display name of the Boundary. When present it must be between 4 and 30 characters. Allowed characters are lowercase and uppercase letters, numbers, hyphen, single-quote, double-quote, space, and exclamation point.
- etag String
- A checksum computed by the server based on the value of other fields. May be sent on update requests to ensure the client has an up-to-date value before proceeding.
- management
Project String - The Management Project associated with this Boundary, in the form
projects/{project_number}. This is populated by the service when the Boundary is associated with a CapabilityConfig; it cannot be set directly on the Boundary. To choose a management project, set it on thegcp.resourcemanager.CapabilityConfigresource instead. - name String
- The unique resource name of the Boundary, in the form
organizations/{organization_id}/boundaries/{boundary_id}orfolders/{folder_id}/boundaries/{boundary_id}. - parent String
- The parent resource under which the Boundary is created. Must be of the
form
organizations/{organization_id}orfolders/{folder_id}. - resource
Filter Property Map - The filter defining the criteria for descendant projects to be included
in the Boundary.
tagValueis the only part of the filter that can be changed after creation, and it cannot be cleared. Structure is documented below. - state String
- The lifecycle state of the Boundary. Possible values are
CREATINGandACTIVE. - update
Time String - The most recent time this Boundary was modified.
Supporting Types
BoundaryResourceFilter, BoundaryResourceFilterArgs
- Tag
Filter BoundaryResource Filter Tag Filter - A tag based filter. A project must match it to be included in the Boundary. Structure is documented below.
- Tag
Filter BoundaryResource Filter Tag Filter - A tag based filter. A project must match it to be included in the Boundary. Structure is documented below.
- tag_
filter object - A tag based filter. A project must match it to be included in the Boundary. Structure is documented below.
- tag
Filter BoundaryResource Filter Tag Filter - A tag based filter. A project must match it to be included in the Boundary. Structure is documented below.
- tag
Filter BoundaryResource Filter Tag Filter - A tag based filter. A project must match it to be included in the Boundary. Structure is documented below.
- tag_
filter BoundaryResource Filter Tag Filter - A tag based filter. A project must match it to be included in the Boundary. Structure is documented below.
- tag
Filter Property Map - A tag based filter. A project must match it to be included in the Boundary. Structure is documented below.
BoundaryResourceFilterTagFilter, BoundaryResourceFilterTagFilterArgs
- Tag
Key string - The namespaced name of the tag key, in the form
{parent_id}/{tag_key_short_name}, for example123456789012/env. - Tag
Value string - The allowed short name of the tag value, for example
production. A project matches this tag filter if its effective tag value for the giventagKeymatches this value.
- Tag
Key string - The namespaced name of the tag key, in the form
{parent_id}/{tag_key_short_name}, for example123456789012/env. - Tag
Value string - The allowed short name of the tag value, for example
production. A project matches this tag filter if its effective tag value for the giventagKeymatches this value.
- tag_
key string - The namespaced name of the tag key, in the form
{parent_id}/{tag_key_short_name}, for example123456789012/env. - tag_
value string - The allowed short name of the tag value, for example
production. A project matches this tag filter if its effective tag value for the giventagKeymatches this value.
- tag
Key String - The namespaced name of the tag key, in the form
{parent_id}/{tag_key_short_name}, for example123456789012/env. - tag
Value String - The allowed short name of the tag value, for example
production. A project matches this tag filter if its effective tag value for the giventagKeymatches this value.
- tag
Key string - The namespaced name of the tag key, in the form
{parent_id}/{tag_key_short_name}, for example123456789012/env. - tag
Value string - The allowed short name of the tag value, for example
production. A project matches this tag filter if its effective tag value for the giventagKeymatches this value.
- tag_
key str - The namespaced name of the tag key, in the form
{parent_id}/{tag_key_short_name}, for example123456789012/env. - tag_
value str - The allowed short name of the tag value, for example
production. A project matches this tag filter if its effective tag value for the giventagKeymatches this value.
- tag
Key String - The namespaced name of the tag key, in the form
{parent_id}/{tag_key_short_name}, for example123456789012/env. - tag
Value String - The allowed short name of the tag value, for example
production. A project matches this tag filter if its effective tag value for the giventagKeymatches this value.
Import
Boundary can be imported using any of these accepted formats:
{{parent}}/boundaries/{{boundary_id}}
When using the pulumi import command, Boundary can be imported using one of the formats above. For example:
$ pulumi import gcp:resourcemanager/boundary:Boundary default {{parent}}/boundaries/{{boundary_id}}
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Google Cloud (GCP) pulumi/pulumi-gcp
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
google-betaTerraform Provider.
published on Wednesday, Nov 18, 2026 by Pulumi