az storage blob copy

Manage asynchronous blob copy operations.

Commands

Name Description Type Status
az storage blob copy start

Start an asynchronous copy of a source URL into a blob.

Core Preview

az storage blob copy start

Preview

Start an asynchronous copy of a source URL into a blob.

Start a server-side copy from a source URL into a destination blob. The source can be another blob or any publicly readable URL. The command returns once the copy is scheduled; check its status with az storage blob show.

az storage blob copy start --source-uri
                           [--account-key]
                           [--account-name]
                           [--client-request-id]
                           [--destination-blob]
                           [--destination-container]
                           [--destination-if-match]
                           [--destination-if-modified-since]
                           [--destination-if-none-match]
                           [--destination-if-unmodified-since]
                           [--destination-lease]
                           [--destination-tags-condition]
                           [--metadata]
                           [--rehydrate-priority {High, Standard}]
                           [--sas-token]
                           [--source-if-match]
                           [--source-if-modified-since]
                           [--source-if-none-match]
                           [--source-if-unmodified-since]
                           [--source-tags-condition]
                           [--tags]
                           [--tier]
                           [--timeout]
                           [--url]

Examples

Copy a public URL into a blob

az storage blob copy start --account-name mystorageaccount --account-key $ACCOUNT_KEY --destination-container mycontainer --destination-blob copied.md --source-uri https://raw.githubusercontent.com/Azure/azure-rest-api-specs/refs/heads/main/specification/storage/data-plane/BlobStorage/readme.md

Copy a blob within the account

az storage blob copy start --account-name mystorageaccount --account-key $ACCOUNT_KEY --destination-container backup --destination-blob myblob.txt --source-uri https://mystorageaccount.blob.core.windows.net/mycontainer/myblob.txt

Required Parameters

--source-uri

The source blob URL. It must be public, in the destination account, or carry a SAS.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

Destination storage account key.

--account-name

Destination storage account name. Used with the container and blob name when --url is not given.

--client-request-id

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

--destination-blob

The destination blob name.

--destination-container

The destination container name.

--destination-if-match

Copy only if the destination blob ETag matches.

--destination-if-modified-since

Copy only if the destination blob has been modified since the specified date-time.

--destination-if-none-match

Copy only if the destination blob ETag does not match.

--destination-if-unmodified-since

Copy only if the destination blob has not been modified since the specified date-time.

--destination-lease

The lease ID specified for the destination blob.

--destination-tags-condition

A SQL-like where clause on the destination blob's tags.

--metadata

Destination metadata in space-separated key=value pairs.

--rehydrate-priority

The priority of the rehydration operation.

Property Value
Accepted values: High, Standard
--sas-token

A shared access signature for the destination. Alternative to --account-key; a source SAS goes in --source-uri.

--source-if-match

Copy only if the source blob ETag matches.

--source-if-modified-since

Copy only if the source blob has been modified since the specified date-time.

--source-if-none-match

Copy only if the source blob ETag does not match.

--source-if-unmodified-since

Copy only if the source blob has not been modified since the specified date-time.

--source-tags-condition

A SQL-like where clause on the source blob's tags.

--tags

Destination tags in space-separated key=value pairs.

--tier

The tier to be set on the destination blob.

--timeout

The timeout parameter is expressed in seconds.

--url

The destination blob URL. Alternative to --account-name, --destination-container and --destination-blob.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h -help -? --?

Show help for the command or group and exit.

--no-cache

Bypass the extension discovery cache and reload extensions from disk.

--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, table, tsv, yaml, yamlc
--query

JMESPath query string to filter/project the command result before rendering.