хранилище моментальных снимков

Начиная с версии 2017-04-17, Snapshot Share операция создает доступный только для чтения моментальный снимок общей папки.

Доступность протокола

Включенный протокол общей папки	Доступно	Состояние
SMB		GA
NFS		GA

Запрос

Запрос можно создать Snapshot Share следующим образом. Рекомендуется использовать протокол HTTPS.

Метод	Универсальный код ресурса (URI) запроса	параметр "Версия HTTP"
PUT	https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot	HTTP/1.1

Замените компоненты пути, показанный в URI запроса, следующим образом:

Компонент path	Описание
myaccount	Имя учетной записи хранения.
myshare	Имя файлового ресурса.

Дополнительные сведения об ограничениях именования путей см. в статье Именование общих папок, каталогов, файлов и метаданных и ссылки на нее.

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

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

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

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

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

Заголовок запроса	Описание
Authorization	Обязательный. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
Date или x-ms-date	Обязательный. Задает время в формате UTC для запроса. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
x-ms-version	Требуется для всех авторизованных запросов. Задает версию операции, используемой для этого запроса. Дополнительные сведения см. в разделе Управление версиями для служб хранилища Azure.
x-ms-meta-name:value	Необязательный элемент. Указывает определяемую пользователем пару "имя-значение", связанную с моментальным снимком общей папки. Если не указать пары "имя-значение", операция копирует метаданные базового общего ресурса в моментальный снимок. Если указать одну или несколько пар "имя-значение", моментальный снимок общей папки создается с указанными метаданными. В этом случае метаданные не копируются из базовой общей папки. Имена метаданных должны соответствовать правилам именования для идентификаторов C#.
x-ms-client-request-id	Необязательный элемент. Предоставляет созданное клиентом непрозрачное значение с ограничением в 1 кибибайт (КиБ), которое записывается в журналы при настройке ведения журнала. Мы настоятельно рекомендуем использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в статье Мониторинг хранилища BLOB-объектов Azure.

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

Нет.

Пример запроса

Request Syntax:  
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot HTTP/1.1

Request Headers:
x-ms-version: 2017-04-17
x-ms-date: Mon, 10 May 2017 22:50:32 GMT
x-ms-meta-Name: StorageSample
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

Ответ

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

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

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

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

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

Заголовок ответа	Описание
ETag	Содержит значение, представляющее версию моментального снимка общего ресурса в кавычках. Моментальный снимок общего ресурса нельзя изменить, поэтому ETag моментальный снимок определенного общего ресурса никогда не изменяется. Однако если вы предоставили новые метаданные с запросом Snapshot Share , то ETag моментальный снимок общего ресурса будет отличаться от базового общего ресурса. Если вы не указали метаданные в запросе, ETag моментальный снимок общей папки будет идентичен моментальному снимку базового ресурса на момент создания моментального снимка общей папки.
Last-Modified	Возвращает дату и время последнего изменения общей папки. Дополнительные сведения см. в разделе Представление значений даты и времени в заголовках. Моментальный снимок общего ресурса нельзя изменить, поэтому время последнего изменения конкретного моментального снимка общей папки никогда не изменяется. Однако если вы предоставили новые метаданные с запросом Snapshot Share , время последнего изменения моментального снимка общего ресурса отличается от времени последнего изменения базового общего ресурса. Если вы не указали метаданные в запросе, время последнего изменения моментального снимка общего ресурса совпадает с временем последнего изменения базового общего ресурса на момент создания моментального снимка общего ресурса.
x-ms-request-id	Уникально идентифицирует выполненный запрос и может использоваться для устранения неполадок с запросом. Дополнительные сведения см. в разделе Устранение неполадок с операциями API.
x-ms-version	Указывает версию файлов Azure, используемую для выполнения запроса.
Date или x-ms-date	Значение даты и времени в формате UTC, указывающее время, когда был инициирован ответ. Служба создает это значение.
x-ms-snapshot	Значение DateTime , однозначно определяющее моментальный снимок общей папки. Значение этого заголовка можно использовать в последующих запросах для доступа к моментальному снимку общей папки. Это значение является непрозрачным.
x-ms-client-request-id	Может использоваться для устранения неполадок с запросами и соответствующими ответами. Значение этого заголовка равно значению заголовка x-ms-client-request-id , если он присутствует в запросе. Значение равно не более 1024 видимых символов ASCII. Если заголовок x-ms-client-request-id отсутствует в запросе, он не будет присутствовать в ответе.

Текст ответа

Нет.

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

Response Status:
HTTP/1.1 201 Created

Response Headers:
Content-Length: 0
Date: Mon, 10 May 2017 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 10 May 2017 23:00:06 GMT
x-ms-version: 2017-04-17
x-ms-snapshot: 2017-05-10T17:52:33.9551861Z
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0

Авторизация

Только владелец учетной записи может вызывать эту операцию.

Комментарии

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

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

Значение DateTime определяет моментальный снимок общего ресурса по URI запроса. Например, файл в базовой общей папке и его моментальные снимки имеют URI, аналогичные следующим примерам:

• Файл в общей папке: http://myaccount.file.core.windows.net/myshare/myfile
• Файл в моментальном снимке общей папки: http://myaccount.file.core.windows.net/myshare/myfile?sharesnapshot=<DateTime>

Общий ресурс может поддерживать создание 200 моментальных снимков общих ресурсов. При попытке создать более 200 моментальных снимков общих ресурсов служба возвращает код ошибки 409 (конфликт). При попытке создать моментальный снимок общего ресурса во время выполнения предыдущей Snapshot Share операции служба также возвращает код ошибки 409 (конфликт).

Существующие моментальные снимки общих папок никогда не перезаписываются. Они должны быть удалены явным образом. Чтобы явно удалить моментальные снимки общих папок, вызовите метод Delete Share и задайте x-ms-include-snapshots для заголовка вместе с параметром sharesnapshot запроса соответствующее значение.

Моментальные снимки общих папок NFS можно просматривать в клиенте NFS с помощью виртуального каталога моментальных снимков (.snapshot), который обычно находится в корне точки подключения общей папки. Доступ к этому каталогу можно отключить, установив для заголовка x-ms-enable-snapshot-virtual-directory-access значение false в API установки свойств общего ресурса . Этот заголовок также можно задать во время создания общей папки в рамках операции Создания общего ресурса .