vcenter ovf library item: filter
Queries an OVF package stored in content library to retrieve information to use when deploying the package. See deploy.
This operation retrieves information from the descriptor of the OVF package stored in the library item specified by ovf_library_item_id
. The information returned by the operation can be used to populate the deployment specification (see vcenter.ovf.library_item.resource_pool_deployment_spec when deploying the OVF package to the deployment target specified by target
.
Request:
HTTP request
POST https://{server}/rest/com/vmware/vcenter/ovf/library-item/id:{ovf_library_item_id}?~action=filter
Path Parameters
Name | Type | Description |
---|---|---|
Required | ||
ovf_library_item_id | string | Identifier of the content library item containing the OVF package to query. |
Request Body Structure:
{
"target": {
"folder_id": "obj-103",
"host_id": "obj-103",
"resource_pool_id": "obj-103"
}
}
"target": {
"folder_id": "obj-103",
"host_id": "obj-103",
"resource_pool_id": "obj-103"
}
}
<?xml version="1.0" ?>
<ns0:Filter-Input xmlns:ns0="http://vmware.com/vcenter/ovf/library_item" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<target>
<folder_id>obj-103</folder_id>
<host_id>obj-103</host_id>
<resource_pool_id>obj-103</resource_pool_id>
</target>
</ns0:Filter-Input>
<ns0:Filter-Input xmlns:ns0="http://vmware.com/vcenter/ovf/library_item" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<target>
<folder_id>obj-103</folder_id>
<host_id>obj-103</host_id>
<resource_pool_id>obj-103</resource_pool_id>
</target>
</ns0:Filter-Input>
Request Body Parameters:
Name | Type | Description |
---|---|---|
bold = required | ||
target | deployment_target | Specification of the deployment target. |
target.resource_pool_id | string | Identifier of the resource pool to which the virtual machine or virtual appliance should be attached. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: ResourcePool . When operations return a value of this structure as a result, the field will be an identifier for the resource type: ResourcePool . |
target.host_id | string | Identifier of the target host on which the virtual machine or virtual appliance will run. The target host must be a member of the cluster that contains the resource pool identified by vcenter.ovf.library_item.deployment_target.resource_pool_id. Optional. If unset, the server will automatically select a target host from the resource pool if vcenter.ovf.library_item.deployment_target.resource_pool_id is a stand-alone host or a cluster with Distributed Resource Scheduling (DRS) enabled.When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: HostSystem . When operations return a value of this structure as a result, the field will be an identifier for the resource type: HostSystem . |
target.folder_id | string | Identifier of the vCenter folder that should contain the virtual machine or virtual appliance. The folder must be virtual machine folder. Optional. If unset, the server will choose the deployment folder.When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: Folder . When operations return a value of this structure as a result, the field will be an identifier for the resource type: Folder . |
Response:
HTTP Status Code: 200
Representations:
{
"value": {
"EULAs": [
"string",
"string"
],
"additional_params": [
{
"@class": "com.vmware.vcenter.ovf.ovf_params",
"type": "string"
},
{
"@class": "com.vmware.vcenter.ovf.ovf_params",
"type": "string"
}
],
"annotation": "string",
"name": "string",
"networks": [
"string",
"string"
],
"storage_groups": [
"string",
"string"
]
}
}
"value": {
"EULAs": [
"string",
"string"
],
"additional_params": [
{
"@class": "com.vmware.vcenter.ovf.ovf_params",
"type": "string"
},
{
"@class": "com.vmware.vcenter.ovf.ovf_params",
"type": "string"
}
],
"annotation": "string",
"name": "string",
"networks": [
"string",
"string"
],
"storage_groups": [
"string",
"string"
]
}
}
<?xml version="1.0" ?>
<ns0:Filter-Result xmlns:ns0="http://vmware.com/vcenter/ovf/library_item" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<value>
<networks-array>
<array-item>string</array-item>
<array-item>string</array-item>
</networks-array>
<annotation>string</annotation>
<storage_groups-array>
<array-item>string</array-item>
<array-item>string</array-item>
</storage_groups-array>
<additional_params-array>
<array-item class="com.vmware.vcenter.ovf.ovf_params">
<type>string</type>
</array-item>
<array-item class="com.vmware.vcenter.ovf.ovf_params">
<type>string</type>
</array-item>
</additional_params-array>
<name>string</name>
<EULAs-array>
<array-item>string</array-item>
<array-item>string</array-item>
</EULAs-array>
</value>
</ns0:Filter-Result>
<ns0:Filter-Result xmlns:ns0="http://vmware.com/vcenter/ovf/library_item" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<value>
<networks-array>
<array-item>string</array-item>
<array-item>string</array-item>
</networks-array>
<annotation>string</annotation>
<storage_groups-array>
<array-item>string</array-item>
<array-item>string</array-item>
</storage_groups-array>
<additional_params-array>
<array-item class="com.vmware.vcenter.ovf.ovf_params">
<type>string</type>
</array-item>
<array-item class="com.vmware.vcenter.ovf.ovf_params">
<type>string</type>
</array-item>
</additional_params-array>
<name>string</name>
<EULAs-array>
<array-item>string</array-item>
<array-item>string</array-item>
</EULAs-array>
</value>
</ns0:Filter-Result>
Response Type:
Name | Type | Description |
---|---|---|
bold = required | ||
value | ovf_summary | Information that can be used to populate the deployment specification (see vcenter.ovf.library_item.resource_pool_deployment_spec) when deploying the OVF package to the deployment target specified by target . |
value.name | string | Default name for the virtual machine or virtual appliance. Optional. If unset, the OVF descriptor did not specify a name. |
value.annotation | string | Default annotation for the virtual machine or virtual appliance. Optional. If unset, the OVF descriptor did not specify an annotation. |
value.EULAs | string[] | End User License Agreements specified in the OVF descriptor. All end user license agreements must be accepted in order for the deploy operation to succeed. See vcenter.ovf.library_item.resource_pool_deployment_spec.accept_all_EULA. |
value.networks | string[] | Section identifiers for sections of type ovf:NetworkSection in the OVF descriptor. These identifiers can be used as keys in vcenter.ovf.library_item.resource_pool_deployment_spec.network_mappings. Optional. If unset, the OVF descriptor did not specify any networks. |
value.storage_groups | string[] | Section identifiers for sections of type vmw:StorageGroupSection in the OVF descriptor. These identifiers can be used as keys in vcenter.ovf.library_item.resource_pool_deployment_spec.storage_mappings. Optional. If unset, the OVF descriptor did not specify any storage groups. |
value.additional_params | object[] | Additional OVF parameters which can be specified for the deployment target. These OVF parameters can be inspected, optionally modified, and used as values in vcenter.ovf.library_item.resource_pool_deployment_spec.additional_parameters for the deploy operation. Optional. If unset, the OVF descriptor does not require addtional parameters or does not have additional parameters suitable for the deployment target.When clients pass a value of this structure as a parameter, the field must contain all the attributes defined in vcenter.ovf.ovf_params. When operations return a value of this structure as a result, the field will contain all the attributes defined in vcenter.ovf.ovf_params. |
Errors:
HTTP Status Code | Type | Description |
---|---|---|
400 | invalid_argument | if target contains invalid arguments. |
404 | not_found | if the library item specified by ovf_library_item_id does not exist. |
400 | resource_inaccessible | if there was an error accessing the OVF package at the specified ovf_library_item_id . |