secret_bundle_versions

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

Overview

Name	secret_bundle_versions
Type	Resource
Id	oci.secrets.secret_bundle_versions

Fields

The following fields are returned by SELECT queries:

list

The properties of the secret bundle. (Secret bundle version summary objects do not include the actual contents of the secret.)<br />

Name	Datatype	Description
secretId	string	The OCID of the secret.
stages	array	A list of possible rotation states for the secret bundle.
timeCreated	string (date-time)	The time when the secret bundle was created.
timeOfDeletion	string (date-time)	An optional property indicating when to delete the secret version, expressed in [RFC 3339](https:​//tools.ietf.org/html/rfc3339) timestamp format. Example: 2019-04-03T21:10:29.600Z
timeOfExpiry	string (date-time)	An optional property indicating when the secret version will expire, expressed in [RFC 3339](https:​//tools.ietf.org/html/rfc3339) timestamp format. Example: 2019-04-03T21:10:29.600Z
versionName	string	The version name of the secret bundle, as provided when the secret was created or last rotated.
versionNumber	integer (int64)	The version number of the secret.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	secretId, region	opc-request-id, limit, page, sortBy, sortOrder	Lists all secret bundle versions for the specified secret.

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
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)
secretId	string	The OCID of the secret.
limit	integer	The maximum number of items to return in a paginated "List" call. For information about pagination, see [List Pagination](../../../#API/Concepts/usingapi.htm#List_Pagination).
opc-request-id	string	Unique identifier for the request.
page	string	The value of the opc-next-page response header from the previous "List" call. For information about pagination, see [List Pagination](../../../#API/Concepts/usingapi.htm#List_Pagination).
sortBy	string	The field to sort by. You can specify only one sort order. The default order for VERSION_NUMBER is descending.
sortOrder	string	The sort order to use, either ascending (ASC) or descending (DESC).

SELECT examples

list

Lists all secret bundle versions for the specified secret.

SELECT
secretId,
stages,
timeCreated,
timeOfDeletion,
timeOfExpiry,
versionName,
versionNumber
FROM oci.secrets.secret_bundle_versions
WHERE secretId = '{{ secretId }}' -- required
AND region = '{{ region }}' -- required
AND opc-request-id = '{{ opc-request-id }}'
AND limit = '{{ limit }}'
AND page = '{{ page }}'
AND sortBy = '{{ sortBy }}'
AND sortOrder = '{{ sortOrder }}'
;