Создание общей папки
Операция Create Share
создает новую общую папку Файлы Azure в указанной учетной записи. Хотя этот API полностью поддерживается, он является устаревшим API управления. Вместо этого рекомендуется использовать общие папки — Создание, предоставляемые поставщиком ресурсов службы хранилища Azure (Microsoft.Storage). Дополнительные сведения о программном взаимодействии с FileShare
ресурсами с помощью поставщика ресурсов службы хранилища Azure см. в статье Операции с общими папками.
Если общая папка с таким именем уже существует, операция завершается ошибкой. Ресурс общей папки содержит метаданные и свойства для данной общей папки. Он не содержит список файлов, содержащихся в общей папке.
Доступность протокола
Включенный протокол общей папки | Доступно |
---|---|
Протокол SMB | |
Файловая система NFS |
Запрос
Запрос можно создать, Create Share
как показано здесь. Рекомендуется использовать ПРОТОКОЛ HTTPS.
Метод | Универсальный код ресурса (URI) запроса | параметр "Версия HTTP" |
---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share |
HTTP/1.1 |
Замените компоненты пути, отображаемые в URI запроса, собственными, как показано ниже.
Компонент path | Описание |
---|---|
myaccount |
Имя учетной записи хранения. |
myshare |
Имя файлового ресурса. Имя может содержать только символы нижнего регистра. |
Дополнительные сведения об ограничениях именования путей см. в разделе Имена и ссылки на общие папки, каталоги, файлы и метаданные.
Параметры универсального кода ресурса (URI)
В запросе URI можно указать следующие дополнительные параметры.
Параметр | Описание |
---|---|
timeout |
Необязательный элемент. Параметр времени ожидания указывается в секундах. Дополнительные сведения см. в разделе Настройка времени ожидания для операций службы файлов. |
Заголовки запросов
Обязательные и необязательные заголовки запросов описаны в следующей таблице:
Заголовок запроса | Описание |
---|---|
Authorization |
Обязательный. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure. |
Date или x-ms-date |
Обязательный. Задает время в формате UTC для запроса. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure. |
x-ms-version |
Требуется для всех авторизованных запросов. Задает версию операции, используемой для этого запроса. Дополнительные сведения см. в статье Управление версиями для служб хранилища Azure. |
x-ms-meta-name:value |
Необязательный элемент. Пары имя-значение, которые будут связаны с общей папкой как метаданные. Имена метаданных должны соответствовать правилам именования для идентификаторов C#. |
x-ms-share-quota |
Необязательный элемент. Поддерживается в версии 2015-02-21 и более поздних версиях. Указывает максимальный размер общей папки в гибибайтах (ГиБ). |
x-ms-access-tier |
Необязательный элемент. Поддерживается в версии 2019-12-12 и более поздних версиях. Указывает уровень доступа к общей папке. Допустимые значения: TransactionOptimized , Hot и Cool . Подробные сведения об уровнях общих папок см. в разделе Файлы Azure уровнях хранилища. |
x-ms-enabled-protocols: <SMB \| NFS> |
Необязательный элемент. Поддерживается в версии 2019-07-07 и более поздних версиях. Указывает включенные протоколы в общей папке. Если они не указаны, по умолчанию используется SMB. - SMB : доступ к общей папке можно получить с помощью SMBv3.0, SMBv2.1 и REST.- NFS : доступ к общей папке можно получить с помощью NFSv4.1. Для этого параметра требуется учетная запись уровня "Премиум". |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Необязательный элемент. Только NFS. Поддерживается в версии 2019-07-07 и более поздних версиях. Указывает поведение корневого сжатия в общей папке при включении NFS. Если он не указан, по умолчанию используется значение NoRootSquash. - NoRootSquash : отключение корневого сжатия.- RootSquash : сопоставляет запросы из uid/gid 0 с анонимным uid/gid.- AllSquash : сопоставьте все uid и gids с анонимным пользователем. |
x-ms-client-request-id |
Необязательный элемент. Предоставляет созданное клиентом непрозрачное значение с ограничением в 1 кибибайт (КиБ), которое записывается в журналы при настройке ведения журнала. Мы настоятельно рекомендуем использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в разделе Мониторинг Файлы Azure. |
Текст запроса
Нет.
Пример запроса
PUT https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1
Request Headers:
x-ms-version: 2020-02-10
x-ms-date: <date>
x-ms-meta-Name: StorageSample
x-ms-enabled-protocols: NFS
x-ms-root-squash: RootSquash
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
Ответ
Ответ включает код состояния HTTP и набор заголовков ответа.
Код состояния
Успешная операция возвращает код состояния 201 (создано).
Дополнительные сведения см. в разделе Состояние и коды ошибок.
Заголовки ответов
Ответ для этой операции включает следующие заголовки. Ответ также может содержать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.
Заголовок ответа | Описание |
---|---|
ETag |
Содержит значение, представляющее версию общей папки, заключенную в кавычки. |
Last-Modified |
Возвращает дату и время последнего изменения общей папки. Дата в формате согласно RFC 1123. Дополнительные сведения см. в разделе Представление значений даты и времени в заголовках. Любая операция, которая изменяет общий ресурс или его свойства или обновляет время последнего изменения. Операции с файлами не влияют на время последнего изменения общего ресурса. |
x-ms-request-id |
Уникально идентифицирует запрос, и его можно использовать для устранения неполадок с запросом. Дополнительные сведения см. в статье Устранение неполадок с операциями API. |
x-ms-version |
Указывает версию Файлы Azure, которая использовалась для выполнения запроса. |
Date |
Значение даты и времени в формате UTC, созданное службой, которое указывает время инициации ответа. |
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:
Transfer-Encoding: chunked
Date: <date>
ETag: "0x8CB14C3E29B7E82"
Last-Modified: <date>
x-ms-version: 2020-02-10
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Авторизация
Вызов этой операции доступен только владельцу учетной записи.
Комментарии
Общие папки создаются непосредственно в учетной записи хранения. Невозможно вложить одну общую папку в другую.
Вы можете указать метаданные для общей папки при ее создании, включив один или несколько заголовков метаданных в запрос. Формат для заголовка метаданных — x-ms-meta-name:value
.
Если общий ресурс с таким же именем удаляется при вызове Create Share
, сервер возвращает код состояния 409 (конфликт), а дополнительные сведения об ошибке указывают на то, что общий ресурс удаляется.
Квоту на размер общего ресурса можно использовать для ограничения размера файлов, хранящихся в общей папке. Квота не ограничивает размер моментальных снимков. Затраты, связанные с файлами и используемые для вычисления размера выставления счетов для учетной записи хранения, не учитываются в квоте.
Если сумма размеров файлов в общей папке превышает квоту, установленную для общей папки, попытки увеличить размер файла завершатся ошибкой, а создание новых непустых файлов (с помощью REST) завершится ошибкой. Вы по-прежнему сможете создавать пустые файлы.
Изменение или установка квоты не оказывает влияния на выставление счетов. Вам по-прежнему выставляется счет за размер файлов плюс накладные расходы.