Managed Object - VsanIscsiTargetSystem(vim.cluster.VsanIscsiTargetSystem)

See also
ClusterComputeResource, Task, VsanIscsiInitiatorGroup, VsanIscsiLUN, VsanIscsiLUNSpec, VsanIscsiTarget, VsanIscsiTargetSpec, VsanObjectInformation
Since
vSphere API 6.5


Managed Object Description

The VsanIscsiTargetSystem exposes interfaces from vCenter to perform vSAN iSCSI target service related operations. To access these APIs from vCenter, user should possess correct privileges of the target cluster: cluster edit privilege is required for the adding, editing and removal of target, LUN, initiator and initiator group, while system read/view privilege is required for the view of these entities. The Managed Entity can be accessed through MOID of vsan-cluster-iscsi-target-system, through vSAN service at both vCenter server and ESXi host side.

Properties

Name Type Description
None

Methods

Methods defined in this Managed Object
VsanVitAddIscsiInitiatorGroup, VsanVitAddIscsiInitiatorsToGroup, VsanVitAddIscsiInitiatorsToTarget, VsanVitAddIscsiLUN, VsanVitAddIscsiTarget, VsanVitAddIscsiTargetToGroup, VsanVitEditIscsiLUN, VsanVitEditIscsiTarget, VsanVitGetHomeObject, VsanVitGetIscsiInitiatorGroup, VsanVitGetIscsiInitiatorGroups, VsanVitGetIscsiLUN, VsanVitGetIscsiLUNs, VsanVitGetIscsiTarget, VsanVitGetIscsiTargets, VsanVitQueryIscsiTargetServiceVersion, VsanVitRemoveIscsiInitiatorGroup, VsanVitRemoveIscsiInitiatorsFromGroup, VsanVitRemoveIscsiInitiatorsFromTarget, VsanVitRemoveIscsiLUN, VsanVitRemoveIscsiTarget, VsanVitRemoveIscsiTargetFromGroup

VsanVitAddIscsiInitiatorGroup(addIscsiInitiatorGroup)

Adds iSCSI initiator group to one cluster.
If the initiator group already exists, a VsanFault will be raised. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
initiatorGroupName Pxsd:string

Since vSphere API 6.5
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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitAddIscsiInitiatorsToGroup(addIscsiInitiatorsToGroup)

Adds iSCSI initiators to one initiator group.
If the initiator group doesn't exist, or some of the initiators are already in the specified initiator group, a VsanFault will be raised. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
initiatorGroupName Pxsd:string

Since vSphere API 6.5
initiatorNames Pxsd:string[]

Since vSphere API 6.5
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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitAddIscsiInitiatorsToTarget(addIscsiInitiatorsToTarget)

Adds iSCSI initiators or initiator groups to one target.

If the target cannot be found or if there are initiators or initiator groups in the initiatorNames parameter are already associated with the specified target, a VsanFault will be raised. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
targetAlias Pxsd:string

Since vSphere API 6.5
initiatorNames Pxsd:string[]

Since vSphere API 6.5
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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitAddIscsiLUN(addIscsiLUN)

Adds iSCSI LUN to specified target.
If the target cannot be found, a VsanFault exception is raised. If the LUN id is provided, it should be in range [0, 255] and be unique in the specified target. The LUN size should be provided, its minimum size is 1MB, the maximum size is 62TB. If either of them is not met, a VsanFault will be raised. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
targetAlias Pxsd:string

Since vSphere API 6.5
lunSpec PVsanIscsiLUNSpec

Since vSphere API 6.5
PRequired privilege - see tooltip for details

Return Value

Type Description
ManagedObjectReference
to a Task
The related task.

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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitAddIscsiTarget(addIscsiTarget)

Adds iSCSI target to this cluster.
The alias in VsanIscsiTargetSpec must be provided and unique. If iqn provided, it should be unique, if either of them is not met, a VsanFault will be raised. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
targetSpec PVsanIscsiTargetSpec

Since vSphere API 6.5
PRequired privilege - see tooltip for details

Return Value

Type Description
ManagedObjectReference
to a Task
The related task.

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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitAddIscsiTargetToGroup(addIscsiTargetToGroup)

Adds the iSCSI target to the specified initiator group.
If the initiator group is not found or the target is already in the accessible targets of the group, a VsanFault will be raised. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
initiatorGroupName Pxsd:string

Since vSphere API 6.5
targetAlias Pxsd:string

Since vSphere API 6.5
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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitEditIscsiLUN(editIscsiLUN)

Edits iSCSI LUN in specified target.
All properties in VsanIscsiLUNSpec can be changed. If new LUN id is provided, it should be in range [0, 255] and be unique in the specified target, if lunSize is provided, it should be greater than existing size, i.e., LUNs are only allowed to grow, if either of them are not met, a VsanFault exception will be raised. If storagePolicy is provided, it is set by calling SetVsanObjectPolicy in VsanObjectSystem. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
targetAlias Pxsd:string

Since vSphere API 6.5
lunSpec PVsanIscsiLUNSpec

Since vSphere API 6.5
PRequired privilege - see tooltip for details

Return Value

Type Description
ManagedObjectReference
to a Task
The related task.

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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitEditIscsiTarget(editIscsiTarget)

Edits iSCSI target in this cluster.
All properties in VsanIscsiTargetSpec can be changed. If authType changed, all existing connections are not effected, but the new connection to this target need to use the new authentication type, if port or network interface changed, it has the same impact to connection as authType change. If IQN or alias provided, it should be unique.
If IQN or alias is not unique, a VsanFault will be raised. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
targetSpec PVsanIscsiTargetSpec

Since vSphere API 6.5
PRequired privilege - see tooltip for details

Return Value

Type Description
ManagedObjectReference
to a Task
The related task.

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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitGetHomeObject(getHomeObject)

Gets the home object which stores the metadata for vSAN iSCSI target service. If the home object is not found, a VsanFault will be raised.
Please don't rely on this function to decide whether need to create the home object or not, because the home object may be in creation process.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
P Required privilege: cluster

Return Value

Type Description
VsanObjectInformationVsanObjectInformation for the home object.

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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitGetIscsiInitiatorGroup(getIscsiInitiatorGroup)

Gets one iSCSI initiator group.
If the initiator group doesn't exists, a VsanFault will be raised. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
initiatorGroupName Pxsd:string

Since vSphere API 6.5
PRequired privilege - see tooltip for details

Return Value

Type Description
VsanIscsiInitiatorGroupiSCSI initiator group.

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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitGetIscsiInitiatorGroups(getIscsiInitiatorGroups)

Gets iSCSI initiator group list for one cluster.
If the operation fails, a VsanFault will be raised.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
P Required privilege: cluster

Return Value

Type Description
VsanIscsiInitiatorGroup[]iSCSI initiator group list.

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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitGetIscsiLUN(getIscsiLUN)

Gets one iSCSI LUN for specified target.
If the target or the LUN cannot be found, a VsanFault will be raised. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
targetAlias Pxsd:string

Since vSphere API 6.5
lunId Pxsd:int

Since vSphere API 6.5
PRequired privilege - see tooltip for details

Return Value

Type Description
VsanIscsiLUNiSCSI LUN.

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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitGetIscsiLUNs(getIscsiLUNs)

Gets iSCSI LUN list for specified target list.
If some targets cannot be found, a VsanFault will be raised. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
targetAliases* Pxsd:string[]

Since vSphere API 6.5
*Need not be set PRequired privilege - see tooltip for details

Return Value

Type Description
VsanIscsiLUN[]iSCSI LUN list, it may be empty.

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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitGetIscsiTarget(getIscsiTarget)

Gets one iSCSI target.
If the target cannot be found, a VsanFault will be raised. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
targetAlias Pxsd:string

Since vSphere API 6.5
PRequired privilege - see tooltip for details

Return Value

Type Description
VsanIscsiTargetiSCSI target detail.

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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitGetIscsiTargets(getIscsiTargets)

Gets iSCSI target list for one cluster.
If the operation fails, a VsanFault will be raised.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
P Required privilege: cluster

Return Value

Type Description
VsanIscsiTarget[]iSCSI target list, it may be empty.

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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitQueryIscsiTargetServiceVersion(queryIscsiTargetServiceVersion)

Queries iSCSI service version, if version file is not found, a NotFound exception is raised. When it is invoked from an ESXi host on MO 'vsan-cluster-iscsi-target-system', it just returns the iSCSI version on this host.
Required Privileges
System.Read

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.

Return Value

Type Description
xsd:string

Faults

Type Description
NotFound
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



VsanVitRemoveIscsiInitiatorGroup(removeIscsiInitiatorGroup)

Removes iSCSI initiator group from one cluster.
If there are initiators in the group, the initiators will be removed at the same time. If the initiator group doesn't exist, a VsanFault will be raised. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
initiatorGroupName Pxsd:string

Since vSphere API 6.5
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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitRemoveIscsiInitiatorsFromGroup(removeIscsiInitiatorsFromGroup)

Removes iSCSI initiators from one initiator group.
If the initiator group does not exist, or some of the initiators are not in the specified initiator group, a VsanFault will be raised. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
initiatorGroupName Pxsd:string

Since vSphere API 6.5
initiatorNames Pxsd:string[]

Since vSphere API 6.5
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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitRemoveIscsiInitiatorsFromTarget(removeIscsiInitiatorsFromTarget)

Removes iSCSI initiator or initiator groups from one target.
If the specified target cannot be found or if the initiators or initiator groups specified by the initiatorNames cannot be associated with the specified target, a VsanFault will be raised. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
targetAlias Pxsd:string

Since vSphere API 6.5
initiatorNames Pxsd:string[]

Since vSphere API 6.5
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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitRemoveIscsiLUN(removeIscsiLUN)

Removes iSCSI LUN from this target.
If the target or the LUN cannot be found, a VsanFault will be raised. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
targetAlias Pxsd:string

Since vSphere API 6.5
lunId Pxsd:int

Since vSphere API 6.5
PRequired privilege - see tooltip for details

Return Value

Type Description
ManagedObjectReference
to a Task
The related task.

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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitRemoveIscsiTarget(removeIscsiTarget)

Removes iSCSI target from this cluster.
If the target cannot be found, a VsanFault will be raised. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
targetAlias Pxsd:string

Since vSphere API 6.5
PRequired privilege - see tooltip for details

Return Value

Type Description
ManagedObjectReference
to a Task
The related task.

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.
VsanFault

Events

Type
None

Show WSDL type definition



VsanVitRemoveIscsiTargetFromGroup(removeIscsiTargetFromGroup)

Removes accessible iSCSI target from one initiator group.
If the initiator group is not found or the target is not in the accessible targets of the group, a VsanFault will be raised. Some unhealthy status of the vSAN iSCSI service can also lead to this VsanFault exception, e.g., the unavailability of the home object.
Required Privileges
None

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the VsanIscsiTargetSystem used to make the method call.
cluster PManagedObjectReference
to a ClusterComputeResource

Since vSphere API 6.5
initiatorGroupName Pxsd:string

Since vSphere API 6.5
targetAlias Pxsd:string

Since vSphere API 6.5
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.
VsanFault

Events

Type
None

Show WSDL type definition