FabricClient.ApplicationManagementClient.ProvisionApplicationAsync Method

Definition

Overloads

ProvisionApplicationAsync(String, TimeSpan, CancellationToken)

Provision or register an application type with the cluster.

ProvisionApplicationAsync(ProvisionApplicationTypeDescriptionBase, TimeSpan, CancellationToken)

Provision or register an application type with the cluster.

ProvisionApplicationAsync(ProvisionApplicationTypeDescriptionBase)

Provision or register an application type with the cluster.

ProvisionApplicationAsync(String)

Provisions or registers a Service Fabric application type with the cluster.

ProvisionApplicationAsync(String, TimeSpan, CancellationToken)

Provision or register an application type with the cluster.

public System.Threading.Tasks.Task ProvisionApplicationAsync (string applicationPackagePathInImageStore, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);
member this.ProvisionApplicationAsync : string * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function ProvisionApplicationAsync (applicationPackagePathInImageStore As String, timeout As TimeSpan, cancellationToken As CancellationToken) As Task

Parameters

applicationPackagePathInImageStore
System.String

The relative path for the application package in the image store specified during CopyApplicationPackage(String, String, String, TimeSpan).

timeout
System.TimeSpan

The maximum amount of time the system will allow this operation to continue before returning System.TimeoutException.

cancellationToken
System.Threading.CancellationToken

The System.Threading.CancellationToken that the operation is observing. It can be used to propagate notification that the operation should be canceled.

Returns

System.Threading.Tasks.Task

A System.Threading.Tasks.Task representing the operation.

Exceptions

The FabricClient object is in a closed state. Dispose of the FabricClient object you are using and instantiate a new FabricClient object.

ImageStoreIOException: There was an IO error communicating with the image store.

ApplicationTypeAlreadyExists: The application type has already been provisioned

System.UnauthorizedAccessException

There was an error accessing a file on the image store.

System.IO.FileNotFoundException

A required file was not found on the image store.

System.IO.DirectoryNotFoundException

A required directory was not found on the image store.

System.IO.PathTooLongException

A path to an image store file/directory was too long.

System.TimeoutException

The request timed out but may have already been accepted for processing by the system.

System.OperationCanceledException

The request was canceled before the timeout expired but may have already been accepted for processing by the system.

Remarks

This is mandatory before an application instance can be created.

Applies to

ProvisionApplicationAsync(ProvisionApplicationTypeDescriptionBase, TimeSpan, CancellationToken)

Provision or register an application type with the cluster.

public System.Threading.Tasks.Task ProvisionApplicationAsync (System.Fabric.Description.ProvisionApplicationTypeDescriptionBase description, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);
member this.ProvisionApplicationAsync : System.Fabric.Description.ProvisionApplicationTypeDescriptionBase * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function ProvisionApplicationAsync (description As ProvisionApplicationTypeDescriptionBase, timeout As TimeSpan, cancellationToken As CancellationToken) As Task

Parameters

description
ProvisionApplicationTypeDescriptionBase

Description of the provision request. To provision a package previously copied to the image store, use ProvisionApplicationTypeDescription. To provision a package from an external store, use ExternalStoreProvisionApplicationTypeDescription.

timeout
System.TimeSpan

The maximum amount of time the system will allow this operation to continue before returning System.TimeoutException.

cancellationToken
System.Threading.CancellationToken

The System.Threading.CancellationToken that the operation is observing. It can be used to propagate notification that the operation should be canceled.

Returns

System.Threading.Tasks.Task

A System.Threading.Tasks.Task representing the operation.

Exceptions

The FabricClient object is in a closed state. Dispose of the FabricClient object you are using and instantiate a new FabricClient object.

ImageStoreIOException: There was an IO error communicating with the image store.

ApplicationTypeAlreadyExists: The application type has already been provisioned

System.UnauthorizedAccessException

There was an error accessing a file on the image store.

System.IO.FileNotFoundException

A required file was not found on the image store.

System.IO.DirectoryNotFoundException

A required directory was not found on the image store.

System.IO.PathTooLongException

A path to an image store file/directory was too long.

System.TimeoutException

The request timed out but may have already been accepted for processing by the system.

System.OperationCanceledException

The request was canceled before the timeout expired but may have already been accepted for processing by the system.

Remarks

The provision operation is mandatory before an application instance can be created.

Applies to

ProvisionApplicationAsync(ProvisionApplicationTypeDescriptionBase)

Provision or register an application type with the cluster.

public System.Threading.Tasks.Task ProvisionApplicationAsync (System.Fabric.Description.ProvisionApplicationTypeDescriptionBase description);
member this.ProvisionApplicationAsync : System.Fabric.Description.ProvisionApplicationTypeDescriptionBase -> System.Threading.Tasks.Task
Public Function ProvisionApplicationAsync (description As ProvisionApplicationTypeDescriptionBase) As Task

Parameters

description
ProvisionApplicationTypeDescriptionBase

The description of the provision request. To provision a package previously copied to the image store, use ProvisionApplicationTypeDescription. To provision a package from an external store, use ExternalStoreProvisionApplicationTypeDescription.

Returns

System.Threading.Tasks.Task

A System.Threading.Tasks.Task representing the operation.

Exceptions

The FabricClient object is in a closed state. Dispose of the FabricClient object you are using and instantiate a new FabricClient object.

ImageStoreIOException: There was an IO error communicating with the image store.

ApplicationTypeAlreadyExists: The application type has already been provisioned

System.UnauthorizedAccessException

There was an error accessing a file on the image store.

System.IO.FileNotFoundException

A required file was not found on the image store.

System.IO.DirectoryNotFoundException

A required directory was not found on the image store.

System.IO.PathTooLongException

A path to an image store file/directory was too long.

System.TimeoutException

The request timed out but may have already been accepted for processing by the system.

System.OperationCanceledException

The request was canceled before the timeout expired but may have already been accepted for processing by the system.

Remarks

The provision operation is mandatory before an application instance can be created.

Applies to

ProvisionApplicationAsync(String)

Provisions or registers a Service Fabric application type with the cluster.

public System.Threading.Tasks.Task ProvisionApplicationAsync (string applicationPackagePathInImageStore);
member this.ProvisionApplicationAsync : string -> System.Threading.Tasks.Task
Public Function ProvisionApplicationAsync (applicationPackagePathInImageStore As String) As Task

Parameters

applicationPackagePathInImageStore
System.String

The relative path for the application package in the image store specified during CopyApplicationPackage(String, String, String, TimeSpan).

Returns

System.Threading.Tasks.Task

A System.Threading.Tasks.Task representing the operation.

Exceptions

The FabricClient object is in a closed state. Dispose of the FabricClient object you are using and instantiate a new FabricClient object.

ImageStoreIOException: There was an IO error communicating with the image store.

ApplicationTypeAlreadyExists: The application type has already been provisioned

System.UnauthorizedAccessException

There was an error accessing a file on the image store.

System.IO.FileNotFoundException

A required file was not found on the image store.

System.IO.DirectoryNotFoundException

A required directory was not found on the image store.

System.IO.PathTooLongException

A path to an image store file/directory was too long.

System.TimeoutException

The request timed out but may have already been accepted for processing by the system.

System.OperationCanceledException

The request was canceled before the timeout expired but may have already been accepted for processing by the system.

Remarks

This is mandatory before an application instance can be created.

Applies to