Dela via


Ö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 Ja Allmän tillgänglighet (GA)
NFS Yes 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 .