1. Packages
  2. Google Cloud Native
  3. API Docs
  4. gkehub
  5. gkehub/v1beta
  6. Namespace

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi

google-native.gkehub/v1beta.Namespace

Explore with Pulumi AI

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi

Creates a fleet namespace. Auto-naming is currently not supported for this resource.

Create Namespace Resource

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

Constructor syntax

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

@overload
def Namespace(resource_name: str,
              opts: Optional[ResourceOptions] = None,
              scope: Optional[str] = None,
              scope_id: Optional[str] = None,
              scope_namespace_id: Optional[str] = None,
              labels: Optional[Mapping[str, str]] = None,
              location: Optional[str] = None,
              name: Optional[str] = None,
              namespace_labels: Optional[Mapping[str, str]] = None,
              project: Optional[str] = None)
func NewNamespace(ctx *Context, name string, args NamespaceArgs, opts ...ResourceOption) (*Namespace, error)
public Namespace(string name, NamespaceArgs args, CustomResourceOptions? opts = null)
public Namespace(String name, NamespaceArgs args)
public Namespace(String name, NamespaceArgs args, CustomResourceOptions options)
type: google-native:gkehub/v1beta:Namespace
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name This property is required. string
The unique name of the resource.
args This property is required. NamespaceArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args This property is required. NamespaceArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args This property is required. NamespaceArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args This property is required. NamespaceArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. NamespaceArgs
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 examplenamespaceResourceResourceFromGkehubv1beta = new GoogleNative.GKEHub.V1Beta.Namespace("examplenamespaceResourceResourceFromGkehubv1beta", new()
{
    Scope = "string",
    ScopeId = "string",
    ScopeNamespaceId = "string",
    Labels = 
    {
        { "string", "string" },
    },
    Location = "string",
    Name = "string",
    NamespaceLabels = 
    {
        { "string", "string" },
    },
    Project = "string",
});
Copy
example, err := gkehubv1beta.NewNamespace(ctx, "examplenamespaceResourceResourceFromGkehubv1beta", &gkehubv1beta.NamespaceArgs{
	Scope:            pulumi.String("string"),
	ScopeId:          pulumi.String("string"),
	ScopeNamespaceId: pulumi.String("string"),
	Labels: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	Location: pulumi.String("string"),
	Name:     pulumi.String("string"),
	NamespaceLabels: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	Project: pulumi.String("string"),
})
Copy
var examplenamespaceResourceResourceFromGkehubv1beta = new Namespace("examplenamespaceResourceResourceFromGkehubv1beta", NamespaceArgs.builder()
    .scope("string")
    .scopeId("string")
    .scopeNamespaceId("string")
    .labels(Map.of("string", "string"))
    .location("string")
    .name("string")
    .namespaceLabels(Map.of("string", "string"))
    .project("string")
    .build());
Copy
examplenamespace_resource_resource_from_gkehubv1beta = google_native.gkehub.v1beta.Namespace("examplenamespaceResourceResourceFromGkehubv1beta",
    scope="string",
    scope_id="string",
    scope_namespace_id="string",
    labels={
        "string": "string",
    },
    location="string",
    name="string",
    namespace_labels={
        "string": "string",
    },
    project="string")
Copy
const examplenamespaceResourceResourceFromGkehubv1beta = new google_native.gkehub.v1beta.Namespace("examplenamespaceResourceResourceFromGkehubv1beta", {
    scope: "string",
    scopeId: "string",
    scopeNamespaceId: "string",
    labels: {
        string: "string",
    },
    location: "string",
    name: "string",
    namespaceLabels: {
        string: "string",
    },
    project: "string",
});
Copy
type: google-native:gkehub/v1beta:Namespace
properties:
    labels:
        string: string
    location: string
    name: string
    namespaceLabels:
        string: string
    project: string
    scope: string
    scopeId: string
    scopeNamespaceId: string
Copy

Namespace 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 Namespace resource accepts the following input properties:

Scope This property is required. string
Scope associated with the namespace
ScopeId
This property is required.
Changes to this property will trigger replacement.
string
ScopeNamespaceId
This property is required.
Changes to this property will trigger replacement.
string
Required. Client chosen ID for the Namespace. namespace_id must be a valid RFC 1123 compliant DNS label: 1. At most 63 characters in length 2. It must consist of lower case alphanumeric characters or - 3. It must start and end with an alphanumeric character Which can be expressed as the regex: [a-z0-9]([-a-z0-9]*[a-z0-9])?, with a maximum length of 63 characters.
Labels Dictionary<string, string>
Optional. Labels for this Namespace.
Location Changes to this property will trigger replacement. string
Name string
The resource name for the namespace projects/{project}/locations/{location}/namespaces/{namespace}
NamespaceLabels Dictionary<string, string>
Optional. Namespace-level cluster namespace labels. These labels are applied to the related namespace of the member clusters bound to the parent Scope. Scope-level labels (namespace_labels in the Fleet Scope resource) take precedence over Namespace-level labels if they share a key. Keys and values must be Kubernetes-conformant.
Project Changes to this property will trigger replacement. string
Scope This property is required. string
Scope associated with the namespace
ScopeId
This property is required.
Changes to this property will trigger replacement.
string
ScopeNamespaceId
This property is required.
Changes to this property will trigger replacement.
string
Required. Client chosen ID for the Namespace. namespace_id must be a valid RFC 1123 compliant DNS label: 1. At most 63 characters in length 2. It must consist of lower case alphanumeric characters or - 3. It must start and end with an alphanumeric character Which can be expressed as the regex: [a-z0-9]([-a-z0-9]*[a-z0-9])?, with a maximum length of 63 characters.
Labels map[string]string
Optional. Labels for this Namespace.
Location Changes to this property will trigger replacement. string
Name string
The resource name for the namespace projects/{project}/locations/{location}/namespaces/{namespace}
NamespaceLabels map[string]string
Optional. Namespace-level cluster namespace labels. These labels are applied to the related namespace of the member clusters bound to the parent Scope. Scope-level labels (namespace_labels in the Fleet Scope resource) take precedence over Namespace-level labels if they share a key. Keys and values must be Kubernetes-conformant.
Project Changes to this property will trigger replacement. string
scope This property is required. String
Scope associated with the namespace
scopeId
This property is required.
Changes to this property will trigger replacement.
String
scopeNamespaceId
This property is required.
Changes to this property will trigger replacement.
String
Required. Client chosen ID for the Namespace. namespace_id must be a valid RFC 1123 compliant DNS label: 1. At most 63 characters in length 2. It must consist of lower case alphanumeric characters or - 3. It must start and end with an alphanumeric character Which can be expressed as the regex: [a-z0-9]([-a-z0-9]*[a-z0-9])?, with a maximum length of 63 characters.
labels Map<String,String>
Optional. Labels for this Namespace.
location Changes to this property will trigger replacement. String
name String
The resource name for the namespace projects/{project}/locations/{location}/namespaces/{namespace}
namespaceLabels Map<String,String>
Optional. Namespace-level cluster namespace labels. These labels are applied to the related namespace of the member clusters bound to the parent Scope. Scope-level labels (namespace_labels in the Fleet Scope resource) take precedence over Namespace-level labels if they share a key. Keys and values must be Kubernetes-conformant.
project Changes to this property will trigger replacement. String
scope This property is required. string
Scope associated with the namespace
scopeId
This property is required.
Changes to this property will trigger replacement.
string
scopeNamespaceId
This property is required.
Changes to this property will trigger replacement.
string
Required. Client chosen ID for the Namespace. namespace_id must be a valid RFC 1123 compliant DNS label: 1. At most 63 characters in length 2. It must consist of lower case alphanumeric characters or - 3. It must start and end with an alphanumeric character Which can be expressed as the regex: [a-z0-9]([-a-z0-9]*[a-z0-9])?, with a maximum length of 63 characters.
labels {[key: string]: string}
Optional. Labels for this Namespace.
location Changes to this property will trigger replacement. string
name string
The resource name for the namespace projects/{project}/locations/{location}/namespaces/{namespace}
namespaceLabels {[key: string]: string}
Optional. Namespace-level cluster namespace labels. These labels are applied to the related namespace of the member clusters bound to the parent Scope. Scope-level labels (namespace_labels in the Fleet Scope resource) take precedence over Namespace-level labels if they share a key. Keys and values must be Kubernetes-conformant.
project Changes to this property will trigger replacement. string
scope This property is required. str
Scope associated with the namespace
scope_id
This property is required.
Changes to this property will trigger replacement.
str
scope_namespace_id
This property is required.
Changes to this property will trigger replacement.
str
Required. Client chosen ID for the Namespace. namespace_id must be a valid RFC 1123 compliant DNS label: 1. At most 63 characters in length 2. It must consist of lower case alphanumeric characters or - 3. It must start and end with an alphanumeric character Which can be expressed as the regex: [a-z0-9]([-a-z0-9]*[a-z0-9])?, with a maximum length of 63 characters.
labels Mapping[str, str]
Optional. Labels for this Namespace.
location Changes to this property will trigger replacement. str
name str
The resource name for the namespace projects/{project}/locations/{location}/namespaces/{namespace}
namespace_labels Mapping[str, str]
Optional. Namespace-level cluster namespace labels. These labels are applied to the related namespace of the member clusters bound to the parent Scope. Scope-level labels (namespace_labels in the Fleet Scope resource) take precedence over Namespace-level labels if they share a key. Keys and values must be Kubernetes-conformant.
project Changes to this property will trigger replacement. str
scope This property is required. String
Scope associated with the namespace
scopeId
This property is required.
Changes to this property will trigger replacement.
String
scopeNamespaceId
This property is required.
Changes to this property will trigger replacement.
String
Required. Client chosen ID for the Namespace. namespace_id must be a valid RFC 1123 compliant DNS label: 1. At most 63 characters in length 2. It must consist of lower case alphanumeric characters or - 3. It must start and end with an alphanumeric character Which can be expressed as the regex: [a-z0-9]([-a-z0-9]*[a-z0-9])?, with a maximum length of 63 characters.
labels Map<String>
Optional. Labels for this Namespace.
location Changes to this property will trigger replacement. String
name String
The resource name for the namespace projects/{project}/locations/{location}/namespaces/{namespace}
namespaceLabels Map<String>
Optional. Namespace-level cluster namespace labels. These labels are applied to the related namespace of the member clusters bound to the parent Scope. Scope-level labels (namespace_labels in the Fleet Scope resource) take precedence over Namespace-level labels if they share a key. Keys and values must be Kubernetes-conformant.
project Changes to this property will trigger replacement. String

Outputs

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

CreateTime string
When the namespace was created.
DeleteTime string
When the namespace was deleted.
Id string
The provider-assigned unique ID for this managed resource.
State Pulumi.GoogleNative.GKEHub.V1Beta.Outputs.NamespaceLifecycleStateResponse
State of the namespace resource.
Uid string
Google-generated UUID for this resource. This is unique across all namespace resources. If a namespace resource is deleted and another resource with the same name is created, it gets a different uid.
UpdateTime string
When the namespace was last updated.
CreateTime string
When the namespace was created.
DeleteTime string
When the namespace was deleted.
Id string
The provider-assigned unique ID for this managed resource.
State NamespaceLifecycleStateResponse
State of the namespace resource.
Uid string
Google-generated UUID for this resource. This is unique across all namespace resources. If a namespace resource is deleted and another resource with the same name is created, it gets a different uid.
UpdateTime string
When the namespace was last updated.
createTime String
When the namespace was created.
deleteTime String
When the namespace was deleted.
id String
The provider-assigned unique ID for this managed resource.
state NamespaceLifecycleStateResponse
State of the namespace resource.
uid String
Google-generated UUID for this resource. This is unique across all namespace resources. If a namespace resource is deleted and another resource with the same name is created, it gets a different uid.
updateTime String
When the namespace was last updated.
createTime string
When the namespace was created.
deleteTime string
When the namespace was deleted.
id string
The provider-assigned unique ID for this managed resource.
state NamespaceLifecycleStateResponse
State of the namespace resource.
uid string
Google-generated UUID for this resource. This is unique across all namespace resources. If a namespace resource is deleted and another resource with the same name is created, it gets a different uid.
updateTime string
When the namespace was last updated.
create_time str
When the namespace was created.
delete_time str
When the namespace was deleted.
id str
The provider-assigned unique ID for this managed resource.
state NamespaceLifecycleStateResponse
State of the namespace resource.
uid str
Google-generated UUID for this resource. This is unique across all namespace resources. If a namespace resource is deleted and another resource with the same name is created, it gets a different uid.
update_time str
When the namespace was last updated.
createTime String
When the namespace was created.
deleteTime String
When the namespace was deleted.
id String
The provider-assigned unique ID for this managed resource.
state Property Map
State of the namespace resource.
uid String
Google-generated UUID for this resource. This is unique across all namespace resources. If a namespace resource is deleted and another resource with the same name is created, it gets a different uid.
updateTime String
When the namespace was last updated.

Supporting Types

NamespaceLifecycleStateResponse
, NamespaceLifecycleStateResponseArgs

Code This property is required. string
The current state of the Namespace resource.
Code This property is required. string
The current state of the Namespace resource.
code This property is required. String
The current state of the Namespace resource.
code This property is required. string
The current state of the Namespace resource.
code This property is required. str
The current state of the Namespace resource.
code This property is required. String
The current state of the Namespace resource.

Package Details

Repository
Google Cloud Native pulumi/pulumi-google-native
License
Apache-2.0

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi