FabricClient.ApplicationManagementClient.CopyApplicationPackage Method

Definition

Namespace:

System.Fabric

Assembly:

System.Fabric.dll

Package:

Microsoft.ServiceFabric v9.1.1833

Overloads

CopyApplicationPackage(String, String, String)	Uploads an application package to the Image Store in preparation for provisioning a new application type.
CopyApplicationPackage(String, String, String, TimeSpan)	Uploads an application package to the Image Store in preparation for provisioning a new application type.
CopyApplicationPackage(String, String, String, IImageStoreProgressHandler, TimeSpan)	Uploads an application package to the Image Store in preparation for provisioning a new application type.

CopyApplicationPackage(String, String, String)

Uploads an application package to the Image Store in preparation for provisioning a new application type.

public void CopyApplicationPackage (string imageStoreConnectionString, string applicationPackagePath, string applicationPackagePathInImageStore);

member this.CopyApplicationPackage : string * string * string -> unit

Public Sub CopyApplicationPackage (imageStoreConnectionString As String, applicationPackagePath As String, applicationPackagePathInImageStore As String)

Parameters

imageStoreConnectionString

String

The connection string for the image store, which should match the "ImageStoreConnectionString" setting value found in the cluster manifest of the target cluster. In an on-premise cluster, the value is chosen during initial deployment by the cluster administrator. In an Azure cluster created through the Azure Resource Manager, this value is "fabric:ImageStore". The image store connection string value can be checked by looking at the cluster manifest contents returned by GetClusterManifestAsync().

applicationPackagePath

String

The full path to the source application package.

applicationPackagePathInImageStore

String

The relative path for the destination in the Image Store. This path is created relative to the root directory in the image store and used as the destination for the application package copy.

Exceptions

UnauthorizedAccessException

There was an error accessing a file on the Image Store.

FileNotFoundException

A required file was not found on the Image Store.

DirectoryNotFoundException

A required directory was not found on the Image Store.

PathTooLongException

A path to an Image Store file/directory was too long.

FabricException

ImageStoreIOException: There was an IO error communicating with the Image Store.

TimeoutException

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

OperationCanceledException

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

Remarks

The timeout of the operation will default to 30 minutes for native image store and there is no timeout capacity for XStore and file share. Can also consider specifying proper timeout value in the overloading function CopyApplicationPackage(String, String, String, TimeSpan)

CopyApplicationPackage(String, String, String, TimeSpan)

Uploads an application package to the Image Store in preparation for provisioning a new application type.

public void CopyApplicationPackage (string imageStoreConnectionString, string applicationPackagePath, string applicationPackagePathInImageStore, TimeSpan timeout);

member this.CopyApplicationPackage : string * string * string * TimeSpan -> unit

Public Sub CopyApplicationPackage (imageStoreConnectionString As String, applicationPackagePath As String, applicationPackagePathInImageStore As String, timeout As TimeSpan)

Parameters

imageStoreConnectionString

String

The connection string for the image store, which should match the "ImageStoreConnectionString" setting value found in the cluster manifest of the target cluster. In an on-premise cluster, the value is chosen during initial deployment by the cluster administrator. In an Azure cluster created through the Azure Resource Manager, this value is "fabric:ImageStore". The image store connection string value can be checked by looking at the cluster manifest contents returned by GetClusterManifestAsync().

applicationPackagePath

String

The full path to the source application package.

applicationPackagePathInImageStore

String

The relative path for the destination in the Image Store. This path is created relative to the root directory in the image store and used as the destination for the application package copy.

timeout

TimeSpan

The timeout of copying application package operation

Exceptions

UnauthorizedAccessException

There was an error accessing a file on the Image Store.

FileNotFoundException

A required file was not found on the Image Store.

DirectoryNotFoundException

A required directory was not found on the Image Store.

PathTooLongException

A path to an Image Store file/directory was too long.

FabricException

ImageStoreIOException: There was an IO error communicating with the Image Store.

TimeoutException

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

OperationCanceledException

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

CopyApplicationPackage(String, String, String, IImageStoreProgressHandler, TimeSpan)

Uploads an application package to the Image Store in preparation for provisioning a new application type.

public void CopyApplicationPackage (string imageStoreConnectionString, string applicationPackagePath, string applicationPackagePathInImageStore, System.Fabric.IImageStoreProgressHandler progressHandler, TimeSpan timeout);

member this.CopyApplicationPackage : string * string * string * System.Fabric.IImageStoreProgressHandler * TimeSpan -> unit

Public Sub CopyApplicationPackage (imageStoreConnectionString As String, applicationPackagePath As String, applicationPackagePathInImageStore As String, progressHandler As IImageStoreProgressHandler, timeout As TimeSpan)

Parameters

imageStoreConnectionString

String

The connection string for the image store, which should match the "ImageStoreConnectionString" setting value found in the cluster manifest of the target cluster. In an on-premise cluster, the value is chosen during initial deployment by the cluster administrator. In an Azure cluster created through the Azure Resource Manager, this value is "fabric:ImageStore". The image store connection string value can be checked by looking at the cluster manifest contents returned by GetClusterManifestAsync().

applicationPackagePath

String

The full path to the source application package.

applicationPackagePathInImageStore

String

The relative path for the destination in the Image Store. This path is created relative to the root directory in the image store and used as the destination for the application package copy.

progressHandler

IImageStoreProgressHandler

The progress handler to retrieve real time progress information

timeout

TimeSpan

The timeout of copying application package operation

Exceptions

UnauthorizedAccessException

There was an error accessing a file on the Image Store.

FileNotFoundException

A required file was not found on the Image Store.

DirectoryNotFoundException

A required directory was not found on the Image Store.

PathTooLongException

A path to an Image Store file/directory was too long.

FabricException

ImageStoreIOException: There was an IO error communicating with the Image Store.

TimeoutException

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

OperationCanceledException

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