Поделиться через

azcopy set-properties

  • Статья

Учитывая расположение, измените все допустимые системные свойства этого хранилища (BLOB-объект или файл).

Краткие сведения

azcopy set-properties [resourceURL] [flags]

Задает свойства для хранилища BLOB-объектов и файлов. В настоящее время эта команда поддерживает следующие свойства:

  • для больших двоичных объектов —> уровень, метаданные, теги;
  • Data Lake Storage —> уровень, метаданные, теги
  • для файлов —> метаданные.

Примечание.

Конечные точки Data Lake Storage будут заменены конечными точками хранилища BLOB-объектов.

Дополнительные сведения см. в примерах.

Примеры

Установите горячий уровень для большого двоичного объекта:

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=cold

Изменение уровня большого двоичного объекта с горячего на архив:

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

Установите холодный уровень для архивного большого двоичного объекта и задайте для него высокий приоритет восстановления:

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/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]

Измените метаданные большого двоичного объекта на {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

Снимите все существующие метаданные из всех файлов:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --recursive --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. При указании нескольких значений введите их через точку с запятой.

См. также