Ustawianie warstwy obiektu blob

Artykuł
02/02/2023
Czas czytania: 6 min

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`, , `Cool`lub `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:

Nowa warstwa obiektu blob nie może być niższa niż istniejąca.
Nowa warstwa obiektu blob powinna być w stanie pomieścić długość zawartości obiektu blob. Aby uzyskać listę warstw i dozwolonej długości zawartości, zobacz Wysokiej wydajności magazyn w warstwie Premium i dyski zarządzane dla maszyn wirtualnych.

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.