Impostare le proprietà di condivisione
L'operazione Set Share Properties imposta le proprietà per la condivisione file di Azure specificata. Anche se questa operazione è completamente supportata, si tratta di un'operazione di gestione legacy. È consigliabile usare invece l'operazione di condivisioni file - Aggiornamento fornita dal provider di risorse di archiviazione (Microsoft.Storage). Per altre informazioni sull'interazione a livello di codice con le risorse di FileShare tramite il provider di risorse di archiviazione, vedere operazioni sulle risorse di Condivisione file.
Disponibilità del protocollo
| Protocollo di condivisione file abilitato | Disponibile |
|---|---|
| SMB |
|
| NFS |
|
Richiesta
È possibile costruire la richiesta di Set Share Properties come indicato di seguito. È consigliabile usare HTTPS. Sostituire myaccount con il nome dell'account di archiviazione.
| Metodo | URI della richiesta | Versione HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=properties |
HTTP/1.1 |
Sostituire i componenti del percorso visualizzati nell'URI della richiesta con i propri, come indicato di seguito:
| Componente percorso | Descrizione |
|---|---|
myaccount |
Nome dell'account di archiviazione. |
myshare |
Nome della condivisione file. |
Per informazioni dettagliate sulle restrizioni di denominazione dei percorsi, vedere Denominazione e riferimento a condivisioni, directory, file e metadati.
Parametri URI
È possibile specificare i parametri aggiuntivi seguenti nell'URI della richiesta:
| Parametro | Descrizione |
|---|---|
timeout |
Opzionale. Espresso in secondi. Per altre informazioni, vedere Impostare timeout per le operazioni di File di Azure. |
Intestazioni della richiesta
Nella tabella seguente vengono descritte le intestazioni di richiesta obbligatorie e facoltative:
| Intestazione della richiesta | Descrizione |
|---|---|
Authorization |
Obbligatorio. Specifica lo schema di autorizzazione, il nome dell'account e la firma. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure. |
Date o x-ms-date |
Obbligatorio. Specifica l'ora UTC (Coordinated Universal Time) per la richiesta. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure. |
x-ms-version |
Obbligatorio per tutte le richieste autorizzate. Specifica la versione dell'operazione da utilizzare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure. |
x-ms-share-quota |
Opzionale. Supportato nella versione 2015-02-21 e successive. Specifica le dimensioni massime della condivisione, in gibibytes (GiB). |
x-ms-access-tier |
Opzionale. Supportato nella versione 2019-12-12 e successive. Specifica il livello di accesso della condivisione. I valori validi sono TransactionOptimized, Hote Cool. Per informazioni dettagliate sulla suddivisione in livelli di condivisione file, vedere livelli di archiviazione di File di Azure. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Opzionale. Supportato nella versione 2020-02-10 e successive. Specifica il comportamento di squashing radice nella condivisione quando NFS è abilitato.
|
x-ms-enable-snapshot-virtual-directory-access: <true \| false> |
Opzionale. Supportato nella versione 2024-08-04 e successive. Specifica se la directory virtuale snapshot deve essere accessibile nella radice del punto di montaggio della condivisione quando NFS è abilitato. |
x-ms-client-request-id |
Opzionale. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 kibibyte (KiB) registrato nei log di Analisi archiviazione quando viene configurata la registrazione. È consigliabile usare questa intestazione per correlare le attività sul lato client alle richieste ricevute dal server. Per altre informazioni, vedere Monitorare l'archiviazione BLOB di Azure. |
x-ms-lease-id:<ID> |
Obbligatorio se la condivisione file di destinazione ha un lease attivo. Disponibile per la versione 2020-02-10 e successive. Se la richiesta non include l'ID lease o non è valida, l'operazione non riesce con codice di stato 412 (Precondizione non riuscita). Se questa intestazione è specificata e la condivisione file di destinazione non dispone attualmente di un lease attivo, l'operazione ha esito negativo con codice di stato 412 (precondizione non riuscita). |
x-ms-share-paid-bursting-enabled: <true \| false> |
Opzionale. Supportato nella versione 2024-11-04 e successive. Consentito solo per le condivisioni file Premium (condivisioni file all'interno del tipo di account di archiviazione FileStorage). Questa proprietà può essere utilizzata per abilitare o disabilitare il bursting a pagamento. Se la proprietà non è specificata, la condivisione manterrà lo stato di abilitazione del bursting a pagamento esistente. |
x-ms-share-paid-bursting-max-iops |
Opzionale. Supportato nella versione 2024-11-04 e successive. Consentito solo per le condivisioni file Premium. Intero che rappresenta il numero massimo di operazioni di input/output a pagamento al secondo consentite per la condivisione. Se il bursting a pagamento non è già abilitato nella condivisione: il comportamento è identico all'intestazione x-ms-share-paid-bursting-max-iops in Crea condivisione. Il valore predefinito se non specificato è il numero massimo di operazioni di I/O al secondo consentite per una condivisione. Se questa intestazione è impostata, x-ms-share-paid-bursting-enabled deve essere impostata anche su true.Se il bursting a pagamento è già abilitato nella condivisione: x-ms-share-paid-bursting-max-iops può essere usato per aggiornare il numero massimo di operazioni di I/O al secondo a pagamento per la condivisione.
x-ms-share-paid-bursting-enabled non è necessario impostare in questo caso. Se x-ms-share-paid-bursting-enabled è impostato su true ma x-ms-share-paid-bursting-max-iops non è impostato, il numero massimo di operazioni di I/O al secondo a pagamento rimarrà invariato. |
x-ms-share-paid-bursting-max-bandwidth-mibps |
Opzionale. Supportato nella versione 2024-11-04 e successive. Consentito solo per le condivisioni file Premium. Intero che rappresenta il numero massimo di mebibyte con burst a pagamento al secondo (MiB/s) consentito per la condivisione. Se il bursting a pagamento non è già abilitato nella condivisione: il comportamento è identico all'intestazione x-ms-share-paid-bursting-max-bandwidth-mibps in Crea condivisione. Il valore predefinito se non specificato è il numero massimo consentito di MiB/s per una condivisione. Se questa intestazione è impostata, x-ms-share-paid-bursting-enabled deve essere impostata anche su true.Se il bursting a pagamento è già abilitato nella condivisione: x-ms-share-paid-bursting-max-bandwidth-mibps può essere usato per aggiornare il numero massimo di picchi a pagamento miB/s per la condivisione.
x-ms-share-paid-bursting-enabled non è necessario impostare in questo caso. Se x-ms-share-paid-bursting-enabled è impostato su true ma x-ms-share-paid-bursting-max-bandwidth-mibps non è impostato, la larghezza di banda massima di bursting a pagamento rimarrà invariata. |
Corpo della richiesta
Nessuno.
Richiesta di esempio
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=properties
Request Headers:
x-ms-version: 2020-02-10
x-ms-date: <date>
Authorization: SharedKey myaccount: Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00Jdjid0Q=
x-ms-share-quota: 55
x-ms-root-squash: RootSquash
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 200 (OK).
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 .
| Intestazione della risposta | Descrizione |
|---|---|
Last-Modified |
Restituisce la data e l'ora dell'ultima modifica della condivisione. Il formato della data segue RFC 1123. Per altre informazioni, vedere Rappresentazione dei valori di data/ora nelle intestazioni. Qualsiasi operazione che modifica la condivisione o le relative proprietà aggiorna l'ora dell'ultima modifica. Le operazioni sui file non influiscono sull'ora dell'ultima modifica della condivisione. |
ETag |
Contiene un valore che rappresenta la versione della condivisione, come stringa tra virgolette. |
x-ms-request-id |
Identifica in modo univoco la richiesta effettuata. È anche possibile usarlo per risolvere i problemi della richiesta. Per altre informazioni, vedere Risolvere i problemi relativi alle operazioni API. |
x-ms-version |
Indica la versione di File di Azure usata per eseguire la richiesta. |
Date o x-ms-date |
Valore di data/ora UTC che indica l'ora in cui il servizio ha inviato la risposta. |
x-ms-client-request-id |
Può essere usato per risolvere i problemi relativi alle richieste e alle risposte corrispondenti. Il valore di questa intestazione è uguale al valore dell'intestazione x-ms-client-request-id, se presente nella richiesta e il valore è al massimo 1.024 caratteri ASCII visibili. Se l'intestazione x-ms-client-request-id non è presente nella richiesta, questa intestazione non sarà presente nella risposta. |
Corpo della risposta
Nessuno.
Autorizzazione
Solo il proprietario dell'account può chiamare questa operazione.
Osservazioni
Per altre informazioni sull'impostazione della quota di condivisione, vedere Create Share.
Se si imposta la quota di condivisione in modo che sia inferiore alle dimensioni dei dati nella condivisione, l'operazione avrà esito positivo. Tuttavia, non sarà possibile aggiungere altri dati alla condivisione fino a quando la quantità di dati nella condivisione non viene ridotta al di sotto della quota. È possibile ridurre la quantità di dati eliminando o comprimendo i file.
Set Share Properties non è supportato per uno snapshot di condivisione. Un tentativo di eseguire questa operazione in uno snapshot di condivisione avrà esito negativo con codice di stato 400 (InvalidQueryParameterValue).
Se si imposta l'intestazione x-ms-enable-snapshot-virtual-directory-access per le condivisioni NFS, montare nuovamente la condivisione per osservare il comportamento aggiornato.