AzCopy を使用して、1 つまたは複数の BLOB のアクセス層を変更し、1 つまたは複数の BLOB のメタデータとインデックス タグを置換 (上書き) することができます。
作業の開始
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 を使用したオンプレミス データのクラウド ストレージへの移行
設定の構成、パフォーマンスの最適化、および問題のトラブルシューティングを行うには、次の記事を参照してください。