Återställ resurs

Åtgärden Restore Share återställer (eller tar bort) en resurs som tidigare hade tagits bort mjukt. Det här API:et stöds fullt ut, men det är ett äldre hanterings-API. Använd i stället Filresurser – Återställning som tillhandahålls av lagringsresursprovidern (Microsoft.Storage). Mer information om hur du interagerar programmatiskt med resurser med FileShare hjälp av lagringsresursprovidern finns i Åtgärder på FileShares.

Resursen återställs tillsammans med alla dess data, metadata och ögonblicksbilder. Resursresursen innehåller metadata och egenskaper för resursen.

Protokolltillgänglighet

Aktiverat filresursprotokoll	Tillgängligt
SMB
NFS

Förfrågan

Du kan skapa begäran på Restore Share följande sätt. HTTPS rekommenderas.

Metod	URI för förfrågan	HTTP-version
PUT	https://myaccount.file.core.windows.net/restoredShareName?restype=share&comp=undelete	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.
restoredShareName	Namnet som ska användas för den återställde resursen. Om det redan finns en resurs med det här namnet misslyckas åtgärden.

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. Tidsgränsparametern uttrycks i sekunder. Mer information finns i Ange tidsgränser för Azure Files åtgärder.

Begärandehuvuden

I följande tabell beskrivs nödvändiga och valfria begärandehuvuden.

Begärandehuvud	Beskrivning
Authorization	Krävs. Anger autentiseringsschema, kontonamn och signatur. Mer information finns i Autentisering för Azure Storage-tjänsterna.
x-ms-date	Krävs. Anger utc-tiden (Coordinated Universal Time) för begäran. Mer information finns i Autentisering för Azure Storage-tjänsterna.
x-ms-version	Krävs för alla autentiserade 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-deleted-share-name	Krävs. Identifierar den mjukt borttagna filresursen som ska återställas. Det här värdet måste matcha värdet restoredShareNameför .
x-ms-deleted-share-version	Krävs. Identifierar unikt den mjukt borttagna filresursen efter dess version.
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 loggningen 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

PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=undelete HTTP/1.1   

Request Headers:  
x-ms-version: 2019-12-12   
x-ms-deleted-share-name: myshare 
x-ms-deleted-share-version: 01D2AC0C18EDFE36   
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). Om målfilresursens namn används av en giltig icke-borttagen filresurs misslyckas begäran med 409 (konflikt). Om källfilresursen inte har tagits bort mjukt, redan har återställts eller om källfilresursen har passerat kvarhållningsperioden och har upphört att gälla misslyckas begäran med 404 (hittades inte).

Information om statuskoder finns i Status och felkoder.

Svarshuvuden

Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också 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 resursens version med citattecken.
Last-Modified	Returnerar datum och tid då resursen senast ändrades. Mer information finns i Representation of date-time Values in headers (Representation av datum-tidsvärden i sidhuvuden). Alla åtgärder som ändrar resursen, dess egenskaper eller metadata, uppdaterar den senaste ändrade tiden. Åtgärder på filer påverkar inte resursens senast ändrade tid.
x-ms-request-id	Identifierar unikt den begäran som gjordes 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	Ett UTC-datum/tid-värde som anger den tid då svaret initierades. Tjänsten genererar det här värdet.
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 header, om det finns i begäran. Värdet är högst 1 024 synliga ASCII-tecken. x-ms-client-request-id header Om inte finns i begäran visas den inte i svaret.

Själva svaret

Inga.

Exempelsvar

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
x-ms-request-id: 78c46801-f01a-0089-31fb-486017000000 
x-ms-version: 2019-12-12   
Content-Length: 0 
Date: <date>   
ETag: "0x8CB14C3E29B7E82"   
Last-Modified: <date>   
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0 

Auktorisering

Lagringskontoägaren kan anropa den här åtgärden. Dessutom kan användare med giltiga signaturtoken för delad åtkomst för kontot anropa den här åtgärden. Token måste innehålla skrivbehörigheter för containerresursen för att kunna auktorisera den här åtgärden.

Kommentarer

Du kan inte återställa en resurs till ett annat namn. När du återställer en resurs misslyckas åtgärden med statuskod 409 (konflikt) om en annan resurs finns med samma namn. Resursen med samma namn måste först tas bort innan den mjukt borttagna resursen kan tas bort.

När en resurs tas bort kan en resurs med samma namn inte återställas på minst 30 sekunder. När resursen tas bort misslyckas försök att återställa en resurs med samma namn med statuskoden 409 (konflikt). Tjänsten returnerar ytterligare felinformation som anger att resursen tas bort.

Se även

Åtgärder på resurser (Azure Files)