Delete KMS server

Content Platform for Cloud Scale Management API Reference

Version
2.5.x
Audience
anonymous
Part Number
MK-HCPCS007-08

You can delete the connection to an external secondary KMS server. The server is not deleted, only the connection to the server.

HTTP request syntax (URI)

POST https://host_ip:9099/mapi/v1/kmip/delete_server

Request structure

"name": "name"
Parameter Required Type Description
name Yes String The user-assigned name of the secondary KMS server you want to delete. Type up to 63 Unicode characters.

Response structure

Not applicable.

Return codes

Note: Before deleting the connection to a secondary KMS server, the system checks the KEKs currently on the reachable online servers. If each KEK on the server is contained in the set of currently available KEKs, the connection to the server is deleted and the method succeeds. However, if the server contains a KEK not available on at least one of the other servers, the connection is not deleted and the method fails.

Status code

HTTP name

Description

200 OK The request was executed successfully.
401 Unauthorized Access was denied because credentials are not valid.
405 Method Not Allowed The specified HTTP method is not allowed for a storage component. Resend using POST.
503 Service Unavailable An external KMS system has not been configured.

Example

Request example:

POST https://10.10.24.195:9099/mapi/v1/kmip/delete_server

JSON request:

"name": "myServer"