Återställa container

  • Artikel

Åtgärden Restore Container återställer innehållet och egenskaperna för en mjukt borttagen container till en angiven container. Åtgärden Restore Container är tillgänglig i version 2019-12-12 och senare.

Förfrågan

Du kan skapa Restore Container begäran med hjälp av en giltig begäran, auktoriserad med hjälp av delad nyckel, signaturauktorisering för delad åtkomst för konto eller rollbaserad åtkomstkontroll.

Metod URI för förfrågan HTTP-version
PUT https://myaccount.blob.core.windows.net/destinationcontainer?restype=container&comp=undelete HTTP/1.1
PUT https://myaccount.blob.core.windows.net/destinationcontainer?restype=container&comp=undelete&sv=validsastoken HTTP/1.1

URI-parametrar

Du kan ange följande ytterligare parametrar för begärande-URI:n.

Parameter Beskrivning
restype Krävs. Parametervärdet restype måste vara container.
comp Krävs. Parametervärdet comp måste vara undelete.
timeout Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ställa in tidsgränser för Blob Storage-å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 or x-ms-date Krävs. Anger Coordinated Universal Time (UTC) 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. För den här åtgärden måste versionen vara 2018-03-28 eller senare. Mer information finns i Versionshantering för Azure Storage-tjänsterna.
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.
x-ms-deleted-container-name Krävs. Du använder det här huvudet för att unikt identifiera den mjukt borttagna container som ska återställas.
x-ms-deleted-container-version Krävs. Du använder det här huvudet för att unikt identifiera den mjukt borttagna container som ska återställas. Du kan hämta det här värdet från att deleted ange värdet i include frågeparametern för List Containers åtgärden. Mer information finns i Listcontainrar.

Begärandetext

Inga.

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
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 Version 2009-09-19 och senare. Anger vilken version av Azure Blob Storage som används för att köra begäran.
Date Ett datum-/tidsvärde för UTC som anger den tid då svaret initierades. Tjänsten genererar det här värdet.
Content-Length Längden på begärandetexten. För den här åtgärden är innehållslängden alltid noll.

Själva svaret

Inga.

Exempelsvar

Response Status:  
HTTP/1.1 201 OK  
  
Response Headers:  
Date: Mon, 15 Jun 2020 12:43:08 GMT  
x-ms-version: 2019-12-12  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
Content-Length: 0

Auktorisering

Auktorisering krävs när du anropar en dataåtkomståtgärd i Azure Storage. Du kan auktorisera åtgärden Restore Container enligt beskrivningen i följande avsnitt.

Azure Storage stöder användning av Microsoft Entra ID för att auktorisera begäranden till blobdata. Med Microsoft Entra ID kan du använda rollbaserad åtkomstkontroll i Azure (Azure RBAC) för att bevilja behörigheter till ett säkerhetsobjekt. Säkerhetsobjektet kan vara en användare, grupp, programtjänstens huvudnamn eller en hanterad Azure-identitet. Säkerhetsobjektet autentiseras av Microsoft Entra ID för att returnera en OAuth 2.0-token. Token kan sedan användas för att auktorisera en begäran mot Blob Storage.

Mer information om auktorisering med hjälp av Microsoft Entra ID finns i Auktorisera åtkomst till blobar med hjälp av Microsoft Entra ID.

Behörigheter

Följande RBAC-åtgärder krävs för att en Microsoft Entra användare, grupp eller tjänstens huvudnamn ska anropa Restore Container åtgärden och den minst privilegierade inbyggda Azure RBAC-rollen som innehåller den här åtgärden:

Mer information om hur du tilldelar roller med hjälp av Azure RBAC finns i Tilldela en Azure-roll för åtkomst till blobdata.

Kommentarer

  • Du kan ange kvarhållningsprincipen för containerborttagning på kontot med hjälp av lagringsresursprovidern.
  • Den angivna containern får inte finnas när åtgärden Restore Container utförs.
  • Om den angivna containern finns misslyckas åtgärden Restore Container med 409 (konflikt).
  • Om den mjukt borttagna containern inte finns, redan har använts som källa för en Restore Container åtgärd eller har överskridit kvarhållningsdagarna misslyckas åtgärden med 409 (konflikt).

Fakturering

Prisbegäranden kan komma från klienter som använder Blob Storage-API:er, antingen direkt via REST-API:et för Blob Storage eller från ett Azure Storage-klientbibliotek. Dessa begäranden ackumulerar avgifter per transaktion. Typen av transaktion påverkar hur kontot debiteras. Lästransaktioner till exempel tillfaller en annan faktureringskategori än skrivtransaktioner. I följande tabell visas faktureringskategorin för Restore Container begäranden baserat på lagringskontotypen:

Åtgärd Typ av lagringskonto Faktureringskategori
Återställningscontainer Premium-blockblob
Standard generell användning v2
Standard generell användning v1		 Lista och skapa containeråtgärder

Mer information om priser för den angivna faktureringskategorin finns i Azure Blob Storage Prissättning.