A newer version of this documentation is available.

View Latest

Deleting Groups

  • reference
    +
    Server groups can be deleted with the DELETE /pools/default/serverGroups/<:uuid> HTTP method and URI.

    HTTP method and URI

    DELETE /pools/default/serverGroups/<:uuid>

    This deletes a specified server group. The server group must be empty, for the request to succeed.

    Curl Syntax

    curl -X DELETE -u <administrator>:<password>
      http://<host>:<port>/pools/default/serverGroups/<uuid>

    As this indicates, the uuid of the group to be deleted must be appended to the URI. The uuid can be determined by means of the procedure explained in Getting Server Group Information.

    Responses

    Success gives 200 OK, and returns an empty object. An incorrectly specified uuid gives 404 Object Not Found, and returns an empty object. Specifying a name already assigned to an existing group gives 400 Bad Request, and returns an object of the form {"name": "already exists"}. Attempting to delete a non-empty group gives 400 Bad Request, and returns an object of the form {"_":"group is not empty"}. Failure to authenticate gives 401 Unauthorized.

    Example

    The following example assumes that the procedure described in Getting Server Group Information has provided output containing the following:

    {
      "name": "Group 2",
      "uri": "/pools/default/serverGroups/dfbed23035cc57eac0f4e72ce0c8667a",
      "addNodeURI": "/pools/default/serverGroups/dfbed23035cc57eac0f4e72ce0c8667a/addNode",
      "nodes": []
    }

    This indicates that the cluster contains a group named Group 2, whose uuid is dfbed23035cc57eac0f4e72ce0c8667a. The value of node is an empty array, indicating that there are no nodes assigned to the group: therefore, the group may be deleted.

    Therefore, the following request deletes Group 2, by specifying dfbed23035cc57eac0f4e72ce0c8667a:

    curl -X DELETE -u Administrator:password \
    http://10.143.190.101:8091/pools/default/serverGroups/\
    dfbed23035cc57eac0f4e72ce0c8667a

    See Also

    See Getting Server Group Information for getting information on the current node-to-group configuration for the server. See Server Group Awareness, for a conceptual overview of groups. See Updating Server Group Memberships for an example of changing the node-to-group configuration. See Manage Groups, for examples of managing groups by means of Couchbase Web Console.