Managed Object - SmsStorageManager

Returned by
QueryStorageManager
See also
Datastore, DrsMigrationCapabilityResult, HostSystem, SmsProvider, SmsProviderSpec, StorageArray, StorageCapability, StorageFileSystem, StorageLun, StoragePort, StorageProcessor
Since
SMS API 2.0


Managed Object Description

The SmsStorageManager managed object (SMS) provides methods to retrieve information about available storage topology, capabilities, and state. SMS establishes and maintains connections with VASA providers. SMS retrieves information about storage availability from the providers, and clients can use the SMS API to perform the following operations.

Properties

Name Type Description
None

Methods

Methods defined in this Managed Object
QueryArray, QueryArrayAssociatedWithLun, QueryDatastoreCapability, QueryDrsMigrationCapabilityForPerformance, QueryDrsMigrationCapabilityForPerformanceEx, QueryFileSystemAssociatedWithArray, QueryHostAssociatedWithLun, QueryLunAssociatedWithArray, QueryLunAssociatedWithPort, QueryNfsDatastoreAssociatedWithFileSystem, QueryPortAssociatedWithArray, QueryPortAssociatedWithLun, QueryPortAssociatedWithProcessor, QueryProcessorAssociatedWithArray, QueryProvider, QueryVmfsDatastoreAssociatedWithLun, RegisterProvider_Task, UnregisterProvider_Task

QueryArray

Get the list of storage arrays managed by all the registered VASA providers.
Required Privileges
StorageViews.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the SmsStorageManager used to make the method call.
providerId*xsd:string[]

List of uid for the VASA provider objects.
*Need not be set

Return Value

Type Description
StorageArray[]List of data objects containing information about StorageArray.

Faults

Type Description
NotFoundThrown if the given providerId does not have any reference.
QueryExecutionFaultThrown if an error is encountered while processing the query request.
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



QueryArrayAssociatedWithLun

Get the StorageArray object that is associated with the ScsiLun.
Required Privileges
StorageViews.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the SmsStorageManager used to make the method call.
canonicalNamexsd:string

canonicalName of ScsiLun

Return Value

Type Description
StorageArrayStorageArray for the for the ScsiLun.

Faults

Type Description
NotFoundThrown if the specified entity does not exist.
QueryExecutionFaultThrown if an error is encountered while processing the query request.
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



QueryDatastoreCapability

Get the capability for the given datastore.
Required Privileges
StorageViews.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the SmsStorageManager used to make the method call.
datastoreManagedObjectReference
to a Datastore

reference to Datastore

Return Value

Type Description
StorageCapabilityA data object containing information about StorageCapability. If the VMFS datastore have heterogeneous Luns (in case of VMFS extends), StorageCapability#description will be empty.

Faults

Type Description
NotFoundThrown if the specified entity does not exist.
QueryExecutionFaultThrown if an error is encountered while processing the query request.
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



QueryDrsMigrationCapabilityForPerformance

Deprecated. As of SMS API 3.0, use QueryDrsMigrationCapabilityForPerformanceEx

Query the provider to figure out whether Storage DRS should migrate VMDKs between the two given datastores.
Required Privileges
StorageViews.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the SmsStorageManager used to make the method call.
srcDatastoreManagedObjectReference
to a Datastore

Reference to the source Datastore
dstDatastoreManagedObjectReference
to a Datastore

Reference to the destination Datastore

Return Value

Type Description
xsd:booleantrue if VM migration is recommended from srcDatastore to dstDatastore. false if VM migration is not recommended from srcDatastore to dstDatastore.

Faults

Type Description
NotFoundThrown if the specified entity does not exist.
QueryExecutionFaultThrown if an error is encountered while processing the query request.
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



QueryDrsMigrationCapabilityForPerformanceEx

Query available VASA providers for I/O performance based migration recommendations for all pair combinations of the given set of datastores. Datastore pairs for which a recommendation cannot be obtained are not included in the result.
Required Privileges
StorageViews.View
Since
SMS API 3.0

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the SmsStorageManager used to make the method call.
datastoreManagedObjectReference[]
to a Datastore[]

Array containing references to Datastore objects.

Return Value

Type Description
DrsMigrationCapabilityResultDrsMigrationCapabilityResult

Faults

Type Description
NotFoundThrown if any Datastore in the specified input array does not exist.
QueryExecutionFaultThrown if an error is encountered while processing the query request.
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



QueryFileSystemAssociatedWithArray

Get the StorageFileSystem data objects for the Array.
Required Privileges
StorageViews.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the SmsStorageManager used to make the method call.
arrayIdxsd:string

uuid for the StorageArray object.

Return Value

Type Description
StorageFileSystem[]List of data objects containing information about StorageFileSystem.

Faults

Type Description
NotFoundThrown if the specified entity does not exist.
QueryExecutionFaultThrown if an error is encountered while processing the query request.
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



QueryHostAssociatedWithLun

Get HostSystem managed entities that share the StorageLun.
Required Privileges
StorageViews.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the SmsStorageManager used to make the method call.
scsi3Idxsd:string

uuid for the StorageLun object.
arrayIdxsd:string

uuid for the StorageArray object.

Return Value

Type Description
ManagedObjectReference[]
to a HostSystem[]
List of HostSystems.

Faults

Type Description
NotFoundThrown if the specified entity does not exist.
QueryExecutionFaultThrown if an error is encountered while processing the query request.
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



QueryLunAssociatedWithArray

Get the list of StorageLun data objects that for the Array.
Required Privileges
StorageViews.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the SmsStorageManager used to make the method call.
arrayIdxsd:string

uuid for the StorageArray object.

Return Value

Type Description
StorageLun[]List of data object containing information about StorageLun.

Faults

Type Description
NotFoundThrown if the specified entity does not exist.
QueryExecutionFaultThrown if an error is encountered while processing the query request.
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



QueryLunAssociatedWithPort

Get the StorageLun data objects that are associated with StoragePort.
Required Privileges
StorageViews.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the SmsStorageManager used to make the method call.
portIdxsd:string

uuid for the StoragePort object.
arrayIdxsd:string

uuid for the StorageArray object.

Return Value

Type Description
StorageLun[]List of data objects containing information about StorageLun.

Faults

Type Description
NotFoundThrown if the specified entity does not exist.
QueryExecutionFaultThrown if an error is encountered while processing the query request.
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



QueryNfsDatastoreAssociatedWithFileSystem

Get NFS datastore managed entity that are associated with StorageFileSystem.
Required Privileges
StorageViews.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the SmsStorageManager used to make the method call.
fileSystemIdxsd:string

uuid for the StorageFileSystem object
arrayIdxsd:string

uuid for the StorageArray object.

Return Value

Type Description
ManagedObjectReference
to a Datastore
Nas datastore for the storage file system id.

Faults

Type Description
NotFoundThrown if the specified entity does not exist.
QueryExecutionFaultThrown if an error is encountered while processing the query request.
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



QueryPortAssociatedWithArray

Get the StoragePort data objects that are associated with Array.
Required Privileges
StorageViews.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the SmsStorageManager used to make the method call.
arrayIdxsd:string

uuid for the StorageArray object.

Return Value

Type Description
StoragePort[]List of data objects containing information about StoragePort.

Faults

Type Description
NotFoundThrown if the specified entity does not exist.
QueryExecutionFaultThrown if an error is encountered while processing the query request.
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



QueryPortAssociatedWithLun

Get the StoragePort data object that is associated with LUN.
Required Privileges
StorageViews.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the SmsStorageManager used to make the method call.
scsi3Idxsd:string

uuid for the StorageLun object.
arrayIdxsd:string

uuid for the StorageArray object.

Return Value

Type Description
StoragePortA data object containing information about StoragePort.

Faults

Type Description
NotFoundThrown if the specified entity does not exist.
QueryExecutionFaultThrown if an error is encountered while processing the query request.
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



QueryPortAssociatedWithProcessor

Get the StoragePort data objects that are associated with Processor.
Required Privileges
StorageViews.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the SmsStorageManager used to make the method call.
processorIdxsd:string

uuid for the StorageProcessor object.
arrayIdxsd:string

uuid for the StorageArray object.

Return Value

Type Description
StoragePort[]List of data objects containing information about StoragePort.

Faults

Type Description
NotFoundThrown if the specified entity does not exist.
QueryExecutionFaultThrown if an error is encountered while processing the query request.
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



QueryProcessorAssociatedWithArray

Get the StorageProcessor data objects that are associated with Array.
Required Privileges
StorageViews.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the SmsStorageManager used to make the method call.
arrayIdxsd:string

uuid for the StorageArray object.

Return Value

Type Description
StorageProcessor[]List of data objects containing information about StorageProcessor.

Faults

Type Description
NotFoundThrown if the specified entity does not exist.
QueryExecutionFaultThrown if an error is encountered while processing the query request.
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



QueryProvider

Get the list of Providers that are currently registered with StorageManager.
Required Privileges
StorageViews.View

Parameters

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

Return Value

Type Description
ManagedObjectReference[]
to a SmsProvider[]
List of Providers.

Faults

Type Description
QueryExecutionFaultThrown if an error is encountered while processing the query request.
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



QueryVmfsDatastoreAssociatedWithLun

Get VMFS Datastore managed entity that are associated with StorageLun.
Required Privileges
StorageViews.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the SmsStorageManager used to make the method call.
scsi3Idxsd:string

uuid for the StorageLun object
arrayIdxsd:string

uuid for the StorageArray object.

Return Value

Type Description
ManagedObjectReference
to a Datastore
Vmfs datastore for the file system id.

Faults

Type Description
NotFoundThrown if the specified entity does not exist.
QueryExecutionFaultThrown if an error is encountered while processing the query request.
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



RegisterProvider_Task

Register the provider and issue a sync operation on it.
Required Privileges
StorageViews.ConfigureService

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the SmsStorageManager used to make the method call.
providerSpecSmsProviderSpec

SmsProviderSpec containing parameters needed to register the provider

Return Value

Type Description
ManagedObjectReference
to a SmsTask

Faults

Type Description
AlreadyExistsThrown if the provider already exists.
InvalidArgumentThrown if invalid input is provided.
ProviderRegistrationFaultThrown if an error is encountered during the registration operation. For instance, IncorrectUsernamePassword is thrown if the login credentials are incorrect. CertificateNotTrusted is thrown if the provider identifies itself with an untrusted certificate.
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



UnregisterProvider_Task

Unregister the provider.

Required Privileges
StorageViews.ConfigureService

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the SmsStorageManager used to make the method call.
providerIdxsd:string

uid for the provider

Return Value

Type Description
ManagedObjectReference
to a SmsTask

Faults

Type Description
InvalidArgumentThrown if invalid input is provided.
NotFoundThrown if the specified entity does not exist.
ProviderUnregistrationFaultThrown if provider service is not available or any exception is thrown by the VASA provider during unregister provider.
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