Skip to main content

secretbundles

Creates, updates, deletes, gets or lists a secretbundles resource.

Overview​

Namesecretbundles
TypeResource
Idoci.secrets.secretbundles

Fields​

The following fields are returned by SELECT queries:

SELECT not supported for this resource, use SHOW METHODS to view available operations for the resource.

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_secret_bundle_by_nameexecsecretName, vaultId, regionopc-request-id, versionNumber, secretVersionName, stageGets a secret bundle by secret name and vault ID, and secret version that matches either the specified stage, secretVersionName, or versionNumber parameter.<br />If none of these parameters are provided, the bundle for the secret version marked as CURRENT is returned.<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.

NameDatatypeDescription
regionstringOCI 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)
secretNamestringA user-friendly name for the secret. Secret names are unique within a vault. Secret names are case-sensitive.
vaultIdstringThe OCID of the vault that contains the secret.
opc-request-idstringUnique identifier for the request.
secretVersionNamestringThe name of the secret. (This might be referred to as the name of the secret version. Names are unique across the different versions of a secret.)
stagestringThe rotation state of the secret version.
versionNumberinteger (int64)The version number of the secret.

Lifecycle Methods​

Gets a secret bundle by secret name and vault ID, and secret version that matches either the specified stage, secretVersionName, or versionNumber parameter.<br />If none of these parameters are provided, the bundle for the secret version marked as CURRENT is returned.<br />

EXEC oci.secrets.secretbundles.get_secret_bundle_by_name
@secretName='{{ secretName }}' --required,
@vaultId='{{ vaultId }}' --required,
@region='{{ region }}' --required,
@opc-request-id='{{ opc-request-id }}',
@versionNumber='{{ versionNumber }}',
@secretVersionName='{{ secretVersionName }}',
@stage='{{ stage }}'
;