Vytvořit oprávnění

Operace Create Permission vytvoří oprávnění (popisovač zabezpečení) na úrovni sdílené složky. Pro soubory a adresáře ve sdílené složce můžete použít vytvořený popisovač zabezpečení. Toto rozhraní API je k dispozici od verze 2019-02-02.

Dostupnost protokolu

Povolený protokol sdílené složky	K dispozici
SMB
NFS

Prosba

Můžete vytvořit požadavek Create Permission, jak je znázorněno zde. Doporučujeme používat PROTOKOL HTTPS.

Nahraďte komponenty cesty uvedené v identifikátoru URI požadavku vlastními komponentami, jak je znázorněno tady:

Informace o omezeních pojmenování cest najdete v tématu Název a odkazové sdílené složky, adresáře, soubory a metadata.

Parametry identifikátoru URI

Pro identifikátor URI požadavku můžete zadat další parametry, jak je znázorněno tady:

Hlavičky požadavku

Povinná a volitelná hlavička požadavku jsou popsána v následující tabulce:

Text požadavku

Popisovač zabezpečení vytvoříte umístěním objektu JSON do textu požadavku. Objekt JSON může mít následující pole:

Pokud používáte SDDL, formát řetězce SDDL popisovače zabezpečení by v něm neměl mít relativní identifikátor domény (například DU, DA nebo DD).

{
    "permission": "<SDDL>"
}

Ve verzi 2024-11-04 nebo novější můžete volitelně explicitně určit, že oprávnění je ve formátu SDDL:

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

Ve verzi 2024-11-04 nebo novější můžete také vytvořit oprávnění v binárním formátu s kódováním base-64. V takovém případě musíte explicitně určit, že formát je "binary".

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

Ukázkový požadavek

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

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 201 (vytvořeno).

Informace o stavových kódech naleznete v tématu Stav a kódy chyb.

Hlavičky odpovědi

Odpověď pro tuto operaci obsahuje následující hlavičky. Odpověď může obsahovat také další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Text odpovědi

Žádný.

Oprávnění

Tuto operaci může volat pouze vlastník účtu nebo volající, který má sdílený přístupový podpis na úrovni sdílené složky s oprávněním k zápisu a odstranění.

Poznámky

Aby byl formát SDDL přenositelný mezi doménou a počítači, které nejsou připojené k doméně, volající může použít ConvertSecurityDescriptorToStringSecurityDescriptor funkci Windows k získání základního řetězce SDDL pro popisovač zabezpečení. Volající pak může nahradit notaci SDDL uvedenou v následující tabulce správnou hodnotou SID.