Créer une autorisation

L’opération Create Permission crée une autorisation (descripteur de sécurité) au niveau du partage. Vous pouvez utiliser le descripteur de sécurité créé pour les fichiers et répertoires du partage. Cette API est disponible à partir de la version 2019-02-02.

Disponibilité du protocole

Protocole de partage de fichiers activé	Disponible
SMB
NFS

Demander

Vous pouvez construire la requête Create Permission comme indiqué ici. Nous vous recommandons d’utiliser HTTPS.

Remplacez les composants de chemin d’accès indiqués dans l’URI de requête par vos propres composants, comme indiqué ici :

Pour plus d’informations sur les restrictions de nommage de chemin d’accès, consultez partages de noms et de référence, répertoires, fichiers et métadonnées.

Paramètres d’URI

Vous pouvez spécifier des paramètres supplémentaires sur l’URI de requête, comme indiqué ici :

En-têtes de requête

Les en-têtes de requête obligatoires et facultatifs sont décrits dans le tableau suivant :

Corps de la demande

Vous créez un descripteur de sécurité en plaçant un objet JSON dans le corps de la demande. L’objet JSON peut avoir les champs suivants :

Si vous utilisez SDDL, le format de chaîne SDDL du descripteur de sécurité ne doit pas avoir d’identificateur relatif de domaine (par exemple, DU, DA ou DD) dans celui-ci.

{
    "permission": "<SDDL>"
}

Dans la version 2024-11-04 ou ultérieure, vous pouvez éventuellement spécifier explicitement que l’autorisation est au format SDDL :

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

Dans la version 2024-11-04 ou ultérieure, vous pouvez également créer une autorisation au format binaire encodé en base 64. Dans ce cas, vous devez spécifier explicitement que le format est "binary".

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

Exemple de requête

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)"}

Réponse

La réponse inclut un code d’état HTTP et un ensemble d’en-têtes de réponse.

Code d’état

Une opération réussie retourne le code d’état 201 (créé).

Pour plus d’informations sur les codes d’état, consultez Les codes d’état et d’erreur.

En-têtes de réponse

La réponse de cette opération inclut les en-têtes suivants. La réponse peut également inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard sont conformes à la spécification de protocole HTTP/1.1.

Corps de la réponse

Aucun.

Autorisation

Seul le propriétaire du compte ou un appelant disposant d’une signature d’accès partagé au niveau du partage avec une autorisation d’écriture et de suppression peut appeler cette opération.

Remarques

Pour rendre le format SDDL portable sur les machines jointes à un domaine et à un domaine, l’appelant peut utiliser la ConvertSecurityDescriptorToStringSecurityDescriptor fonction Windows pour obtenir la chaîne SDDL de base pour le descripteur de sécurité. L’appelant peut ensuite remplacer la notation SDDL répertoriée dans le tableau suivant par la valeur SID correcte.