Ögonblicksbildsresurs
Från och med version 2017-04-17 Snapshot Share skapar åtgärden en skrivskyddad ögonblicksbild av en resurs.
Protokolltillgänglighet
| Aktiverat filresursprotokoll | Tillgängligt | Status |
|---|---|---|
| SMB |
|
Allmän tillgänglighet (GA) |
| NFS |
|
Allmän tillgänglighet (GA) |
Förfrågan
Du kan skapa begäran på Snapshot Share följande sätt. HTTPS rekommenderas.
| Metod | URI för förfrågan | HTTP-version |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot |
HTTP/1.1 |
Ersätt sökvägskomponenterna som visas i begärande-URI:n med dina egna, enligt följande:
| Sökvägskomponent | Description |
|---|---|
myaccount |
Namnet på ditt lagringskonto. |
myshare |
Namnet på filresursen. |
Mer information om namngivningsbegränsningar för sökvägar finns i Namnge och referera till resurser, kataloger, filer och metadata.
URI-parametrar
Du kan ange följande ytterligare parameter i begärande-URI:n.
| Parameter | Beskrivning |
|---|---|
timeout |
Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ställa in tidsgränser för Azure Files-åtgärder. |
Begärandehuvuden
I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.
| Begärandehuvud | Beskrivning |
|---|---|
Authorization |
Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage. |
Date eller x-ms-date |
Krävs. Anger UTC-tid (Coordinated Universal Time) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage. |
x-ms-version |
Krävs för alla auktoriserade begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage-tjänsterna. |
x-ms-meta-name:value |
Valfritt. Anger ett användardefinierat namn/värde-par som är associerat med resursögonblicksbilden. Om du inte anger några namn/värde-par kopierar åtgärden basresursmetadata till ögonblicksbilden. Om du anger ett eller flera namn/värde-par skapas resursögonblicksbilden med angivna metadata. I det här fallet kopieras inte metadata från basresursen. Metadatanamn måste följa namngivningsreglerna för C#-identifierare. |
x-ms-client-request-id |
Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggning har konfigurerats. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Blob Storage. |
Begärandetext
Inga.
Exempelbegäran
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=
Svarsåtgärder
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Statuskod
En lyckad åtgärd returnerar statuskoden 201 (skapad). Information om statuskoder finns i Status och felkoder.
Svarshuvuden
Svaret för den här åtgärden innehåller följande rubriker. Svaret kan även innehålla ytterligare STANDARD HTTP-huvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.
| Svarsrubrik | Description |
|---|---|
ETag |
Innehåller ett värde som representerar versionen av resursögonblicksbilden med citattecken. En resursögonblicksbild kan inte ändras, så ETag för en viss resursögonblicksbild ändras aldrig. Men om du har angett nya metadata med Snapshot Share begäran skiljer sig resursögonblicksbilden ETag från basresursens. Om du inte angav några metadata med begäran är resursögonblicksbilden ETag identisk med basresursens när resursögonblicksbilden togs. |
Last-Modified |
Returnerar datum och tid då resursen senast ändrades. Mer information finns i Representation of date-time values in headers (Representation av datum/tid-värden i rubriker). Det går inte att ändra en resursögonblicksbild, så den senaste ändringstiden för en viss resursögonblicksbild ändras aldrig. Men om du har angett nya metadata med Snapshot Share begäran skiljer sig den senaste ändrade tiden för resursögonblicksbilden från basresursens. Om du inte angav några metadata med begäran är den senast ändrade tiden för resursögonblicksbilden identisk med basresursens tidpunkt då resursögonblicksbilden togs. |
x-ms-request-id |
Identifierar den begäran som gjordes unikt och kan användas för att felsöka begäran. Mer information finns i Felsöka API-åtgärder. |
x-ms-version |
Anger vilken version av Azure Files som används för att köra begäran. |
Date eller x-ms-date |
Ett datum-/tidsvärde för UTC som anger den tid då svaret initierades. Tjänsten genererar det här värdet. |
x-ms-snapshot |
Ett DateTime värde som unikt identifierar resursögonblicksbilden. Du kan använda värdet för det här huvudet i efterföljande begäranden för att få åtkomst till resursögonblicksbilden. Det här värdet är ogenomskinlig. |
x-ms-client-request-id |
Kan användas för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet för x-ms-client-request-id huvudet, om det finns i begäran. Värdet är högst 1 024 synliga ASCII-tecken. Om rubriken x-ms-client-request-id inte finns i begäran finns den inte i svaret. |
Själva svaret
Inga.
Exempelsvar
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
Auktorisering
Endast kontoinnehavaren kan anropa den här åtgärden.
Kommentarer
Resursögonblicksbilder ger skrivskyddade versioner av resurser. När du har skapat en resursögonblicksbild kan du inte ändra den. En resursögonblicksbild är ett bekvämt sätt att skapa en konsekvent säkerhetskopia av alla filer på en resurs.
Varje gång du anropar Snapshot Share åtgärden skapas en ny resursögonblicksbild med ett unikt DateTime värde som identifierar resursögonblicksbilden i förhållande till dess basresurs. Du kan använda det här DateTime värdet för att utföra ytterligare åtgärder på resursögonblicksbilden och dess innehåll. Du bör behandla det här DateTime värdet som ogenomskinlig.
Värdet DateTime identifierar resursögonblicksbilden på begärande-URI:n. En fil på basresursen och dess ögonblicksbilder har till exempel URI:er som liknar följande exempel:
- Fil på resursen:
http://myaccount.file.core.windows.net/myshare/myfile - Fil på resursögonblicksbilden:
http://myaccount.file.core.windows.net/myshare/myfile?sharesnapshot=<DateTime>
En resurs kan stödja skapandet av 200 resursögonblicksbilder. Om du försöker skapa fler än 200 resursögonblicksbilder returnerar tjänsten felkoden 409 (konflikt). Om du försöker skapa en resursögonblicksbild medan en tidigare Snapshot Share åtgärd pågår returnerar tjänsten även felkod 409 (konflikt).
Befintliga resursögonblicksbilder skrivs aldrig över. De måste tas bort uttryckligen. Om du uttryckligen vill ta bort resursögonblicksbilder anropar du Ta bort resurs och anger x-ms-include-snapshots sidhuvudet, tillsammans med sharesnapshot frågeparametern, till lämpligt värde.
Du kan visa NFS-resursögonblicksbilder på en NFS-klient med hjälp av den virtuella ögonblicksbildkatalogen (.snapshot), som vanligtvis finns i roten på resursmonteringspunkten. Åtkomst till den här katalogen kan inaktiveras genom att ange x-ms-enable-snapshot-virtual-directory-access rubriken till false i API:et Ange resursegenskaper . Du kan också ange det här huvudet när resursen skapas som en del av åtgärden Skapa resurs .