Å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.