Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
L'operazione Set Share Properties imposta le proprietà per la condivisione file Azure specificata. Anche se questa operazione è completamente supportata, si tratta di un'operazione di gestione legacy. Consigliamo di utilizzare invece l'operazione File Shares - Update fornita dal fornitore delle risorse di storage (Microsoft.Storage). Per saperne di più sull'interazione programmativa con FileShare le risorse utilizzando il provider di risorse di storage, vedi Operazioni sulle risorse FileShare.
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 dettagli sulle restrizioni sulla denominazione dei percorsi, vedi Denominazione e riferimento di 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 maggiori informazioni, vedi Imposta timeout per le operazioni Azure Files. |
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 oppure 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-share-provisioned-iops |
Opzionale. Supportato dalla versione 2025-01-05 e successive. Consentito solo condivisioni file v2 provisionate. Se specificato, aggiorna l'IOPS provisionato della condivisione al valore specificato. Se non specificato, l'IOPS provisionato della condivisione rimane invariato. |
x-ms-share-provisioned-bandwidth-mibps |
Opzionale. Supportato dalla versione 2025-01-05 e successive. Consentito solo condivisioni file v2 provisionate. Se specificato, aggiorna la larghezza di banda provisionata della condivisione al valore specificato, in mebibyte al secondo (MiBps). Se non specificato, la larghezza di banda provisionata della condivisione rimane invariata. |
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 sul tiering della condivisione file, vedi Azure Files storage tiers. |
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 v1 provisionate. 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 v1 provisionate. Intero che rappresenta il numero massimo di operazioni di input/output a pagamento al secondo consentite per la condivisione. Se il bursting pagato non è già abilitato sulla condivisione: il comportamento è identico all'intestazione x-ms-share-paid-bursting-max-iops in Create Share. Il valore predefinito se non specificato è il numero massimo di operazioni di I/O al secondo consentite per una condivisione. Se questo header è impostato, x-ms-share-paid-bursting-enabled deve essere impostato anche su true.Se il paybursting è già abilitato sulla condivisione: x-ms-share-paid-bursting-max-iops può essere usato per aggiornare il massimo a pagamento degli bursting IOPS per la condivisione.
x-ms-share-paid-bursting-enabled in questo caso non è necessario che sia impostato. Se x-ms-share-paid-bursting-enabled è impostato su true ma x-ms-share-paid-bursting-max-iops non è impostato, il massimo pagamento di bursting IOPS 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 v1 provisionate. Intero che rappresenta il numero massimo di mebibyte con burst a pagamento al secondo (MiB/s) consentito per la condivisione. Se il bursting pagato non è già abilitato sulla condivisione: il comportamento è identico all'intestazione x-ms-share-paid-bursting-max-bandwidth-mibps in Create Share. Il valore predefinito se non specificato è il numero massimo consentito di MiB/s per una condivisione. Se questo header è impostato, x-ms-share-paid-bursting-enabled deve essere impostato anche su true.Se il bursting pagato è già abilitato sulla condivisione: x-ms-share-paid-bursting-max-bandwidth-mibps può essere usato per aggiornare il massimo MiB/s di bursting pagato per la condivisione.
x-ms-share-paid-bursting-enabled in questo caso non è necessario che sia impostato. Se x-ms-share-paid-bursting-enabled è impostato su vero ma x-ms-share-paid-bursting-max-bandwidth-mibps non è impostato, la larghezza di banda massima 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 ulteriori 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 oppure 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. |
x-ms-share-quota |
Versione 2025-01-05 e successive. Restituito solo per le condivisioni file v2 di cui è stato effettuato il provisioning. Restituisce la dimensione di archiviazione provisionata della condivisione, in gibibyte (GiB). |
x-ms-share-provisioned-iops |
Versione 2025-01-05 e successive. Restituito solo per le condivisioni file v2 di cui è stato effettuato il provisioning. Restituisce il numero provisionato di operazioni di input/output per secondo (IOPS) della condivisione. |
x-ms-share-provisioned-bandwidth-mibps |
Versione 2025-01-05 e successive. Restituito solo per le condivisioni file v2 di cui è stato effettuato il provisioning. Restituisce la larghezza di banda provisionata della condivisione, in mebibyte al secondo (MiBps). |
x-ms-share-included-burst-iops |
Versione 2025-01-05 e successive. Restituito solo per le condivisioni file v2 di cui è stato effettuato il provisioning. Restituisce le operazioni di I/O al secondo del burst calcolato della condivisione. |
x-ms-share-max-burst-credits-for-iops |
Versione 2025-01-05 e successive. Restituito solo per le condivisioni file v2 di cui è stato effettuato il provisioning. Restituisce i crediti massimi calcolati per la condivisione. Questo non è il livello di credito burst corrente, ma il numero massimo di crediti burst che la condivisione può avere. |
x-ms-share-next-allowed-quota-downgrade-time |
Versione 2025-01-05 e successive. Restituito solo per le condivisioni file v2 di cui è stato effettuato il provisioning. Un valore data/ora che specifica quando la quota per la condivisione file è consentita da ridotto. Il formato della data segue RFC 1123. |
x-ms-share-next-allowed-provisioned-iops-downgrade-time |
Versione 2025-01-05 e successive. Restituito solo per le condivisioni file v2 di cui è stato effettuato il provisioning. Un valore data/ora che specifica quando è permesso ridurre l'IOPS provisionato per la condivisione file. Il formato della data segue RFC 1123. |
x-ms-share-next-allowed-provisioned-bandwidth-downgrade-time |
Versione 2025-01-05 e successive. Restituito solo per le condivisioni file v2 di cui è stato effettuato il provisioning. Un valore data/ora che specifica quando la larghezza di banda provisionata per la condivisione file è consentita da ridotto. Il formato della data segue RFC 1123. |
Corpo della risposta
Nessuno.
Autorizzazione
Solo il proprietario dell'account può chiamare questa operazione.
Osservazioni
Per maggiori informazioni sull'impostazione della quota di quota, vedi Crea Condivisione.
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 è supportata per una snapshot di condivisione. Un tentativo di eseguire questa operazione in uno snapshot di condivisione avrà esito negativo con codice di stato 400 (InvalidQueryParameterValue).