Managed Object - VasaProvider

Extends: SmsProvider
Since: SMS API 2.0

Managed Object Description

VASA(vStorage APIs for Storage Awareness) provider definition.

Properties

Name	Type	Description
None
Properties inherited from SmsProvider
None

Methods

Methods defined in this Managed Object
VasaProviderReconnect_Task, VasaProviderRefreshCertificate_Task, VasaProviderRevokeCertificate_Task, VasaProviderSync_Task
Methods inherited from SmsProvider
QueryProviderInfo

VasaProviderReconnect_Task

Reconnect to the provider. This API will be used to reconnect to a provider that is in "disconnected" state. If reconnecting fails due to InvalidCertificate exception, that means the current provider certificate is expired or corrupted. Then user has to recover the provider following these steps: 1. Unregister the provider using sms.StorageManager.unregisterProvider 2. Provision a new self signed certificate for the provider 3. Register the provider using sms.StorageManager.registerProvider If the provider is not in "disconnected" state, this operation will be a no-op. Note: This API works only for providers that support VASA 2.0 and onwards.

Required Privileges: StorageViews.ConfigureService
Since: SMS API 5.0

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VasaProvider used to make the method call.

Return Value

Type	Description
ManagedObjectReference to a SmsTask

Faults

Type	Description
InvalidCertificate	Thrown if the provider certificate is invalid
ProviderConnectionFailed	Thrown if an error is encountered while reconnecting to the provider.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

VasaProviderRefreshCertificate_Task

Refresh a CA signed certificate for the provider. This API will be used when provider certificate is about to expire, but still within soft or hard limit window. If the provider is in "disconnected" state, this operation will be a no-op. Note: This API works only for providers that support VASA 2.0 and onwards.

Required Privileges: StorageViews.ConfigureService
Since: SMS API 5.0

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VasaProvider used to make the method call.

Return Value

Type	Description
ManagedObjectReference to a SmsTask

Faults

Type	Description
CertificateRefreshFailed	Thrown if an error is encountered while refreshing CA signed certificate for the provider.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

VasaProviderRevokeCertificate_Task

Revoke CA signed certificate of the provider. This API will unregister the provider automatically. Note: This API works only for providers that support VASA 2.0 and onwards.

Required Privileges: StorageViews.ConfigureService
Since: SMS API 5.0

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VasaProvider used to make the method call.

Return Value

Type	Description
ManagedObjectReference to a SmsTask

Faults

Type	Description
CertificateRevocationFailed	Thrown if an error is encountered while revoking CA signed certificate of the provider.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

VasaProviderSync_Task

Issue a sync for the given Storage Array.

Required Privileges: StorageViews.View

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the VasaProvider used to make the method call.
arrayId*	xsd:string

*Need not be set

Return Value

Type	Description
ManagedObjectReference to a SmsTask

Faults

Type	Description
InvalidArgument	Thrown if invalid input is provided.
ProviderSyncFailed	Thrown if an error is encountered while executing sync operation for the provider.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None