Ottenere le proprietà di condivisione
La Get Share Properties richiesta restituisce le proprietà per la condivisione o lo snapshot di condivisione specificati.
Anche se questa API è completamente supportata, è un'API di gestione legacy. Per questo motivo, è consigliabile usare condivisioni file - Get, che viene fornito dal provider di risorse di archiviazione (Microsoft.Storage), invece.
Per altre informazioni sull'interazione a livello di codice con FileShare le risorse usando il provider di risorse di archiviazione, vedere Operazioni su FileShares.
Disponibilità del protocollo
| Protocollo di condivisione file abilitato | Disponibile |
|---|---|
| SMB |  |
| NFS | |
Richiesta
La richiesta Get Share Properties può essere costruita come segue. È consigliabile usare HTTPS.
| Metodo | URI 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 mostrati nell'URI di richiesta con valori personalizzati, come illustrato di seguito:
| Componente percorso | Descrizione |
|---|---|
myaccount |
nome dell'account di archiviazione. |
myshare |
Nome della condivisione file. |
Per informazioni sulle restrizioni di denominazione del percorso, vedere Condivisioni nome e riferimenti, directory, file e metadati.
Parametri URI
I parametri aggiuntivi seguenti possono essere specificati nell'URI della richiesta:
| Parametro | Descrizione |
|---|---|
sharesnapshot |
Facoltativa. Versione 2017-04-17 e successiva. Il sharesnapshot parametro è un valore di data/ora opaco che, quando presente, specifica lo snapshot di condivisione da eseguire per eseguire query per recuperare le proprietà. |
timeout |
facoltativo. Il parametro timeout viene espresso in secondi. Per altre informazioni, vedere Impostare 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 la data per la richiesta nel fuso orario UTC (Coordinated Universal Time). 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 usare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure. |
x-ms-client-request-id |
facoltativo. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 kibibyte (KiB) registrato nei log quando la registrazione è configurata. È consigliabile usare questa intestazione per correlare le attività lato client con le richieste ricevute dal server. Per altre informazioni, vedere Monitorare File di Azure. |
x-ms-lease-id:<ID> |
facoltativo. Versione 2020-02-10 e versioni successive. Se l'intestazione è 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 non riesce con il codice di stato 412 (Precondizione non riuscita). |
Testo della richiesta
Nessuno.
Risposta
Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.
Codice stato
Un'operazione completata correttamente restituisce 200 (OK).
Per altre informazioni sui codici di stato, vedere Codici di stato e di errore.
Intestazioni di risposta
Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.
| Intestazione risposta | Descrizione |
|---|---|
Last-Modified |
Restituisce la data e l'ora dell'ultima modifica della condivisione. Il formato data è conforme a RFC 1123. Per altre informazioni, vedere Rappresentazione dei valori di Date-Time nelle intestazioni. Qualsiasi operazione che comporta modifiche alla condivisione o alle relative proprietà comporta l'aggiornamento dell'ora dell'ultima modifica. Le operazioni sui file non influiscono sull'ultima ora modificata della condivisione. |
x-ms-meta-name:value |
Set di coppie nome-valore contenente i metadati definiti dall'utente per la 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 la richiesta. Per altre informazioni, vedere Risolvere i problemi relativi alle operazioni api. |
x-ms-version |
Versione File di Azure usata per eseguire la richiesta. |
Date |
Valore di data/ora UTC generato dal servizio, che indica l'ora in cui è stata avviata la risposta. |
x-ms-share-quota |
Versione 2015-02-21 e successiva. Restituisce la quota di condivisione corrente in gibibyte (GiB). |
x-ms-share-provisioned-iops |
Versione 2019-07-07 e successiva. 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 (I/O al secondo), come effettuato il provisioning per la condivisione Premium. |
x-ms-share-provisioned-ingress-mbps |
Versione 2019-07-07 e successiva. Restituito solo per le condivisioni file Premium (condivisioni file all'interno del tipo di account di archiviazione FileStorage). Restituisce i dati in ingresso in mebibyte al secondo (MiB/s), come previsto per la condivisione Premium. |
x-ms-share-provisioned-egress-mbps |
Versione 2019-07-07 e successiva. 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 effettuato il provisioning per la condivisione Premium. |
x-ms-share-provisioned-bandwidth-mibps |
Versione 2021-02-12 e versioni 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 + uscita) in MiB/s, come previsto per la condivisione Premium. |
x-ms-share-next-allowed-quota-downgrade-time |
Versione 2019-07-07 e successiva. 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 data è conforme a RFC 1123. |
x-ms-access-tier |
Versione 2019-12-12 e successive. Restituisce il livello di accesso corrente della condivisione. Negli account TransationOptimized di archiviazione per utilizzo generico versione 2 (GPv2) è il livello predefinito della condivisione. Nei tipi di Premium account di archiviazione FileStorage è 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 del livello, questa intestazione indica il livello da cui sta eseguendo la transizione. |
x-ms-lease-duration:<fixed,infinite> |
Versione 2020-02-10 e successive. Specifica se il lease in una condivisione è di durata fissa o infinita. |
x-ms-lease-state: <available;leased;expired;breaking;broken> |
Versione 2020-02-10 e successive. Quando una condivisione viene con lease, questa intestazione specifica lo stato del lease della condivisione. |
x-ms-lease-status: <locked;unlocked> |
Versione 2020-02-10 e successive. Quando una condivisione viene con lease, 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 schiacciamento della 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. |
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. |
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.
Commenti
Nessuno.