POST Config/CountObjects
Returns the number of subordinate objects.
Requirements
- Permissions: In order for the object count to work properly, the caller must have View permission to the Distinguished Name (DN).
- 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 |
Begin counting subordinate objects at the Distinguished Name (DN). |
Type |
The class name of the object to count. |
Recursive (Optional) |
true: Recursively count subordinate objects. false: Omit subordinate objects from the total. |
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: Count subordinate objects, use a pattern to filter results
Request
POST https://tpp.venafi.example/vedsdk/Config/CountObjects Authorization:Bearer 4MyGeneratedBearerTknz== { "ObjectDN":"\\VED\\Policy\\TopLevel\\", "Type":"Policy", "Recursive":"true", "Pattern":"*est.MyCompany.net" }
Response
HTTP/1.1 200 OK { "Count":2, "Result":1 }