Creates a new key version resource and rotates the key to use it for encryption.
POST {{managementEndpoint}}/20180608/keys/:keyId/keyVersions
Generates a new KeyVersion resource that provides new cryptographic
material for a master encryption key. The key must be in an ENABLED
state to be rotated.
As a management operation, this call is subject to a Key Management limit that applies to the total number of requests across all management write operations. Key Management might throttle this call to reject an otherwise valid request when the total rate of management write operations exceeds 10 requests per second for a given tenancy.
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
opc-request-id | string | Unique identifier for the request. If provided, the returned request ID | |
will include this value. Otherwise, a random request ID will be | |||
generated by the service. | |||
opc-retry-token | string | A token that uniquely identifies a request so it can be retried in case | |
of a timeout or server error without risk of executing that same action | |||
again. Retry tokens expire after 24 hours, but can be invalidated | |||
before then due to conflicting operations (e.g., if a resource has been | |||
deleted and purged from the system, then a retry of the original | |||
creation request may be rejected). | |||
Accept | string |
RESPONSES
status: OK
{"id":"\u003cstring\u003e","compartmentId":"\u003cstring\u003e","timeCreated":"\u003cdateTime\u003e","vaultId":"\u003cstring\u003e","keyId":"\u003cstring\u003e","isPrimary":"\u003cboolean\u003e","lifecycleState":"ENABLED","origin":"EXTERNAL","publicKey":"\u003cstring\u003e","replicaDetails":{"replicationId":"\u003cstring\u003e"},"restoredFromKeyVersionId":"\u003cstring\u003e","timeOfDeletion":"\u003cdateTime\u003e"}