azcopy set-properties
場所が指定された場合は、そのストレージ (BLOB またはファイル) の有効なシステム プロパティをすべて変更します。
構文
azcopy set-properties [resourceURL] [flags]
BLOB ストレージとファイル ストレージのプロパティを設定します。 このコマンドで現在サポートされているプロパティは次のとおりです。
- BLOB -> レベル、メタデータ、タグ
- Data Lake Storage -> 層、メタデータ、タグ
- ファイル -> メタデータ
Note
Data Lake Storage エンドポイントは、Blob Storage エンドポイントに置き換えられます。
詳しくは、例を参照してください。
関連する概念に関する記事
例
BLOB の層をホットに変更します。
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot
BLOB の層をコールドに変更します。
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cold
BLOB の層をホットからアーカイブに変更します。
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=archive
リハイドレート優先度を高に設定して、BLOB の階層をアーカイブからクールに変更します。
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cool --rehydrate-priority=high
リハイドレート優先度を Standard に設定して、BLOB の層をクールからホットに変更します。
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot --rehydrate-priority=standard
アーカイブするディレクトリ内のすべてのファイルの階層を変更します。
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --block-blob-tier=archive --recursive=true
ページ BLOB の層を変更する:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --page-blob-tier=[P10/P15/P20/P30/P4/P40/P50/P6]--rehydrate-priority=[Standard/High]
BLOB のメタデータを {key = "abc"、val = "def"}、{key = "ghi"、val = "jkl"} に変更します。
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=abc=def;ghi=jkl
ディレクトリ内のすべてのファイルのメタデータを {key = "abc"、val = "def"}、{key = "ghi"、val = "jkl"} に変更します。
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --metadata=abc=def;ghi=jkl --recursive=true
BLOB のすべての既存のメタデータをクリアします。
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=clear
すべてのファイルから既存のすべてのメタデータをクリアします。
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --recursive --metadata=clear
BLOB の BLOB タグを {key = "abc"、val = "def"}、{key = "ghi"、val = "jkl"} に変更します。
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=abc=def&ghi=jkl
BLOB にタグを設定している間、SAS には他のアクセス許可 (タグの場合は 't') があります。 これらのタグがないと、サービスは認可エラーを返します。
BLOB のすべての既存の BLOB タグをクリアします。
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=clear
BLOB にタグを設定している間、SAS には他のアクセス許可 (タグの場合は 't') があります。 これらのタグがないと、サービスは認可エラーを返します。
[オプション]
--blob-tags
string ストレージ アカウント内のデータを分類する BLOB のタグを設定する ('> で区切る)
--block-blob-tier
string BLOB のアクセス層を特定の層に変更します (既定の "None")
--dry-run
このコマンドによって影響を受けるファイルのパスを出力します。 このフラグによって、実際のファイルが影響を受けることはありません。
--exclude-path
string 削除時にこれらのパスを除外します。 このオプションは、ワイルドカード文字 (*) をサポートしていません。 相対パスのプレフィックスを確認します。 例: myFolder;myFolder/subDirName/file.pdf
--exclude-pattern
string 名前がパターンの一覧と一致するファイルを除外します。 例: .jpg; .pdf;exactName
--from-to
string 必要に応じて、コピー元とコピー先の組み合わせを指定します。 有効な値: BlobNone、FileNone、BlobFSNone
-h
、--help
set-properties のヘルプ
--include-path
string プロパティを設定するときにこれらのパスのみを含めます。 このオプションは、ワイルドカード文字 (*) をサポートしていません。 相対パスのプレフィックスを確認します。 例: myFolder;myFolder/subDirName/file.pdf
--include-pattern
string 名前がパターンの一覧と一致するファイルをのみを含めます。 例: .jpg; .pdf;exactName
--list-of-files
string コピーするファイルの一覧を含むテキスト ファイルの場所を定義します。
--metadata
string これらのキーと値のペア (';' で区切られた) をメタデータとして指定した場所を設定します。
--page-blob-tier
string この BLOB 層を使用して Azure Storage にページ BLOB をアップロードします。 (既定値は "None")。 (既定値は "None")
--recursive
ローカル ファイル システムからアップロードするときにサブディレクトリを再帰的に検索します。
--rehydrate-priority
string リハイドレートのリハイドレート優先度を設定する省略可能なフラグ。 有効な値: Standard、High。 既定値 - standard (既定の "Standard")
親コマンドから継承されるオプション
--cap-mbps float
転送速度の上限を設定します (メガビット/秒)。 瞬間的なスループットは、上限と若干異なる場合があります。 このオプションを 0 に設定した場合や省略した場合は、スループットは制限されません。
--log-level
(string) ログ ファイルのログの詳細度を定義します。使用できるレベルは次のとおりです。INFO (すべての要求と応答)、WARNING (遅い応答)、ERROR (失敗した要求のみ)、NONE (出力ログなし)。 (既定値 は"INFO")。 (既定値は "INFO")
--output-type
(string) コマンドの出力の形式。 選択肢には、text、json などがあります。 既定値は "text" です。 (既定値は "text")
--output-level
(string) 出力の詳細を定義します。 利用可能なレベル: essential、quiet。 (default "default")
--trusted-microsoft-suffixes
(string) Microsoft Entra ID ログイン トークンを送信できる他のドメイン サフィックスを指定します。 既定値は ".core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net" です。 ここに記載されているすべてが既定値に追加されます。 セキュリティのために、Microsoft Azure のドメインのみをここに入力してください。 複数のエンティティは、セミコロンで区切ります。