CloudPageBlob.StartCopy 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
StartCopy(CloudPageBlob, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext) |
Begins an operation to start copying another page blob's contents, properties, and metadata to this page blob. |
StartCopy(CloudPageBlob, Nullable<PremiumPageBlobTier>, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext) |
Begins an operation to start copying another page blob's contents, properties, and metadata to this page blob. |
StartCopy(CloudPageBlob, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext)
Begins an operation to start copying another page blob's contents, properties, and metadata to this page blob.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual string StartCopy (Microsoft.Azure.Storage.Blob.CloudPageBlob source, Microsoft.Azure.Storage.AccessCondition sourceAccessCondition = default, Microsoft.Azure.Storage.AccessCondition destAccessCondition = default, Microsoft.Azure.Storage.Blob.BlobRequestOptions options = default, Microsoft.Azure.Storage.OperationContext operationContext = default);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
override this.StartCopy : Microsoft.Azure.Storage.Blob.CloudPageBlob * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> string
Public Overridable Function StartCopy (source As CloudPageBlob, Optional sourceAccessCondition As AccessCondition = Nothing, Optional destAccessCondition As AccessCondition = Nothing, Optional options As BlobRequestOptions = Nothing, Optional operationContext As OperationContext = Nothing) As String
Parameters
- source
- CloudPageBlob
The CloudPageBlob that is 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. If null
, default options are applied to the request.
- operationContext
- OperationContext
An OperationContext object that represents the context for the current operation.
Returns
The copy ID associated with the copy operation.
- Attributes
Remarks
This method fetches the blob's ETag, last-modified time, and part of the copy state. The copy ID and copy status fields are fetched, and the rest of the copy state is cleared.
Applies to
StartCopy(CloudPageBlob, Nullable<PremiumPageBlobTier>, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext)
Begins an operation to start copying another page blob's contents, properties, and metadata to this page blob.
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual string StartCopy (Microsoft.Azure.Storage.Blob.CloudPageBlob source, Microsoft.Azure.Storage.Blob.PremiumPageBlobTier? premiumPageBlobTier, Microsoft.Azure.Storage.AccessCondition sourceAccessCondition = default, Microsoft.Azure.Storage.AccessCondition destAccessCondition = default, Microsoft.Azure.Storage.Blob.BlobRequestOptions options = default, Microsoft.Azure.Storage.OperationContext operationContext = default);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
override this.StartCopy : Microsoft.Azure.Storage.Blob.CloudPageBlob * Nullable<Microsoft.Azure.Storage.Blob.PremiumPageBlobTier> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> string
Public Overridable Function StartCopy (source As CloudPageBlob, premiumPageBlobTier As Nullable(Of PremiumPageBlobTier), Optional sourceAccessCondition As AccessCondition = Nothing, Optional destAccessCondition As AccessCondition = Nothing, Optional options As BlobRequestOptions = Nothing, Optional operationContext As OperationContext = Nothing) As String
Parameters
- source
- CloudPageBlob
The CloudPageBlob that is the source blob.
- premiumPageBlobTier
- Nullable<PremiumPageBlobTier>
A PremiumPageBlobTier representing the tier to set.
- 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. If null
, default options are applied to the request.
- operationContext
- OperationContext
An OperationContext object that represents the context for the current operation.
Returns
The copy ID associated with the copy operation.
- Attributes
Remarks
This method fetches the blob's ETag, last-modified time, and part of the copy state. The copy ID and copy status fields are fetched, and the rest of the copy state is cleared.