POST /kms-key/{id}/rotate

Perform a manual rotation of the key material for a symmetric key.

Path parameters

  • id string(uuid) Required

Responses

  • 200 application/json

    200

    Hide response attribute Show response attribute object
    • rotation object Required
      Hide rotation attributes Show rotation attributes object
      • manual-count integer Required
      • automatic boolean Required
      • rotation-period integer Required
      • next-at string(date-time) Required
  • 400 application/json

    400

    Hide response attributes Show response attributes object
    • type string(uri-reference) Required
    • title string Required
    • status integer Required

      Minimum value is 100, maximum value is 599.

    • detail string Required
    • instance string(uri-reference)
    • errors array[object]
      Hide errors attributes Show errors attributes object
      • path string
      • detail string
      • pointer string
      • location string
POST /kms-key/{id}/rotate 
curl \
 --request POST 'https://api-ch-gva-2.exoscale.com/v2/kms-key/{id}/rotate'
Response examples (200) 
{
  "rotation": {
    "manual-count": 42,
    "automatic": true,
    "rotation-period": 42,
    "next-at": "2026-05-04T09:42:00Z"
  }
}
Response examples (400) 
{
  "type": "string",
  "title": "string",
  "status": 42,
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "path": "string",
      "detail": "string",
      "pointer": "string",
      "location": "string"
    }
  ]
}