AzCopy は、ストレージ アカウント間のデータ コピーに利用できるコマンドライン ユーティリティです。 この記事は、AzCopy をダウンロードし、ストレージ アカウントに接続し、データを転送する際に役立ちます。
AzCopy V10 が現在サポートされているバージョンの AzCopy です。 正式に保守されている Windows、Linux、または macOS のバージョンでのみサポートされます。 以前のバージョンの AzCopy を使用する必要がある場合は、この記事の「以前のバージョンの AzCopy の使用」セクションを参照してください。
AzCopy のユース ケース
AzCopy を使用して、Azure ストレージ アカウントとの間でデータをコピーします。 一般的なユース ケースは次のとおりです。
- オンプレミスのソースから Azure ストレージ アカウントへのデータのコピー
- Azure ストレージ アカウントからオンプレミス ソースへのデータのコピー
- あるストレージ アカウントから別のストレージ アカウントへのデータのコピー
AzCopy では、コマンドとオプションを使用して各ユース ケースをサポートしています。 たとえば、AzCopy には、データをコピーまたは同期するためのネイティブ コマンドがあります。 このサポートにより、AzCopy は、1 回限りのコピー アクティビティや継続的な同期シナリオに使用できる柔軟なツールになります。 Azure Blob Storage や Azure Files などの特定のストレージ サービスをターゲットにすることができ、それらの間でコピーすることもできます。 たとえば、Azure Blob Storage コンテナーから Azure ファイル共有に、またはその逆にデータをコピーできます。
データ転送ガイドの完全な一覧については、この記事の 「データの転送 」セクションを参照してください。
AzCopy を取得する
Linux マシンで AzCopy を使用している場合は、パッケージ マネージャーを使用できます。 他のすべてのオペレーティング システムでは、ポータブル バイナリ ファイルをダウンロードします。 AzCopy リリースの詳細については、AzCopy リリースに関するページを参照してください。
パッケージ マネージャーを使用する (Linux のみ)
Linux ディストリビューションのパッケージ マネージャーを使用して AzCopy をインストールすることは、このツールを入手するための最も便利で保守しやすい方法です。 パッケージ マネージャーのインストールには、依存関係の自動解決、簡略化された更新プログラム、およびシステムのソフトウェア管理との統合が含まれます。 詳細なガイダンスについては、 パッケージ マネージャーを使用した AzCopy on Linux のインストールに関する記事を参照してください。
移植可能なバイナリをダウンロードする
インストール パッケージは Linux でのみ使用できます。 他のすべてのオペレーティング システムでは、AzCopy V10 実行可能ファイルをコンピューター上の任意のディレクトリにダウンロードできます。
- Windows 64 ビット (zip)
- Windows 32 ビット (zip)
- Windows ARM64 (zip)
- Linux x86-64 (tar)
- Linux ARM64 (tar)
- macOS (zip)
- macOS ARM64 (zip)
これらのファイルは、zip ファイル (Windows および Mac) または tar ファイル (Linux) として圧縮されます。 Linux 上で tar ファイルをダウンロードして圧縮を解除するには、お使いの Linux ディストリビューションのドキュメントを参照してください。
注
Azure Table Storage サービスとの間でデータをコピーする場合は、AzCopy バージョン 7.3 をインストールします。
AzCopy をシステム パスに追加する
便宜上、AzCopy 実行可能ファイルのディレクトリの場所をシステム パスに追加することを検討してください。 そうすると、ご使用のシステム上にある任意のディレクトリから「azcopy」を入力できます。 AzCopy ディレクトリをパスに追加しない場合は、AzCopy 実行可能ファイルの場所にディレクトリを変更し、コマンド シェルで azcopy または .\azcopy を入力する必要があります。
AzCopy を承認する
ご自分の Azure Storage アカウントの所有者であっても、データへのアクセス許可が自動的に割り当てられるわけではありません。 AzCopy を使用して意味のある動作を行う前に、ストレージ サービスに認証資格情報を提供する方法を決定する必要があります。 資格情報は、Microsoft Entra ID を使用するか、SAS トークンを使用して指定できます。
Microsoft Entra ID で承認する
Microsoft Entra ID を使用すると、各コマンドに SAS トークンを追加する代わりに、資格情報を 1 回入力するだけで済みます。 まず、承認する セキュリティ プリンシパル の種類を選択します。 次の表をガイドとして使用してください。
| セキュリティ プリンシパル | ガイダンス |
|---|---|
| ユーザー ID | ユーザー ID を使用して AzCopy へのアクセスを承認する |
| マネージド ID | マネージド ID を使用して AzCopy へのアクセスを承認する |
| サービス プリンシパル | サービス プリンシパルを使用して AzCopy のアクセスを承認する |
SAS トークンを使用して承認する
AzCopy コマンドで使用する各ソースまたは宛先 URL に SAS トークンを追加できます。 この例のコマンドでは、ローカル ディレクトリから BLOB コンテナーにデータが繰り返しコピーされます。 架空の SAS トークンが、コンテナー 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) の使用」を参照してください。
データの転送
ID を承認するか、SAS トークンを取得したら、データの転送を開始できます。
コマンドの例については、次のいずれかの記事を参照してください。
| サービス | [アーティクル] |
|---|---|
| Azure Blob Storage | Azure Blob Storage にファイルをアップロードする |
| Azure Blob Storage | Azure Blob Storage から BLOB をダウンロードする |
| Azure Blob Storage | Azure ストレージ アカウント間で BLOB をコピーする |
| Azure Blob Storage | Azure Blob Storage と同期する |
| Azure Files | AzCopy とファイル ストレージでデータを転送する |
| Amazon S3 | Amazon S3 から Azure Storage にデータをコピーする |
| Google Cloud Storage | Google Cloud Storage から Azure Storage にデータをコピーする (プレビュー) |
| Azure Stack ストレージ | AzCopy と Azure Stack ストレージを使用してデータを転送する |
AzCopy コマンドは対話形式で実行できます。 また、AzCopy を、バッチ操作、スケジュールされたデータ転送、または継続的インテグレーション パイプライン用の自動スクリプトに組み込むこともできます。 詳細については、「 スクリプトとスケジュールされた転送で AzCopy を使用する」を参照してください。
注
AzCopy では、転送中にソースまたは宛先がアクティブに変更されるシナリオはサポートされていません。
コマンドのヘルプを表示する
コマンドの一覧を表示するには、「azcopy -h」と入力し、ENTER キーを押します。
特定のコマンドについて学習するには、コマンドの名前を含めます (例: azcopy list -h)。
コマンドの一覧
次の表に、AzCopy v10 のすべてのコマンドを示します。 各コマンドは、リファレンス記事にリンクされています。
| コマンド | 説明 |
|---|---|
| azcopy bench（AzCopyのベンチマークテスト用） | 指定した場所との間でテスト データをアップロードまたはダウンロードすることで、パフォーマンス ベンチマークを実行します。 |
| azcopy copy | ソース データをコピー先の場所にコピーします。 |
| azcopy doc | ツールのドキュメントをマークダウン形式で生成します。 |
| azcopy env | AzCopy の動作を構成できる環境変数を示します。 |
| azcopy jobs | ジョブの管理に関連するサブコマンド。 |
| azcopy jobs clean | すべてのジョブのログとプランのファイルをすべて削除します。 |
| azcopy jobs list | すべてのジョブに関する情報を表示します。 |
| azcopy jobs remove | 指定されたジョブ ID に関連付けられているすべてのファイルを削除します。 |
| azcopy jobs resume | 指定されたジョブ ID を持つ既存のジョブを再開します。 |
| azcopy jobs show | 指定されたジョブ ID の詳細情報を表示します。 |
| azcopy list | 指定されたリソース内のエンティティを一覧表示します。 |
| azcopy login | Microsoft Entra ID にサインインして、Azure Storage リソースにアクセスします。 |
| azcopy ログイン状態 | 指定されたリソース内のエンティティを一覧表示します。 |
| azcopy logout | ユーザーをサインアウトし、Azure Storage リソースへのアクセスを終了します。 |
| azcopy make | コンテナーまたはファイル共有を作成します。 |
| azcopy remove | Azure ストレージ アカウントから BLOB またはファイルを削除します。 |
| azcopy sync | 元の場所を同期先の場所にレプリケートします。 |
| azcopy set-properties | 1 つ以上の BLOB のアクセス層を変更し、1 つ以上の BLOB のメタデータとインデックス タグを置き換えます (上書き)。 |
注
AzCopy には、ファイルの名前を変更するコマンドがありません。
構成、最適化、修正を行う
次のいずれかのリソースを参照してください。
以前のバージョンを使う (非推奨)
以前のバージョンの AzCopy を使用する必要がある場合は、次のいずれかのリンクを参照してください。
注
これらのバージョンの AzCopy は非推奨です。 Microsoft では、AzCopy v10 の使用をお勧めします。
次のステップ
質問、問題、または一般的なフィードバックがある場合は、 GitHub で送信してください。