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 Hot
typ magazynu , Cool
, Cold
lub 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 archive Cold . 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 dohot
warstwy lubcool
. Jedynym sposobem pobrania danych zarchive
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
lubcool
. - 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