POST New KSS Keystore Method

Use the POST method to create a new Keystore Service (KSS) Keystore.

REST Request

POST /idaas/platform/admin/v1/keystoreservice

Request Body

Media Types: application/json

The request body contains the details of the create request:

Attribute Description
"keystore" Name for the KSS keystore.
"permission" Boolean value that specifies whether to create a permission-based keystore.
"pwd" Password for the KSS keystore.
"stripe" Name of the stripe to contain the KSS keystore.

Response Body

Media Types: application/json

The response body returns the status of the create operation, including:

Attribute Description
"ERROR_CODE" If "STATUS" is set to "Failed", provides the error code.
"ERROR_MSG" If "STATUS" is set to "Failed", provides the contents of the error message.
"STATUS" Status of operation. For example, "Succeeded" or "Failed".

cURL Example

The following example shows how to create a KSS keystore by submitting a POST request on the REST resource using cURL.

curl -i -X POST -u username:password --data @createkss.json -H Content-Type:application/json http://myhost:7001/idaas/platform/admin/v1/keystoreservice

Example of Request Body

The following shows an example of the request body in JSON format.

{
    "stripe" : "myStripe",
    "keystore" : "myKeystore",
    "pwd" : "myPwd",
    "permission" : "false"
}

Note:

A password is required unless creating a permission-based keystore ("permission" : "true").

Example of Response Header

The following shows an example of the response header.

HTTP/1.1 201 Created

Example of Response Body

The following shows an example of the response body in JSON format.

{
    "STATUS": "Succeeded"
}