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 dei percorsi, 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 di 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 1 kibibyte (KiB) registrato nei log al momento della configurazione della registrazione. È consigliabile usare questa intestazione per correlare le attività lato client alle richieste ricevute dal server. Per altre informazioni, vedere Monitorare 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 standard aggiuntive. 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 di condivisione, tra virgolette. Non è possibile modificare uno snapshot di condivisione, quindi l'oggetto ETag di uno snapshot di condivisione specifico non viene mai modificato. Tuttavia, se sono stati forniti nuovi metadati con la Snapshot Share richiesta, l'oggetto ETag dello snapshot di condivisione è diverso da quello della condivisione di base. Se non sono stati specificati metadati con la richiesta, l'oggetto ETag dello snapshot di condivisione è identico a quello della condivisione di base, al momento dell'acquisizione dello snapshot di condivisione. |
Last-Modified |
Restituisce la data e l'ora dell'ultima modifica apportata alla condivisione. Per altre informazioni, vedere Rappresentazione dei valori di data e ora nelle intestazioni. Non è possibile modificare uno snapshot di condivisione, quindi l'ora dell'ultima modifica di uno snapshot di condivisione specifico non cambia mai. Tuttavia, se sono stati forniti nuovi metadati con la Snapshot Share richiesta, l'ora dell'ultima modifica dello snapshot di condivisione è diversa da quella della condivisione di base. Se non sono stati specificati metadati con la richiesta, l'ora dell'ultima modifica dello snapshot di condivisione è identica a quella della condivisione di base, al momento dell'acquisizione dello snapshot di 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 utilizzata 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 di condivisione. Questo valore è opaco. |
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. 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.