AzCopy を使ってみるGet started with AzCopy

AzCopy は、ストレージ アカウント間の BLOB またはファイル コピーに利用できるコマンドライン ユーティリティです。AzCopy is a command-line utility that you can use to copy blobs or files to or from a storage account. この記事は、AzCopy をダウンロードし、ストレージ アカウントに接続し、ファイルを転送する際に役立ちます。This article helps you download AzCopy, connect to your storage account, and then transfer files.

注意

AzCopy V10 が現在サポートされているバージョンの AzCopy です。AzCopy V10 is the currently supported version of AzCopy.

以前のバージョンの AzCopy を使用する必要がある場合は、この記事の「以前のバージョンの AzCopy の使用」セクションを参照してください。If you need to use a previous version of AzCopy, see the Use the previous version of AzCopy section of this article.

AzCopy をダウンロードするDownload AzCopy

まず、お使いのコンピューター上の任意のディレクトリに AzCopy V10 実行可能ファイルをダウンロードします。First, download the AzCopy V10 executable file to any directory on your computer. AzCopy V10 は単に実行可能ファイルなので、インストールするものはありません。AzCopy V10 is just an executable file, so there's nothing to install.

これらのファイルは、zip ファイル (Windows および Mac) または tar ファイル (Linux) として圧縮されます。These files are compressed as a zip file (Windows and Mac) or a tar file (Linux). Linux 上で tar ファイルをダウンロードして圧縮を解除するには、お使いの Linux ディストリビューションのドキュメントを参照してください。To download and decompress the tar file on Linux, see the documentation for your Linux distribution.

注意

Azure Table Storage サービスとの間でデータをコピーする場合、AzCopy バージョン 7.3 をインストールしてください。If you want to copy data to and from your Azure Table storage service, then install AzCopy version 7.3.

AzCopy を実行するRun AzCopy

利便性のため、AzCopy 実行可能ファイルのディレクトリの場所をご自分のシステム パスに追加して使いやすくすることを検討してください。For convenience, consider adding the directory location of the AzCopy executable to your system path for ease of use. そうすると、ご使用のシステム上にある任意のディレクトリから「azcopy」を入力できます。That way you can type azcopy from any directory on your system.

AzCopy ディレクトリをご自分のパスに追加しないことを選択した場合、実際の AzCopy 実行可能ファイルの場所にディレクトリを変更し、Windows PowerShell コマンド プロンプトで「azcopy」または「.\azcopy」と入力する必要があります。If you choose not to add the AzCopy directory to your path, you'll have to change directories to the location of your AzCopy executable and type azcopy or .\azcopy in Windows PowerShell command prompts.

コマンドの一覧を表示するには、「azcopy -h」と入力し、ENTER キーを押します。To see a list of commands, type azcopy -h and then press the ENTER key.

特定のコマンドの情報を知るには、単にコマンドの名前を含めてください (例: azcopy list -h)。To learn about a specific command, just include the name of the command (For example: azcopy list -h).

インライン ヘルプInline help

各コマンドとコマンド パラメーターの詳細なリファレンス ドキュメントについては、「azcopy」を参照してくださいTo find detailed reference documentation for each command and command parameter, see azcopy

注意

ご自分の Azure Storage アカウントの所有者であっても、データへのアクセス許可が自動的に割り当てられるわけではありません。As an owner of your Azure Storage account, you aren't automatically assigned permissions to access data. AzCopy を使用して意味のある動作を行う前に、ストレージ サービスに認証資格情報を提供する方法を決定する必要があります。Before you can do anything meaningful with AzCopy, you need to decide how you'll provide authorization credentials to the storage service.

AzCopy を承認するAuthorize AzCopy

認証資格情報は、Azure Active Directory (AD) または Shared Access Signature (SAS) トークンを使用して提供できます。You can provide authorization credentials by using Azure Active Directory (AD), or by using a Shared Access Signature (SAS) token.

次の表をガイドとして使用してください。Use this table as a guide:

ストレージの種類Storage type 現在サポートされている認証方法Currently supported method of authorization
Blob StorageBlob storage Azure AD および SASAzure AD & SAS
BLOB ストレージ (階層型名前空間)Blob storage (hierarchical namespace) Azure AD および SASAzure AD & SAS
File StorageFile storage SAS のみSAS only

オプション 1: Azure Active Directory を使用するOption 1: Use Azure Active Directory

このオプションは、BLOB ストレージでのみ使用できます。This option is available for blob Storage only. Azure Active Directory を使用すると、各コマンドに SAS トークンを追加する代わりに、資格情報を 1 回入力するだけで済みます。By using Azure Active Directory, you can provide credentials once instead of having to append a SAS token to each command.

注意

現在のリリースでは、ストレージ アカウント間で BLOB をコピーする場合は、各ソース URL に SAS トークンを追加する必要があります。In the current release, if you plan to copy blobs between storage accounts, you'll have to append a SAS token to each source URL. コピー先 URL からのみ、SAS トークンを省略できます。You can omit the SAS token only from the destination URL. 例については、「ストレージ アカウント間で BLOB をコピーする」をご覧ください。For examples, see Copy blobs between storage accounts.

Azure AD を使用してアクセスを承認するには、「AzCopy と Azure Active Directory (Azure AD) を使用して BLOB へのアクセスを承認する」を参照してください。To authorize access by using Azure AD, see Authorize access to blobs with AzCopy and Azure Active Directory (Azure AD).

オプション 2:SAS トークンを使用するOption 2: Use a SAS token

AzCopy コマンドで使用する各コピー元または各コピー先の URL に SAS トークンを追加できます。You can append a SAS token to each source or destination URL that use in your AzCopy commands.

この例のコマンドでは、ローカル ディレクトリから BLOB コンテナーにデータが繰り返しコピーされます。This example command recursively copies data from a local directory to a blob container. 架空の SAS トークンが、コンテナー URL の末尾に追加されます。A fictitious SAS token is appended to the end of the container URL.

azcopy copy "C:\local\path" "https://account.blob.core.windows.net/mycontainer1/?sv=2018-03-28&ss=bjqt&srt=sco&sp=rwddgcup&se=2019-05-01T05:01:17Z&st=2019-04-30T21:01:17Z&spr=https&sig=MGCXiyEzbtttkr3ewJIh2AR8KrghSy1DGM9ovN734bQF4%3D" --recursive=true

SAS トークンの詳細とその取得方法については、「Shared Access Signatures (SAS) の使用」を参照してください。To learn more about SAS tokens and how to obtain one, see Using shared access signatures (SAS).

データの転送Transfer data

ID を承認するか、SAS トークンを取得したら、データの転送を開始できます。After you've authorized your identity or obtained a SAS token, you can begin transferring data.

サンプル コマンドは次の記事のいずれかをご覧ください。To find example commands, see any of these articles.

サービスService [アーティクル]Article
Azure Blob StorageAzure Blob storage Azure Blob Storage にファイルをアップロードするUpload files to Azure Blob storage

Azure Blob Storage から BLOB をダウンロードするDownload blobs from Azure Blob storage

Azure ストレージ アカウント間で BLOB をコピーするCopy blobs between Azure storage accounts

Azure Blob Storage と同期するSynchronize with Azure Blob storage
Azure FilesAzure Files AzCopy とファイル ストレージでデータを転送するTransfer data with AzCopy and file storage
Amazon S3Amazon S3 AzCopy と Amazon S3 バケットでデータを転送するTransfer data with AzCopy and Amazon S3 buckets
Azure Stack ストレージAzure Stack storage AzCopy と Azure Stack ストレージを使用してデータを転送するTransfer data with AzCopy and Azure Stack storage

スクリプト内で使用するUse in a script

時間と共に、AzCopy のダウンロード リンクは AzCopy の新しいバージョンを指します。Over time, the AzCopy download link will point to new versions of AzCopy. 実際のスクリプトで AzCopy をダウンロードする場合、実際のスクリプトで使用する機能が新しいバージョンの AzCopy で変更されていると、スクリプトの動作が停止する可能性があります。If your script downloads AzCopy, the script might stop working if a newer version of AzCopy modifies features that your script depends upon.

これらの問題を回避するには、AzCopy の現在のバージョンの静的 (変更されない) リンクを取得します。To avoid these issues, obtain a static (unchanging) link to the current version of AzCopy. そうすることで、実際のスクリプトを実行するたびに、まったく同じバージョンの AzCopy がダウンロードされます。That way, your script downloads the same exact version of AzCopy each time that it runs.

そのリンクを取得するには、このコマンドを実行します。To obtain the link, run this command:

オペレーティング システムOperating system commandCommand
LinuxLinux curl -s -D- https://aka.ms/downloadazcopy-v10-linux | grep ^Location
WindowsWindows (curl https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue).headers.location

注意

Linux の場合、tar コマンドの --strip-components=1 では、バージョン名を含む最上位フォルダーが削除され、代わりに現在のフォルダーに直接バイナリが抽出されます。For Linux, --strip-components=1 on the tar command removes the top-level folder that contains the version name, and instead extracts the binary directly into the current folder. これにより、wget URL を更新するだけで、新しいバージョンの azcopy でスクリプトを更新できます。This allows the script to be updated with a new version of azcopy by only updating the wget URL.

この URL はこのコマンドの出力に表示されます。The URL appears in the output of this command. その後、実際のスクリプトでその URL を使用して AzCopy をダウンロードできます。Your script can then download AzCopy by using that URL.

オペレーティング システムOperating system commandCommand
LinuxLinux wget -O azcopy_v10.tar.gz https://aka.ms/downloadazcopy-v10-linux && tar -xf azcopy_v10.tar.gz --strip-components=1
WindowsWindows Invoke-WebRequest https://azcopyvnext.azureedge.net/release20190517/azcopy_windows_amd64_10.1.2.zip -OutFile azcopyv10.zip <<Unzip here>>

SAS トークンの特殊文字をエスケープするEscape special characters in SAS tokens

拡張子が .cmd のバッチ ファイルでは、SAS トークンに出現する % 文字をエスケープする必要があります。In batch files that have the .cmd extension, you'll have to escape the % characters that appear in SAS tokens. これを行うには、SAS トークン文字列の既存の % 文字の横に、% の文字を追加します。You can do that by adding an additional % character next to existing % characters in the SAS token string.

Jenkins を使用してスクリプトを実行するRun scripts by using Jenkins

Jenkins を使用してスクリプトを実行する場合は、必ずスクリプトの先頭に次のコマンドを配置してください。If you plan to use Jenkins to run scripts, make sure to place the following command at the beginning of the script.

/usr/bin/keyctl new_session

Azure Storage Explorer で使用するUse in Azure Storage Explorer

Storage Explorer は、AzCopy を使用してすべてのデータ転送操作を実行します。Storage Explorer uses AzCopy to perform all of its data transfer operations. AzCopy のパフォーマンス上の利点を活用する場合は、Storage Explorer を使用できますが、ファイルの操作にはコマンド ラインではなくグラフィカル ユーザー インターフェイスを使用することをお勧めします。You can use Storage Explorer if you want to leverage the performance advantages of AzCopy, but you prefer to use a graphical user interface rather than the command line to interact with your files.

Storage Explorer では、ご自分のアカウント キーを使用して、操作を実行します。そのため、Storage Explorer にサインインした後は、追加の承認資格情報を提供する必要はありません。Storage Explorer uses your account key to perform operations, so after you sign into Storage Explorer, you won't need to provide additional authorization credentials.

構成、最適化、修正を行うConfigure, optimize, and fix

AzCopy の構成、最適化、トラブルシューティング」を参照してください。See Configure, optimize, and troubleshoot AzCopy

以前のバージョンを使用するUse a previous version

以前のバージョンの AzCopy を使用する必要がある場合は、次のいずれかのリンクを参照してください。If you need to use the previous version of AzCopy, see either of the following links:

次のステップNext steps

ご質問、問題、一般的なフィードバックは、GitHub ページからお送りください。If you have questions, issues, or general feedback, submit them on GitHub page.