POST X509CertificateStore/Retrieve

Retrieves a certificate based on the certificate VaultId.

Requirements

  • Permissions:  The caller must have read Read permission to any owner object of the requested Vault ID.
  • Token scope:  Certificate:Manage

Headers

  • Content type: Content-Type:application/json.

  • Token: The bearer access token that you received. For example, Authorization:Bearer xxxxxx==. For more information, see Passing a bearer token in your API calls.

Parameters

Input parameters

Name

Description

VaultId

Integer that uniquely identifies the vault entry containing the certificate to retrieve.

Returns

Response description

Name

Description

CertificateString

The Base64-encoded certificate.

Result

A number indicating indicating success 0 or failure. Because this API is a wrapper for SecretStore, see SecretStore result codes.

TypedNameValues

An array of all associated values that correspond to the vault entry.

  • Name: The certificate attribute name.
  • Type: The data type. For example, datetime, integer, or string
  • Value One or more associated values for this vault entry.

Example

Request

POST https://tpp.venafi.example/vedsdk/X509CertificateStore/Retrieve
Authorization:Bearer xxxxxx==
{
   "VaultId":683
}

Response

HTTP/1.1 200 OK
{
   "CertificateString":"MIIBMCMA0G...",
   "Result":0,
   "TypedNameValues":[
      {
         "Name":"CN",
         "Type":"string",
         "Value":"Web SDK.Example"
      },
      {
         "Name":"Hash",
         "Type":"string",
         "Value":"444DD0EC268AED3FDBB2BDC096696C710BE0683F"
      },
      {
         "Name":"ValidFrom",
         "Type":"datetime",
         "Value":"10\/10\/2013 18:16:01"
      }
   ]
}