published on Monday, Jul 20, 2026 by Byteplus
published on Monday, Jul 20, 2026 by Byteplus
ID namespace is a resource isolation unit in permissions management. It can be used to organize associated entities, projects, and tags.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as bytepluscc from "@byteplus/pulumi-bytepluscc";
const example = new bytepluscc.id.PermissionNamespace("Example", {
namespaceName: "test-namespace-full",
description: "test description",
projectName: "default",
tags: [{
key: "env",
value: "test",
}],
});
import pulumi
import pulumi_bytepluscc as bytepluscc
example = bytepluscc.id.PermissionNamespace("Example",
namespace_name="test-namespace-full",
description="test description",
project_name="default",
tags=[{
"key": "env",
"value": "test",
}])
package main
import (
"github.com/byteplus-sdk/pulumi-bytepluscc/sdk/go/bytepluscc/id"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := id.NewPermissionNamespace(ctx, "Example", &id.PermissionNamespaceArgs{
NamespaceName: pulumi.String("test-namespace-full"),
Description: pulumi.String("test description"),
ProjectName: pulumi.String("default"),
Tags: id.PermissionNamespaceTagArray{
&id.PermissionNamespaceTagArgs{
Key: pulumi.String("env"),
Value: pulumi.String("test"),
},
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Bytepluscc = Byteplus.Pulumi.Bytepluscc;
return await Deployment.RunAsync(() =>
{
var example = new Bytepluscc.Id.PermissionNamespace("Example", new()
{
NamespaceName = "test-namespace-full",
Description = "test description",
ProjectName = "default",
Tags = new[]
{
new Bytepluscc.Id.Inputs.PermissionNamespaceTagArgs
{
Key = "env",
Value = "test",
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.byteplus.bytepluscc.id.PermissionNamespace;
import com.byteplus.bytepluscc.id.PermissionNamespaceArgs;
import com.pulumi.bytepluscc.id.inputs.PermissionNamespaceTagArgs;
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 example = new PermissionNamespace("example", PermissionNamespaceArgs.builder()
.namespaceName("test-namespace-full")
.description("test description")
.projectName("default")
.tags(PermissionNamespaceTagArgs.builder()
.key("env")
.value("test")
.build())
.build());
}
}
resources:
example:
type: bytepluscc:id:PermissionNamespace
name: Example
properties:
namespaceName: test-namespace-full
description: test description
projectName: default
tags:
- key: env
value: test
pulumi {
required_providers {
bytepluscc = {
source = "pulumi/bytepluscc"
}
}
}
resource "bytepluscc_id_permissionnamespace" "Example" {
namespace_name = "test-namespace-full"
description = "test description"
project_name = "default"
tags {
key = "env"
value = "test"
}
}
Create PermissionNamespace Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new PermissionNamespace(name: string, args: PermissionNamespaceArgs, opts?: CustomResourceOptions);@overload
def PermissionNamespace(resource_name: str,
args: PermissionNamespaceArgs,
opts: Optional[ResourceOptions] = None)
@overload
def PermissionNamespace(resource_name: str,
opts: Optional[ResourceOptions] = None,
namespace_name: Optional[str] = None,
description: Optional[str] = None,
project_name: Optional[str] = None,
tags: Optional[Sequence[PermissionNamespaceTagArgs]] = None)func NewPermissionNamespace(ctx *Context, name string, args PermissionNamespaceArgs, opts ...ResourceOption) (*PermissionNamespace, error)public PermissionNamespace(string name, PermissionNamespaceArgs args, CustomResourceOptions? opts = null)
public PermissionNamespace(String name, PermissionNamespaceArgs args)
public PermissionNamespace(String name, PermissionNamespaceArgs args, CustomResourceOptions options)
type: bytepluscc:id:PermissionNamespace
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "bytepluscc_id_permissionnamespace" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args PermissionNamespaceArgs
- 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 PermissionNamespaceArgs
- 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 PermissionNamespaceArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args PermissionNamespaceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args PermissionNamespaceArgs
- 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 permissionNamespaceResource = new Bytepluscc.Id.PermissionNamespace("permissionNamespaceResource", new()
{
NamespaceName = "string",
Description = "string",
ProjectName = "string",
Tags = new[]
{
new Bytepluscc.Id.Inputs.PermissionNamespaceTagArgs
{
Key = "string",
Value = "string",
},
},
});
example, err := id.NewPermissionNamespace(ctx, "permissionNamespaceResource", &id.PermissionNamespaceArgs{
NamespaceName: pulumi.String("string"),
Description: pulumi.String("string"),
ProjectName: pulumi.String("string"),
Tags: id.PermissionNamespaceTagArray{
&id.PermissionNamespaceTagArgs{
Key: pulumi.String("string"),
Value: pulumi.String("string"),
},
},
})
resource "bytepluscc_id_permissionnamespace" "permissionNamespaceResource" {
namespace_name = "string"
description = "string"
project_name = "string"
tags {
key = "string"
value = "string"
}
}
var permissionNamespaceResource = new PermissionNamespace("permissionNamespaceResource", PermissionNamespaceArgs.builder()
.namespaceName("string")
.description("string")
.projectName("string")
.tags(PermissionNamespaceTagArgs.builder()
.key("string")
.value("string")
.build())
.build());
permission_namespace_resource = bytepluscc.id.PermissionNamespace("permissionNamespaceResource",
namespace_name="string",
description="string",
project_name="string",
tags=[{
"key": "string",
"value": "string",
}])
const permissionNamespaceResource = new bytepluscc.id.PermissionNamespace("permissionNamespaceResource", {
namespaceName: "string",
description: "string",
projectName: "string",
tags: [{
key: "string",
value: "string",
}],
});
type: bytepluscc:id:PermissionNamespace
properties:
description: string
namespaceName: string
projectName: string
tags:
- key: string
value: string
PermissionNamespace 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 PermissionNamespace resource accepts the following input properties:
- Namespace
Name string - Namespace Name
- Description string
- Namespace Description
- Project
Name string - Project Associated with Namespace
-
List<Byteplus.
Permission Namespace Tag> - Namespace Tag List Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
- Namespace
Name string - Namespace Name
- Description string
- Namespace Description
- Project
Name string - Project Associated with Namespace
-
[]Permission
Namespace Tag Args - Namespace Tag List Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
- namespace_
name string - Namespace Name
- description string
- Namespace Description
- project_
name string - Project Associated with Namespace
- list(object)
- Namespace Tag List Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
- namespace
Name String - Namespace Name
- description String
- Namespace Description
- project
Name String - Project Associated with Namespace
-
List<Permission
Namespace Tag> - Namespace Tag List Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
- namespace
Name string - Namespace Name
- description string
- Namespace Description
- project
Name string - Project Associated with Namespace
-
Permission
Namespace Tag[] - Namespace Tag List Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
- namespace_
name str - Namespace Name
- description str
- Namespace Description
- project_
name str - Project Associated with Namespace
-
Sequence[Permission
Namespace Tag Args] - Namespace Tag List Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
- namespace
Name String - Namespace Name
- description String
- Namespace Description
- project
Name String - Project Associated with Namespace
- List<Property Map>
- Namespace Tag List Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
Outputs
All input properties are implicitly available as output properties. Additionally, the PermissionNamespace resource produces the following output properties:
- Associates List<string>
- Associated Entities List
- Create
Time string - Namespace Creation Time
- Id string
- The provider-assigned unique ID for this managed resource.
- Namespace
Id string - Namespace Unique ID
- Trn string
- Namespace TRN
- Update
Time string - Namespace Update Time
- Associates []string
- Associated Entities List
- Create
Time string - Namespace Creation Time
- Id string
- The provider-assigned unique ID for this managed resource.
- Namespace
Id string - Namespace Unique ID
- Trn string
- Namespace TRN
- Update
Time string - Namespace Update Time
- associates list(string)
- Associated Entities List
- create_
time string - Namespace Creation Time
- id string
- The provider-assigned unique ID for this managed resource.
- namespace_
id string - Namespace Unique ID
- trn string
- Namespace TRN
- update_
time string - Namespace Update Time
- associates List<String>
- Associated Entities List
- create
Time String - Namespace Creation Time
- id String
- The provider-assigned unique ID for this managed resource.
- namespace
Id String - Namespace Unique ID
- trn String
- Namespace TRN
- update
Time String - Namespace Update Time
- associates string[]
- Associated Entities List
- create
Time string - Namespace Creation Time
- id string
- The provider-assigned unique ID for this managed resource.
- namespace
Id string - Namespace Unique ID
- trn string
- Namespace TRN
- update
Time string - Namespace Update Time
- associates Sequence[str]
- Associated Entities List
- create_
time str - Namespace Creation Time
- id str
- The provider-assigned unique ID for this managed resource.
- namespace_
id str - Namespace Unique ID
- trn str
- Namespace TRN
- update_
time str - Namespace Update Time
- associates List<String>
- Associated Entities List
- create
Time String - Namespace Creation Time
- id String
- The provider-assigned unique ID for this managed resource.
- namespace
Id String - Namespace Unique ID
- trn String
- Namespace TRN
- update
Time String - Namespace Update Time
Look up Existing PermissionNamespace Resource
Get an existing PermissionNamespace 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?: PermissionNamespaceState, opts?: CustomResourceOptions): PermissionNamespace@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
associates: Optional[Sequence[str]] = None,
create_time: Optional[str] = None,
description: Optional[str] = None,
namespace_id: Optional[str] = None,
namespace_name: Optional[str] = None,
project_name: Optional[str] = None,
tags: Optional[Sequence[PermissionNamespaceTagArgs]] = None,
trn: Optional[str] = None,
update_time: Optional[str] = None) -> PermissionNamespacefunc GetPermissionNamespace(ctx *Context, name string, id IDInput, state *PermissionNamespaceState, opts ...ResourceOption) (*PermissionNamespace, error)public static PermissionNamespace Get(string name, Input<string> id, PermissionNamespaceState? state, CustomResourceOptions? opts = null)public static PermissionNamespace get(String name, Output<String> id, PermissionNamespaceState state, CustomResourceOptions options)resources: _: type: bytepluscc:id:PermissionNamespace get: id: ${id}import {
to = bytepluscc_id_permissionnamespace.example
id = "${id}"
}
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Associates List<string>
- Associated Entities List
- Create
Time string - Namespace Creation Time
- Description string
- Namespace Description
- Namespace
Id string - Namespace Unique ID
- Namespace
Name string - Namespace Name
- Project
Name string - Project Associated with Namespace
-
List<Byteplus.
Permission Namespace Tag> - Namespace Tag List Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
- Trn string
- Namespace TRN
- Update
Time string - Namespace Update Time
- Associates []string
- Associated Entities List
- Create
Time string - Namespace Creation Time
- Description string
- Namespace Description
- Namespace
Id string - Namespace Unique ID
- Namespace
Name string - Namespace Name
- Project
Name string - Project Associated with Namespace
-
[]Permission
Namespace Tag Args - Namespace Tag List Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
- Trn string
- Namespace TRN
- Update
Time string - Namespace Update Time
- associates list(string)
- Associated Entities List
- create_
time string - Namespace Creation Time
- description string
- Namespace Description
- namespace_
id string - Namespace Unique ID
- namespace_
name string - Namespace Name
- project_
name string - Project Associated with Namespace
- list(object)
- Namespace Tag List Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
- trn string
- Namespace TRN
- update_
time string - Namespace Update Time
- associates List<String>
- Associated Entities List
- create
Time String - Namespace Creation Time
- description String
- Namespace Description
- namespace
Id String - Namespace Unique ID
- namespace
Name String - Namespace Name
- project
Name String - Project Associated with Namespace
-
List<Permission
Namespace Tag> - Namespace Tag List Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
- trn String
- Namespace TRN
- update
Time String - Namespace Update Time
- associates string[]
- Associated Entities List
- create
Time string - Namespace Creation Time
- description string
- Namespace Description
- namespace
Id string - Namespace Unique ID
- namespace
Name string - Namespace Name
- project
Name string - Project Associated with Namespace
-
Permission
Namespace Tag[] - Namespace Tag List Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
- trn string
- Namespace TRN
- update
Time string - Namespace Update Time
- associates Sequence[str]
- Associated Entities List
- create_
time str - Namespace Creation Time
- description str
- Namespace Description
- namespace_
id str - Namespace Unique ID
- namespace_
name str - Namespace Name
- project_
name str - Project Associated with Namespace
-
Sequence[Permission
Namespace Tag Args] - Namespace Tag List Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
- trn str
- Namespace TRN
- update_
time str - Namespace Update Time
- associates List<String>
- Associated Entities List
- create
Time String - Namespace Creation Time
- description String
- Namespace Description
- namespace
Id String - Namespace Unique ID
- namespace
Name String - Namespace Name
- project
Name String - Project Associated with Namespace
- List<Property Map>
- Namespace Tag List Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
- trn String
- Namespace TRN
- update
Time String - Namespace Update Time
Supporting Types
PermissionNamespaceTag, PermissionNamespaceTagArgs
Import
$ pulumi import bytepluscc:id/permissionNamespace:PermissionNamespace example "namespace_name"
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- bytepluscc byteplus-sdk/pulumi-bytepluscc
- License
- MPL-2.0
- Notes
- This Pulumi package is based on the
byteplusccTerraform Provider.
published on Monday, Jul 20, 2026 by Byteplus