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
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
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.
Destination storage account key.
Destination storage account name. Used with the container and blob name when --url is not given.
An opaque, globally-unique, client-generated string identifier for the request.
The destination blob name.
The destination container name.
Copy only if the destination blob ETag matches.
Copy only if the destination blob has been modified since the specified date-time.
Copy only if the destination blob ETag does not match.
Copy only if the destination blob has not been modified since the specified date-time.
The lease ID specified for the destination blob.
A SQL-like where clause on the destination blob's tags.
Destination metadata in space-separated key=value pairs.
The priority of the rehydration operation.
| Property | Value |
|---|---|
| Accepted values: | High, Standard |
A shared access signature for the destination. Alternative to --account-key; a source SAS goes in --source-uri.
Copy only if the source blob ETag matches.
Copy only if the source blob has been modified since the specified date-time.
Copy only if the source blob ETag does not match.
Copy only if the source blob has not been modified since the specified date-time.
A SQL-like where clause on the source blob's tags.
Destination tags in space-separated key=value pairs.
The tier to be set on the destination blob.
The timeout parameter is expressed in seconds.
The destination blob URL. Alternative to --account-name, --destination-container and --destination-blob.
Global Parameters
Increase logging verbosity to show all debug logs.
Show help for the command or group and exit.
Bypass the extension discovery cache and reload extensions from disk.
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, table, tsv, yaml, yamlc |
JMESPath query string to filter/project the command result before rendering.