Delete a KMIP server

Virtual Storage Platform One Object API Reference Guide

Version
3.0.x
File Size
270 KB
Audience
anonymous
Part Number
MK-24VSP1OB002-01

Deletes the connection to an external secondary KMIP server. The server is not deleted in the process, only the connection.

Endpoint

POST /kmip/delete_server

Request structure

{
"name": "name"
}
Parameter Type Description
name String The user-assigned name of the secondary KMIP 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 KMIP 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 endpoint 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 endpoint fails.

Status code

HTTP name

Description

200 OK The request was executed successfully.
400 Bad Request The request is invalid or improperly formatted.
401 Unauthorized Access was denied because credentials are not valid.
404 Not Found The KMIP configuration can't be located.
405 Method Not Allowed The specified HTTP method is not allowed. Resend using POST.
500 Internal Server Error An issue has occurred with the server.