Udostępnij za pośrednictwem

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 (P4/P6/P10/P15/P20/P30/P40/P50/P60) określa dozwolony rozmiar, liczbę operacji we/wy na sekundę i przepustowość obiektu blob. Warstwa blokowego obiektu blob określa Hot/Cool/Cold/Archive 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.

Prosić

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

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 Fakultatywny. Parametr migawki jest nieprzezroczystą wartością DateTime, 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 w wersji 2019-12-12 lub nowszej. Parametr versionid jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa wersję obiektu blob w celu ustawienia warstwy.
timeout Fakultatywny. 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ń

Wymagane i opcjonalne nagłówki żądań zostały opisane 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 uniwersalny czas koordynowany (UTC) dla żądania. 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 Usługi Premium Storage 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, Coldi Archive. Uwaga: warstwaCold jest obsługiwana w wersji 2021-12-02 lub nowszej. Aby uzyskać szczegółowe informacje o warstwach na poziomie konta obiektów blob w warstwach 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 Versioning for the Azure Storage Services.
x-ms-client-request-id Fakultatywny. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem 1-kB znaków rejestrowanym w dziennikach analitycznych po włączeniu rejestrowania analizy magazynu. Użycie tego nagłówka jest zdecydowanie zalecane do korelowania działań po stronie klienta z żądaniami odebranymi przez serwer. Aby uzyskać więcej informacji, zobacz About Storage Analytics Logging.
x-ms-rehydrate-priority Fakultatywny. Wskazuje priorytet, za pomocą którego ma być przywracany zarchiwizowany obiekt blob. Obsługiwane w wersji 2019-02-02 i nowszej dla blokowych obiektów blob. Prawidłowe wartości to High/Standard. Priorytet można ustawić na obiekcie 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 ponownego wypełniania można zaktualizować po wcześniejszym ustawieniu. Ustawienie priorytetu można zmienić z Standard na High, wywołując Ustaw warstwę obiektu blob z tym nagłówkiem ustawionym na High i ustawiając x-ms-access-tier na tę samą wartość co poprzednio 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

Żaden.

Odpowiedź

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 w życie lub kod stanu 202 (Zaakceptowane), jeśli przejście do nowej warstwy oczekuje.

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, są opisane w poniższej tabeli:

Kondygnacja Ustaw na warstwę Gorąca Ustaw na warstwę Chłodna Ustaw na warstwę zimna 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, przywracany do warstwy Gorąca 202 409 409 409
Obiekt blob w warstwie Archiwum, ponownie wypełnianie do warstwy Chłodna 409 202 409 409
Obiekt blob w warstwie Archiwum, przywracany do warstwy zimnej 409 409 202 409

Aby uzyskać więcej informacji na temat kodów 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 Opis
x-ms-request-id Jednoznacznie identyfikuje żądanie, które zostało wykonane 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 odpowiedziami. Wartość tego nagłówka jest równa wartości nagłówka x-ms-client-request-id, jeśli znajduje się w żądaniu, a wartość nie zawiera więcej niż 1024 widocznych znaków ASCII. Jeśli nagłówek x-ms-client-request-id nie znajduje się w żądaniu, nie będzie on obecny w odpowiedzi.

Autoryzacja

Autoryzacja jest wymagana podczas wywoływania dowolnej operacji dostępu do danych w usłudze Azure Storage. Możesz autoryzować operację Set Blob Tier zgodnie z poniższym opisem.

Ważny

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 identyfikatora Entra firmy Microsoft do autoryzowania żądań do danych obiektów 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ń. Podmiot zabezpieczeń może być użytkownikiem, grupą, jednostką usługi aplikacji lub tożsamością zarządzaną platformy Azure. Podmiot zabezpieczeń jest uwierzytelniany przez identyfikator entra firmy Microsoft w celu zwrócenia tokenu OAuth 2.0. Token może następnie służyć do autoryzowania żądania względem usługi Blob Service.

Aby dowiedzieć się więcej o autoryzacji przy użyciu identyfikatora Entra firmy Microsoft, zobacz Autoryzowanie dostępu do obiektów blob przy użyciu identyfikatora Entra firmy Microsoft.

Uprawnienia

Poniżej wymieniono akcję RBAC niezbędną dla użytkownika microsoft Entra, grupy, tożsamości zarządzanej lub jednostki usługi w celu wywołania operacji Set Blob Tier oraz najmniej uprzywilejowanej wbudowanej roli RBAC platformy Azure, która obejmuje tę akcję:

Aby dowiedzieć się więcej na temat przypisywania ról przy użyciu kontroli dostępu opartej na rolach platformy Azure, zobacz Assign an Azure role for access to blob data.

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 2019-12-12 REST.
  • Migawki, które są warstwowe do archive nie można ponownie przywrócić do migawki. Oznacza to, że migawka nie może zostać przywrócona do warstwy hot ani cool. Jedynym sposobem pobrania danych z migawki lub wersji archive jest skopiowanie ich do nowego obiektu blob.
  • Jeśli wersja jest głównym obiektem blob, można go ponownie przywrócić do hot lub cool.
  • Migawki lub wersje w stanie archive 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 stanie archive.
  • 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 stanie archive.

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

W przypadku obiektów blob korzystających z szyfrowania dostarczonego przez klienta Set Blob Tier jest obsługiwana w wersji 2023-08-03 lub nowszej. W przypadku wersji wcześniejszych niż 2023-08-03 Set Blob Tier zwraca kod stanu 409 dla obiektów blob korzystających z szyfrowania dostarczonego przez klienta.

Nuta

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

Rozliczeń

Żą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ń Set Blob Tier na podstawie typu konta magazynu:

Operacja Typ konta magazynu Kategoria rozliczeń
Ustawianie warstwy obiektów blob (warstwa w dół) Blokowy obiekt blob w warstwie Premium
Standardowa ogólnego przeznaczenia, wersja 2		 Operacje zapisu
Ustawianie warstwy obiektów blob (warstwa w górę) Blokowy obiekt blob w warstwie Premium
Standardowa ogólnego przeznaczenia, wersja 2		 Operacje odczytu

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

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