POST Config/GuidToDn

Translates a GUID into an Object DN.

Requirements

Permissions: The caller must have View permission to the requested object.
Token scope: Any valid scope, such as Agent, Certificate, or SSH

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

Input parameters
Name	Description
ObjectGUID	The GUID of an object to be translated. To get the GUID, call POST Config/Find.

Returns

Response description
Name	Description
HTTP 200	For valid requests, this call returns a HTTP 200 message and the following data in the message body: ClassName: The object class. Error: Appears only when the operation cannot supply the necessary data. Provides only a description and Result. No other data. HierarchicalGUID: The object hierarchical GUID.. ObjectDNThe Distinguished Name (DN) of the object corresponding to the specified GUID. Error : Appears only when the operation cannot supply the necessary data. Provides only a description and Result. No other data. Result: The result code that indicates the reason for success or failure. For more information, see Config result codes. Revision: Revision
HTTP 400	For invalid requests, this call returns HTTP 400 Bad Request and the following data in the message body: error: The reason for the error. error_description: If available, additional information about how to retry the request.

Example: Find DN information based on its GUID

Request

POST https://tpp.venafi.example/vedsdk/Config/GuidToDn
Authorization:Bearer 4MyGeneratedBearerTknz==
{
   "ObjectGUID":"{c7fdd8d1-1fb2-4cd0-a041-9a020245a6df}"
}

Response

HTTP/1.1 200 OK
{
   "ClassName":"Policy",
   "HierarchicalGUID":"{19f0795c-...}{e3712316-...d}{61045a15-...}",
   "ObjectDN":"\\VED\\Policy\\Certificates",
   "Result":1,
   "Revision":724335
}