Filter Library Item
Queries an OVF package stored in content library to retrieve information to use when deploying the package. See LibraryItem.deploy. This operation retrieves information from the descriptor of the OVF package stored in the library item specified by ovfLibraryItemId. The information returned by the operation can be used to populate the deployment specification (see LibraryItem.ResourcePoolDeploymentSpec when deploying the OVF package to the deployment target specified by target.
if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource com.vmware.content.library.Item referenced by the parameter ovfLibraryItemId requires System.Read. - The resource ResourcePool referenced by the attribute LibraryItem.DeploymentTarget.resource-pool-id requires System.Read. - The resource HostSystem referenced by the attribute LibraryItem.DeploymentTarget.host-id requires System.Read. - The resource Folder referenced by the attribute LibraryItem.DeploymentTarget.folder-id requires System.Read.
Request
URLURL
https://{api_host}/rest/com/vmware/vcenter/ovf/library-item/id:{ovf_library_item_id}?~action=filter
Path Parameters
Path Parameters
string
ovf_library_item_id
Required
Identifier of the content library item containing the OVF package to query. The parameter must be an identifier for the resource type: com.vmware.content.library.Item.
Header Parameters
Header Parameters
string
vmware-api-session-id
Required
Required session ID, acquired from Create Session API under CIS product
vmware-api-session-id example
"b00db39f948d13ea1e59b4d6fce56389"
Request Body
Request Body
OvfLibraryItemFilterRequestBody of mimetype application/json
Required
This is a request body class for an operation.
(The request body parameter is missing description)
{
"target": {
"resource_pool_id": "string"
}
}
Authentication
This operation uses the following authentication methods.
Response
Response
Response BodyResponse Body
200 OK returns
OvfLibraryItemFilterResponseBody of type application/json
Information that can be used to populate the deployment specification (see LibraryItem.ResourcePoolDeploymentSpec) when deploying the OVF package to the deployment target specified by target.
{
"value": {
"EULAs": [
"string"
],
"additional_params": {},
"annotation": "string",
"name": "string",
"networks": [
"string"
],
"storage_groups": [
"string"
]
}
}
value
Optional
Information that can be used to populate the deployment specification (see LibraryItem.ResourcePoolDeploymentSpec) when deploying the OVF package to the deployment target specified by target.
Errors
404
com.vmware.vapi.std.errors.not_found : if the library item specified by ovfLibraryItemId does not exist. if any resource specified by a field of the LibraryItem.DeploymentTarget structure, specified by target, does not exist.
500
com.vmware.vapi.std.errors.resource_inaccessible : if there was an error accessing the OVF package at the specified ovfLibraryItemId.
default
‘Default’ means this response is used for all HTTP codes that are not covered individually for this operation.
Code Samples
cURL Command
curl -X POST -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" -H "Content-Type: application/json" -d '{"target":{"folder_id":"string","host_id":"string","resource_pool_id":"string"}}' https://{api_host}/rest/com/vmware/vcenter/ovf/library-item/id:{ovf_library_item_id}?~action=filter
Vendor Extensions
This operation contains the following vendor extensions defined in the spec:
x-vmw-doc-operation: filter
