v1

latestOpenAPI 3.0.22026-08-062794201004.1 KB
CMEK

List Key Rotation History

Retrieves the full history of rotations for a specific customer-managed encryption key within the organization. In order to access this endpoint, the provided API key must have at least one of the following roles:

get/v4/organizations/{organizationId}/cmek/{cmekId}/history

Query parameters

pageinteger

Sets the page you would like to view.

perPageinteger

Sets the number of results you would like to have on each page.

sortBy'active' | 'associatedAt' | 'associatedBy' | 'key'

Sets the order of how you would like to sort the results and the key you would like to order by. Valid fields to sort the results are: active, associatedAt, associatedBy, key

sortDirection'asc' | 'desc'

The order in which the items will be sorted.

Response

Successfully fetched the key rotation history based on its ID.

Example response

{
  "data": [
    {
      "config": {
        "arn": "arn:aws:kms:us-west-2:123456789012:key/abcd1234-a123-456a-a12b-a123b4cd56ef"
      },
      "associatedBy": "ffffffff-aaaa-1414-eeee-000000000000"
    }
  ],
  "cursor": {
    "pages": {
      "page": 2,
      "next": 3,
      "previous": 1,
      "last": 10,
      "perPage": 10,
      "totalItems": 10
    },
    "hrefs": {
      "first": "https://cloud.couchbase.com/v4/users?page=1&perPage=10",
      "last": "https://cloud.couchbase.com/v4/users?page=1&perPage=10",
      "previous": "https://cloud.couchbase.com/v4/users?page=1&perPage=10",
      "next": "https://cloud.couchbase.com/v4/users?page=1&perPage=10"
    }
  }
}