Przywróć kontener

Operacja przywraca Restore Container zawartość i właściwości miękko usuniętego kontenera do określonego kontenera. Operacja ta Restore Container jest dostępna w wersji 2019-12-12 i nowszych.

Request

Możesz zbudować Restore Container żądanie, używając prawidłowego żądania, autoryzowanego za pomocą wspólnego klucza, autoryzacji podpisu współudostępnionego konta lub kontroli dostępu opartej na rolach.

Metoda Żądanie URI Wersja protokołu HTTP
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

Parametry identyfikatora URI

Możesz określić następujące dodatkowe parametry dla identyfikatora URI żądania.

Parametr Description
restype Required. Wartość parametru restype musi być .container
comp Required. Wartość parametru comp musi być .undelete
timeout Optional. Parametr timeout jest wyrażony w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji usługi Blob Storage.

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.

Nagłówek żądania Description
Authorization Required. Określa schemat autoryzacji, nazwę konta i podpis. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
Date or x-ms-date Required. Określa uniwersalny czas koordynowany (UTC) dla żądania. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
x-ms-version Wymagane dla wszystkich autoryzowanych żądań. Określa wersję operacji do użycia dla tego żądania. Do tej operacji wersja musi być lub nowsza 2018-03-28 . Aby uzyskać więcej informacji, zobacz Przechowywanie wersji usług Azure Storage.
x-ms-client-request-id Optional. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB), który jest rejestrowany w dziennikach podczas konfigurowania rejestrowania. Zdecydowanie zalecamy używanie tego nagłówka do korelowania działań po stronie klienta z żądaniami odbieranymi przez serwer. Aby uzyskać więcej informacji, zobacz Monitor Azure Blob Storage.
x-ms-deleted-container-name Required. Używasz tego nagłówka, aby jednoznacznie zidentyfikować miękko usunięty kontener, który powinien zostać przywrócony.
x-ms-deleted-container-version Required. Używasz tego nagłówka, aby jednoznacznie zidentyfikować miękko usunięty kontener, który powinien zostać przywrócony. Można uzyskać tę wartość, określając ją deleted w parametrze include zapytania operacji List Containers . Więcej informacji można znaleźć w sekcji Lista Kontenerów.

Treść żądania

None.

Response

Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.

Kod stanu

Pomyślna operacja zwraca kod stanu 201 (Utworzono). Aby uzyskać informacje o kodach stanu, zobacz Stan i kody błędów.

Nagłówki odpowiedzi

Odpowiedź dla tej operacji zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe, standardowe nagłówki HTTP. Wszystkie standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1 .

Nagłówek odpowiedzi Description
x-ms-request-id Unikalnie identyfikuje złożone żądanie i może być użyty do jego rozwiązywania problemów. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z operacjami interfejsu API.
x-ms-version Wersja 2009-09-19 i nowsze. Wskazuje wersję Azure Blob Storage użytej do uruchomienia żądania.
Date Wartość daty/godziny UTC wskazująca godzinę, o której zainicjowano odpowiedź. Usługa generuje tę wartość.
Content-Length Długość treści żądania. Dla tej operacji długość zawartości jest zawsze zerowa.

Treść odpowiedzi

None.

Przykładowa odpowiedź

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

Authorization

Autoryzacja jest wymagana, gdy wywołujesz dowolną operację dostępu do danych w Azure Storage. Możesz autoryzować operację Restore Container zgodnie z opisaniem w poniższych sekcjach.

Important

Firma Microsoft zaleca używanie identyfikatora Entra firmy Microsoft z tożsamościami zarządzanymi w celu autoryzowania żądań do usługi Azure Storage. Identyfikator Entra firmy Microsoft zapewnia lepsze zabezpieczenia i łatwość użycia w porównaniu z autoryzacją klucza współdzielonego.

Usługa Azure Storage obsługuje używanie Microsoft Entra ID do autoryzacji żądań do danych blob. Za pomocą identyfikatora Entra firmy Microsoft możesz użyć kontroli dostępu opartej na rolach (RBAC) platformy Azure, aby udzielić uprawnień podmiotowi zabezpieczeń. Zasadą bezpieczeństwa może być użytkownik, grupa, główny element usługi aplikacji lub zarządzana tożsamość Azure. Podmiot zabezpieczeń jest uwierzytelniany przez Microsoft Entra ID, aby zwrócić token OAuth 2.0. Token może być następnie użyty do autoryzacji żądania przeciwko Blob Storage.

Aby dowiedzieć się więcej o autoryzacji za pomocą Microsoft Entra ID, zobacz Autoryzuj dostęp do blobów za pomocą Microsoft Entra ID.

Uprawnienia

Następujące działania RBAC są konieczne, aby użytkownik, grupa, zarządzana tożsamość lub podmiot usługi Microsoft Entra wywołały operacjęRestore Container, a także najmniej uprzywilejowana wbudowana rola Azure RBAC, która obejmuje tę akcję:

Aby dowiedzieć się więcej o przypisywaniu ról za pomocą Azure RBAC, zobacz Assign an Azure role, aby uzyskać dostęp do danych blob.

Remarks

  • Możesz ustawić politykę retencji usuwania kontenerów na koncie, korzystając z dostawcy zasobów magazynowych.
  • Określony pojemnik nie może istnieć w momencie wykonania operacji Restore Container .
  • Jeśli określony kontener istnieje, operacja zakończy Restore Container się niepowodzeniem z 409 (Konflikt).
  • Jeśli kontener miękko usunięty nie istnieje, został już użyty jako źródło operacji Restore Container lub przekroczył swoje dni retencyjne, operacja zakończy się niepowodzeniem z powodu 409 (Konflikt).

Billing

Żądania cen mogą pochodzić od klientów korzystających z interfejsów API usługi Blob Storage bezpośrednio za pośrednictwem interfejsu API REST usługi Blob Storage lub z biblioteki klienta usługi Azure Storage. Te żądania naliczają opłaty za transakcję. Typ transakcji wpływa na sposób naliczania opłat za konto. Na przykład transakcje odczytu są naliczane do innej kategorii rozliczeniowej niż transakcje zapisu. W poniższej tabeli przedstawiono kategorię rozliczeń dla żądań Restore Container na podstawie typu konta magazynu:

Operation Typ konta magazynowania Kategoria rozliczeń
Przywróć kontener Obiekt typu blob Premium
Standard ogólnego przeznaczenia wersja 2
Standard o ogólnym przeznaczeniu V1		 Wyświetlanie listy i tworzenie operacji kontenera

Aby dowiedzieć się więcej o cenach dla określonej kategorii rozliczeń, zobacz Cennik usługi Azure Blob Storage.

  • Ostatnia aktualizacja o