Previous Next JavaScript must be enabled to correctly display this content

## pool

Encapsulates commands that manipulates Storage Node pools, which are used for resource allocations. The subcommands are as follows:

- pool clone

- pool create

- pool join

- pool leave

- pool remove

### pool clone

    pool clone -name <name> -from <source pool name> [-json]

Clone an existing Storage Node pool to a new Storage Node pool to be used for resource distribution when creating or modifying a store.

For more information on using a cloned Storage Node pool when contracting a topology, see Contracting a Topology.

    kv-> pool clone -name mypool from snpool -json{
    "operation" : "pool clone",
    "returnCode" : 5000,
    "description" : "Operation ends successfully",
    "returnValue" : {
    	"poolName" : "mypool"
    	}
    }

### pool create

    pool create -name <name> -json

Creates a new Storage Node pool to be used for resource distribution when creating or modifying a store.

For more information on creating a Storage Node pool, see Create a Storage Node Pool.

    kv-> pool create -name newPool -json{
    "operation" : "pool create",
    "returnCode" : 5000,
    "description" : "Operation ends successfully",
    "returnValue" : {
    	"storeName" : "newPool"
    	}
    }

### pool join

    pool join -name <name> [-sn <snX>]* [-json]

Adds Storage Nodes to an existing Storage Node pool.

    kv-> pool join -name newPool -sn sn1 -json{
    "operation" : "pool join",
    "returnCode" : 5000,
    "description" : "Operation ends successfully",
    "returnValue" : {
    	"storeName" : "newPool"
    	}
    }

### pool leave

    pool leave -name <name> [-sn <snX>]* [-json]

Remove Storage Nodes from an existing Storage Node pool.

    kv-> pool leave -name newPool -sn sn1 -json{
    "operation" : "pool leave",
    "returnCode" : 5000,
    "description" : "Operation ends successfully",
    "returnValue" : {
    	"storeName" : "newPool"
    	}
    }

### pool remove

    pool remove -name <name>

Removes a Storage Node pool.

    kv-> pool remove -name newPool -json{
    "operation" : "pool remove",
    "returnCode" : 5000,
    "description" : "Operation ends successfully",
    "returnValue" : {
    	"storeName" : "newPool"
    	}
    }