Managed Object - CustomFieldsManager(vim.CustomFieldsManager)

Property of
ServiceContent
See also
CustomFieldDef, ManagedEntity, PrivilegePolicyDef
Since
2.0


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* PCustomFieldDef[]

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(addFieldDefinition)

Creates a new custom field. If the moType is specified, the field will only be available for that type of managed object.
Required Privileges
Global.ManageCustomFields

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the CustomFieldsManager used to make the method call.
name Pxsd:string

The name of the field.

Since 2.0
moType* Pxsd:string

The managed object type to which this field will apply

Since 2.0
fieldDefPolicy* PPrivilegePolicyDef

Privilege policy to apply to FieldDef being created

Since 2.0
fieldPolicy* PPrivilegePolicyDef

Privilege policy to apply to instances of field

Since 2.0
*Need not be set PRequired privilege - see tooltip for details

Return Value

Type Description
CustomFieldDef

Faults

Type Description
DuplicateNameThrown if a custom field with the name already exists.
InvalidPrivilegeThrown if a specified privilege is not defined.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



RemoveCustomFieldDef(removeFieldDefinition)

Removes a custom field. This also removes all values assigned to this custom field.
Required Privileges
Global.ManageCustomFields

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the CustomFieldsManager used to make the method call.
key Pxsd:int

The unique key for the field definition.

Since 2.0
P Required privilege: key

Return Value

Type Description
None

Faults

Type Description
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



RenameCustomFieldDef(renameFieldDefinition)

Renames a custom field.
Required Privileges
Global.ManageCustomFields

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the CustomFieldsManager used to make the method call.
key Pxsd:int

The unique key for the field definition.

Since 2.0
name Pxsd:string

The new name for the field.

Since 2.0
PRequired privilege - see tooltip for details

Return Value

Type Description
None

Faults

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

Events

Type
None

Show WSDL type definition



SetField(setField)

Assigns a value to a custom field on an entity.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the CustomFieldsManager used to make the method call.
entity PManagedObjectReference
to a ManagedEntity

Since 2.0
key Pxsd:int

Since 2.0
value Pxsd:string

Since 2.0
PRequired privilege - see tooltip for details

Return Value

Type Description
None

Faults

Type Description
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition