AWS::RedshiftServerless::Namespace

A collection of database objects and users.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::RedshiftServerless::Namespace",
  "Properties" : {
      "AdminUsername" : String,
      "AdminUserPassword" : String,
      "DbName" : String,
      "DefaultIamRoleArn" : String,
      "FinalSnapshotName" : String,
      "FinalSnapshotRetentionPeriod" : Integer,
      "IamRoles" : [ String, ... ],
      "KmsKeyId" : String,
      "LogExports" : [ String, ... ],
      "NamespaceName" : String,
      "Tags" : [ Tag, ... ]
    }
}

YAML

Type: AWS::RedshiftServerless::Namespace
Properties: 
  AdminUsername: String
  AdminUserPassword: String
  DbName: String
  DefaultIamRoleArn: String
  FinalSnapshotName: String
  FinalSnapshotRetentionPeriod: Integer
  IamRoles: 
    - String
  KmsKeyId: String
  LogExports: 
    - String
  NamespaceName: String
  Tags: 
    - Tag

Properties

AdminUsername

The username of the administrator for the primary database created in the namespace.

Required: No

Type: String

Update requires: No interruption

AdminUserPassword

The password of the administrator for the primary database created in the namespace.

Required: No

Type: String

Update requires: No interruption

DbName

The name of the primary database created in the namespace.

Required: No

Type: String

Update requires: No interruption

DefaultIamRoleArn

The Amazon Resource Name (ARN) of the IAM role to set as a default in the namespace.

Required: No

Type: String

Update requires: No interruption

FinalSnapshotName

The name of the snapshot to be created before the namespace is deleted.

Required: No

Type: String

Update requires: No interruption

FinalSnapshotRetentionPeriod

How long to retain the final snapshot.

Required: No

Type: Integer

Update requires: No interruption

IamRoles

A list of IAM roles to associate with the namespace.

Required: No

Type: List of String

Update requires: No interruption

KmsKeyId

The ID of the AWS Key Management Service key used to encrypt your data.

Required: No

Type: String

Update requires: No interruption

LogExports

The types of logs the namespace can export. Available export types are userlog, connectionlog, and useractivitylog.

Required: No

Type: List of String

Update requires: No interruption

NamespaceName

The name of the namespace. Must be between 3-64 alphanumeric characters in lowercase, and it cannot be a reserved word. A list of reserved words can be found in Reserved Words in the Amazon Redshift Database Developer Guide.

Required: Yes

Type: String

Update requires: Replacement

Tags

The map of the key-value pairs used to tag the namespace.

Required: No

Type: List of Tag

Update requires: Replacement

Return values

Ref

When the logical ID of this resource is provided to the Ref intrinsic function, Ref returns the NamespaceName, such as sample-namespace. For more information about using the Ref function, see Ref.

Fn::GetAtt

GetAtt returns a value for a specified attribute of this type. For more information, see Fn::GetAtt. The following are the available attributes and sample return values.

Namespace

The collection of computing resources from which an endpoint is created.

Namespace.AdminUsername

The username of the administrator for the first database created in the namespace.

Namespace.CreationDate

The date of when the namespace was created.

Namespace.DbName

The name of the first database created in the namespace.

Namespace.DefaultIamRoleArn

The Amazon Resource Name (ARN) of the IAM role to set as a default in the namespace.

Namespace.IamRoles

A list of IAM roles to associate with the namespace.

Namespace.KmsKeyId

The ID of the AWS Key Management Service key used to encrypt your data.

Namespace.LogExports

The types of logs the namespace can export. Available export types are User log, Connection log, and User activity log.

Namespace.NamespaceArn

The Amazon Resource Name (ARN) associated with a namespace.

Namespace.NamespaceId

The unique identifier of a namespace.

Namespace.NamespaceName

The name of the namespace. Must be between 3-64 alphanumeric characters in lowercase, and it cannot be a reserved word. A list of reserved words can be found in Reserved Words in the Amazon Redshift Database Developer Guide.

Namespace.Status

The status of the namespace.