Замена свойств и метаданных BLOB-объектов с помощью AzCopy версии 10
С помощью AzCopy можно изменить уровень доступа для одного или нескольких больших двоичных объектов и заменить (перезаписать) метаданные и теги индекса для одного или нескольких больших двоичных объектов.
Начать
Ознакомьтесь со статьей Начало работы с AzCopy, чтобы получить сведения о том, как скачать AzCopy, а также о способах предоставления учетных данных авторизации в службе хранилища.
Примечание.
В примерах этой статьи предполагается, что вы предоставили учетные данные авторизации с помощью идентификатора Microsoft Entra.
Если вы предпочитаете использовать для авторизации доступа к данным большого двоичного объекта маркер SAS, маркер можно добавить к URL-адресу ресурса в каждой команде AzCopy. Например: 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>'.
Изменение уровня доступа
Чтобы изменить уровень доступа для большого двоичного объекта, используйте команду azcopy set-properties и задайте в параметре -block-blob-tier имя уровня доступа.
Совет
В этом примере аргументы пути заключены в одинарные кавычки (' '). Используйте одинарные кавычки во всех командных оболочках, кроме командной оболочки Windows (cmd.exe). Если вы используете командную оболочку Windows (cmd.exe), заключите аргументы пути в двойные кавычки ("") вместо одинарных (").
Синтаксис
azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --block-blob-tier=<access-tier>
Пример
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot
Чтобы изменить уровень доступа для всех BLOB-объектов в виртуальном каталоге, укажите имя виртуального каталога вместо имени большого двоичного объекта, а затем добавьте в команду --recursive=true.
Пример
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --block-blob-tier=hot --recursive=true
Чтобы восстановить большой двоичный объект с архивного уровня на любой подключенный уровень, задайте для --rehydrate-priority значение standard или high. По умолчанию этот параметр имеет значение standard. Дополнительные сведения о компромиссах для каждого из этих вариантов см. в статье Приоритет восстановления.
Пример
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot --rehydrate-priority=high
Замена метаданных
Чтобы заменить метаданные большого двоичного объекта, используйте команду azcopy set-properties и присвойте параметру --metadata одну или несколько пар "ключ — значение".
Совет
В этом примере аргументы пути заключены в одинарные кавычки (' '). Используйте одинарные кавычки во всех командных оболочках, кроме командной оболочки Windows (cmd.exe). Если вы используете командную оболочку Windows (cmd.exe), заключите аргументы пути в двойные кавычки ("") вместо одинарных (").
Синтаксис
azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --metadata=<key>=<value>;<key>=<value>
Пример
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=mykey1=myvalue1;mykey2=myvalue2
Чтобы заменить метаданные для всех BLOB-объектов в виртуальном каталоге, укажите имя виртуального каталога вместо имени большого двоичного объекта, а затем добавьте в команду --recursive=true.
Пример
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --metadata=mykey1=myvalue1;mykey2=myvalue2 --recursive=true
Чтобы очистить метаданные, не указывайте теги и добавьте --metadata=clear в конец команды.
Пример
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=clear
Замена тегов индекса
Чтобы заменить теги индекса большого двоичного объекта, используйте команду azcopy set-properties и присвойте параметру --blob-tags одну или несколько пар "ключ — значение". Задать теги индекса большого двоичного объекта может владелец данных больших двоичных объектов в хранилище и любой пользователь с подписанным URL-адресом (SAS), имеющий разрешение на доступ к тегам BLOB-объекта (разрешение SAS t). Кроме того, выполнять эту операцию могут пользователи RBAC с разрешением Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write.
Совет
В этом примере аргументы пути заключены в одинарные кавычки (' '). Используйте одинарные кавычки во всех командных оболочках, кроме командной оболочки Windows (cmd.exe). Если вы используете командную оболочку Windows (cmd.exe), заключите аргументы пути в двойные кавычки ("") вместо одинарных (").
Синтаксис
azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --blob-tags=<tag>=<value>;<tag>=<value>
Пример
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --blob-tags=mytag1=mytag1value;mytag2=mytag2value
Чтобы заменить теги индекса для всех BLOB-объектов в виртуальном каталоге, укажите имя виртуального каталога вместо имени большого двоичного объекта, а затем добавьте в команду --recursive=true.
Пример
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --blob-tags=mytag1=mytag1value;mytag2=mytag2value
Следующие шаги
Дополнительные примеры см. в следующих статьях:
- Примеры: отправка
- Примеры: скачивание
- Примеры: копирование между учетными записями
- Примеры: синхронизация
- Примеры: контейнеры Amazon S3
- Примеры: облачное хранилище Google
- Примеры. Файлы Azure
- Руководство. Перенос локальных данных в облачное хранилище с помощью AzCopy
Ознакомьтесь со статьями ниже, чтобы получить сведения о настройке параметров, оптимизации производительности и устранении проблем: