Sign in

v4

latestSwagger 2.02026-07-13475662.4 KB

Starts an asynchronous copy from a source URL to a destination blob.

put/

Query parameters

timeoutinteger

The timeout parameter is expressed in seconds. For more information, see <a href="https://docs.microsoft.com/en-us/rest/api/storageservices/fileservices/setting-timeouts-for-blob-service-operations\">Setting Timeouts for Blob Service Operations.</a>

Headers

x-ms-versionstring required

Specifies the version of the operation to use for this request.

x-ms-client-request-idstring uuid

An opaque, globally-unique, client-generated string identifier for the request.

x-ms-metastring

The metadata headers.

x-ms-access-tier'P4' | 'P6' | 'P10' | 'P15' | 'P20' | 'P30' | 'P40' | 'P50' | 'P60' | 'P70' | 'P80' | 'Hot' | 'Cool' | 'Archive' | 'Premium' | 'Cold' | 'Smart'

The tier to be set on the blob.

x-ms-rehydrate-priority'High' | 'Standard'

The priority of the rehydration operation.

x-ms-source-if-modified-sincestring date-time-rfc7231

Specify this value to operate only on a source blob if it has been modified since the specified date-time.

x-ms-source-if-unmodified-sincestring date-time-rfc7231

Specify this header value to operate only on a blob if it has not been modified since the specified date-time.

x-ms-source-if-matchstring

Specify this value to operate only on a source blob with a matching Etag value.

x-ms-source-if-none-matchstring

Specify this value to operate only on a source blob with a non-matching Etag value.

x-ms-source-if-tagsstring

Specifies a SQL-like where clause on blob tags to operate only on a source blob with matching tags.

If-Modified-Sincestring date-time-rfc7231

Specify this value to operate only on a blob if it has been modified since the specified date-time.

If-Unmodified-Sincestring date-time-rfc7231

Specify this value to operate only on a blob if it has not been modified since the specified date-time.

If-None-Matchstring

Specify this value to operate only on a blob with a non-matching Etag value.

If-Matchstring

Specify this value to operate only on a blob with a matching Etag value.

x-ms-if-tagsstring

Specifies a SQL-like where clause on blob tags to operate only on a blob with matching tags.

x-ms-copy-sourcestring required

Specifies the name of the source URL for the copy operation. The value should be URL-encoded as it would appear in a request URI.

x-ms-lease-idstring

If specified, the operation only succeeds if the resource's lease is active and matches this ID.

x-ms-tagsstring

The blob tags.

x-ms-seal-blobboolean

Overrides the sealed state of the destination blob.

x-ms-immutability-policy-until-datestring date-time-rfc7231

The date-time that indicates the time at which the blob immutability policy will expire.

x-ms-immutability-policy-mode'mutable' | 'locked' | 'unlocked'

Indicates the immutability policy mode of the blob.

x-ms-legal-holdboolean

Indicates whether the blob has a legal hold.

Response

The request has been accepted for processing, but processing has not yet completed.