Managed Object - CustomFieldsManager

Property of: ServiceContent
See also: CustomFieldDef, ManagedEntity

Managed Object Description

The CustomFieldsManager object is used to add and remove custom fields to managed entities.

The custom fields values set on managed entities are available through the customValue property and through the summary objects for VirtualMachine and HostSystem. They are not available directly through this managed object.

This functionality is only available through VirtualCenter.

Properties

Name	Type	Description
field* P	CustomFieldDef[]	List of custom fields defined on this server. The fields are sorted by name.

*May not be presentP Required privilege: System.View

Methods

Methods defined in this Managed Object
AddCustomFieldDef, RemoveCustomFieldDef, RenameCustomFieldDef, SetField

AddCustomFieldDef

Creates a new custom field.

Required Privileges: Global.ManageCustomFields

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the CustomFieldsManager used to make the method call.
name	xsd:string	The name of the field.

Return Value

Type	Description
CustomFieldDef

Faults

Type	Description
DuplicateName	Thrown if a custom field with the name already exists.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" name="AddCustomFieldDef">
            <complexType>
               <sequence>
                  <element name="_this" type="vim2:ManagedObjectReference"/>
                  <element name="name" type="xsd:string"/>
               </sequence>
            </complexType>
         </element>
         <element xmlns="http://www.w3.org/2001/XMLSchema" name="AddCustomFieldDefResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim2:CustomFieldDef"/>
               </sequence>
            </complexType>
         </element>

RemoveCustomFieldDef

Removes a custom field. This also removes all values assigned to this custom field.

Required Privileges: Global.ManageCustomFields

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the CustomFieldsManager used to make the method call.
key	xsd:int	The unique key for the field definition.

Return Value

Type	Description
None

Faults

Type	Description
InvalidArgument	Thrown if no custom field with that key exists.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" name="RemoveCustomFieldDef">
            <complexType>
               <sequence>
                  <element name="_this" type="vim2:ManagedObjectReference"/>
                  <element name="key" type="xsd:int"/>
               </sequence>
            </complexType>
         </element>
         <element xmlns="http://www.w3.org/2001/XMLSchema" name="RemoveCustomFieldDefResponse">
            <complexType/>
         </element>

RenameCustomFieldDef

Renames a custom field.

Required Privileges: Global.ManageCustomFields

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the CustomFieldsManager used to make the method call.
key	xsd:int	The unique key for the field definition.
name	xsd:string	The new name for the fieldp

Return Value

Type	Description
None

Faults

Type	Description
DuplicateName	Thrown if a custom field with the name already exists.
InvalidArgument	Thrown if no custom field with that key exists.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" name="RenameCustomFieldDef">
            <complexType>
               <sequence>
                  <element name="_this" type="vim2:ManagedObjectReference"/>
                  <element name="key" type="xsd:int"/>
                  <element name="name" type="xsd:string"/>
               </sequence>
            </complexType>
         </element>
         <element xmlns="http://www.w3.org/2001/XMLSchema" name="RenameCustomFieldDefResponse">
            <complexType/>
         </element>

SetField

Assigns a value to a custom field on an entity.

Required Privileges: None

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the CustomFieldsManager used to make the method call.
entity P	ManagedObjectReference to a ManagedEntity
key	xsd:int
value	xsd:string

P Required privilege: Global.SetCustomField

Return Value

Type	Description
None

Faults

Type	Description
InvalidArgument	Thrown if no custom field with that key exists.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" name="SetField">
            <complexType>
               <sequence>
                  <element name="_this" type="vim2:ManagedObjectReference"/>
                  <element name="entity" type="vim2:ManagedObjectReference"/>
                  <element name="key" type="xsd:int"/>
                  <element name="value" type="xsd:string"/>
               </sequence>
            </complexType>
         </element>
         <element xmlns="http://www.w3.org/2001/XMLSchema" name="SetFieldResponse">
            <complexType/>
         </element>