azcopy set-properties (プレビュー)

  • [アーティクル]

場所が指定された場合は、そのストレージ (BLOB またはファイル) の有効なシステム プロパティをすべて変更します。

構文

azcopy set-properties [resourceURL] [flags]

BLOB ストレージとファイル ストレージのプロパティを設定します。 このコマンドで現在サポートされているプロパティは次のとおりです。

  • BLOB -> レベル、メタデータ、タグ
  • Data Lake Storage Gen2 -> レベル、メタデータ、タグ
  • ファイル -> メタデータ

注意

Data Lake Storage Gen2 エンドポイントは 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=cool --rehydrate-priority=high

アーカイブするディレクトリ内のすべてのファイルの階層を変更します。

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --block-blob-tier=archive --recursive=true

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

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 のドメインのみをここに入力してください。 複数のエンティティは、セミコロンで区切ります。

関連項目