Создание общего ресурса
Операция Create Share создает новую общую папку Службы файлов Azure в указанной учетной записи. Хотя этот API полностью поддерживается, это устаревший API управления. Вместо этого рекомендуется использовать общие папки . Создание, которое предоставляется поставщиком ресурсов службы хранилища Azure (Microsoft.Storage). Дополнительные сведения о программном взаимодействии с ресурсами FileShare с помощью поставщика ресурсов службы хранилища Azure см. в статье Operations on FileShares.
Если общий ресурс с тем же именем уже существует, операция завершается ошибкой. Ресурс общего ресурса содержит метаданные и свойства для этой общей папки. Он не содержит список файлов, содержащихся в общей папке.
Доступность протокола
| Протокол общей папки с включенным доступом | Доступный |
|---|---|
| Блок сообщений сервера (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 и более поздних версий. Указывает максимальный размер общей папки в гибибайтах (GiB). |
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. Для этого параметра требуется учетная запись premium. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Необязательный. Только NFS. Поддерживается в версии 2019-07-07 и более поздних версий. Указывает поведение корневого скваширования в общей папке при включении NFS. Если он не указан, значение по умолчанию — NoRootSquash. - NoRootSquash. Отключение корневого сквоширования.- RootSquash: сопоставление запросов из uid/gid 0 в анонимный пользовательский интерфейс или gid.- AllSquash. Сопоставление всех пользовательских интерфейсов и гибов с анонимным пользователем. |
x-ms-enable-snapshot-virtual-directory-access: <true \| false> |
Необязательный. Поддерживается в версии 2024-08-04 и более поздних версий. Указывает, должен ли виртуальный каталог моментального снимка быть доступен в корне точки подключения общего ресурса при включении NFS. Если значение не указано, значение по умолчанию равно true. |
x-ms-client-request-id |
Необязательный. Предоставляет созданное клиентом непрозрачное значение с ограничением символов 1-kibibyte (KiB), записанным в журналах при настройке ведения журнала. Настоятельно рекомендуется использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в статье Monitor Azure Files. |
x-ms-share-paid-bursting-enabled: <true \| false> |
Необязательный. Поддерживается в версии 2024-11-04 и более поздних версий. Разрешено только для общих папок класса Premium (общие папки в типе учетной записи хранения FileStorage). Это свойство обеспечивает платный всплеск. Если свойство не указано, значение по умолчанию равно false. |
x-ms-share-paid-bursting-max-iops |
Необязательный. Поддерживается в версии 2024-11-04 и более поздних версий. Разрешено только для общих папок класса Premium. Целое число, представляющее максимальное число операций ввода-вывода в секунду( операций ввода-вывода), разрешенных для общей папки. Значение по умолчанию, если не указано максимально допустимое число операций ввода-вывода в секунду для общей папки. Если этот заголовок задан, x-ms-share-paid-bursting-enabled также должно быть задано значение true. |
x-ms-share-paid-bursting-max-bandwidth-mibps |
Необязательный. Поддерживается в версии 2024-11-04 и более поздних версий. Разрешено только для общих папок класса Premium. Целое число, представляющее максимальное количество платных мебибайтов в секунду (MiB/s), допустимое для общей папки. Значение по умолчанию, если не указано максимально допустимое значение MiB/s для общей папки. Если этот заголовок задан, x-ms-share-paid-bursting-enabled также должно быть задано значение true. |
Текст запроса
Никакой.
Пример запроса
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) завершится ошибкой. Вы по-прежнему сможете создавать пустые файлы.
Изменение или настройка квоты не влияет на выставление счетов. Вы по-прежнему оплачиваете размер файлов, а также накладные расходы.