AzCopy v10 を使用して BLOB のプロパティとメタデータを置き換える (プレビュー)
AzCopy を使用して、1 つまたは複数の BLOB のアクセス層を変更し、1 つまたは複数の BLOB のメタデータとインデックス タグを置換 (上書き) することができます。
重要
この機能は現在プレビューの段階です。 ベータ版、プレビュー版、または一般提供としてまだリリースされていない Azure の機能に適用される法律条項については、「Microsoft Azure プレビューの追加使用条件」を参照してください。
はじめに
AzCopy のダウンロード方法と、ストレージ サービスに認証資格情報を与える方法については、AzCopy の作業開始に関するページをご覧ください。
Note
この記事の例では、Microsoft Entra ID を使って認可の資格情報を指定していることを前提としています。
SAS トークンを使用して BLOB データへのアクセスを承認する場合、各 AzCopy コマンドのリソース URL の先頭にそのトークンを追加できます。 (例: 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>')。
アクセス層を変更する
BLOB のアクセス層を変更するには、azcopy set-properties コマンドを使用し、-block-blob-tier パラメーターをアクセス層の名前に設定します。
ヒント
この例では、パス引数を単一引用符 ('') で囲んでいます。 Windows コマンド シェル (cmd.exe) を除き、すべてのコマンド シェルで単一引用符を使用します。 Windows コマンド シェル (cmd.exe) を使用している場合は、単一引用符 ('') ではなく、二重引用符 ("") でパス引数を囲みます。
構文
azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --block-blob-tier=<access-tier>
例
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot
仮想ディレクトリ内のすべての BLOB のアクセス層を変更するには、BLOB 名ではなく仮想ディレクトリ名を参照し、--recursive=true をコマンドに追加します。
例
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --block-blob-tier=hot --recursive=true
アーカイブ層からオンライン層に BLOB をリハイドレートするには、--rehydrate-priority を standard または high に設定します。 既定では、このパラメーターは standard に設定されます。 各オプションのトレードオフの詳細については、「リハイドレートの優先度」を参照してください。
例
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot --rehydrate-priority=high
メタデータを置換する
BLOB のメタデータを置換するには、azcopy set-properties コマンドを使用し、--metadata パラメーターを 1 つ以上のキーと値のペアに設定します。
ヒント
この例では、パス引数を単一引用符 ('') で囲んでいます。 Windows コマンド シェル (cmd.exe) を除き、すべてのコマンド シェルで単一引用符を使用します。 Windows コマンド シェル (cmd.exe) を使用している場合は、単一引用符 ('') ではなく、二重引用符 ("") でパス引数を囲みます。
構文
azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --metadata=<key>=<value>;<key>=<value>
例
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=mykey1=myvalue1;mykey2=myvalue2
仮想ディレクトリ内のすべての BLOB のメタデータを置換するには、BLOB 名ではなく仮想ディレクトリ名を参照し、--recursive=true をコマンドに追加します。
例
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --metadata=mykey1=myvalue1;mykey2=myvalue2 --recursive=true
メタデータをクリアするには、タグを省略し、コマンドの末尾に --metadata=clear を追加します。
例
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=clear
インデックス タグを置換する
BLOB のインデックス タグを置換するには、azcopy set-properties コマンドを使用し、--blob-tags パラメーターを 1 つ以上のキーと値のペアに設定します。 BLOB インデックス タグの設定は、ストレージ BLOB データ所有者と、BLOB のタグにアクセスするためのアクセス許可 (t SAS アクセス許可) が割り当てられた Shared Access Signature を持つ任意のユーザーが実行できます。 さらに、Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write アクセス許可を持つ RBAC ユーザーも、この操作を実行できます。
ヒント
この例では、パス引数を単一引用符 ('') で囲んでいます。 Windows コマンド シェル (cmd.exe) を除き、すべてのコマンド シェルで単一引用符を使用します。 Windows コマンド シェル (cmd.exe) を使用している場合は、単一引用符 ('') ではなく、二重引用符 ("") でパス引数を囲みます。
構文
azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --blob-tags=<tag>=<value>;<tag>=<value>
例
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --blob-tags=mytag1=mytag1value;mytag2=mytag2value
仮想ディレクトリ内のすべての BLOB のインデックス タグを置換するには、BLOB 名ではなく仮想ディレクトリ名を参照し、--recursive=true をコマンドに追加します。
例
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --blob-tags=mytag1=mytag1value;mytag2=mytag2value
次のステップ
他の例については、次の記事を参照してください。
- 例:アップロード
- 例:ダウンロード」をご覧ください
- 例:アカウント間のコピー
- 例:同期
- 例:Amazon S3 バケット
- 例: Google Cloud Storage
- 例:Azure Files
- チュートリアル:AzCopy を使用したオンプレミス データのクラウド ストレージへの移行
設定の構成、パフォーマンスの最適化、および問題のトラブルシューティングを行うには、次の記事を参照してください。