CloudBlob.StartCopyAsync Method

Reference

Definition

Namespace:: Microsoft.Azure.Storage.Blob

Assembly:: Microsoft.Azure.Storage.Blob.dll

Package:: Microsoft.Azure.Storage.Blob v11.2.3

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

StartCopyAsync(Uri)	Initiates an asynchronous operation to start copying another blob's contents, properties, and metadata to this blob.
StartCopyAsync(Uri, CancellationToken)	Initiates an asynchronous operation to start copying another blob's contents, properties, and metadata to this blob.
StartCopyAsync(Uri, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext)	Initiates an asynchronous operation to start copying another blob's contents, properties, and metadata to this blob.
StartCopyAsync(Uri, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)	Initiates an asynchronous operation to start copying another blob's contents, properties, and metadata to this blob.
StartCopyAsync(Uri, Nullable<PremiumPageBlobTier>, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)	Initiates an asynchronous operation to start copying another blob's contents, properties, and metadata to this blob.
StartCopyAsync(Uri, Nullable<StandardBlobTier>, Nullable<RehydratePriority>, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)	Initiates an asynchronous operation to start copying another blob's contents, properties, and metadata to this blob.

StartCopyAsync(Uri)

Initiates an asynchronous operation to start copying another blob's contents, properties, and metadata to this blob.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<string> StartCopyAsync (Uri source);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member StartCopyAsync : Uri -> System.Threading.Tasks.Task<string>
override this.StartCopyAsync : Uri -> System.Threading.Tasks.Task<string>

Public Overridable Function StartCopyAsync (source As Uri) As Task(Of String)

Parameters

source: Uri

The Uri of the source blob.

Returns

Task<String>

A Task<TResult> object of type string that represents the asynchronous operation.

Attributes: DoesServiceRequestAttribute

Applies to

StartCopyAsync(Uri, CancellationToken)

Initiates an asynchronous operation to start copying another blob's contents, properties, and metadata to this blob.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<string> StartCopyAsync (Uri source, System.Threading.CancellationToken cancellationToken);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member StartCopyAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>
override this.StartCopyAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>

Public Overridable Function StartCopyAsync (source As Uri, cancellationToken As CancellationToken) As Task(Of String)

Parameters

source: Uri

The Uri of the source blob.

cancellationToken: CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

Task<String>

A Task<TResult> object of type string that represents the asynchronous operation.

Attributes: DoesServiceRequestAttribute

Applies to

StartCopyAsync(Uri, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext)

Initiates an asynchronous operation to start copying another blob's contents, properties, and metadata to this blob.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<string> StartCopyAsync (Uri source, Microsoft.Azure.Storage.AccessCondition sourceAccessCondition, Microsoft.Azure.Storage.AccessCondition destAccessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member StartCopyAsync : Uri * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<string>
override this.StartCopyAsync : Uri * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<string>

Public Overridable Function StartCopyAsync (source As Uri, sourceAccessCondition As AccessCondition, destAccessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext) As Task(Of String)

Parameters

source: Uri

The Uri of the source blob.

sourceAccessCondition: AccessCondition

An AccessCondition object that represents the access conditions for the source blob. If null, no condition is used.

destAccessCondition: AccessCondition

An AccessCondition object that represents the access conditions for the destination blob. If null, no condition is used.

options: BlobRequestOptions

A BlobRequestOptions object that specifies additional options for the request.

operationContext: OperationContext

An OperationContext object that represents the context for the current operation.

Returns

Task<String>

A Task<TResult> object of type string that represents the asynchronous operation.

Attributes: DoesServiceRequestAttribute

Applies to

StartCopyAsync(Uri, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

Initiates an asynchronous operation to start copying another blob's contents, properties, and metadata to this blob.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<string> StartCopyAsync (Uri source, Microsoft.Azure.Storage.AccessCondition sourceAccessCondition, Microsoft.Azure.Storage.AccessCondition destAccessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member StartCopyAsync : Uri * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>
override this.StartCopyAsync : Uri * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>

Public Overridable Function StartCopyAsync (source As Uri, sourceAccessCondition As AccessCondition, destAccessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of String)

Parameters

source: Uri

The Uri of the source blob.

sourceAccessCondition: AccessCondition

An AccessCondition object that represents the access conditions for the source blob. If null, no condition is used.

destAccessCondition: AccessCondition

An AccessCondition object that represents the access conditions for the destination blob. If null, no condition is used.

options: BlobRequestOptions

A BlobRequestOptions object that specifies additional options for the request.

operationContext: OperationContext

An OperationContext object that represents the context for the current operation.

cancellationToken: CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

Task<String>

A Task<TResult> object of type string that represents the asynchronous operation.

Attributes: DoesServiceRequestAttribute

Applies to

StartCopyAsync(Uri, Nullable<PremiumPageBlobTier>, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

Initiates an asynchronous operation to start copying another blob's contents, properties, and metadata to this blob.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<string> StartCopyAsync (Uri source, Microsoft.Azure.Storage.Blob.PremiumPageBlobTier? premiumPageBlobTier, Microsoft.Azure.Storage.AccessCondition sourceAccessCondition, Microsoft.Azure.Storage.AccessCondition destAccessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member StartCopyAsync : Uri * Nullable<Microsoft.Azure.Storage.Blob.PremiumPageBlobTier> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>
override this.StartCopyAsync : Uri * Nullable<Microsoft.Azure.Storage.Blob.PremiumPageBlobTier> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>

Public Overridable Function StartCopyAsync (source As Uri, premiumPageBlobTier As Nullable(Of PremiumPageBlobTier), sourceAccessCondition As AccessCondition, destAccessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of String)

Parameters

source: Uri

The Uri of the source blob.

premiumPageBlobTier: Nullable<PremiumPageBlobTier>

A PremiumPageBlobTier representing the tier to set. Only valid for page blobs.

sourceAccessCondition: AccessCondition

An AccessCondition object that represents the access conditions for the source blob. If null, no condition is used.

destAccessCondition: AccessCondition

An AccessCondition object that represents the access conditions for the destination blob. If null, no condition is used.

options: BlobRequestOptions

A BlobRequestOptions object that specifies additional options for the request.

operationContext: OperationContext

An OperationContext object that represents the context for the current operation.

cancellationToken: CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

Task<String>

A Task<TResult> object of type string that represents the asynchronous operation.

Attributes: DoesServiceRequestAttribute

Applies to

StartCopyAsync(Uri, Nullable<StandardBlobTier>, Nullable<RehydratePriority>, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

Initiates an asynchronous operation to start copying another blob's contents, properties, and metadata to this blob.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<string> StartCopyAsync (Uri source, Microsoft.Azure.Storage.Blob.StandardBlobTier? standardBlockBlobTier, Microsoft.Azure.Storage.Blob.RehydratePriority? rehydratePriority, Microsoft.Azure.Storage.AccessCondition sourceAccessCondition, Microsoft.Azure.Storage.AccessCondition destAccessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member StartCopyAsync : Uri * Nullable<Microsoft.Azure.Storage.Blob.StandardBlobTier> * Nullable<Microsoft.Azure.Storage.Blob.RehydratePriority> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>
override this.StartCopyAsync : Uri * Nullable<Microsoft.Azure.Storage.Blob.StandardBlobTier> * Nullable<Microsoft.Azure.Storage.Blob.RehydratePriority> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>

Public Overridable Function StartCopyAsync (source As Uri, standardBlockBlobTier As Nullable(Of StandardBlobTier), rehydratePriority As Nullable(Of RehydratePriority), sourceAccessCondition As AccessCondition, destAccessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of String)

Parameters

source: Uri

The Uri of the source blob.

standardBlockBlobTier: Nullable<StandardBlobTier>

A StandardBlobTier representing the tier to set. Only valid for block blobs.

rehydratePriority: Nullable<RehydratePriority>

The priority with which to rehydrate an archived blob.

sourceAccessCondition: AccessCondition

An AccessCondition object that represents the access conditions for the source blob. If null, no condition is used.

destAccessCondition: AccessCondition

An AccessCondition object that represents the access conditions for the destination blob. If null, no condition is used.

options: BlobRequestOptions

A BlobRequestOptions object that specifies additional options for the request.

operationContext: OperationContext

An OperationContext object that represents the context for the current operation.

cancellationToken: CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

Task<String>

A Task<TResult> object of type string that represents the asynchronous operation.

Attributes: DoesServiceRequestAttribute

Applies to

Share via

CloudBlob.StartCopyAsync Method

Definition

Overloads

StartCopyAsync(Uri)

Parameters

Returns

Applies to

StartCopyAsync(Uri, CancellationToken)

Parameters

Returns

Applies to

StartCopyAsync(Uri, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext)

Parameters

Returns

Applies to

StartCopyAsync(Uri, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

Parameters

Returns

Applies to

StartCopyAsync(Uri, Nullable<PremiumPageBlobTier>, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

Parameters

Returns

Applies to

StartCopyAsync(Uri, Nullable<StandardBlobTier>, Nullable<RehydratePriority>, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

Parameters

Returns

Applies to

Additional resources