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

Замена свойств и метаданных BLOB-объектов с помощью AzCopy версии 10

С помощью AzCopy можно изменить уровень доступа одного или нескольких BLOB-объектов и перезаписать метаданные и теги индекса одного или нескольких BLOB-объектов.

Начало работы

Ознакомьтесь со статьей Начало работы с AzCopy, чтобы получить сведения о том, как скачать AzCopy, а также о способах предоставления учетных данных авторизации в службе хранилища.

Примечание.

В примерах этой статьи предполагается, что вы предоставляете учетные данные авторизации с помощью идентификатора Microsoft Entra.

Если вы хотите использовать маркер SAS для авторизации доступа к данным BLOB-объектов, добавьте этот маркер к 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 одну или несколько пар "ключ — значение". Роль владельца данных блобов хранилища и любой пользователь с Общей Сигнатурой Доступа c разрешением на доступ к тегам блоба ( t разрешение SAS) могут задать теги индекса блобов. Кроме того, выполнять эту операцию могут пользователи 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

Следующие шаги

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

Ознакомьтесь со статьями ниже, чтобы получить сведения о настройке параметров, оптимизации производительности и устранении проблем:

  • Last updated on