Renaming a Project (CLI)

You can rename a project with file retention if the project is empty and has an unexpired grace period. If retention is set on an empty project and the grace period is met or not set, you cannot rename the project until the expiration period has been met. A non-empty project cannot be renamed until all retained filesystems within the project have an expired retention value. For more information, see File Retention Management.

Caution:

Changing a project name will disrupt active client I/O operations.

Disconnect any active clients connected to the project.
Go to shares.
```
hostname:> shares
```
To view the projects, use the list command.
```
hostname:shares> list
default
home
```
Enter rename, the existing project name, and the new project name.
The name must be 1 to 64 characters in length. The name cannot begin with a period (.) and cannot include spaces. Allowable characters are alphanumeric characters and special characters _ - . :
```
hostname:shares> rename home project1
```
To confirm the project was renamed, use the list command.
```
hostname:shares> list
default
project1
```