Ottenere le proprietà di condivisione

La richiesta di Get Share Properties restituisce le proprietà per la condivisione o lo snapshot di condivisione specificato.

Anche se questa API è completamente supportata, è un'API di gestione legacy. Per questo motivo, è consigliabile usare condivisioni file - Ottenere, fornito 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 in FileShares.

Disponibilità del protocollo

Protocollo di condivisione file abilitato	Disponibile
SMB
NFS

Richiesta

La richiesta di Get Share Properties può essere costruita nel modo seguente. È consigliabile usare HTTPS.

Metodo	URI della richiesta	Versione HTTP
GET/HEAD	https://myaccount.file.core.windows.net/myshare?restype=share	HTTP/1.1
GET/HEAD	https://myaccount.file.core.windows.net/myshare?restype=share&sharesnapshot=<DateTime>	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 sulle restrizioni di denominazione dei percorsi, vedere Condivisioni nome e riferimenti, directory, file e metadati.

Parametri URI

Nell'URI della richiesta è possibile specificare i parametri aggiuntivi seguenti:

Parametro	Descrizione
sharesnapshot	Opzionale. Versione 2017-04-17 e successive. Il parametro sharesnapshot è un valore di data/ora opaco che, quando presente, specifica lo snapshot di condivisione su cui eseguire la query per recuperare le proprietà.
timeout	Opzionale. Il parametro di timeout è espresso in secondi. Per altre informazioni, vedere Impostare i timeout per le operazioni di File di Azure.

Intestazioni della richiesta

Le intestazioni obbligatorie e facoltative sono descritte nella tabella seguente:

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-client-request-id	Opzionale. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 kibibyte (KiB) registrato nei log 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 File di Azure.
x-ms-lease-id:<ID>	Opzionale. Versione 2020-02-10 e successive. Se l'intestazione viene specificata, l'operazione viene eseguita solo se il lease della condivisione file è attualmente attivo e l'ID lease specificato nella richiesta corrisponde all'ID lease della condivisione file. Se non esiste alcuna corrispondenza, l'operazione ha esito negativo con codice di stato 412 (Precondizione non riuscita).

Corpo della richiesta

Nessuno.

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 altre 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 può 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 Date-Time 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.
x-ms-meta-name:value	Set di coppie nome-valore che contengono i metadati definiti dall'utente della condivisione.
ETag	Contiene un valore che è possibile usare per eseguire operazioni in modo condizionale. Il valore è racchiuso tra virgolette.
x-ms-request-id	Identifica in modo univoco la richiesta effettuata e può essere usata per risolvere i problemi della richiesta. Per altre informazioni, vedere Risolvere i problemi relativi alle operazioni API.
x-ms-version	Versione di File di Azure usata per eseguire la richiesta.
Date	Valore di data/ora UTC generato dal servizio, che indica l'ora di avvio della risposta.
x-ms-share-quota	Versione 2015-02-21 e successive. Restituisce la quota di condivisione corrente in gibibytes (GiB).
x-ms-share-provisioned-iops	Versione 2019-07-07 e successive. Restituito solo per le condivisioni file Premium (condivisioni file all'interno del tipo di account di archiviazione FileStorage). Restituisce il numero di operazioni di input/output al secondo (IOPS), di cui è stato effettuato il provisioning per la condivisione Premium.
x-ms-share-provisioned-ingress-mbps	Versione 2019-07-07 e successive. Restituito solo per le condivisioni file Premium (condivisioni file all'interno del tipo di account di archiviazione FileStorage). Restituisce l'ingresso in mebibyte al secondo (MiB/s), come provisioning per la condivisione Premium.
x-ms-share-provisioned-egress-mbps	Versione 2019-07-07 e successive. Restituito solo per le condivisioni file Premium (condivisioni file all'interno del tipo di account di archiviazione FileStorage). Restituisce l'uscita in MiB/s, come provisioning per la condivisione Premium.
x-ms-share-provisioned-bandwidth-mibps	Versione 2021-02-12 e successive. Restituito solo per le condivisioni file Premium (condivisioni file all'interno del tipo di account di archiviazione FileStorage). Restituisce la larghezza di banda combinata (in ingresso + in uscita) in MiB/s, come provisioning per la condivisione Premium.
x-ms-share-next-allowed-quota-downgrade-time	Versione 2019-07-07 e successive. Restituito solo per le condivisioni file Premium (condivisioni file all'interno del tipo di account di archiviazione FileStorage). Valore di data/ora che specifica quando è consentita la riduzione della quota per la condivisione file Premium. Il formato della data segue RFC 1123.
x-ms-access-tier	Versione 2019-12-12 e successive. Restituisce il livello di accesso corrente della condivisione. Negli account di archiviazione per utilizzo generico versione 2 (GPv2), TransationOptimized è il livello predefinito della condivisione. In Tipi di account di archiviazione FileStorage Premium è il livello predefinito della condivisione.
x-ms-access-tier-change-time	Versione 2019-12-12 e successive. Restituisce la data e l'ora dell'ultima modifica del livello di accesso nella condivisione.
x-ms-access-tier-transition-state	Versione 2019-12-12 e successive. Se la condivisione è in fase di transizione di livello, questa intestazione indica il livello da cui sta effettuando la transizione.
x-ms-lease-duration:<fixed,infinite>	Versione 2020-02-10 e successive. Specifica se il lease di una condivisione è di durata infinita o fissa.
x-ms-lease-state: <available;leased;expired;breaking;broken>	Versione 2020-02-10 e successive. Quando viene eseguito il lease di una condivisione, questa intestazione specifica lo stato di lease della condivisione.
x-ms-lease-status: <locked;unlocked>	Versione 2020-02-10 e successive. Quando viene eseguito il lease di una condivisione, questa intestazione specifica lo stato del lease della condivisione.
x-ms-enabled-protocols: <SMB;NFS>	Restituisce i protocolli correnti abilitati per la condivisione per la versione 2019-07-07 e successive. - SMB: è possibile accedere alla condivisione tramite SMBv3.0, SMBv2.1 e REST. - NFS: è possibile accedere alla condivisione tramite NFSv4.1.
x-ms-root-squash: <NoRootSquash;RootSquash;AllSquash>	Restituisce il comportamento di squashing radice della condivisione corrente per la versione 2019-07-07 e successive. Solo NFS. - NoRootSquash: lo squash radice è disattivato. - RootSquash: le richieste da UID/GID 0 vengono mappate all'UID/GID anonimo. - AllSquash: tutti gli UID e i GID vengono mappati all'utente anonimo. Questa intestazione viene restituita solo per le condivisioni, non per gli snapshot.
x-ms-enable-snapshot-virtual-directory-access: <true;false>	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. Questa intestazione viene restituita solo per le condivisioni, non per gli snapshot.
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 non contiene più di 1.024 caratteri ASCII visibili. Se l'intestazione x-ms-client-request-id non è presente nella richiesta, non sarà presente nella risposta.
x-ms-share-paid-bursting-enabled: <true;false>	Versione 2024-11-04 e successive. Restituito solo per le condivisioni file Premium (condivisioni file all'interno del tipo di account di archiviazione FileStorage). Specifica se il bursting a pagamento è abilitato. Questa intestazione viene restituita solo per le condivisioni, non per gli snapshot.
x-ms-share-paid-bursting-max-iops	Versione 2024-11-04 e successive. Restituito solo per le condivisioni file Premium. Restituisce il numero massimo di operazioni di I/O al secondo a pagamento consentite per la condivisione. Restituito solo se x-ms-share-paid-bursting-enabled è true. Questa intestazione viene restituita solo per le condivisioni, non per gli snapshot.
x-ms-share-paid-bursting-max-bandwidth-mibps	Versione 2024-11-04 e successive. Restituito solo per le condivisioni file Premium. Restituisce il numero massimo di miB a pagamento consentito per la condivisione. Restituito solo se x-ms-share-paid-bursting-enabled è true. Questa intestazione viene restituita solo per le condivisioni, non per gli snapshot.

Corpo della risposta

Nessuno.

Risposta di esempio

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Transfer-Encoding: chunked  
x-ms-meta-name: some_metadata  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Last-Modified: <date>  
x-ms-share-quota: 1024
x-ms-access-tier: Premium
x-ms-version: 2020-02-10  
x-ms-enabled-protocols: NFS
x-ms-root-squash: RootSquash
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  

Autorizzazione

Solo il proprietario dell'account può chiamare questa operazione.

Osservazioni

Nessuno.

Vedere anche

operazioni sulle condivisioni file di Azure