POST Config/Find
Returns objects based on their attribute values.
Requirements
- Permissions: The caller must have Read 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 |
---|---|
Pattern |
A pattern to match against object attribute values:
|
AttributeNames (Optional) |
A list of attribute names to limit the search against. For more information, see How to find class names and attributes. |
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: Use an attribute value to find an object
Request
POST https://tpp.venafi.example/vedsdk/Config/Find Authorization:Bearer 4MyGeneratedBearerTknz== { "Pattern":"*escri*", "AttributeNames":[ "Description", "Credential" ] }
Response
HTTP/1.1 200 OK { "Objects":[ { "AbsoluteGUID":"{72c1add5}{e3be4130}{ffff1738}{370a606b}{44f0f3}", "DN":"\\VED\\Policy\\folder\\Device2\\Basic3", "GUID":"{44f0f3}", "Name":"Basic3", "Parent":"\\VED\\Policy\\folder\\Device2", "TypeName":"Basic" }, { "AbsoluteGUID":"{72c1add5}{e3be4130}{16b86c0b}", "DN":"\\VED\\Policy\\Testdevice", "GUID":"{16b86c0b}", "Name":"Testdevice", "Parent":"\\VED\\Policy", "TypeName":"Device" } ], "Result":1 }