Map of AzCopy v10 commands to Azure Blob Storage REST operations
When you run a command that operates on data in your storage account, AzCopy translates that command to a REST operation. This article maps AzCopy commands to Azure Blob Storage REST operations.
Command mapping
The following table shows the operations that are used by each AzCopy command. To determine the price of each operation, see Map each REST operation to a price.
Commands that target the Blob Service Endpoint
| Command | Scenario | Operations |
|---|---|---|
| azcopy bench | Upload | Put Block and Put Block List. Possibly Put Blob based on object size. |
| azcopy bench | Download | List Blobs, Get Blob Properties, and Get Blob |
| azcopy copy | Upload | Put Block, Put Block List, and Get Blob Properties. Possibly Put Blob based on object size. |
| azcopy copy | Download | List Blobs, Get Blob Properties, and Get Blob |
| azcopy copy | Perform a dry run | List Blobs |
| azcopy copy | Copy from Amazon S3 | Put Blob from URL. Based on object size, could also be Put Block From URL and Put Block List. |
| azcopy copy | Copy from Google Cloud Storage | Put Blob from URL. Based on object size, could also be Put Block From URL and Put Block List. |
| azcopy copy | Copy to another container | List Blobs, Get Blob Properties, and Put Blob From URL. Based on object size, could also be Put Block From URL and Put Block List. |
| azcopy sync | Update local with changes to container | List Blobs, Get Blob Properties, and Get Blob |
| azcopy sync | Update container with changes to local file system | List Blobs, Get Blob Properties, Put Block, and Put Block List. Possibly Put Blob based on object size. |
| azcopy sync | Synchronize containers | List Blobs, Get Blob Properties, and Put Blob From URL. Based on object size, could also be Put Block From URL and Put Block List. |
| azcopy set-properties | Set blob tier | Set Blob Tier and List Blobs (if targeting a virtual directory) |
| azcopy set-properties | Set metadata | Set Blob Metadata and List Blobs (if targeting a virtual directory) |
| azcopy set-properties | Set blob tags | Set Blob Tags and List Blobs (if targeting a virtual directory) |
| azcopy list | List blobs in a container | List Blobs |
| azcopy make | Create a container | Create Container |
| azcopy remove | Delete a container | Delete Container |
| azcopy remove | Delete a blob | Get Blob Properties. List Blobs (if targeting a virtual directory), and Delete Blob |
Commands that target the Data Lake Storage endpoint
| Command | Scenario | Operations |
|---|---|---|
| azcopy bench | Upload | Path - Update (Append), and Path - Update (Flush) |
| azcopy bench | Download | List Blobs, Get Blob Properties, and Path - Read |
| azcopy copy | Upload | Path - Update, and Get Blob Properties |
| azcopy copy | Download | List Blobs, Get Blob Properties, and Path - Read |
| azcopy copy | Perform a dry run | List Blobs |
| azcopy copy | Copy from Amazon S3 | Not supported |
| azcopy copy | Copy from Google Cloud Storage | Not supported |
| azcopy copy | Copy to another container | List Blobs, and Copy Blob. if --preserve-permissions-true, then Path - Get Properties (Get Access Control List) and Path - Update (Set access control) otherwise, Get Blob Properties. |
| azcopy sync | Update local with changes to container | List Blobs, Get Blob Properties, and Get Blob |
| azcopy sync | Update container with changes to local file system | List Blobs, Get Blob Properties, Path - Update (Append), and Path - Update (Flush) |
| azcopy sync | Synchronize containers | List Blobs, Get Blob Properties, and Copy Blob |
| azcopy set-properties | Set blob tier | Not supported |
| azcopy set-properties | Set metadata | Not supported |
| azcopy set-properties | Set blob tags | Not supported |
| azcopy list | List blobs in a container | List Blobs |
| azcopy make | Create a container | Filesystem - Create |
| azcopy remove | Delete a container | Filesystem - Delete |
| azcopy remove | Delete a blob | Filesystem - Delete |