хранилище моментальных снимков
Начиная с версии 2017-04-17, Snapshot Share операция создает доступную только для чтения snapshot общей папки.
Доступность протокола
| Включенный протокол общей папки | Доступно | Состояние |
|---|---|---|
| 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 |
Необязательный элемент. Указывает определяемую пользователем пару "имя-значение", связанную с общей snapshot. Если не указать пары "имя-значение", операция копирует метаданные базового общего ресурса в snapshot. Если указать одну или несколько пар "имя-значение", snapshot общей папки создается с указанными метаданными. В этом случае метаданные не копируются из базовой общей папки. Имена метаданных должны соответствовать правилам именования для идентификаторов 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 |
Содержит значение, представляющее версию snapshot общей папки в кавычках. Общий snapshot нельзя изменить, поэтому ETag объект определенной общей папки никогда не snapshot изменяться. Однако если вы предоставили новые метаданные с запросом Snapshot ShareETag, то snapshot общего ресурса будет отличаться от базового общего ресурса. Если вы не указали метаданные в запросе, ETag то snapshot общей папки будет идентична базовой общей папке на момент получения snapshot общей папки. |
Last-Modified |
Возвращает дату и время последнего изменения общей папки. Дополнительные сведения см. в разделе Представление значений даты и времени в заголовках. Общий snapshot нельзя изменить, поэтому время последнего изменения конкретной общей папки snapshot никогда не изменяется. Однако если вы предоставили новые метаданные с запросом Snapshot Share, время последнего изменения snapshot общей папки отличается от времени последнего изменения базового общего ресурса. Если вы не указали метаданные в запросе, время последнего изменения snapshot общего ресурса совпадает с временем последнего изменения базового общего ресурса на момент получения snapshot общей папки. |
x-ms-request-id |
Уникально идентифицирует выполненный запрос и может использоваться для устранения неполадок с запросом. Дополнительные сведения см. в разделе Устранение неполадок с операциями API. |
x-ms-version |
Указывает версию Файлы Azure, используемую для выполнения запроса. |
Date или x-ms-date |
Значение даты и времени в формате UTC, указывающее время, когда был инициирован ответ. Служба создает это значение. |
x-ms-snapshot |
Значение DateTime , однозначно определяющее snapshot общей папки. Значение этого заголовка можно использовать в последующих запросах для доступа к общей snapshot. Это значение является непрозрачным. |
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 вы не сможете изменить его. Общий snapshot предоставляет удобный способ создания согласованной резервной копии всех файлов в общей папке.
При каждом вызове Snapshot Share операции создается новый snapshot общей папки с уникальным DateTime значением, определяющим snapshot общей папки относительно ее базовой общей папки. Это DateTime значение можно использовать для выполнения дальнейших операций с общим snapshot и его содержимым. Это значение следует рассматривать DateTime как непрозрачное.
Значение DateTime определяет общий snapshot в URI запроса. Например, файл в базовой общей папке и его моментальные снимки имеют URI, аналогичные следующим примерам:
- Файл в общей папке:
http://myaccount.file.core.windows.net/myshare/myfile - Файл в snapshot общей папки:
http://myaccount.file.core.windows.net/myshare/myfile?sharesnapshot=<DateTime>
Общая папка может поддерживать создание 200 моментальных снимков общих папок. При попытке создать более 200 моментальных снимков общих папок служба возвращает код ошибки 409 (конфликт). При попытке создать общую папку snapshot во время выполнения предыдущей Snapshot Share операции служба также возвращает код ошибки 409 (конфликт).
Существующие моментальные снимки общих папок никогда не перезаписываются. Они должны быть удалены явным образом. Чтобы явным образом удалить моментальные снимки общего ресурса, вызовите метод Delete Share и задайте x-ms-include-snapshots в заголовке вместе с параметром sharesnapshot запроса соответствующее значение.