Renaming a storage pool

Use the pool_rename command to rename a specified storage pool.

pool_rename pool=PoolName new_name=Name

Parameters

Name Type Description Mandatory
pool Object name Name of the storage pool. Y
new_name Object name New name of the storage pool. Y

The new name of the storage pool must be unique in the system.

This command succeeds even if the new name is identical to the current name.

Example: 

pool_rename pool=DBPool new_name=ERPPool

Output: 

Command completed successfully.

Access control

User Category Permission
Storage administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
Read-only users Disallowed
Operations administrator Disallowed
Host side accelerator client Disallowed

Return codes

  • POOL_DOES_NOT_EXIST

    Storage pool does not exist.

  • POOL_NAME_EXISTS

    Storage pool name already assigned to another storage pool.

  • OPERATION_DENIED_OBJECT_MANAGED

    This is a managed object. Only the managing software and xiv_maintenance / xiv_development may complete this operation on this object.