Ustawianie warstwy obiektu blob

Operacja Set Blob Tier ustawia warstwę dostępu w obiekcie blob. Operacja jest dozwolona na stronicowym obiekcie blob na koncie usługi Premium Storage i na blokowym obiekcie blob w magazynie obiektów blob lub na koncie ogólnego przeznaczenia w wersji 2. Warstwa stronicowego obiektu blob w warstwie Premium (P1, P2, P3, P4 itd.) określa dozwolony rozmiar, operacje wejściowe/wyjściowe na sekundę i przepustowość obiektu blob. Warstwa blokowego obiektu blob określa Hottyp magazynu , Cool, Coldlub Archive . Ta operacja nie aktualizuje elementu ETag obiektu blob.

Uwaga

Warstwa Cold jest obecnie dostępna w wersji zapoznawczej.

Aby uzyskać szczegółowe informacje na temat warstw na poziomie blokowych obiektów blob, zobacz Warstwy magazynowania Gorąca, Chłodna i Archiwum.

Żądanie

Żądanie można skonstruować Set Blob Tier w następujący sposób. Zalecamy używanie protokołu HTTPS. Zastąp ciąg myaccount nazwą konta magazynu i zastąp ciąg myblob nazwą obiektu blob , dla którego warstwa ma zostać zmieniona.

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tier HTTP/1.1

Parametry identyfikatora URI

W identyfikatorze URI żądania można określić następujące dodatkowe parametry:

Parametr Opis
snapshot Opcjonalny. Parametr migawki jest nieprzezroczystą DateTime wartością, która w chwili obecnej określa migawkę obiektu blob w celu ustawienia warstwy. Aby uzyskać więcej informacji na temat pracy z migawkami obiektów blob, zobacz Tworzenie migawki obiektu blob
versionid Opcjonalnie dla wersji 2019-12-12 lub nowszej. Parametr versionid jest nieprzezroczystą DateTime wartością określającą wersję obiektu blob w celu ustawienia warstwy.
timeout Opcjonalny. Parametr jest wyrażony timeout w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji usługi Blob Storage.

Nagłówki żądań

Wymagane i opcjonalne nagłówki żądań opisano w poniższej tabeli:

Nagłówek żądania Opis
Authorization Wymagane. Określa schemat autoryzacji, nazwę konta magazynu i podpis. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
Date lub x-ms-date Wymagane. Określa dla żądania godzinę w formacie uniwersalnego czasu koordynowanego (UTC). Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
x-ms-access-tier Wymagane. Wskazuje warstwę, która ma zostać ustawiona na obiekcie blob. Aby uzyskać listę dozwolonych warstw stronicowych obiektów blob w warstwie Premium, zobacz Magazyn w warstwie Premium o wysokiej wydajności i dyski zarządzane dla maszyn wirtualnych. W przypadku konta magazynu obiektów blob lub ogólnego przeznaczenia w wersji 2 prawidłowe wartości to Hot, , Coollub archiveCold. Uwaga: warstwa Cold jest obecnie dostępna w wersji zapoznawczej i jest obsługiwana w wersji 2021-12-02 lub nowszej. Aby uzyskać szczegółowe informacje o warstwach warstwowych na poziomie konta obiektów blob na koncie obiektów blob, zobacz Warstwy magazynowania Gorąca, Chłodna i Archiwum.
x-ms-version Wymagane dla wszystkich autoryzowanych żądań. Określa wersję operacji do użycia dla tego żądania. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji usług Azure Storage.
x-ms-client-request-id Opcjonalny. Udostępnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB), który jest rejestrowany w dziennikach po włączeniu 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 Informacje o rejestrowaniu analityka magazynu.
x-ms-rehydrate-priority Opcjonalny. Wskazuje priorytet, za pomocą którego należy ponownie uzupełnić zarchiwizowany obiekt blob. Obsługiwane w wersji 2019-02-02 i nowszej dla blokowych obiektów blob. Prawidłowe wartości to High lub Standard. Priorytet można ustawić na obiekcie blob tylko raz dla wersji starszych niż 2020-06-12; ten nagłówek jest ignorowany w kolejnych żądaniach. Domyślnym ustawieniem priorytetu jest Standard.

Od wersji 2020-06-12 można zaktualizować priorytet ponownego wypełniania po jego ustawieniu. Ustawienie priorytetu można zmienić z Standard na High , wywołując polecenie Ustaw warstwę obiektu blob, z tym nagłówkiem ustawionym na High i przez ustawienie x-ms-access-tier na tę samą wartość, do której została wcześniej ustawiona. Nie można obniżyć ustawienia priorytetu z High do Standard.

Ta operacja obsługuje również użycie nagłówków warunkowych do warstwy obiektu blob tylko wtedy, gdy zostanie spełniony określony warunek. Aby uzyskać więcej informacji, zobacz Określanie nagłówków warunkowych dla operacji usługi Blob Storage.

Treść żądania

Brak.

Reakcja

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

Kod stanu

Operacja zakończona powodzeniem zwraca kod stanu 200 (OK), jeśli nowa warstwa zostanie natychmiast w życie lub kod stanu 202 (zaakceptowany), jeśli przejście do nowej warstwy jest oczekujące.

W przypadku kont magazynu w warstwie Premium operacja stronicowego obiektu blob zwraca kod stanu 200 (OK).

W przypadku blokowych obiektów blob zwracane są kody stanu HTTP oparte na bieżących i żądanych warstwach obiektu blob, opisano w poniższej tabeli:

Warstwa Ustaw na warstwę Gorąca Ustaw na warstwę Chłodna Ustaw na warstwę chłodną Ustaw na warstwę archiwum
Obiekt blob w warstwie Gorąca 200 200 200 200
Obiekt blob w warstwie Chłodna 200 200 200 200
Obiekt blob w warstwie zimnej 200 200 200 200
Obiekt blob w warstwie archiwum 202 202 202 200
Obiekt blob w warstwie archiwum, ponowne wypełnianie do warstwy gorąca 202 409 409 409
Obiekt blob w warstwie archiwum, wypełnianie do warstwy Chłodna 409 202 409 409
Obiekt blob w warstwie archiwum, przywracany do zimnego 409 409 202 409

Aby uzyskać więcej informacji na temat kodów stanu, zobacz Kody stanu i błędów.

Nagłówki odpowiedzi

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

Nagłówek odpowiedzi Opis
x-ms-request-id Jednoznacznie identyfikuje wykonane żądanie i może służyć do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z operacjami interfejsu API.
x-ms-version Wersja usługi Blob Storage, która została użyta do wykonania żądania. Ten nagłówek jest zwracany dla żądań wysyłanych w wersji 2009-09-19 lub nowszej.
x-ms-client-request-id Może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi im odpowiedziami. Wartość tego nagłówka jest równa wartości x-ms-client-request-id nagłówka, jeśli znajduje się w żądaniu, a wartość nie zawiera więcej niż 1024 widocznych znaków ASCII. x-ms-client-request-id Jeśli nagłówek nie znajduje się w żądaniu, nie będzie on obecny w odpowiedzi.

Autoryzacja

Ta operacja może być wywoływana tylko przez właściciela konta magazynu i przez każdego, kto ma sygnaturę dostępu współdzielonego z uprawnieniami do zapisu w tym obiekcie blob lub jego kontenerze.

Uwagi

Ustawienie warstwy obiektu blob dla stronicowych obiektów blob na kontach Premium ma następujące ograniczenia:

Ustawienie warstwy blokowego obiektu blob na koncie usługi Blob Storage lub ogólnego przeznaczenia w wersji 2 ma następujące ograniczenia:

  • Ustawienie warstwy migawki jest dozwolone w wersji REST 2019-12-12.
  • Migawki warstwowe, które archive nie mogą być ponownie wypełnianie do migawki. Oznacza to, że migawka nie może zostać przywrócona do hot warstwy lub cool . Jedynym sposobem pobrania danych z archive migawki lub wersji jest skopiowanie ich do nowego obiektu blob.
  • Jeśli wersja jest głównym obiektem blob, można go ponownie uzupełnić do hot lub cool.
  • Migawki lub wersje w archive stanie nie mogą być promowane do katalogu głównego.
  • Po włączeniu obsługi wersji usunięcie głównego obiektu blob, gdy znajduje się w stanie oczekiwania na ponowne wypełnianie, spowoduje anulowanie ponownego wypełniania, a wersja będzie w archive stanie .
  • Jeśli obiekt blob zostanie zastąpiony, gdy znajduje się w stanie oczekiwania na ponowne wypełnianie i usuwanie nietrwałe, spowoduje to anulowanie ponownego wypełniania, a wersja migawki usuniętej nietrwale będzie w archive stanie.

Lista obsługiwanych warstw nie jest ograniczona przez wersję żądania, a w przyszłości można dodać nowe warstwy.

Uwaga

Aby uzyskać szczegółowe informacje na temat warstw na poziomie blokowych obiektów blob, zobacz Warstwy magazynowania Gorąca, Chłodna i Archiwum.

Zobacz też

Autoryzowanie żądań do usługi Azure Storage
Kody stanu i błędów
Kody błędów usługi Blob Storage
Ustawianie limitów czasu dla operacji usługi Blob Storage