Viewing the List of Rotations of a Specified Key
Use the get /v1/cckm/aws/keys/{id}/rotations API to view the list of rotations of a specified key.
Syntax
curl -k '<IP>/api/v1/cckm/aws/keys/{id}/rotations' -H 'Authorization: Bearer AUTHTOKEN' -H 'accept: application/json' --compressed
Here, {id} represents the key ID.
Request Parameter
| Parameter | Type | Description |
|---|---|---|
| AUTHTOKEN | string | Authorization token. |
Request Query Parameters
| Parameter | Type | Description |
|---|---|---|
| key_source | string | Name of the key material source. • LunaHSM (HSM Luna)• DSM (Data Security Manager)• LOCAL (CipherTrust Manager))• External (External CipherTrust Manager). |
| key_material_origin | string | Origin of the key material. The origin of the key can be: • cckm: Key material is created on CCKM. • native: Key material is created on the AWS cloud. • unknown: Source of the key material is unknown. It is different than CCKM and the native cloud. |
| ImportState | string | Fetches rotations based on the import state of the key material. |
| KeyMaterialState | string | Fetches rotations based on the state of the key material. |
| RotationType | string | Fetches rotations based on the rotation type. |
| KeyMaterialId | string | Fetches rotations based on the key material ID. |
| skip | integer | Number of records to skip. For example, if "skip":5 is specified, the first five records will not be displayed in the output. |
| limit | integer | Numbers of records to display. For example, if "limit":10 is specified, then the next 10 records (after skipping the number of records specified in the skip parameter ) will be displayed in the output. |
| sort | string | Comma-delimited list of properties to sort the results. |
Example Request
curl -k 'https://127.0.0.1/api/v1/cckm/aws/keys/129sd/rotations?skip=0&limit=10&sort=updatedAt' -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJjNWMwZGJlNC1lMmJmLTQ3M2MtODY4MC01NWVkMWIzMDEzMmEiLCJzdWIiOiJsb2NhbHxhNjdjMzc0OC05YTRiLTRhZGQtYjNkOS0wNTRiYTIwYmUzYWMiLCJpc3MiOiJreWxvIiwiYWNjIjoia3lsbyIsInByZWZlcnJlZF91c2VybmFtZSI6ImFkbWluIiwiY3VzdCI6eyJkb21haW5faWQiOiIwMDAwMDAwMC0wMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDAiLCJncm91cHMiOlsiYWRtaW4iXSwic2lkIjoiMDhkNDI5ZjktNDgzYi00ODdlLWJjOTQtNGE1Mjc2ZDI2ZjZjIiwiem9uZV9pZCI6IjAwMDAwMDAwLTAwMDAtMDAwMC0wMDAwLTAwMDAwMDAwMDAwMCJ9LCJqd3RpZCI6ImU5YWUwYTI3LWVlYjQtNGNhZi04YjE4LTdhNzIzMDBkOTA0MCIsImlhdCI6MTYwNDU1ODEzOCwiZXhwIjoxNjA0NTU4NDM4fQ.MIMArFeC4cpPNTYOd39mu6_-yihdN0CDl_917eH8-kY' -H 'accept: application/json' --compressed
Example Response
{
"skip": 0,
"limit": 10,
"total": 3,
"resources": [
{
"id": "5d93e0b4-a9da-48e2-8855-fcc7ae575d09",
"uri": "kylo:kylo:cckm:aws-key-rotation:5d93e0b4-a9da-48e2-8855-fcc7ae575d09",
"account": "kylo:kylo:admin:accounts:kylo",
"createdAt": "2025-06-04T10:19:49.642009Z",
"updatedAt": "2025-06-04T10:19:49.640879Z",
"local_key_id": "b47728a9-1b7f-4cdb-b02f-5614059c7587",
"kms_id": "15c0c713-bab0-45b4-9ae5-ccd6eed1d8c3",
"source_key_identifier": "9087edf11df14129b747014e14a9c2b9b6386b642a6f44079f3346cf295ea767",
"source_key_name": "source-key-name-3",
"key_source": "local",
"key_material_origin": "cckm",
"aws_param": {
"KeyId": "arn:aws:kms:us-east-1:12345678910:key/cf7e2dcd-b804-4d49-b80c-78ecdbf155e2",
"KeyMaterialId": "be64cf1c1651b9e90b4b187c79bb4fdcf8d197879d0101f6cb28eb52f829c0be",
"ExpirationModel": "KEY_MATERIAL_DOES_NOT_EXPIRE",
"KeyMaterialState": "PENDING_ROTATION",
"ImportState": "IMPORTED"
}
},
{
"id": "05a8545d-fd3d-4fe7-935e-ea7709ab0e79",
"uri": "kylo:kylo:cckm:aws-key-rotation:05a8545d-fd3d-4fe7-935e-ea7709ab0e79",
"account": "kylo:kylo:admin:accounts:kylo",
"createdAt": "2025-06-04T10:18:01.644522Z",
"updatedAt": "2025-06-04T10:19:49.344061Z",
"local_key_id": "b47728a9-1b7f-4cdb-b02f-5614059c7587",
"kms_id": "15c0c713-bab0-45b4-9ae5-ccd6eed1d8c3",
"source_key_identifier": "82da473127ae4e35b67d1deed4c8b338a9b6b33f3e664b38938d3fc1d8b2e1ec",
"source_key_name": "source-key-name-2",
"key_source": "local",
"key_material_origin": "cckm",
"aws_param": {
"KeyId": "arn:aws:kms:us-east-1:12345678910:key/cf7e2dcd-b804-4d49-b80c-78ecdbf155e2",
"RotationDate": "2025-06-04T10:18:46.787Z",
"RotationType": "ON_DEMAND",
"KeyMaterialId": "67c5065d7802cd9680e0113740e3e2b3b1a87d2666c2816aab790cb2958ae2a8",
"ExpirationModel": "KEY_MATERIAL_DOES_NOT_EXPIRE",
"KeyMaterialState": "CURRENT",
"ImportState": "IMPORTED"
}
},
{
"id": "0735327b-66f3-45fb-890d-7420d40c6455",
"uri": "kylo:kylo:cckm:aws-key-rotation:0735327b-66f3-45fb-890d-7420d40c6455",
"account": "kylo:kylo:admin:accounts:kylo",
"createdAt": "2025-06-04T10:16:29.994812Z",
"updatedAt": "2025-06-04T10:19:49.345997Z",
"local_key_id": "b47728a9-1b7f-4cdb-b02f-5614059c7587",
"kms_id": "15c0c713-bab0-45b4-9ae5-ccd6eed1d8c3",
"source_key_identifier": "2cdaa9e80f994dbca4700f70bb9ca0db376a8c63f0f84835922c480efda50402",
"source_key_name": "source-key-name-1",
"key_source": "local",
"key_material_origin": "cckm",
"aws_param": {
"KeyId": "arn:aws:kms:us-east-1:12345678910:key/cf7e2dcd-b804-4d49-b80c-78ecdbf155e2",
"RotationType": "",
"KeyMaterialId": "ebb15474581d601ce94b086d0627683ea136cefe068fbddf9cc3fc7c0b64a6bc",
"ExpirationModel": "KEY_MATERIAL_DOES_NOT_EXPIRE",
"KeyMaterialState": "NON_CURRENT",
"ImportState": "IMPORTED"
}
}
]
}
Response Codes
| Response Code | Description |
|---|---|
| 2xx | Success |
| 4xx | Client errors |
| 5xx | Server errors |
Refer to HTTP status codes for details.
