POST Config/Enumerate
Returns a list of all subordinate Config objects for a specified folder.
Requirements
- Permissions: In order for the enumeration to work properly, the caller must have View permission to the requested object.
- 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 policy folder with subordinate objects. |
Recursive (Optional) |
The amount of detail to return: true: List the parent and all matching subordinate objects from subordinate folders. false: List only parent objects. |
Pattern |
An expression for filtering DN matches:
|
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: List all subordinate Config objects for a policy folder
Request
POST https://tpp.venafi.example/vedsdk/Config/Enumerate Authorization:Bearer 4MyGeneratedBearerTknz== { "ObjectDN":"\\VED\\Policy\\Top Level\\Lab A\\", "Pattern":"*est.MyCompany.net" }
Response
HTTP/1.1 200 OK { "Objects":[ { "AbsoluteGUID":"{a6692653-...}{425ad54b-...}{066ceff9-...}{78a66d22-...}", "DN":"\\VED\\Policy\\TopLevel\\LabA\\Test.MyCompany.net", "GUID":"{15dd6264-dcb2-49ce-97a5-bb89ffd0dedf}", "Id":1068, "Name":"Test.MyCompany.net", "Parent":"\\VED\\Policy\\TopLevel\\LabA", "Revision":1782188, "TypeName":"X509 Server Certificate" }, { "AbsoluteGUID":"{a6692653-...}{425ad54b-...}{066ceff9-...}{78a66d22-...}{7c7dfcd1-...}", "DN":"\\VED\\Policy\\TopLevel\\LabA\\West.MyCompany.net", "GUID":"{7c7dfcd1-6bfc-4366-8ee1-77c8e2bda62c}", "Id":1067, "Name":"West.MyCompany.net", "Parent":"\\VED\\Policy\\TopLevel\\LabA", "Revision":10175, "TypeName":"X509 Server Certificate" } ], "Result":1 }