Ustawianie warstwy obiektu blob

  • Artykuł

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/P15//P30P40/P50///P60P6P10/P20) określa dozwolony rozmiar, liczbę operacji we/wy na sekundę i przepustowość obiektu blob. Warstwa blokowego obiektu blob określa HotColdArchive/Cool//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 można skonstruować Set Blob Tier w następujący sposób. Zalecamy korzystanie z 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

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 Opcjonalnie w wersji 2019-12-12 lub nowszej. Parametr versionid jest nieprzezroczystą DateTime wartością, która w chwili obecnej określa 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ń 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 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 konta usługi Blob Storage lub ogólnego przeznaczenia w wersji 2 prawidłowe wartości to Hot, Cool, Coldi Archive. Uwaga:Cold warstwa jest obsługiwana w wersji 2021-12-02 lub nowszej. 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 About analityka magazynu Logging (Informacje o rejestrowaniu analityka 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 nowszej dla blokowych obiektów blob. Prawidłowe wartości to High/Standard. Priorytet można ustawić dla obiektu blob tylko raz dla wersji starszych 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 funkcję 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 Storage.

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 (zaakceptowany), 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:

Warstwa Ustaw warstwę Gorąca Ustaw warstwę Chłodna Ustaw na warstwę zimna Ustaw 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, przywracanie do warstwy Gorąca 202 409 409 409
Obiekt blob w warstwie Archiwum, przywracany 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 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 standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi Opis
x-ms-request-id Unikatowo 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 w przypadku żą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 x-ms-client-request-id nagłówka, jeśli jest obecna w żądaniu, a wartość zawiera nie więcej niż 1024 widoczne znaki ASCII. x-ms-client-request-id Jeśli nagłówek 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.

Usługa Azure Storage obsługuje autoryzację żądań do danych obiektów blob przy użyciu Tożsamość Microsoft Entra. Dzięki Tożsamość Microsoft Entra 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 Tożsamość Microsoft Entra 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 na temat autoryzacji przy użyciu Tożsamość Microsoft Entra, zobacz Autoryzowanie dostępu do obiektów blob przy użyciu Tożsamość Microsoft Entra.

Uprawnienia

Poniżej przedstawiono akcję RBAC niezbędną do wywołania Set Blob Tier operacji przez użytkownika, grupę lub jednostkę usługi Microsoft Entra oraz najmniej uprzywilejowaną wbudowaną rolę RBAC platformy Azure obejmującą tę akcję:

Aby dowiedzieć się więcej na temat przypisywania ról przy użyciu kontroli dostępu opartej na rolach platformy Azure, zobacz Przypisywanie roli platformy Azure w celu uzyskania dostępu do danych obiektów blob.

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 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, które są podzielone na archive warstwy, nie mogą być ponownie przywracane do migawki. Oznacza to, że migawka nie może zostać przywrócona hot do 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 przywrócić ją z powrotem 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 jest 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 jest 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 mogą zostać dodane 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.

Rozliczenia

Żą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 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 w innej kategorii rozliczeniowej niż transakcje zapisu. W poniższej tabeli przedstawiono kategorię rozliczeń dla Set Blob Tier żądań 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 obiektu 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 Azure Blob Storage Cennik.

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