Прерывание копирования большого двоичного объекта

  • Статья

Операция Abort Copy Blob отменяет ожидающие Copy Blob операции и оставляет целевой BLOB-объект с нулевой длиной и полными метаданными. Эта операция применяется к версии 2012-02-12 и более поздних версий.

Запрос

Создайте Abort Copy Blob операцию следующим образом. Рекомендуется использовать протокол HTTPS. Замените myaccount именем своей учетной записи хранения, mycontainer — именем своего контейнера, а myblob — именем своего конечного большого двоичного объекта. Замените <id> идентификатором копирования, указанным в заголовке x-ms-copy-id исходной Copy Blob операции.

Начиная с версии 2013-08-15, вы можете указать подписанный URL-адрес для целевого BLOB-объекта, если он находится в той же учетной записи, что и исходный BLOB-объект. Начиная с версии 2015-04-05, вы также можете указать подписанный URL-адрес для целевого BLOB-объекта, если он находится в другой учетной записи хранения.

URI запроса метода PUT параметр "Версия HTTP"
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=copy&copyid=<id> HTTP/1.1

URI эмулированной службы хранилища

При выполнении запроса к локальной службе хранилища укажите имя локального узла и порт Хранилище BLOB-объектов Azure в качестве 127.0.0.1:10000, за которым следует имя локальной учетной записи хранения:

URI запроса метода PUT параметр "Версия HTTP"
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=copy&copyid=<id> HTTP/1.1

Дополнительные сведения см. в статье Использование эмулятора Azurite для разработки и тестирования службы хранилища Azure.

Параметры универсального кода ресурса (URI)

В URI запроса можно указать следующий дополнительный параметр.

Параметр Описание
timeout Необязательный элемент. Параметр timeout указывается в секундах. Дополнительные сведения см. в разделе Настройка времени ожидания для операций с хранилищем BLOB-объектов.

Заголовки запросов

В следующей таблице перечислены обязательные и необязательные заголовки запросов.

Заголовок запроса Описание
Authorization Обязательный. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
Date или x-ms-date Обязательный. Задает время запроса в формате UTC. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
x-ms-version Требуется для всех авторизованных запросов. Дополнительные сведения см. в разделе Управление версиями для служб хранилища Azure.
x-ms-lease-id:<ID> Обязательно, если целевой BLOB-объект имеет бесконечную аренду.
x-ms-copy-action: abort Обязательный.
x-ms-client-request-id Необязательный элемент. Предоставляет созданное клиентом непрозрачное значение с ограничением в 1 кибибайт (КиБ), которое записывается в журналы при настройке ведения журнала. Мы настоятельно рекомендуем использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в разделе Мониторинг Хранилище BLOB-объектов Azure.

Текст запроса

Нет.

Ответ

Ответ включает код состояния HTTP и набор заголовков ответа.

Код состояния

Успешная операция возвращает код состояния 204 (нет контента). Сведения о кодах состояния см. в разделе Коды состояния и ошибок.

Заголовки ответов

Ответ для этой операции включает следующие заголовки. Ответ может также включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.

Заголовок ответа Описание
x-ms-request-id Этот заголовок однозначно идентифицирует выполненный запрос и может использоваться для устранения неполадок с запросом. Дополнительные сведения см. в разделе Устранение неполадок операций API.
x-ms-version Указывает версию хранилища BLOB-объектов, используемой для выполнения запроса.
Date Значение даты и времени в формате UTC, сформированное службой и указывающее время, когда был инициирован ответ.
x-ms-client-request-id Этот заголовок можно использовать для устранения неполадок с запросами и соответствующими ответами. Значение этого заголовка равно значению заголовка, x-ms-client-request-id если он присутствует в запросе. Значение равно не более 1024 видимых символов ASCII. Если заголовок x-ms-client-request-id отсутствует в запросе, этот заголовок отсутствует в ответе.

Авторизация

Авторизация требуется при вызове любой операции доступа к данным в службе хранилища Azure. Вы можете авторизовать операцию, Abort Copy Blob как описано ниже.

Важно!

Корпорация Майкрософт рекомендует использовать Microsoft Entra ID с управляемыми удостоверениями для авторизации запросов к службе хранилища Azure. Microsoft Entra ID обеспечивает более высокий уровень безопасности и простоту использования по сравнению с авторизацией с общим ключом.

Служба хранилища Azure поддерживает использование Microsoft Entra ID для авторизации запросов к данным BLOB-объектов. С помощью Microsoft Entra ID можно использовать управление доступом на основе ролей Azure (Azure RBAC) для предоставления разрешений субъекту безопасности. Субъектом безопасности может быть пользователь, группа, субъект-служба приложения или управляемое удостоверение Azure. Субъект безопасности проходит проверку подлинности Microsoft Entra ID для возврата маркера OAuth 2.0. Затем маркер можно использовать для авторизации запроса к службе BLOB-объектов.

Дополнительные сведения об авторизации с помощью Microsoft Entra ID см. в статье Авторизация доступа к BLOB-объектам с помощью Microsoft Entra ID.

Разрешения

Ниже перечислены действия RBAC, необходимые Microsoft Entra пользователю, группе, управляемому удостоверению или субъекту-службе для вызова Abort Copy Blob операции, а также встроенная роль Azure RBAC с минимальными привилегиями, которая включает это действие.

Дополнительные сведения о назначении ролей с помощью Azure RBAC см. в статье Назначение роли Azure для доступа к данным BLOB-объектов.

Комментарии

При отмене ожидающей Copy Blob операции заголовок большого x-ms-copy-status двоичного объекта назначения имеет значение aborted. Отмена операции копирования приводит к тому, что конечный blob-объект нулевой длины для блочных, добавочных и страничных BLOB-объектов. Однако метаданные для целевого BLOB-объекта будут содержать новые значения, скопированные из исходного BLOB-объекта или явно заданные в вызове Copy Blob операции. Чтобы сохранить исходные метаданные до копирования, создайте моментальный снимок целевого BLOB-объекта перед вызовом Copy Blob.

Можно отменить только ожидающую операцию копирования. Попытка отменить завершенную или неудачную копию приводит к конфликтующей ошибке. Попытка отменить операцию копирования с использованием неверного идентификатора копирования также приводит к конфликтующей ошибке.

Выставление счетов

Запросы на ценообразование могут исходить от клиентов, использующих API хранилища BLOB-объектов, напрямую через REST API хранилища BLOB-объектов или из клиентской библиотеки службы хранилища Azure. Эти запросы начисляют плату за каждую транзакцию. Тип транзакции влияет на способ оплаты учетной записи. Например, транзакции чтения начисляются на категорию выставления счетов, отличную от категории операций записи. В следующей таблице показана категория выставления счетов для Abort Copy Blob запросов на основе типа учетной записи хранения.

Операция Тип учетной записи хранения Категория выставления счетов
Прерывание копирования большого двоичного объекта Блочный BLOB-объект (ценовая категории "Премиум")
Общего назначения версии 2 (цен. категория "Стандартный")		 Другие операции
Прерывание копирования большого двоичного объекта Стандартная общего назначения версии 1 Операции записи

Дополнительные сведения о ценах для указанной категории выставления счетов см. в разделе Цены на Хранилище BLOB-объектов Azure.

См. также раздел

Авторизация запросов к службе хранилища Azure
Коды состояний и ошибок
Коды ошибок Хранилище BLOB-объектов Azure
Операция копирования BLOB-объекта