Восстановление контейнера

Статья
02/03/2024

Операция Restore Container восстанавливает содержимое и свойства обратимо удаленного контейнера в указанный контейнер. Операция Restore Container доступна в версии и более поздних версиях 2019-12-12 .

Запрос

Вы можете создать Restore Container запрос с помощью допустимого запроса, авторизованного с помощью общего ключа, авторизации подписанного URL-адреса учетной записи или управления доступом на основе ролей.

Метод	Универсальный код ресурса (URI) запроса	параметр "Версия HTTP"
`PUT`	`https://myaccount.blob.core.windows.net/destinationcontainer?restype=container&comp=undelete`	HTTP/1.1
`PUT`	`https://myaccount.blob.core.windows.net/destinationcontainer?restype=container&comp=undelete&sv=validsastoken`	HTTP/1.1

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

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

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

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

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

Заголовок запроса	Описание
`Authorization`	Обязательный. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
`Date or x-ms-date`	Обязательный. Задает время запроса в формате UTC. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
`x-ms-version`	Требуется для всех авторизованных запросов. Задает версию операции, используемой для этого запроса. Для этой операции должна быть `2018-03-28` версия или более поздняя. Дополнительные сведения см. в разделе Управление версиями для служб хранилища Azure.
`x-ms-client-request-id`	Необязательный элемент. Предоставляет созданное клиентом непрозрачное значение с ограничением в 1 кибибайт (КиБ), которое записывается в журналы при настройке ведения журнала. Мы настоятельно рекомендуем использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в разделе Мониторинг Хранилище BLOB-объектов Azure.
`x-ms-deleted-container-name`	Обязательный. Этот заголовок используется для уникальной идентификации обратимо удаленного контейнера, который необходимо восстановить.
`x-ms-deleted-container-version`	Обязательный. Этот заголовок используется для уникальной идентификации обратимо удаленного контейнера, который необходимо восстановить. Это значение можно получить, указав `deleted` значение в параметре `includeList Containers` запроса операции. Дополнительные сведения см. в разделе Перечисление контейнеров.

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

Нет.

Ответ

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

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

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

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

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

Заголовок ответа	Описание
`x-ms-request-id`	Уникально идентифицирует выполненный запрос и может использоваться для устранения неполадок с запросом. Дополнительные сведения см. в разделе Устранение неполадок операций API.
`x-ms-version`	Версия 19.09.2009 и более поздняя. Указывает версию Хранилище BLOB-объектов Azure, используемой для выполнения запроса.
`Date`	Значение даты и времени в формате UTC, указывающее время, в которое был инициирован ответ. Служба создает это значение.
`Content-Length`	Длина текста запроса. Для этой операции длина содержимого всегда равна нулю.

Текст ответа

Нет.

Пример ответа

Response Status:  
HTTP/1.1 201 OK  
  
Response Headers:  
Date: Mon, 15 Jun 2020 12:43:08 GMT  
x-ms-version: 2019-12-12  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
Content-Length: 0

Авторизация

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

Служба хранилища 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 пользователю, группе или субъекту-службе для вызова Restore Container операции, а также встроенной роли Azure RBAC с минимальными привилегиями, которая включает это действие:

Действие Azure RBAC: Microsoft.Storage/storageAccounts/blobServices/containers/write
Встроенная роль с наименьшими привилегиями: участник данных BLOB-объектов хранилища

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

Подписанный URL-адрес (SAS) обеспечивает безопасный делегированный доступ к ресурсам в учетной записи хранения. С помощью SAS вы можете детально контролировать доступ клиента к данным. Вы можете указать, к какому ресурсу может получить доступ клиент, какие у него есть разрешения на эти ресурсы и как долго будет действителен SAS.

Операция Restore Container поддерживает авторизацию с помощью SAS учетной записи.

Если доступ к общему ключу запрещен для учетной записи хранения, маркер SAS учетной записи не будет разрешен при запросе к хранилищу BLOB-объектов. Дополнительные сведения см. в статье Сведения о том, как запрет общего ключа влияет на маркеры SAS.

SAS для учетной записи

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

В следующей таблице указаны подписанный тип ресурса и подписанные разрешения, которые необходимо указать при делегировании доступа:

Операция	Подписанная служба	Подписанный тип ресурса	Подписанное разрешение
Восстановление контейнера	Большой двоичный объект (b)	Контейнер (c)	Запись (w)

Дополнительные сведения о SAS учетной записи см. в статье Создание SAS учетной записи.

Операция Restore Container поддерживает авторизацию с помощью общего ключа. В большинстве сценариев не рекомендуется авторизоваться с помощью ключей учетной записи, так как это менее безопасно.

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

Вы можете задать политику хранения удаления контейнера для учетной записи с помощью поставщика ресурсов хранилища.
Указанный контейнер не должен существовать во время Restore Container выполнения операции.
Если указанный контейнер существует, Restore Container операция завершится ошибкой 409 (конфликт).
Если обратимо удаленный контейнер не существует, уже использовался в качестве источника Restore Container операции или превысил срок хранения, операция завершится ошибкой 409 (конфликт).

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

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

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

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