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 のタグ (t SAS アクセス許可) にアクセスするアクセス許可を持つ Shared Access Signature を持つすべてのユーザーは、BLOB インデックス タグを設定できます。 さらに、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
次のステップ
他の例については、次の記事を参照してください。
設定の構成、パフォーマンスの最適化、および問題のトラブルシューティングを行うには、次の記事を参照してください。