Sign in Dashboard Get started
  1. Packages
  2. Packages
  3. AWS
  4. API Docs
  5. redshift
  6. NamespaceRegistration
Viewing docs for AWS v7.30.0
published on Thursday, May 14, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws

aws.redshift.NamespaceRegistration

aws logo
Viewing docs for AWS v7.30.0
published on Thursday, May 14, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws

    Manages an Amazon Redshift namespace registration to the AWS Glue Data Catalog. Use this resource to enable access to a Redshift data warehouse using the Apache Iceberg REST API.

    NOTE: This resource has limited drift detection capabilities. AWS does not provide a reliable API to verify registration status after creation. The resource verifies that the underlying cluster or namespace exists and that an internal data share was created, but cannot detect if the registration was removed outside of Terraform.

    Example Usage

    Serverless Namespace

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
import * as std from "@pulumi/std";

const current = aws.getCallerIdentity({});
const example = new aws.redshiftserverless.Namespace("example", {
    namespaceName: "example",
    dbName: "example",
});
const exampleWorkgroup = new aws.redshiftserverless.Workgroup("example", {
    namespaceName: example.namespaceName,
    workgroupName: "example",
});
const exampleNamespaceRegistration = new aws.redshift.NamespaceRegistration("example", {
    consumerIdentifier: std.format({
        input: "DataCatalog/%s",
        args: [current.then(current => current.accountId)],
    }).then(invoke => invoke.result),
    namespaceType: "serverless",
    serverlessNamespaceIdentifier: example.namespaceName,
    serverlessWorkgroupIdentifier: exampleWorkgroup.workgroupName,
});

    import pulumi
import pulumi_aws as aws
import pulumi_std as std

current = aws.get_caller_identity()
example = aws.redshiftserverless.Namespace("example",
    namespace_name="example",
    db_name="example")
example_workgroup = aws.redshiftserverless.Workgroup("example",
    namespace_name=example.namespace_name,
    workgroup_name="example")
example_namespace_registration = aws.redshift.NamespaceRegistration("example",
    consumer_identifier=std.format(input="DataCatalog/%s",
        args=[current.account_id]).result,
    namespace_type="serverless",
    serverless_namespace_identifier=example.namespace_name,
    serverless_workgroup_identifier=example_workgroup.workgroup_name)

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws"
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/redshift"
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/redshiftserverless"
	"github.com/pulumi/pulumi-std/sdk/go/std"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		current, err := aws.GetCallerIdentity(ctx, &aws.GetCallerIdentityArgs{}, nil)
		if err != nil {
			return err
		}
		example, err := redshiftserverless.NewNamespace(ctx, "example", &redshiftserverless.NamespaceArgs{
			NamespaceName: pulumi.String("example"),
			DbName:        pulumi.String("example"),
		})
		if err != nil {
			return err
		}
		exampleWorkgroup, err := redshiftserverless.NewWorkgroup(ctx, "example", &redshiftserverless.WorkgroupArgs{
			NamespaceName: example.NamespaceName,
			WorkgroupName: pulumi.String("example"),
		})
		if err != nil {
			return err
		}
		invokeFormat, err := std.Format(ctx, &std.FormatArgs{
			Input: "DataCatalog/%s",
			Args: []*string{
				current.AccountId,
			},
		}, nil)
		if err != nil {
			return err
		}
		_, err = redshift.NewNamespaceRegistration(ctx, "example", &redshift.NamespaceRegistrationArgs{
			ConsumerIdentifier:            pulumi.String(invokeFormat.Result),
			NamespaceType:                 pulumi.String("serverless"),
			ServerlessNamespaceIdentifier: example.NamespaceName,
			ServerlessWorkgroupIdentifier: exampleWorkgroup.WorkgroupName,
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
using Std = Pulumi.Std;

return await Deployment.RunAsync(() => 
{
    var current = Aws.GetCallerIdentity.Invoke();

    var example = new Aws.RedshiftServerless.Namespace("example", new()
    {
        NamespaceName = "example",
        DbName = "example",
    });

    var exampleWorkgroup = new Aws.RedshiftServerless.Workgroup("example", new()
    {
        NamespaceName = example.NamespaceName,
        WorkgroupName = "example",
    });

    var exampleNamespaceRegistration = new Aws.RedShift.NamespaceRegistration("example", new()
    {
        ConsumerIdentifier = Std.Format.Invoke(new()
        {
            Input = "DataCatalog/%s",
            Args = new[]
            {
                current.Apply(getCallerIdentityResult => getCallerIdentityResult.AccountId),
            },
        }).Apply(invoke => invoke.Result),
        NamespaceType = "serverless",
        ServerlessNamespaceIdentifier = example.NamespaceName,
        ServerlessWorkgroupIdentifier = exampleWorkgroup.WorkgroupName,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.AwsFunctions;
import com.pulumi.aws.inputs.GetCallerIdentityArgs;
import com.pulumi.aws.redshiftserverless.Namespace;
import com.pulumi.aws.redshiftserverless.NamespaceArgs;
import com.pulumi.aws.redshiftserverless.Workgroup;
import com.pulumi.aws.redshiftserverless.WorkgroupArgs;
import com.pulumi.aws.redshift.NamespaceRegistration;
import com.pulumi.aws.redshift.NamespaceRegistrationArgs;
import com.pulumi.std.StdFunctions;
import com.pulumi.std.inputs.FormatArgs;
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) {
        final var current = AwsFunctions.getCallerIdentity(GetCallerIdentityArgs.builder()
            .build());

        var example = new Namespace("example", NamespaceArgs.builder()
            .namespaceName("example")
            .dbName("example")
            .build());

        var exampleWorkgroup = new Workgroup("exampleWorkgroup", WorkgroupArgs.builder()
            .namespaceName(example.namespaceName())
            .workgroupName("example")
            .build());

        var exampleNamespaceRegistration = new NamespaceRegistration("exampleNamespaceRegistration", NamespaceRegistrationArgs.builder()
            .consumerIdentifier(StdFunctions.format(FormatArgs.builder()
                .input("DataCatalog/%s")
                .args(current.accountId())
                .build()).result())
            .namespaceType("serverless")
            .serverlessNamespaceIdentifier(example.namespaceName())
            .serverlessWorkgroupIdentifier(exampleWorkgroup.workgroupName())
            .build());

    }
}

    resources:
  example:
    type: aws:redshiftserverless:Namespace
    properties:
      namespaceName: example
      dbName: example
  exampleWorkgroup:
    type: aws:redshiftserverless:Workgroup
    name: example
    properties:
      namespaceName: ${example.namespaceName}
      workgroupName: example
  exampleNamespaceRegistration:
    type: aws:redshift:NamespaceRegistration
    name: example
    properties:
      consumerIdentifier:
        fn::invoke:
          function: std:format
          arguments:
            input: DataCatalog/%s
            args:
              - ${current.accountId}
          return: result
      namespaceType: serverless
      serverlessNamespaceIdentifier: ${example.namespaceName}
      serverlessWorkgroupIdentifier: ${exampleWorkgroup.workgroupName}
variables:
  current:
    fn::invoke:
      function: aws:getCallerIdentity
      arguments: {}

    Example coming soon!

    Provisioned Cluster

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
import * as std from "@pulumi/std";

const current = aws.getCallerIdentity({});
const example = new aws.redshift.Cluster("example", {
    clusterIdentifier: "example",
    databaseName: "example",
    masterUsername: "exampleuser",
    masterPassword: "ExamplePassword123!",
    nodeType: "dc2.large",
    clusterType: "single-node",
});
const exampleNamespaceRegistration = new aws.redshift.NamespaceRegistration("example", {
    consumerIdentifier: std.format({
        input: "DataCatalog/%s",
        args: [current.then(current => current.accountId)],
    }).then(invoke => invoke.result),
    namespaceType: "provisioned",
    provisionedClusterIdentifier: example.clusterIdentifier,
});

    import pulumi
import pulumi_aws as aws
import pulumi_std as std

current = aws.get_caller_identity()
example = aws.redshift.Cluster("example",
    cluster_identifier="example",
    database_name="example",
    master_username="exampleuser",
    master_password="ExamplePassword123!",
    node_type="dc2.large",
    cluster_type="single-node")
example_namespace_registration = aws.redshift.NamespaceRegistration("example",
    consumer_identifier=std.format(input="DataCatalog/%s",
        args=[current.account_id]).result,
    namespace_type="provisioned",
    provisioned_cluster_identifier=example.cluster_identifier)

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws"
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/redshift"
	"github.com/pulumi/pulumi-std/sdk/go/std"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		current, err := aws.GetCallerIdentity(ctx, &aws.GetCallerIdentityArgs{}, nil)
		if err != nil {
			return err
		}
		example, err := redshift.NewCluster(ctx, "example", &redshift.ClusterArgs{
			ClusterIdentifier: pulumi.String("example"),
			DatabaseName:      pulumi.String("example"),
			MasterUsername:    pulumi.String("exampleuser"),
			MasterPassword:    pulumi.String("ExamplePassword123!"),
			NodeType:          pulumi.String("dc2.large"),
			ClusterType:       pulumi.String("single-node"),
		})
		if err != nil {
			return err
		}
		invokeFormat, err := std.Format(ctx, &std.FormatArgs{
			Input: "DataCatalog/%s",
			Args: []*string{
				current.AccountId,
			},
		}, nil)
		if err != nil {
			return err
		}
		_, err = redshift.NewNamespaceRegistration(ctx, "example", &redshift.NamespaceRegistrationArgs{
			ConsumerIdentifier:           pulumi.String(invokeFormat.Result),
			NamespaceType:                pulumi.String("provisioned"),
			ProvisionedClusterIdentifier: example.ClusterIdentifier,
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
using Std = Pulumi.Std;

return await Deployment.RunAsync(() => 
{
    var current = Aws.GetCallerIdentity.Invoke();

    var example = new Aws.RedShift.Cluster("example", new()
    {
        ClusterIdentifier = "example",
        DatabaseName = "example",
        MasterUsername = "exampleuser",
        MasterPassword = "ExamplePassword123!",
        NodeType = "dc2.large",
        ClusterType = "single-node",
    });

    var exampleNamespaceRegistration = new Aws.RedShift.NamespaceRegistration("example", new()
    {
        ConsumerIdentifier = Std.Format.Invoke(new()
        {
            Input = "DataCatalog/%s",
            Args = new[]
            {
                current.Apply(getCallerIdentityResult => getCallerIdentityResult.AccountId),
            },
        }).Apply(invoke => invoke.Result),
        NamespaceType = "provisioned",
        ProvisionedClusterIdentifier = example.ClusterIdentifier,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.AwsFunctions;
import com.pulumi.aws.inputs.GetCallerIdentityArgs;
import com.pulumi.aws.redshift.Cluster;
import com.pulumi.aws.redshift.ClusterArgs;
import com.pulumi.aws.redshift.NamespaceRegistration;
import com.pulumi.aws.redshift.NamespaceRegistrationArgs;
import com.pulumi.std.StdFunctions;
import com.pulumi.std.inputs.FormatArgs;
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) {
        final var current = AwsFunctions.getCallerIdentity(GetCallerIdentityArgs.builder()
            .build());

        var example = new Cluster("example", ClusterArgs.builder()
            .clusterIdentifier("example")
            .databaseName("example")
            .masterUsername("exampleuser")
            .masterPassword("ExamplePassword123!")
            .nodeType("dc2.large")
            .clusterType("single-node")
            .build());

        var exampleNamespaceRegistration = new NamespaceRegistration("exampleNamespaceRegistration", NamespaceRegistrationArgs.builder()
            .consumerIdentifier(StdFunctions.format(FormatArgs.builder()
                .input("DataCatalog/%s")
                .args(current.accountId())
                .build()).result())
            .namespaceType("provisioned")
            .provisionedClusterIdentifier(example.clusterIdentifier())
            .build());

    }
}

    resources:
  example:
    type: aws:redshift:Cluster
    properties:
      clusterIdentifier: example
      databaseName: example
      masterUsername: exampleuser
      masterPassword: ExamplePassword123!
      nodeType: dc2.large
      clusterType: single-node
  exampleNamespaceRegistration:
    type: aws:redshift:NamespaceRegistration
    name: example
    properties:
      consumerIdentifier:
        fn::invoke:
          function: std:format
          arguments:
            input: DataCatalog/%s
            args:
              - ${current.accountId}
          return: result
      namespaceType: provisioned
      provisionedClusterIdentifier: ${example.clusterIdentifier}
variables:
  current:
    fn::invoke:
      function: aws:getCallerIdentity
      arguments: {}

    Example coming soon!

    Create NamespaceRegistration Resource

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

    Constructor syntax

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

@overload
def NamespaceRegistration(resource_name: str,
                          opts: Optional[ResourceOptions] = None,
                          consumer_identifier: Optional[str] = None,
                          namespace_type: Optional[str] = None,
                          provisioned_cluster_identifier: Optional[str] = None,
                          region: Optional[str] = None,
                          serverless_namespace_identifier: Optional[str] = None,
                          serverless_workgroup_identifier: Optional[str] = None)
    func NewNamespaceRegistration(ctx *Context, name string, args NamespaceRegistrationArgs, opts ...ResourceOption) (*NamespaceRegistration, error)
    public NamespaceRegistration(string name, NamespaceRegistrationArgs args, CustomResourceOptions? opts = null)
    public NamespaceRegistration(String name, NamespaceRegistrationArgs args)
public NamespaceRegistration(String name, NamespaceRegistrationArgs args, CustomResourceOptions options)

    type: aws:redshift:NamespaceRegistration
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "aws_redshift_namespaceregistration" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args NamespaceRegistrationArgs
    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 NamespaceRegistrationArgs
    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 NamespaceRegistrationArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args NamespaceRegistrationArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args NamespaceRegistrationArgs
    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 namespaceRegistrationResource = new Aws.RedShift.NamespaceRegistration("namespaceRegistrationResource", new()
{
    ConsumerIdentifier = "string",
    NamespaceType = "string",
    ProvisionedClusterIdentifier = "string",
    Region = "string",
    ServerlessNamespaceIdentifier = "string",
    ServerlessWorkgroupIdentifier = "string",
});

    example, err := redshift.NewNamespaceRegistration(ctx, "namespaceRegistrationResource", &redshift.NamespaceRegistrationArgs{
	ConsumerIdentifier:            pulumi.String("string"),
	NamespaceType:                 pulumi.String("string"),
	ProvisionedClusterIdentifier:  pulumi.String("string"),
	Region:                        pulumi.String("string"),
	ServerlessNamespaceIdentifier: pulumi.String("string"),
	ServerlessWorkgroupIdentifier: pulumi.String("string"),
})

    resource "aws_redshift_namespaceregistration" "namespaceRegistrationResource" {
  consumer_identifier             = "string"
  namespace_type                  = "string"
  provisioned_cluster_identifier  = "string"
  region                          = "string"
  serverless_namespace_identifier = "string"
  serverless_workgroup_identifier = "string"
}

    var namespaceRegistrationResource = new NamespaceRegistration("namespaceRegistrationResource", NamespaceRegistrationArgs.builder()
    .consumerIdentifier("string")
    .namespaceType("string")
    .provisionedClusterIdentifier("string")
    .region("string")
    .serverlessNamespaceIdentifier("string")
    .serverlessWorkgroupIdentifier("string")
    .build());

    namespace_registration_resource = aws.redshift.NamespaceRegistration("namespaceRegistrationResource",
    consumer_identifier="string",
    namespace_type="string",
    provisioned_cluster_identifier="string",
    region="string",
    serverless_namespace_identifier="string",
    serverless_workgroup_identifier="string")

    const namespaceRegistrationResource = new aws.redshift.NamespaceRegistration("namespaceRegistrationResource", {
    consumerIdentifier: "string",
    namespaceType: "string",
    provisionedClusterIdentifier: "string",
    region: "string",
    serverlessNamespaceIdentifier: "string",
    serverlessWorkgroupIdentifier: "string",
});

    type: aws:redshift:NamespaceRegistration
properties:
    consumerIdentifier: string
    namespaceType: string
    provisionedClusterIdentifier: string
    region: string
    serverlessNamespaceIdentifier: string
    serverlessWorkgroupIdentifier: string

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

    ConsumerIdentifier string
    Consumer identifier for the registration. Typically in the format DataCatalog/<account-id>.
    NamespaceType string

    Type of namespace being registered. Valid values: serverless, provisioned.

    The following arguments are optional:

    ProvisionedClusterIdentifier string
    Identifier of the provisioned cluster. Required when namespaceType is provisioned.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    ServerlessNamespaceIdentifier string
    Identifier of the serverless namespace. Required when namespaceType is serverless. Can be either the namespace name or namespace ID (UUID).
    ServerlessWorkgroupIdentifier string
    Identifier of the serverless workgroup. Required when namespaceType is serverless.
    ConsumerIdentifier string
    Consumer identifier for the registration. Typically in the format DataCatalog/<account-id>.
    NamespaceType string

    Type of namespace being registered. Valid values: serverless, provisioned.

    The following arguments are optional:

    ProvisionedClusterIdentifier string
    Identifier of the provisioned cluster. Required when namespaceType is provisioned.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    ServerlessNamespaceIdentifier string
    Identifier of the serverless namespace. Required when namespaceType is serverless. Can be either the namespace name or namespace ID (UUID).
    ServerlessWorkgroupIdentifier string
    Identifier of the serverless workgroup. Required when namespaceType is serverless.
    consumer_identifier string
    Consumer identifier for the registration. Typically in the format DataCatalog/<account-id>.
    namespace_type string

    Type of namespace being registered. Valid values: serverless, provisioned.

    The following arguments are optional:

    provisioned_cluster_identifier string
    Identifier of the provisioned cluster. Required when namespaceType is provisioned.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    serverless_namespace_identifier string
    Identifier of the serverless namespace. Required when namespaceType is serverless. Can be either the namespace name or namespace ID (UUID).
    serverless_workgroup_identifier string
    Identifier of the serverless workgroup. Required when namespaceType is serverless.
    consumerIdentifier String
    Consumer identifier for the registration. Typically in the format DataCatalog/<account-id>.
    namespaceType String

    Type of namespace being registered. Valid values: serverless, provisioned.

    The following arguments are optional:

    provisionedClusterIdentifier String
    Identifier of the provisioned cluster. Required when namespaceType is provisioned.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    serverlessNamespaceIdentifier String
    Identifier of the serverless namespace. Required when namespaceType is serverless. Can be either the namespace name or namespace ID (UUID).
    serverlessWorkgroupIdentifier String
    Identifier of the serverless workgroup. Required when namespaceType is serverless.
    consumerIdentifier string
    Consumer identifier for the registration. Typically in the format DataCatalog/<account-id>.
    namespaceType string

    Type of namespace being registered. Valid values: serverless, provisioned.

    The following arguments are optional:

    provisionedClusterIdentifier string
    Identifier of the provisioned cluster. Required when namespaceType is provisioned.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    serverlessNamespaceIdentifier string
    Identifier of the serverless namespace. Required when namespaceType is serverless. Can be either the namespace name or namespace ID (UUID).
    serverlessWorkgroupIdentifier string
    Identifier of the serverless workgroup. Required when namespaceType is serverless.
    consumer_identifier str
    Consumer identifier for the registration. Typically in the format DataCatalog/<account-id>.
    namespace_type str

    Type of namespace being registered. Valid values: serverless, provisioned.

    The following arguments are optional:

    provisioned_cluster_identifier str
    Identifier of the provisioned cluster. Required when namespaceType is provisioned.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    serverless_namespace_identifier str
    Identifier of the serverless namespace. Required when namespaceType is serverless. Can be either the namespace name or namespace ID (UUID).
    serverless_workgroup_identifier str
    Identifier of the serverless workgroup. Required when namespaceType is serverless.
    consumerIdentifier String
    Consumer identifier for the registration. Typically in the format DataCatalog/<account-id>.
    namespaceType String

    Type of namespace being registered. Valid values: serverless, provisioned.

    The following arguments are optional:

    provisionedClusterIdentifier String
    Identifier of the provisioned cluster. Required when namespaceType is provisioned.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    serverlessNamespaceIdentifier String
    Identifier of the serverless namespace. Required when namespaceType is serverless. Can be either the namespace name or namespace ID (UUID).
    serverlessWorkgroupIdentifier String
    Identifier of the serverless workgroup. Required when namespaceType is serverless.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing NamespaceRegistration Resource

    Get an existing NamespaceRegistration 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?: NamespaceRegistrationState, opts?: CustomResourceOptions): NamespaceRegistration
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        consumer_identifier: Optional[str] = None,
        namespace_type: Optional[str] = None,
        provisioned_cluster_identifier: Optional[str] = None,
        region: Optional[str] = None,
        serverless_namespace_identifier: Optional[str] = None,
        serverless_workgroup_identifier: Optional[str] = None) -> NamespaceRegistration
    func GetNamespaceRegistration(ctx *Context, name string, id IDInput, state *NamespaceRegistrationState, opts ...ResourceOption) (*NamespaceRegistration, error)
    public static NamespaceRegistration Get(string name, Input<string> id, NamespaceRegistrationState? state, CustomResourceOptions? opts = null)
    public static NamespaceRegistration get(String name, Output<String> id, NamespaceRegistrationState state, CustomResourceOptions options)
    resources:  _:    type: aws:redshift:NamespaceRegistration    get:      id: ${id}
    import {
  to = aws_redshift_namespaceregistration.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.
    The following state arguments are supported:
    ConsumerIdentifier string
    Consumer identifier for the registration. Typically in the format DataCatalog/<account-id>.
    NamespaceType string

    Type of namespace being registered. Valid values: serverless, provisioned.

    The following arguments are optional:

    ProvisionedClusterIdentifier string
    Identifier of the provisioned cluster. Required when namespaceType is provisioned.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    ServerlessNamespaceIdentifier string
    Identifier of the serverless namespace. Required when namespaceType is serverless. Can be either the namespace name or namespace ID (UUID).
    ServerlessWorkgroupIdentifier string
    Identifier of the serverless workgroup. Required when namespaceType is serverless.
    ConsumerIdentifier string
    Consumer identifier for the registration. Typically in the format DataCatalog/<account-id>.
    NamespaceType string

    Type of namespace being registered. Valid values: serverless, provisioned.

    The following arguments are optional:

    ProvisionedClusterIdentifier string
    Identifier of the provisioned cluster. Required when namespaceType is provisioned.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    ServerlessNamespaceIdentifier string
    Identifier of the serverless namespace. Required when namespaceType is serverless. Can be either the namespace name or namespace ID (UUID).
    ServerlessWorkgroupIdentifier string
    Identifier of the serverless workgroup. Required when namespaceType is serverless.
    consumer_identifier string
    Consumer identifier for the registration. Typically in the format DataCatalog/<account-id>.
    namespace_type string

    Type of namespace being registered. Valid values: serverless, provisioned.

    The following arguments are optional:

    provisioned_cluster_identifier string
    Identifier of the provisioned cluster. Required when namespaceType is provisioned.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    serverless_namespace_identifier string
    Identifier of the serverless namespace. Required when namespaceType is serverless. Can be either the namespace name or namespace ID (UUID).
    serverless_workgroup_identifier string
    Identifier of the serverless workgroup. Required when namespaceType is serverless.
    consumerIdentifier String
    Consumer identifier for the registration. Typically in the format DataCatalog/<account-id>.
    namespaceType String

    Type of namespace being registered. Valid values: serverless, provisioned.

    The following arguments are optional:

    provisionedClusterIdentifier String
    Identifier of the provisioned cluster. Required when namespaceType is provisioned.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    serverlessNamespaceIdentifier String
    Identifier of the serverless namespace. Required when namespaceType is serverless. Can be either the namespace name or namespace ID (UUID).
    serverlessWorkgroupIdentifier String
    Identifier of the serverless workgroup. Required when namespaceType is serverless.
    consumerIdentifier string
    Consumer identifier for the registration. Typically in the format DataCatalog/<account-id>.
    namespaceType string

    Type of namespace being registered. Valid values: serverless, provisioned.

    The following arguments are optional:

    provisionedClusterIdentifier string
    Identifier of the provisioned cluster. Required when namespaceType is provisioned.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    serverlessNamespaceIdentifier string
    Identifier of the serverless namespace. Required when namespaceType is serverless. Can be either the namespace name or namespace ID (UUID).
    serverlessWorkgroupIdentifier string
    Identifier of the serverless workgroup. Required when namespaceType is serverless.
    consumer_identifier str
    Consumer identifier for the registration. Typically in the format DataCatalog/<account-id>.
    namespace_type str

    Type of namespace being registered. Valid values: serverless, provisioned.

    The following arguments are optional:

    provisioned_cluster_identifier str
    Identifier of the provisioned cluster. Required when namespaceType is provisioned.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    serverless_namespace_identifier str
    Identifier of the serverless namespace. Required when namespaceType is serverless. Can be either the namespace name or namespace ID (UUID).
    serverless_workgroup_identifier str
    Identifier of the serverless workgroup. Required when namespaceType is serverless.
    consumerIdentifier String
    Consumer identifier for the registration. Typically in the format DataCatalog/<account-id>.
    namespaceType String

    Type of namespace being registered. Valid values: serverless, provisioned.

    The following arguments are optional:

    provisionedClusterIdentifier String
    Identifier of the provisioned cluster. Required when namespaceType is provisioned.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    serverlessNamespaceIdentifier String
    Identifier of the serverless namespace. Required when namespaceType is serverless. Can be either the namespace name or namespace ID (UUID).
    serverlessWorkgroupIdentifier String
    Identifier of the serverless workgroup. Required when namespaceType is serverless.

    Import

    For provisioned clusters:

    Identity Schema

    Required

    • consumerIdentifier (String) Consumer identifier for the registration.
    • namespaceType (String) Type of namespace being registered. Valid values: serverless, provisioned.

    Optional

    • provisionedClusterIdentifier (String) Identifier of the provisioned cluster. Required when namespaceType is provisioned.
    • serverlessNamespaceIdentifier (String) Identifier of the serverless namespace. Required when namespaceType is serverless.
    • serverlessWorkgroupIdentifier (String) Identifier of the serverless workgroup. Required when namespaceType is serverless.

    For provisioned clusters:

    Using pulumi import, import Redshift Namespace Registration using the composite ID. For example:

    For serverless namespaces:

    $ pulumi import aws:redshift/namespaceRegistration:NamespaceRegistration example DataCatalog/123456789012,example-namespace,example-workgroup

    For provisioned clusters:

    $ pulumi import aws:redshift/namespaceRegistration:NamespaceRegistration example DataCatalog/123456789012,example-cluster

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

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo
    Viewing docs for AWS v7.30.0
    published on Thursday, May 14, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial