POST Metadata/LoadItem
Returns a Metadata Item with Custom Field details. The details describe where and how the Metadata object applies to certificates and/or devices in the Policy tree.
Requirements
- Permissions: The caller must have Read permission to the Metadata that is referenced by its DN in the request.
- 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 |
---|---|
DN |
The Distinguished Name (DN) of a Certificate or Device object that contains a Custom Field. If necessary, use the DN value from the GET Metadata/Items or POST Metadata/GetItemsForClass response. |
Returns
Name |
Description |
---|---|
Item |
An array of Metadata Item settings that are present in the Distinguished Name (DN). If a setting is missing, the value is not set. Each array element describes a Custom Field. |
Locked |
The status of the data:
|
Result |
The reason for success or failure. For more information, see Metadata Result Codes. |
Example: Show metadata for a Custom Field
Request
POST https://tpp.venafi.example/vedsdk/Metadata/LoadItem Authorization:Bearer 4MyGeneratedBearerTknz== { "DN": "\\VED\\Metadata Root\\Hidden Object Name" }
Response
HTTP/1.1 200 OK { "Item":{ "AllowedValues":[ ], "Classes":[ "X509 Certificate" ], "ConfigAttribute":"{a80714f0-565c-4bc2-9026-787cf076d764}", "DN":"\\VED\\Metadata Root\\Hidden Object Name", "DefaultValues":[ ], "ErrorMessage":"Error Message", "Guid":"{a80714f0-565c-4bc2-9026-787cf076d764}", "Help":"Help Text", "Label":"Cost Center", "Mandatory":true, "Name":"Hidden Object Name", "Policyable":true, "RegularExpression":"^[a-zA-Z0-9_\\.\\+-]+@[a-zA-Z0-9-]+\\.[a-zA-Z0-9-\\.]+$", "RenderHidden":false, "RenderReadOnly":false, "Type":1 }, "Locked":false, "Result":0 }