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 na koncie magazynu obiektów blob lub ogólnego przeznaczenia w wersji 2. Warstwa stronicowego obiektu blob w warstwie Premium (P1P3P4/P2//itp.) określa dozwolony rozmiar, liczbę operacji we/wy na sekundę i przepustowość obiektu blob. Warstwa blokowego obiektu blob określa Hot//CoolArchive typ magazynu. Ta operacja nie aktualizuje elementu ETag obiektu blob.

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 Set Blob Tier może być skonstruowane w następujący sposób. Zalecane jest użycie protokołu HTTPS. Zastąp ciąg myaccount nazwą konta magazynu i 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

Dla identyfikatora 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 Opcjonalne dla wersji 2019-12-12 i nowszych. Parametr versionid jest nieprzezroczystą DateTime wartością, która w chwili obecnej określa wersję obiektu blob do ustawienia warstwy.
timeout Opcjonalny. Parametr limitu czasu jest wyrażony w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji usługi Blob Service.

Nagłówki żądań

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

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 w obiekcie blob. Aby uzyskać listę dozwolonych warstw stronicowych obiektów blob w warstwie Premium, zobacz Premium Storage o wysokiej wydajności i dyski zarządzane dla maszyn wirtualnych. W przypadku magazynu obiektów blob lub konta ogólnego przeznaczenia w wersji 2 prawidłowe wartości to HotArchive/Cool/. Aby uzyskać szczegółowe informacje na temat warstw warstwowych na poziomie konta obiektów blob w warstwach magazynowania konta obiektów blob w warstwach 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. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem 1-kB znaków rejestrowanym w dziennikach analitycznych po włączeniu rejestrowania analizy magazynu. Używanie tego nagłówka jest wysoce zalecane do korelowania działań po stronie klienta z żądaniami odebranymi przez serwer. Aby uzyskać więcej informacji, zobacz Informacje o rejestrowaniu analityka magazynu i rejestrowaniu platformy Azure: używanie dzienników do śledzenia żądań magazynu.
x-ms-rehydrate-priority Opcjonalny. Wskazuje priorytet, za pomocą którego ma być przywracany zarchiwizowany obiekt blob. Obsługiwane w wersji 2019-02-02 i nowszych dla blokowych obiektów blob. Prawidłowe wartości to High/Standard. Priorytet można ustawić dla obiektu blob tylko raz dla wersji wcześniejszych niż 2020-06-12; ten nagłówek zostanie zignorowany w kolejnych żądaniach. Domyślne ustawienie priorytetu to Standard.

Począwszy od wersji 2020-06-12, priorytet przywracania można zaktualizować po wcześniejszym ustawieniu. Ustawienie priorytetu można zmienić z Standard na High , wywołując ustawienie Ustaw warstwę obiektu blob z tym nagłówkiem na High i ustawiając x-ms-access-tier tę samą wartość co 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 Service.

Treść żądania

Brak.

Reakcja

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

Kod stanu

Pomyślna operacja zwraca kod stanu 200 (OK), jeśli nowa warstwa zostanie natychmiast wprowadzona lub kod stanu 202 (Zaakceptowano), jeśli przejście do nowej warstwy oczekuje. W przypadku operacji stronicowego obiektu blob konta Premium zwraca kod stanu 200 (OK). W przypadku blokowych obiektów blob w poniższej tabeli opisano kody stanu http zwracane na podstawie bieżącej warstwy i żądanej warstwy obiektu blob:

Warstwa Ustaw warstwę Gorąca Ustaw warstwę Chłodna Ustaw warstwę archiwum
Obiekt blob w warstwie Gorąca 200 200 200
Obiekt blob w warstwie Chłodna 200 200 200
Obiekt blob w warstwie Archiwum 202 202 200
Obiekt blob w warstwie Archiwum, przywracanie do warstwy Gorąca 202 409 409
Obiekt blob w warstwie Archiwum, przywracanie do warstwy Chłodna 409 202 409

Aby uzyskać informacje o kodach stanu, zobacz Status and Error Codes (Kody stanu i błędów).

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera poniższe 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 Opis
x-ms-request-id Ten nagłówek 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 Wskazuje wersję usługi Blob Service używaną do wykonania żądania. Ten nagłówek jest zwracany dla żądań wysyłanych w wersji 2009-09-19 i nowszej.
x-ms-client-request-id Ten nagłówek 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ść wynosi co najwyżej 1024 widoczne znaki ASCII. x-ms-client-request-id Jeśli nagłówek nie znajduje się w żądaniu, ten nagłówek nie będzie 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, która ma uprawnienia do zapisu w tym obiekcie blob lub kontenerze.

Uwagi

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

Ustawienie warstwy blokowego obiektu blob na koncie magazynu obiektów blob lub ogólnego przeznaczenia w wersji 2 ma następujące ograniczenia:

  • Ustawienie warstwy migawki jest dozwolone, począwszy od wersji REST 2019-12-12.
  • Migawki warstwowe w celu archiwizacji nie mogą być ponownie wypełnianie do migawki. tj. migawki nie można przywrócić do warstwy Gorąca/Chłodna. Tylko sposobem pobrania danych z zarchiwizowanej 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 warstwy Gorąca lub Chłodna.
  • Migawki lub wersje w stanie zarchiwizowanym nie mogą być promowane do katalogu głównego.
  • Po włączeniu obsługi wersji usuń główny obiekt blob, gdy w oczekiwaniu na ponowne wypełnianie spowoduje anulowanie ponownego wypełniania, a wersja będzie w stanie Archiwum.
  • Jeśli obiekt blob zostanie zastąpiony podczas ponownego wypełniania stanu oczekującego i softdeleted, spowoduje to anulowanie ponownego wypełniania, a wersja lub migawka softdeleted będzie w stanie zarchiwizowanym.

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 Service
Ustawianie limitów czasu operacji usługi Blob Service