REST API - property

vcenter ovf: property params

The property_params structure contains a array of OVF properties that can be configured when the OVF package is deployed.

This is based on the ovf:ProductSection.

See deploy and filter.

Representation:

JSON

{
    "type" : "string",
    "properties" : [
        {
            "instance_id" : "string",
            "class_id" : "string",
            "description" : "string",
            "id" : "string",
            "label" : "string",
            "category" : "string",
            "type" : "string",
            "value" : "string",
            "ui_optional" : true
        },
        {
            "instance_id" : "string",
            "class_id" : "string",
            "description" : "string",
            "id" : "string",
            "label" : "string",
            "category" : "string",
            "type" : "string",
            "value" : "string",
            "ui_optional" : true
        }
    ]
}

Attributes:

Name	Type	Description
Optional
properties	property[]	Array of OVF properties. Optional. This field is optional in the input parameters when deploying an OVF package. This field will always be present in the result when retrieving information about an OVF package.
properties[].class_id	string	The classId of this OVF property. Optional. This field is not used in the input parameters when deploying an OVF package. This field will always be present in the result when retrieving information about an OVF package.
properties[].id	string	The identifier of this OVF property. Optional. This field must be provided in the input parameters when deploying an OVF package. This field will always be present in the result when retrieving information about an OVF package.
properties[].instance_id	string	The instanceId of this OVF property. Optional. This field is not used in the input parameters when deploying an OVF package. This field will always be present in the result when retrieving information about an OVF package.
properties[].category	string	If this is set to a non-empty string, this property starts a new category. Optional. This field is not used in the input parameters when deploying an OVF package. This field is optional in the result when retrieving information about an OVF package. If unset, the property is in the same category as the previous item, otherwise, it starts a new category.
properties[].ui_optional	boolean	Whether a category is UI optional. This is only used if this property starts a new category (see vcenter.ovf.property.category). The value is stored in an optional attribute vmw:uioptional to the ovf:Category element. The default value is false. If this value is true, the properties within this category are optional. The UI renders this as a group with a check box, and the group is grayed out until the check box is selected. When the check box is selected, the input values are read and used in deployment. If properties within the same category specify conflicting values the default is used. Only implemented in vSphere Web Client 5.1 and later as of Nov 2012. Optional. This field is not used in the input parameters when deploying an OVF package. This field is optional in the result when retrieving information about an OVF package.
properties[].label	string	The display name of this OVF property. Optional. This field is not used in the input parameters when deploying an OVF package. This field will always be present in the result when retrieving information about an OVF package.
properties[].description	string	A description of this OVF property. Optional. This field is not used in the input parameters when deploying an OVF package. This field is optional in the result when retrieving information about an OVF package.
properties[].type	string	The type of this OVF property. Refer to the configuration of a virtual appliance/virtual machine for the valid values. Optional. This field is not used in the input parameters when deploying an OVF package. This field will always be present in the result when retrieving information about an OVF package.
properties[].value	string	The OVF property value. This contains the default value from ovf:defaultValue if ovf:value is not present when read. Optional. This field must be provided in the input parameters when deploying an OVF package. This field will always be present in the result when retrieving information about an OVF package.
type	string	Unique identifier describing the type of the OVF parameters. The value is the name of the OVF parameters structure. Optional. This field must be provided in the input parameters when deploying an OVF package. This field will always be present in the result when retrieving information about an OVF package.