condivisione snapshot
A partire dalla versione 2017-04-17, l'operazione Snapshot Share crea uno snapshot di sola lettura di una condivisione.
Disponibilità del protocollo
| Protocollo di condivisione file abilitato | Disponibile | Stato |
|---|---|---|
| SMB |
|
GA |
| NFS |
|
GA |
Richiesta
È possibile costruire la Snapshot Share richiesta come indicato di seguito. È consigliato il protocollo HTTPS.
| Metodo | URI richiesta | Versione HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot |
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 dettagliate sulle restrizioni di denominazione del percorso, vedere Denominazione e riferimento a condivisioni, directory, file e metadati.
Parametri URI
È possibile specificare il parametro aggiuntivo seguente nell'URI della richiesta.
| Parametro | Descrizione |
|---|---|
timeout |
Facoltativa. Il parametro timeout viene espresso in secondi. Per altre informazioni, vedere Impostazione dei timeout per le operazioni di File di Azure. |
Intestazioni della richiesta
Nella seguente tabella 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 usare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure. |
x-ms-meta-name:value |
facoltativo. Specifica una coppia nome-valore definita dall'utente associata allo snapshot della condivisione. Se non si specificano coppie nome-valore, l'operazione copia i metadati della condivisione di base nello snapshot. Se si specificano una o più coppie nome-valore, lo snapshot di condivisione viene creato con i metadati specificati. In questo caso, i metadati non vengono copiati dalla condivisione di base. I nomi dei metadati devono rispettare le regole di denominazione per gli identificatori C#. |
x-ms-client-request-id |
facoltativo. Fornisce un valore opaco generato dal client con un limite di caratteri 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 l'archiviazione BLOB di Azure. |
Testo della richiesta
Nessuno.
Richiesta di esempio
Request Syntax:
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot HTTP/1.1
Request Headers:
x-ms-version: 2017-04-17
x-ms-date: Mon, 10 May 2017 22:50:32 GMT
x-ms-meta-Name: StorageSample
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
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 il codice di stato 201 (Creato). Per 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; La risposta può includere anche intestazioni HTTP aggiuntive e standard. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.
| Intestazione risposta | Descrizione |
|---|---|
ETag |
Contiene un valore che rappresenta la versione dello snapshot della condivisione, nelle virgolette. Non è possibile modificare uno snapshot di condivisione, quindi l'oggetto ETag di uno snapshot di condivisione specifico non cambia mai. Tuttavia, se sono stati forniti nuovi metadati con la Snapshot Share richiesta, lo ETag snapshot della condivisione differisce da quello della condivisione di base. Se non è stato specificato alcun metadato con la richiesta, lo ETag snapshot della condivisione è identico a quello della condivisione di base, al momento dell'acquisizione dello snapshot della condivisione. |
Last-Modified |
Restituisce la data e l'ora dell'ultima modifica apportata alla condivisione. Per altre informazioni, vedere Rappresentazione dei valori data-ora nelle intestazioni. Non è possibile modificare uno snapshot di condivisione, quindi l'ultima volta modificata di uno snapshot di condivisione specifico non cambia mai. Tuttavia, se sono stati forniti nuovi metadati con la richiesta, l'ultima Snapshot Share volta modificata dello snapshot di condivisione differisce da quella della condivisione di base. Se non è stato specificato alcun metadato con la richiesta, l'ultima volta modificata dello snapshot della condivisione è identica a quella della condivisione di base, al momento in cui è stato eseguito lo snapshot della condivisione. |
x-ms-request-id |
Identifica in modo univoco la richiesta effettuata e può essere usata per la risoluzione dei problemi della richiesta. Per altre informazioni, vedere Risoluzione dei 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 è stata avviata la risposta. Il servizio genera questo valore. |
x-ms-snapshot |
Valore DateTime che identifica in modo univoco lo snapshot della condivisione. È possibile usare il valore di questa intestazione nelle richieste successive per accedere allo snapshot della condivisione. Questo valore è opaco. |
x-ms-client-request-id |
Può essere usato per risolvere le richieste e le risposte corrispondenti. Il valore di questa intestazione è uguale al valore dell'intestazione x-ms-client-request-id , se presente nella richiesta. Il valore è al massimo 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 201 Created
Response Headers:
Content-Length: 0
Date: Mon, 10 May 2017 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 10 May 2017 23:00:06 GMT
x-ms-version: 2017-04-17
x-ms-snapshot: 2017-05-10T17:52:33.9551861Z
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Autorizzazione
Solo il proprietario dell'account può chiamare questa operazione.
Commenti
Gli snapshot di condivisione forniscono versioni di sola lettura delle condivisioni. Dopo aver creato uno snapshot di condivisione, non è possibile modificarlo. Uno snapshot di condivisione offre un modo pratico per creare un backup coerente di tutti i file in una condivisione.
Ogni volta che si chiama l'operazione Snapshot Share , viene creato un nuovo snapshot di condivisione, con un valore univoco DateTime che identifica lo snapshot di condivisione rispetto alla condivisione di base. È possibile usare questo DateTime valore per eseguire altre operazioni sullo snapshot di condivisione e sul relativo contenuto. È consigliabile considerare questo DateTime valore come opaco.
Il DateTime valore identifica lo snapshot di condivisione nell'URI della richiesta. Ad esempio, un file nella condivisione di base e i relativi snapshot hanno URI simili agli esempi seguenti:
- File nella condivisione:
http://myaccount.file.core.windows.net/myshare/myfile - File nello snapshot di condivisione:
http://myaccount.file.core.windows.net/myshare/myfile?sharesnapshot=<DateTime>
Una condivisione può supportare la creazione di 200 snapshot di condivisione. Se si tenta di creare più di 200 snapshot di condivisione, il servizio restituisce il codice di errore 409 (Conflitto). Se si tenta di creare uno snapshot di condivisione mentre è in corso un'operazione precedente Snapshot Share , il servizio restituisce anche il codice di errore 409 (Conflitto).
Gli snapshot di condivisione esistenti non vengono mai sovrascritti. Devono essere eliminati in modo esplicito. Per eliminare in modo esplicito gli snapshot di condivisione, chiamare Elimina condivisione e impostare l'intestazione x-ms-include-snapshots , insieme sharesnapshot al parametro di query, sul valore appropriato.
È possibile visualizzare gli snapshot di condivisione NFS in un client NFS usando la directory virtuale snapshot (con estensione snapshot), che in genere si trova nella radice del punto di montaggio della condivisione. L'accesso a questa directory può essere disabilitato impostando l'intestazione x-ms-enable-snapshot-virtual-directory-access su false nell'API Imposta proprietà condivisione . È anche possibile impostare questa intestazione al momento della creazione della condivisione come parte dell'operazione Crea condivisione .