1. Packages
  2. Google Cloud Native
  3. API Docs
  4. gkehub
  5. gkehub/v1
  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/v1.Namespace

Explore with Pulumi AI

google-native logo

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/v1:Namespace
    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 NamespaceArgs
    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 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 string
    The unique name of the resource.
    args NamespaceArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args NamespaceArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args 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 namespaceResource = new GoogleNative.GKEHub.V1.Namespace("namespaceResource", new()
    {
        Scope = "string",
        ScopeId = "string",
        ScopeNamespaceId = "string",
        Labels = 
        {
            { "string", "string" },
        },
        Location = "string",
        Name = "string",
        NamespaceLabels = 
        {
            { "string", "string" },
        },
        Project = "string",
    });
    
    example, err := gkehub.NewNamespace(ctx, "namespaceResource", &gkehub.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"),
    })
    
    var namespaceResource = new Namespace("namespaceResource", 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());
    
    namespace_resource = google_native.gkehub.v1.Namespace("namespaceResource",
        scope="string",
        scope_id="string",
        scope_namespace_id="string",
        labels={
            "string": "string",
        },
        location="string",
        name="string",
        namespace_labels={
            "string": "string",
        },
        project="string")
    
    const namespaceResource = new google_native.gkehub.v1.Namespace("namespaceResource", {
        scope: "string",
        scopeId: "string",
        scopeNamespaceId: "string",
        labels: {
            string: "string",
        },
        location: "string",
        name: "string",
        namespaceLabels: {
            string: "string",
        },
        project: "string",
    });
    
    type: google-native:gkehub/v1:Namespace
    properties:
        labels:
            string: string
        location: string
        name: string
        namespaceLabels:
            string: string
        project: string
        scope: string
        scopeId: string
        scopeNamespaceId: string
    

    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

    The Namespace resource accepts the following input properties:

    Scope string
    Scope associated with the namespace
    ScopeId string
    ScopeNamespaceId 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 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 string
    Scope string
    Scope associated with the namespace
    ScopeId string
    ScopeNamespaceId 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 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 string
    scope String
    Scope associated with the namespace
    scopeId String
    scopeNamespaceId 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 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 String
    scope string
    Scope associated with the namespace
    scopeId string
    scopeNamespaceId 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 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 string
    scope str
    Scope associated with the namespace
    scope_id str
    scope_namespace_id 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 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 str
    scope String
    Scope associated with the namespace
    scopeId String
    scopeNamespaceId 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 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 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.V1.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 string
    The current state of the Namespace resource.
    Code string
    The current state of the Namespace resource.
    code String
    The current state of the Namespace resource.
    code string
    The current state of the Namespace resource.
    code str
    The current state of the Namespace resource.
    code String
    The current state of the Namespace resource.

    Package Details

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

    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