POST SecretStore/LookupAssociationbyVaultID
Returns certificate information from the Secret Store.
This API call only returns the following certificate association attributes: 'Store Archived', 'Store Added', 'Hash', 'Serial', 'Key Algorithm', 'Label', 'Template Major Version', 'Template Minor Version', 'Template Name', and 'Template Oid'. To obtain comprehensive details and validation information for a certificate, please use the Certificates API.
Requirements
- Permissions: The caller must have Read permission to the owner.
- Token scope: Restricted
Headers
-
Content type: Content-Type:application/json.
- Token: The bearer access token that you received. For example, Authorization:Bearer 4MyGeneratedBearerTknz==. For more information, see Passing a bearer token in your API calls.
Parameters
Name |
Description |
---|---|
Name |
(Optional) Specify one of the following certificate parameters:
|
VaultID |
Required. The integer that uniquely identifies the vault entry. To get the correct VaultID, use the POST SecretStore/LookupByOwner method. |
Returns
Name |
Description |
---|---|
Result |
A number indicating the status:
|
Value |
The value that is present in the vault for this certificate. |
Example 1: Get the certificate serial number
Request for Example 1
POST https://tpp.venafi.example/vedsdk/SecretStore/LookupAssociationbyVaultID Authorization:Bearer 4MyGeneratedBearerTknz== { "VaultID": "2127", "Name": "Serial" }
Response for Example 1
HTTP/1.1 200 OK { "Result": 0, "Value": "16FC49B10002000051B8" }
Example 2: Get the certificate authority template name
Request for Example 2
POST https://tpp.venafi.example/vedsdk/SecretStore/LookupAssociationbyVaultID Authorization:Bearer 4MyGeneratedBearerTknz== { "VaultID":"2127", "Name":"Template Name" }
Response for Example 2
HTTP/1.1 200 OK { "Result": 0, "Value": "Venafi" }
Example 3: Get the certificate hash
Request for Example 3
POST https://tpp.venafi.example/vedsdk/SecretStore/LookupAssociationbyVaultID Authorization:Bearer 4MyGeneratedBearerTknz== { "VaultID":"2127", "Name":"Hash" }
Response for Example 3
HTTP/1.1 200 OK { "Result": 0, "Value": "60447EE534017DF56C22B2C5200D567A3C463F22" }