# Namespace operations
<a name="namespace-operations"></a>

An Amazon Quick Sight *namespace* is a logical container that you can use to organize clients, subsidiaries, teams, and so on. By using a namespace, you can isolate the Amazon Quick Sight users and groups that are registered for that namespace. Users that access the namespace can share assets only with other users or groups in the same namespace. They can't see users and groups in other namespaces. For more information about namespaces, see [Supporting multitenancy with isolated namespaces](https://docs.aws.amazon.com/quicksight/latest/user/namespaces.html) in the *Quick Sight User guide*.

To implement namespaces, you use the following Quick Sight API operations.

**Topics**
+ [CreateNamespace](create-namespace.md)
+ [DeleteNamespace](delete-namespace.md)
+ [DescribeNamespace](describe-namespace.md)
+ [ListNamespaces](list-namespaces.md)

# CreateNamespace
<a name="create-namespace"></a>

Use the `CreateNamespace` API operation to create a new namespace for you to use with Amazon Quick Sight.

You can create a namespace after your AWS account is subscribed to Amazon Quick Sight. The namespace must be unique within the AWS account. By default, there is a limit of 100 namespaces per AWS account. To increase your limit, create a ticket with AWS Support.

Following is an example AWS CLI command for this operation.

------
#### [ AWS CLI ]

```
aws quicksight create-namespace 
    --aws-account-id AWSACCOUNTID 
    --namespace NAMESPACE \
    --identity-store QUICKSIGHT
```

You can also make this command using a CLI skeleton file with the following command. For more information about CLI skeleton files, see [Use CLI skeleton files](cli-skeletons.md).

```
aws quicksight create-namespace 
    --cli-input-json file://createnamespace.json
```

------

For more information about the `CreateNamespace` API operation, see [CreateNamespace](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateNamespace.html) in the *Amazon Quick Sight API Reference*.

# DeleteNamespace
<a name="delete-namespace"></a>

Use the `DeleteNamespace` API operation to delete a namespace and the users and groups that are associated with the namespace. This is an asynchronous process. Assets including dashboards, analyses, datasets, and data sources are not deleted. To delete these assets, you use the relevant API operations for each asset, such as `DeleteDashboard` or `DeleteDataSet`.

Following is an example AWS CLI command for this operation.

------
#### [ AWS CLI ]

```
aws quicksight delete-namespace 
    --aws-account-id AWSACCOUNTID 
    --namespace NAMESPACE
```

Find a namespace by running the `ListNamespaces` operation.

------

For more information about the `DeleteNamespace` API operation, see [DeleteNamespace](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DeleteNamespace.html) in the *Amazon Quick Sight API Reference*.

# DescribeNamespace
<a name="describe-namespace"></a>

Use the `DescribeNamespace` API operation to describe a specified namespace. Following is an example AWS CLI command for this operation.

------
#### [ AWS CLI ]

```
aws quicksight describe-namespace 
    --aws-account-id AWSACCOUNTID 
    --namespace NAMESPACE
```

------

For more information about the `DescribeNamespace` API operation, see [DescribeNamespace](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeNamespace.html) in the *Amazon Quick Sight API Reference*.

# ListNamespaces
<a name="list-namespaces"></a>

Use the `ListNamespaces` API operation to list namespaces for a specified AWS account. Following is an example AWS CLI command for this operation.

------
#### [ AWS CLI ]

```
aws quicksight list-namespaces 
    --aws-account-id AWSACCOUNTID 
    --page-size 10
    --max-items 100
```

------

For more information about the `ListNamespaces` API operation, see [ListNamespaces](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListNamespaces.html) in the *Amazon Quick Sight API Reference*.