A newer version of this documentation is available.

View Latest

Delete Root Certificates

  • reference
    +
    Trusted CA (or 'root') certificates previously loaded into the Couchbase-Server cluster can be deleted.

    Http Method and URI

    DELETE /pools/default/trustedCAs/<id>

    Description

    Removes from the list of trusted CA certificates for the cluster the certificate with the specified id. The id can be retrieved by means of the GET /node/controller/trustedCAs method and URI: for information, see Get Root Certificates.

    Removal fails if there is on the cluster at least one node certificate that is directly or indirectly (that is, by means of one or more intermediate certificates) signed by the specified certificate. Removal is idempotent.

    Note that this API can be used only on clusters all of whose nodes are running Couchbase Server Version 7.1 or later. It cannot be used on clusters any of whose nodes is running a version of Couchbase Server prior to 7.1.

    Either the Full Admin or the Security Admin role is required.

    Curl Syntax

    The curl syntax is as follows:

    curl -X DELETE http://<ip-address-or-domain-name>:8091/pools/default/trustedCAs/<id>
     -u <username>:<password>

    The id must be an integer that is the id of the certificate that is to be deleted: this can be retrieved as the value of the id key, in the array returned by GET /node/controller/trustedCAs. See Get Root Certificates.

    Responses

    Success returns 200 OK. If no root certificate corresponding to the specified id can be found, deletion fails with 404 Object Not Found; and the message Not found is displayed.

    If an attempt is made to delete a root certificate that has signed a node-certificate that is currently in use, deletion fails with 400 Bad Request, and an error message such as: {"errors":{"_":"The CA certificate is in use by the following nodes: 10.144.220.102"}}.

    Failure to authenticate returns HTTP/1.1 401 Unauthorized. Authentication with inadequate credentials returns 403 Forbidden, and an error message such as: {"message":"Forbidden. User needs the following permissions","permissions":["cluster.admin.security!write"]}.

    A malformed URI returns HTTP/1.1 404 Object Not Found. An incorrect method returns HTTP/1.1 405 Method Not Allowed.

    Example

    The following call removes from the list of trusted CA certificates for the cluster the certificate whose id is 3 :

    curl -X DELETE http://10.144.220.101:8091/pools/default/trustedCAs/3 -u Administrator:password

    See Also

    An overview of certificate management is provided in Certificates. Steps for certificate creation are provided in Configure Server Certificates and Configure Client Certificates.