list_namespaces

list_namespaces(**kwargs)

Returns information about a list of specified namespaces.

See also: AWS API Documentation

Request Syntax

response = client.list_namespaces(
    maxResults=123,
    nextToken='string'
)
Parameters
  • maxResults (integer) -- An optional parameter that specifies the maximum number of results to return. You can use nextToken to display the next page of results.
  • nextToken (string) -- If your initial ListNamespaces operation returns a nextToken , you can include the returned nextToken in following ListNamespaces operations, which returns results in the next page.
Return type

dict

Returns

Response Syntax

{
    'namespaces': [
        {
            'adminUsername': 'string',
            'creationDate': datetime(2015, 1, 1),
            'dbName': 'string',
            'defaultIamRoleArn': 'string',
            'iamRoles': [
                'string',
            ],
            'kmsKeyId': 'string',
            'logExports': [
                'useractivitylog'|'userlog'|'connectionlog',
            ],
            'namespaceArn': 'string',
            'namespaceId': 'string',
            'namespaceName': 'string',
            'status': 'AVAILABLE'|'MODIFYING'|'DELETING'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • namespaces (list) --

      The list of returned namespaces.

      • (dict) --

        A collection of database objects and users.

        • adminUsername (string) --

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

        • creationDate (datetime) --

          The date of when the namespace was created.

        • dbName (string) --

          The name of the first database created in the namespace.

        • defaultIamRoleArn (string) --

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

        • iamRoles (list) --

          A list of IAM roles to associate with the namespace.

          • (string) --
        • kmsKeyId (string) --

          The ID of the Amazon Web Services Key Management Service key used to encrypt your data.

        • logExports (list) --

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

          • (string) --
        • namespaceArn (string) --

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

        • namespaceId (string) --

          The unique identifier of a namespace.

        • namespaceName (string) --

          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.

        • status (string) --

          The status of the namespace.

    • nextToken (string) --

      When nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page.

Exceptions

  • RedshiftServerless.Client.exceptions.InternalServerException
  • RedshiftServerless.Client.exceptions.ValidationException