FabricClient.ApplicationManagementClient.ProvisionApplicationAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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
- String
The relative path for the application package in the image store specified during CopyApplicationPackage(String, String, String, TimeSpan).
- timeout
- TimeSpan
The maximum amount of time the system will allow this operation to continue before returning TimeoutException.
- cancellationToken
- CancellationToken
The CancellationToken that the operation is observing. It can be used to propagate notification that the operation should be canceled.
Returns
A 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
There was an error accessing a file on the image store.
A required file was not found on the image store.
A required directory was not found on the image store.
A path to an image store file/directory was too long.
The request timed out but may have already been accepted for processing by the system.
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
- TimeSpan
The maximum amount of time the system will allow this operation to continue before returning TimeoutException.
- cancellationToken
- CancellationToken
The CancellationToken that the operation is observing. It can be used to propagate notification that the operation should be canceled.
Returns
A 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
There was an error accessing a file on the image store.
A required file was not found on the image store.
A required directory was not found on the image store.
A path to an image store file/directory was too long.
The request timed out but may have already been accepted for processing by the system.
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
A 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
There was an error accessing a file on the image store.
A required file was not found on the image store.
A required directory was not found on the image store.
A path to an image store file/directory was too long.
The request timed out but may have already been accepted for processing by the system.
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
- String
The relative path for the application package in the image store specified during CopyApplicationPackage(String, String, String, TimeSpan).
Returns
A 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
There was an error accessing a file on the image store.
A required file was not found on the image store.
A required directory was not found on the image store.
A path to an image store file/directory was too long.
The request timed out but may have already been accepted for processing by the system.
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
Azure SDK for .NET