POST Config/FindContainers
Returns a list of all subordinate objects for a parent object.
Requirements
- Permissions: The caller must have View permission to objects in order for them to appear in the results.
- Token scope: Configuration
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 |
---|---|
ObjectDN |
The Distinguished Name (DN) of the object under which to look for subordinates. |
Recursive (Optional) |
When set to 1, subordinates of subordinates should also be returned. |
Returns
Name |
Description |
---|---|
HTTP 200 |
For valid requests, this call returns a HTTP 200 message and the following data in the message body:
|
HTTP 400 |
For invalid requests, this call returns HTTP 400 Bad Request and the following data in the message body:
|
Example: Find subordinate folders for a DN
Request
POST https://tpp.venafi.example/vedsdk/Config/FindContainers Authorization:Bearer 4MyGeneratedBearerTknz== { "ObjectDN":"\\VED\\Policy\\folder" }
Response
HTTP/1.1 200 OK { "Objects":[ { "AbsoluteGUID":"{72c1add5}{e3be4130}{ee684cfd}{73480380}{4e14b7}", "DN":"\\VED\\Policy\\folder\\Device2\\Basic2", "GUID":"{4e14b7}", "Name":"Basic2", "Parent":"\\VED\\Policy\\folder\\Device2", "TypeName":"Basic" }, { "AbsoluteGUID":"{72c1add5}{e3be4130}{ee684cfd}{73480380}{9734d3}", "DN":"\\VED\\Policy\\folder\\Device2\\Basic3", "GUID":"{9734d3}", "Name":"Basic3", "Parent":"\\VED\\Policy\\folder\\Device2", "TypeName":"Basic" } ] }