azcopy remove
Удаление BLOB-объектов и файлов из учетной записи службы хранилища Azure.
Краткие сведения
azcopy remove [resourceURL] [flags]
Статьи по теме
- Начало работы с AzCopy
- Передача данных с помощью AzCopy и хранилища BLOB-объектов
- Перенос данных с помощью AzCopy и хранилища файлов
Примеры
Удаление одного BLOB-объекта с помощью маркера SAS:
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Удаление всего виртуального каталога с помощью маркера SAS:
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Удаление только BLOB-объектов внутри виртуального каталога без удаления вложенных папок и содержащихся в них BLOB-объектов:
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --recursive=false
Удаление множества BLOB-объектов в виртуальном каталоге (например, удаление только JPG- и PDF-файлов, или BLOB-объектов с именем exactName):
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --include-pattern="*.jpg;*.pdf;exactName"
Удаление всего виртуального каталога, исключая определенные BLOB-объекты (например, все BLOB-объекты, которые начинаются с "foo" или оканчиваются на "bar"):
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --exclude-pattern="foo*;*bar"
Удалите указанные идентификаторы версий BLOB-объекта из службы хранилища Azure. Убедитесь, что источником является допустимый BLOB-объект и versionidsfile, который принимает путь к файлу, где каждая версия записывается в отдельной строке. Все указанные версии будут удалены из службы хранилища Azure.
azcopy rm "https://[srcaccount].blob.core.windows.net/[containername]/[blobname]" "/path/to/dir" --list-of-versions="/path/to/dir/[versionidsfile]"
Удалите определенные большие двоичные объекты и виртуальные каталоги, поместив их относительные пути (НЕ закодированные URL-адресом) в текстовый файл (например: list.txt) с помощью флага --list-of-files . В текстовом файле каждый большой двоичный объект и виртуальный каталог записываются в отдельную строку. Флаг --list-of-files может привести к затратам на производительность из-за дополнительных транзакций для получения свойств объекта. Дополнительные сведения об API, которые использует AzCopy и для оценки затрат, см. в статье "Оценка стоимости использования AzCopy для передачи больших двоичных объектов".
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/parent/dir]" --recursive=true --list-of-files=/usr/bar/list.txt
Удаление одного файла из учетной записи хранилища BLOB-объектов с иерархическим пространством имен (включение и исключение не поддерживаются):
azcopy rm "https://[account].dfs.core.windows.net/[container]/[path/to/file]?[SAS]"
Удаление одного каталога из учетной записи хранилища BLOB-объектов с иерархическим пространством имен (включение и исключение не поддерживаются):
azcopy rm "https://[account].dfs.core.windows.net/[container]/[path/to/directory]?[SAS]"
Параметры
--cpk-by-name(строка) Предоставленный клиентом ключ по имени позволяет клиентам выполнять запросы к Хранилище BLOB-объектов Azure возможность предоставления ключа шифрования на основе каждого запроса. Предоставленное имя ключа будет извлечено из Azure Key Vault и использоваться для шифрования данных.
--cpk-by-value. Значение по умолчанию — false. Предоставленный клиентом ключ по имени позволяет клиентам выполнять запросы к Хранилище BLOB-объектов Azure возможность предоставления ключа шифрования на основе каждого запроса. Предоставленный ключ и хэш будут получены из переменных CPK_ENCRYPTION_KEY среды и CPK_ENCRYPTION_KEY_SHA256.
--delete-snapshots (строка) — по умолчанию операция удаления завершается сбоем, если у BLOB-объекта есть моментальные снимки. Укажите include, чтобы удалить корневой BLOB-объект и все его моментальные снимки. Также можно указать only, чтобы удалить только моментальные снимки, но оставить корневой BLOB-объект.
--dry-run. Значение по умолчанию — false. Выводит файлы пути, которые будут удалены командой. Этот флаг не вызывает удаление файлов.
--exclude-path (строка) — исключение этих путей при удалении. Этот параметр не поддерживает подстановочные знаки (*). Проверка префикса относительного пути. Например: myFolder;myFolder/subDirName/file.pdf.
Строка --exclude-pattern. Исключает файлы, имена которых соответствуют списку шаблонов. Например: .jpg;.pdf;exactName.
--force-if-read-only. Значение по умолчанию — false. При удалении файла или папки Файлы Azure принудительно выполните удаление, даже если существующий объект имеет набор атрибутов только для чтения.
--from-to (строка). Дополнительно задает комбинацию назначения источника. Например: BlobTrash, FileTrash, BlobFSTrash
-h, --help — справка по удалению.
--include-after (строка) Включите только те файлы, которые были изменены или после заданной даты и времени. Значение должно быть указано в формате ISO8601. Если часовой пояс не указан, предполагается, что значение находится в локальном часовом поясе компьютера, на котором работает AzCopy (например, "2020-08-19T15:04:00Z" для времени UTC или "2020-08-19" для полуночи (00:00) в местном часовом поясе). По состоянию на AzCopy 10.5 этот флаг применяется только к файлам, а не к папкам, поэтому свойства папок не будут скопированы при использовании этого флага или --preserve-smb-info --preserve-smb-permissionс.
--include-before (строка) Включите только эти файлы, измененные до или по заданной дате и времени. Значение должно быть указано в формате ISO8601. Если часовой пояс не указан, предполагается, что значение находится в локальном часовом поясе компьютера, на котором работает AzCopy (например, "2020-08-19T15:04:00Z" для времени UTC или "2020-08-19" для полуночи (00:00) в местном часовом поясе). Начиная с AzCopy 10.7 этот флаг применяется только к файлам, а не к папкам, поэтому свойства папки не копируются при одновременном использовании этого флага с параметрами --preserve-smb-info или --preserve-smb-permissions.
--include-path (строка) — включение только этих путей при удалении. Этот параметр не поддерживает подстановочные знаки (*). Проверка префикса относительного пути. Например: myFolder;myFolder/subDirName/file.pdf.
--include-pattern (строка) — включение только тех файлов, имена которых соответствуют списку шаблонов. Например: .jpg;.pdf;exactName.
--list-of-files (строка) Определяет расположение текстового файла, содержащего список файлов и каталогов, которые нужно удалить. Относительные пути должны быть разделены разрывами строк. Пути не должны быть закодированы в виде URL-адресов.
--list-of-versions (строка) Указывает текстовый файл, в котором каждый идентификатор версии указан в отдельной строке. Убедитесь, что источник указывает на один BLOB-объект, а все идентификаторы версий, перечисленные в файле при использовании этого флага, принадлежат только к исходному BLOB-объекту. Версии BLOB-объекта с указанными идентификаторами будут удалены из службы хранилища Azure.
--permanent-delete (строка) — предварительная версия функции, которая НЕОБРАТИМО удаляет удаленные обратимым способом моментальные снимки и версии. Возможные значения: snapshots, versions, snapshotsandversions, none. (Значение по умолчанию — none.)
--trailing-dot Включен по умолчанию для обработки связанных операций с общей папкой безопасным способом. Доступные варианты: Enable, Disable. Выберите Disable , чтобы вернуться к устаревшей (потенциально небезопасной) обработке конечных точек файлов, где служба файлов обрезает все конечные точки в путях. Это может привести к повреждению данных, если передача содержит два пути, которые отличаются только конечными точками (например mypath , и mypath.). Если для этого флага задано Disable значение, а AzCopy обнаруживает конечный dot-файл, он предупреждает клиентов в журнале сканирования, но не попытается прервать операцию. Если целевой объект не поддерживает конечные точки файлов (Windows или BLOB-объектов служба хранилища), AzCopy завершится ошибкой, если конечный dot file является корнем передачи и пропускать конечные путь к точкам, встречающимся во время перечисления.
--recursive. Значение по умолчанию — false. Просматривайте подкаталоги рекурсивно при синхронизации между каталогами.
Параметры, наследуемые от родительских команд
--cap-mbps float — ограничение скорости передачи данных в Мбит/с. Наблюдаемая пропускная способность может слегка отличаться от предельной. Если установить для этого параметра значение 0 или вообще не указывать значение, пропускная способность не ограничивается.
--output-type (строка) Формат выходных данных команды. Возможные варианты: text, json. Значение по умолчанию — text.
--trusted-microsoft-suffixes (строка) Указывает дополнительные суффиксы домена, в которых могут отправляться маркеры входа Microsoft Entra. Значение по умолчанию: .core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net. Все перечисленные здесь домены добавлены по умолчанию. Для безопасности здесь следует указывать только домены Microsoft Azure. При указании нескольких значений введите их через точку с запятой.
--log-level (строка) — определение уровня детализации для файла журнала. Доступные уровни: INFO (все запросы и ответы), WARNING (медленные запросы), ERROR (запросы, завершившиеся сбоем), NONE (отсутствие выходных журналов). (Значение по умолчанию — INFO.) (Значение по умолчанию — INFO.)