Gets a secret bundle by secret name and vault ID.

POST {{baseUrl}}/secretbundles/actions/getByName?secretName=<string>&vaultId=<string>&versionNumber=0&secretVersionName=<string>&stage=PENDING

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

Request Params

KeyDatatypeRequiredDescription
secretNamestring(Required) A user-friendly name for the secret. Secret names are unique within a vault. Secret names are case-sensitive.
vaultIdstring(Required) The OCID of the vault that contains the secret.
versionNumbernumberThe version number of the secret.
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.

HEADERS

KeyDatatypeRequiredDescription
opc-request-idstringUnique identifier for the request.
Acceptstring

RESPONSES

status: OK

{&quot;secretId&quot;:&quot;\u003cstring\u003e&quot;,&quot;versionNumber&quot;:&quot;\u003clong\u003e&quot;,&quot;metadata&quot;:{&quot;anim3&quot;:{}},&quot;secretBundleContent&quot;:{&quot;contentType&quot;:&quot;BASE64&quot;},&quot;stages&quot;:[&quot;CURRENT&quot;,&quot;DEPRECATED&quot;],&quot;timeCreated&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeOfDeletion&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeOfExpiry&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;versionName&quot;:&quot;\u003cstring\u003e&quot;}