boot_volume_kms_keys
Creates, updates, deletes, gets or lists a boot_volume_kms_keys resource.
Overview​
| Name | boot_volume_kms_keys |
| Type | Resource |
| Id | oci.block_storage.boot_volume_kms_keys |
Fields​
The following fields are returned by SELECT queries:
- get
The OCID of the Vault service master encryption key associated with this boot volume.
| Name | Datatype | Description |
|---|---|---|
kmsKeyId | string | The OCID of the Vault service key assigned to this volume. If the volume is not using Vault service, then the kmsKeyId will be a null string. |
Methods​
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | bootVolumeId, region | if-match | Gets the Vault service encryption key assigned to the specified boot volume.<br /> |
update | update | bootVolumeId, region | if-match | Updates the specified volume with a new Vault service master encryption key.<br /> |
delete | delete | bootVolumeId, region | if-match | Removes the specified boot volume's assigned Vault Service encryption key.<br /> |
Parameters​
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
bootVolumeId | string | The OCID of the boot volume. |
region | string | OCI region identifier (e.g. us-ashburn-1, ap-sydney-1); resolves from OCI_REGION when not supplied in the query. (default: us-ashburn-1, x-stackQL-envVar: OCI_REGION) |
if-match | string | For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value. |
SELECT examples​
- get
Gets the Vault service encryption key assigned to the specified boot volume.<br />
SELECT
kmsKeyId
FROM oci.block_storage.boot_volume_kms_keys
WHERE bootVolumeId = '{{ bootVolumeId }}' -- required
AND region = '{{ region }}' -- required
AND if-match = '{{ if-match }}'
;
UPDATE examples​
- update
Updates the specified volume with a new Vault service master encryption key.<br />
UPDATE oci.block_storage.boot_volume_kms_keys
SET
kmsKeyId = '{{ kmsKeyId }}'
WHERE
bootVolumeId = '{{ bootVolumeId }}' --required
AND region = '{{ region }}' --required
AND if-match = '{{ if-match}}'
RETURNING
kmsKeyId;
DELETE examples​
- delete
Removes the specified boot volume's assigned Vault Service encryption key.<br />
DELETE FROM oci.block_storage.boot_volume_kms_keys
WHERE bootVolumeId = '{{ bootVolumeId }}' --required
AND region = '{{ region }}' --required
AND if-match = '{{ if-match }}'
;