Lists keys in the specified vault and compartment.
GET {{managementEndpoint}}/20180608/keys?compartmentId={{compartment_ocid}}&sortBy=TIMECREATED&sortOrder=DESC
Lists the master encryption keys in the specified vault and compartment.
As a management operation, this call is subject to a Key Management limit that applies to the total number of requests across all management read operations. Key Management might throttle this call to reject an otherwise valid request when the total rate of management read operations exceeds 10 requests per second for a given tenancy.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
compartmentId | string | (Required) The OCID of the compartment. | |
limit | string | The maximum number of items to return in a paginated "List" call. | |
page | string | The value of the opc-next-page response header | |
from the previous "List" call. | |||
sortBy | string | The field to sort by. You can specify only one sort order. The default | |
order for TIMECREATED is descending. The default order for DISPLAYNAME | |||
is ascending. | |||
sortOrder | string | The sort order to use, either ascending (ASC ) or descending (DESC ). | |
protectionMode | string | A key's protection mode indicates how the key persists and where cryptographic operations that use the key are performed. A | |
protection mode of HSM means that the key persists on a hardware security module (HSM) and all cryptographic operations are | |||
performed inside the HSM. A protection mode of SOFTWARE means that the key persists on the server, protected by the vault's | |||
RSA wrapping key which persists on the HSM. All cryptographic operations that use a key with a protection mode of | |||
SOFTWARE are performed on the server. | |||
algorithm | string | The algorithm used by a key's key versions to encrypt or decrypt data. Currently, support includes AES, RSA, and ECDSA algorithms. | |
length | string | The length of the key in bytes, expressed as an integer. Supported values include 16, 24, or 32. | |
curveId | string | The curve ID of the keys. (This pertains only to ECDSA keys.) | |
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. | |||
Accept | string |
RESPONSES
status: OK
[{"id":"\u003cstring\u003e","compartmentId":"\u003cstring\u003e","displayName":"\u003cstring\u003e","timeCreated":"\u003cdateTime\u003e","lifecycleState":"UPDATING","vaultId":"\u003cstring\u003e","algorithm":"ECDSA","definedTags":{"consectetur_1d":{"in2b":{},"Lorem_3":{},"ipsum6":{}},"Duise34":{"anim6a":{}}},"freeformTags":{"essee":"\u003cstring\u003e","nulla_7":"\u003cstring\u003e","irure55":"\u003cstring\u003e","ut18":"\u003cstring\u003e"},"protectionMode":"HSM"},{"id":"\u003cstring\u003e","compartmentId":"\u003cstring\u003e","displayName":"\u003cstring\u003e","timeCreated":"\u003cdateTime\u003e","lifecycleState":"BACKUP_IN_PROGRESS","vaultId":"\u003cstring\u003e","algorithm":"ECDSA","definedTags":{"ut5":{"in_bf_":{},"pariatur468":{}},"ipsum60":{"dolore17a":{},"pariatur2ae":{},"ut_197":{},"ullamcocd":{}},"voluptate_d":{"labore_6":{}},"labore4c8":{"sed29":{},"dolore1d":{}},"nisi_bce":{"commodo_f15":{}}},"freeformTags":{"labore_14_":"\u003cstring\u003e","velit_64":"\u003cstring\u003e","occaecat_7af":"\u003cstring\u003e"},"protectionMode":"SOFTWARE"}]