Crea autorizzazione

L'operazione Create Permission crea un'autorizzazione (un descrittore di sicurezza) a livello di condivisione. È possibile usare il descrittore di sicurezza creato per i file e le directory nella condivisione. Questa API è disponibile a partire dalla versione 2019-02-02.

Disponibilità del protocollo

Protocollo di condivisione file abilitato	Disponibile
SMB
NFS

Richiesta

È possibile costruire la richiesta di Create Permission come illustrato di seguito. È consigliabile usare HTTPS.

Sostituire i componenti del percorso visualizzati nell'URI della richiesta con i propri componenti, come illustrato di seguito:

Per informazioni sulle restrizioni di denominazione dei percorsi, vedere Nome e condivisioni di riferimento, directory, file e metadati.

Parametri URI

È possibile specificare parametri aggiuntivi nell'URI della richiesta, come illustrato di seguito:

Intestazioni della richiesta

Le intestazioni di richiesta obbligatorie e facoltative sono descritte nella tabella seguente:

Corpo della richiesta

Per creare un descrittore di sicurezza, inserire un oggetto JSON nel corpo della richiesta. L'oggetto JSON può avere i campi seguenti:

Se si usa SDDL, il formato di stringa SDDL del descrittore di sicurezza non deve avere un identificatore relativo del dominio (ad esempio, DU, DA o DD).

{
    "permission": "<SDDL>"
}

Nella versione 2024-11-04 o successiva, facoltativamente, è possibile specificare in modo esplicito che l'autorizzazione sia in formato SDDL:

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

Nella versione 2024-11-04 o successiva è anche possibile creare un'autorizzazione in formato binario con codifica base 64. In tal caso, è necessario specificare in modo esplicito che il formato sia "binary".

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

Richiesta di esempio

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

Risposta

La risposta include un codice di stato HTTP e un set di intestazioni di risposta.

Codice di stato

Un'operazione riuscita restituisce il codice di stato 201 (Creato).

Per informazioni sui codici di stato, vedere Stato e codici di errore.

Intestazioni di risposta

La risposta per questa operazione include le intestazioni seguenti. La risposta potrebbe includere anche intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1 .

Corpo della risposta

Nessuno.

Autorizzazione

Solo il proprietario dell'account o un chiamante con una firma di accesso condiviso a livello di condivisione con autorizzazione di scrittura ed eliminazione può chiamare questa operazione.

Osservazioni

Per rendere il formato SDDL portabile in computer non appartenenti a dominio e dominio, il chiamante può usare il ConvertSecurityDescriptorToStringSecurityDescriptor funzione Windows per ottenere la stringa SDDL di base per il descrittore di sicurezza. Il chiamante può quindi sostituire la notazione SDDL elencata nella tabella seguente con il valore SID corretto.