Создание разрешения

Операция Create Permission создает разрешение (дескриптор безопасности) на уровне общего ресурса. Вы можете использовать созданный дескриптор безопасности для файлов и каталогов в общей папке. Этот API доступен в версии 2019-02-02.

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

Протокол общей папки с включенным доступом	Доступный
SMB
NFS

Просьба

Вы можете создать запрос Create Permission, как показано здесь. Рекомендуется использовать ПРОТОКОЛ HTTPS.

Замените компоненты пути, отображаемые в URI запроса, собственными компонентами, как показано ниже:

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

Параметры URI

Дополнительные параметры можно указать в URI запроса, как показано здесь:

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

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

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

Дескриптор безопасности создается путем размещения объекта JSON в тексте запроса. Объект JSON может иметь следующие поля:

Если используется SDDL, формат строки SDDL дескриптора безопасности не должен содержать относительный идентификатор домена (например, DU, DA или DD).

{
    "permission": "<SDDL>"
}

В версии 2024-11-04 или более поздней версии можно явно указать, что разрешение находится в формате SDDL:

{
    "format": "sddl",
    "permission": "<SDDL>"
}

В версии 2024-11-04 или более поздней версии можно также создать разрешение в двоичном формате в кодировке Base-64. В этом случае необходимо явно указать, что формат "binary".

{
    "format": "binary",
    "permission": "<base64>"
}

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

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

Request Headers:
x-ms-date: Mon, 27 Jan 2014 22:15:50 GMT
x-ms-version: 2014-02-14
Authorization: SharedKey myaccount:4KdWDiTdA9HmIF9+WF/8WfYOpUrFhieGIT7f0av+GEI=

Request Body:
{"permission": "O:S-1-5-21-2127521184-1604012920-1887927527-21560751G:S-1-5-21-2127521184-1604012920-1887927527-513D:AI(A;;FA;;;SY)(A;;FA;;;BA)(A;;0x1200a9;;;S-1-5-21-397955417-626881126-188441444-3053964)"}

Ответ

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

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

Успешная операция возвращает код состояния 201 (создан).

Сведения о кодах состояния см. в коды состояния и коды ошибок.

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

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

Текст ответа

Никакой.

Авторизация

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

Замечания

Чтобы сделать формат SDDL переносимым между доменами и компьютерами, не присоединенными к домену, вызывающий объект может использовать функцию ConvertSecurityDescriptorToStringSecurityDescriptor Windows, чтобы получить базовую строку SDDL для дескриптора безопасности. Вызывающий объект может заменить нотацию SDDL, указанную в следующей таблице, правильным значением идентификатора безопасности.