Momentopnameshare
Vanaf versie 2017-04-17 maakt de Snapshot Share bewerking een alleen-lezen momentopname van een share.
Protocol beschikbaarheid
| Bestandsshareprotocol ingeschakeld | Beschikbaar | Status |
|---|---|---|
| SMB |  |
Algemene beschikbaarheid |
| NFS | |
Algemene beschikbaarheid |
Aanvraag
U kunt de Snapshot Share aanvraag als volgt samenstellen. HTTPS wordt aanbevolen.
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot |
HTTP/1.1 |
Vervang de padonderdelen die in de aanvraag-URI worden weergegeven, als volgt door uw eigen:
| Padonderdeel | Description |
|---|---|
myaccount |
De naam van uw opslagaccount. |
myshare |
De naam van de bestandsshare. |
Zie Shares, mappen, bestanden en metagegevens een naam geven en hiernaar verwijzen voor meer informatie over beperkingen voor padnamen.
URI-parameters
U kunt de volgende extra parameter opgeven voor de aanvraag-URI.
| Parameter | Beschrijving |
|---|---|
timeout |
Optioneel. De timeout parameter wordt uitgedrukt in seconden. Zie Time-outs instellen voor Azure Files bewerkingen voor meer informatie. |
Aanvraagheaders
In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven.
| Aanvraagheader | Beschrijving |
|---|---|
Authorization |
Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie. |
Date of x-ms-date |
Vereist. Hiermee geeft u de UTC-tijd (Coordinated Universal Time) voor de aanvraag op. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie. |
x-ms-version |
Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-services voor meer informatie. |
x-ms-meta-name:value |
Optioneel. Hiermee geeft u een door de gebruiker gedefinieerd, naam-waardepaar, gekoppeld aan de momentopname van de share. Als u geen naam-waardeparen opgeeft, kopieert de bewerking de metagegevens van de basisshare naar de momentopname. Als u een of meer naam-waardeparen opgeeft, wordt de momentopname van de share gemaakt met de opgegeven metagegevens. In dit geval worden metagegevens niet gekopieerd van de basisshare. Namen van metagegevens moeten voldoen aan de naamgevingsregels voor C#-id's. |
x-ms-client-request-id |
Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 kibibyte (KiB) die wordt vastgelegd in de logboeken wanneer logboekregistratie wordt geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Zie Azure Blob Storage bewaken voor meer informatie. |
Aanvraagbody
Geen.
Voorbeeldaanvraag
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=
Antwoord
Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.
Statuscode
Een geslaagde bewerking retourneert statuscode 201 (gemaakt). Zie Status- en foutcodes voor meer informatie over statuscodes.
Antwoordheaders
Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook extra, standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.
| Antwoordheader | Description |
|---|---|
ETag |
Bevat een waarde die de versie van de momentopname van de share vertegenwoordigt, tussen aanhalingstekens. Een momentopname van een share kan niet worden gewijzigd, zodat de ETag van een bepaalde momentopname van een share nooit verandert. Als u echter nieuwe metagegevens hebt opgegeven bij de Snapshot Share aanvraag, wijkt de ETag van de momentopname van de share af van die van de basisshare. Als u geen metagegevens bij de aanvraag hebt opgegeven, is de ETag momentopname van de share identiek aan die van de basisshare op het moment dat de momentopname van de share is gemaakt. |
Last-Modified |
Retourneert de datum en tijd waarop de share voor het laatst is gewijzigd. Zie Weergave van datum-tijdwaarden in kopteksten voor meer informatie. Een momentopname van een share kan niet worden gewijzigd, zodat de laatste wijzigingstijd van een bepaalde momentopname van een share nooit verandert. Als u echter nieuwe metagegevens hebt opgegeven bij de Snapshot Share aanvraag, wijkt de laatste wijzigingstijd van de momentopname van de share af van die van de basisshare. Als u geen metagegevens bij de aanvraag hebt opgegeven, is de laatste wijzigingstijd van de momentopname van de share identiek aan die van de basisshare, op het moment dat de momentopname van de share is gemaakt. |
x-ms-request-id |
Uniek identificeert de aanvraag die is gedaan en kan worden gebruikt voor het oplossen van problemen met de aanvraag. Zie Problemen met API-bewerkingen oplossen voor meer informatie. |
x-ms-version |
Geeft de versie van Azure Files gebruikt om de aanvraag uit te voeren. |
Date of x-ms-date |
Een UTC-datum/tijd-waarde die de tijd aangeeft waarop het antwoord is gestart. De service genereert deze waarde. |
x-ms-snapshot |
Een DateTime waarde die de momentopname van de share uniek identificeert. U kunt de waarde van deze header gebruiken in volgende aanvragen voor toegang tot de momentopname van de share. Deze waarde is ondoorzichtig. |
x-ms-client-request-id |
Kan worden gebruikt om problemen met aanvragen en bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de x-ms-client-request-id header, als deze aanwezig is in de aanvraag. De waarde is maximaal 1024 zichtbare ASCII-tekens. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze niet aanwezig in het antwoord. |
Hoofdtekst van de reactie
Geen.
Voorbeeldantwoord
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
Autorisatie
Alleen de accounteigenaar kan deze bewerking aanroepen.
Opmerkingen
Momentopnamen van delen bieden alleen-lezen versies van shares. Nadat u een momentopname van een share hebt gemaakt, kunt u deze niet meer wijzigen. Een momentopname van een share biedt een handige manier om een consistente back-up te maken van alle bestanden op een share.
Telkens wanneer u de Snapshot Share bewerking aanroept, wordt er een momentopname van een nieuwe share gemaakt, met een unieke DateTime waarde die de momentopname van de share identificeert ten opzichte van de basisshare. U kunt deze DateTime waarde gebruiken om verdere bewerkingen uit te voeren op de momentopname van de share en de inhoud ervan. U moet deze DateTime waarde als ondoorzichtig beschouwen.
De DateTime waarde identificeert de momentopname van de share op de aanvraag-URI. Een bestand op de basisshare en de momentopnamen hebben bijvoorbeeld URI's die vergelijkbaar zijn met de volgende voorbeelden:
- Bestand op de share:
http://myaccount.file.core.windows.net/myshare/myfile - Bestand op de momentopname van de share:
http://myaccount.file.core.windows.net/myshare/myfile?sharesnapshot=<DateTime>
Een share kan het maken van 200 momentopnamen van shares ondersteunen. Als u meer dan 200 momentopnamen van shares probeert te maken, retourneert de service foutcode 409 (Conflict). Als u probeert een momentopname van een share te maken terwijl een eerdere Snapshot Share bewerking wordt uitgevoerd, retourneert de service ook foutcode 409 (conflict).
Bestaande share-momentopnamen worden nooit overschreven. Ze moeten expliciet worden verwijderd. Als u momentopnamen van shares expliciet wilt verwijderen, roept u Share verwijderen aan en stelt u de x-ms-include-snapshots header samen met de sharesnapshot queryparameter in op de juiste waarde.