azcopy set-properties (предварительная версия)
Учитывая расположение, измените все допустимые системные свойства этого хранилища (BLOB-объект или файл).
Краткие сведения
azcopy set-properties [resourceURL] [flags]
Задает свойства для хранилища BLOB-объектов и файлов. В настоящее время эта команда поддерживает следующие свойства:
- для больших двоичных объектов —> уровень, метаданные, теги;
- для Data Lake Storage 2-го поколения —> уровень, метаданные, теги;
- для файлов —> метаданные.
Примечание.
Конечные точки Data Lake Storage 2-го поколения скоро будут заменены конечными точками хранилища BLOB-объектов.
Дополнительные сведения см. в примерах.
Статьи по теме
- Начало работы с AzCopy
- Замена свойств и метаданных BLOB-объектов с помощью AzCopy версии 10 (предварительная версия)
Примеры
Установите горячий уровень для большого двоичного объекта:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot
Установите холодный уровень для архивного большого двоичного объекта и задайте для него высокий приоритет восстановления:
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
Измените метаданные большого двоичного объекта на {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
Очистите все существующие метаданные большого двоичного объекта:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=clear
Измените теги большого двоичного объекта на {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
При настройке тегов в больших двоичных объектах в SAS указываются другие разрешения ("t" для тегов). Без этих тегов служба вернет ошибку авторизации.
Очистите все существующие теги в BLOB-объекте:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=clear
При настройке тегов в больших двоичных объектах в SAS указываются другие разрешения ("t" для тегов). Без этих тегов служба вернет ошибку авторизации.
Параметры
--blob-tags строковое определение тегов больших двоичных объектов для классификации данных в учетной записи хранения (разделенных "&")
--block-blob-tier (строка) — изменяет уровень доступа больших двоичных объектов на заданный уровень (по умолчанию "None").
--dry-run (строка) — выводит файловые пути, которые будут затронуты этой командой. Этот флаг не изменяет файлы.
--exclude-path (строка) — исключает указанные путей при удалении. Этот параметр не поддерживает подстановочные знаки (*). Проверка префикса относительного пути. Например: myFolder;myFolder/subDirName/file.pdf.
--exclude-pattern (строка) — исключает файлы, имена которых соответствуют списку шаблонов. Например: .jpg;.pdf;exactName.
--from-to (строка) — задает необязательную комбинацию назначения источника. Допустимые значения: BlobNone, FileNone, BlobFSNone.
-h, --help — справка по set-properties.
--include-path (строка) — при задании свойства включает только указанные пути. Этот параметр не поддерживает подстановочные знаки (*). Проверка префикса относительного пути. Например: myFolder;myFolder/subDirName/file.pdf
--include-pattern (строка) — включает только те файлы, имена которых соответствуют списку шаблонов. Например: .jpg;.pdf;exactName.
--list-of-files (строка) — определяет расположение текстового файла со списком копируемых файлов.
--metadata (строка) — задает для заданного расположения указанные пары "ключ — значение" (с разделителем ";") в качестве метаданных.
--page-blob-tier (строка) — передает страничный BLOB-объект в службу хранилища Azure с сохранением уровня этого BLOB-объекта. (значение по умолчанию — None). (значение по умолчанию — "None")
--recursive Рекурсивно просматривайте подкаталоги при отправке из локальной файловой системы.
--rehydrate-priority (строка) — необязательный флаг, задающий приоритет восстановления. Допустимые значения: Standard, High. По умолчанию используется значение Standard (Стандартный).
Параметры, наследуемые от родительских команд
--cap-mbps float — ограничение скорости передачи данных в Мбит/с. Наблюдаемая пропускная способность может слегка отличаться от предельной. Если установить для этого параметра значение 0 или вообще не указывать значение, пропускная способность не ограничивается.
--log-level (строка). Определяет уровень детализации журнала для файла журнала. Доступные уровни: INFO (все запросы и ответы), WARNING (медленные ответы), ERROR (только невыполненные запросы) и NONE (без выходных журналов). (Значение по умолчанию — INFO). Значение по умолчанию — "INFO".
--output-type (строка) Формат выходных данных команды. Возможные варианты: text, json. Значение по умолчанию — text.
--output-level (строка) — определяет детализацию выходных данных. Доступные уровни: essential, quiet. (значение по умолчанию — "default")
--trusted-microsoft-suffixes (строка) Указывает другие суффиксы домена, в которых может отправляться журнал идентификатора Microsoft Entra ID в токенах. Значение по умолчанию: .core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net. Все перечисленные здесь домены добавлены по умолчанию. Для безопасности здесь следует указывать только домены Microsoft Azure. При указании нескольких значений введите их через точку с запятой.