Creating a New Version of External CipherTrust Manager Key
Use the post /v1/cckm/external-cm/keys/{id}/versions API to create a new version of the existing external CipherTrust Manager key, with the same key name, metadata, and attributes.
Syntax
curl -k '<IP>/api/v1/cckm/external-cm/keys/03fe3378-efe4-41cc-9177-12e778258f84/versions' -X POST -H 'Authorization: Bearer AUTHTOKEN' --compressed
Example Request
curl -k 'https://10.171.15.223/api/v1/cckm/external-cm/keys/03fe3378-efe4-41cc-9177-12e778258f84/versions' -X POST -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJjNGU3MDM0MC1lNWE4LTQ5NjYtYTczYS0xYzY4NGMzMzA2YTMiLCJzdWIiOiJsb2NhbHwxNDc1MmJiOS02MTQ5LTRmZDctODM1Mi04NmVhOTE2ZTYxMTQiLCJpc3MiOiJreWxvIiwiYWNjIjoia3lsby85NzU5MmRkYi0xNDQ0LTRhZGEtYmFhZC0xMDUwNTc2NTI5ODUiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJhZG1pbiIsImN1c3QiOnsiY2xpZW50X3R5cGUiOiJ1bnJlZ2lzdGVyZWQiLCJkb21haW5faWQiOiI5NzU5MmRkYi0xNDQ0LTRhZGEtYmFhZC0xMDUwNTc2NTI5ODUiLCJncm91cHMiOlsiYWRtaW4iXSwic2lkIjoiYzgwN2ZjNTItMTI4OC00YzY5LTlkN2UtMDQ1MjM3ZDFjZWY2Iiwiem9uZV9pZCI6IjQ5N2RlYzI2LTA0M2YtNDhmZi05ZmZhLTAyNTFkODk0NWEwOCJ9LCJqd3RpZCI6IjQ0OGY0MTVmLTljZjAtNDNlNi05OTdiLTZiNjNiNzViNDQxNyIsImlhdCI6MTY4MzAyMTQ2OSwiZXhwIjoxNjgzMDIxNzY5fQ.O6lPZpIPAaVkKIjS0rnrEZ-cAOjZbKKqfqVyQWwv5Ww' -H 'accept: application/json' --compressed
Example Response
{
"application/json": {
"id": "042dbed0-47c7-41cf-8446-119dfc76e054",
"uri": "kylo:kylo:cckm:external-cm-key:042dbed0-47c7-41cf-8446-119dfc76e054",
"account": "kylo:kylo:admin:accounts:kylo",
"createdAt": "2023-03-29T12:46:31.741538Z",
"updatedAt": "2023-03-29T12:46:31.739786Z",
"domain_id": "60b48c3e-b365-4984-9150-19cd083c1cde",
"gone": false,
"cm_key_params": {
"key_name": "key1",
"key_usage_mask": 12,
"meta": {
"ownerId": "local|f9dc0d37-0f22-4d38-941b-e37a32605cbf",
"permissions": {}
},
"object_type": "Symmetric Key",
"version": 1,
"algorithm": "AES",
"key_size": 256,
"unexportable": true,
"undeletable": false,
"never_exported": true,
"never_exportable": true,
"format": "raw",
"key_id": "f8ec69710cd64759a0ac7382ed6892c3a57799ef88be45929b49a883403f2b40",
"key_state": "Active"
}
}
}
A new key version named key-ver-1 is created on the external CipherTrust Manager.
Response Codes
| Response Code | Description |
|---|---|
| 2xx | Success |
| 4xx | Client errors |
| 5xx | Server errors |
Refer to HTTP status codes for details.
