Udostępnij za pośrednictwem

Ustawianie właściwości obiektu blob

  • Artykuł

Operacja Set Blob Properties ustawia właściwości systemowe obiektu blob.

Żądanie

Żądanie Set Blob Properties może być skonstruowane w następujący sposób. Zalecamy korzystanie z protokołu HTTPS. Zastąp ciąg myaccount nazwą konta magazynu:

Identyfikator URI żądania PUT Wersja PROTOKOŁU HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=properties HTTP/1.1

Identyfikator URI usługi emulacji magazynu

Gdy wysyłasz żądanie względem usługi emulowanego magazynu, określ nazwę hosta emulatora i port usługi Blob Storage jako 127.0.0.1:10000, a następnie nazwę emulowanego konta magazynu:

Identyfikator URI żądania PUT Wersja PROTOKOŁU HTTP
http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=properties HTTP/1.1

Aby uzyskać więcej informacji, zobacz Use the Azurite emulator for local Azure Storage development (Używanie emulatora Azurite do lokalnego programowania w usłudze Azure Storage).

Parametry identyfikatora URI

Dla identyfikatora URI żądania można określić następujące dodatkowe parametry:

Parametr Opis
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ń (wszystkie typy obiektów blob)

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań dla wszystkich typów obiektów blob.

Nagłówek żądania Opis
Authorization Wymagane. Określa schemat autoryzacji, nazwę konta 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-version Wymagane dla wszystkich autoryzowanych żądań. Określa wersję operacji do użycia dla tego żądania. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji dla usług Azure Storage.
x-ms-blob-cache-control Opcjonalny. Modyfikuje ciąg sterowania pamięci podręcznej dla obiektu blob.

Jeśli ta właściwość nie zostanie określona w żądaniu, właściwość zostanie wyczyszczone dla obiektu blob. Kolejne wywołania funkcji Pobierz właściwości obiektu blob nie zwracają tej właściwości, chyba że zostanie jawnie ustawiona w obiekcie blob ponownie.
x-ms-blob-content-type Opcjonalny. Ustawia typ zawartości obiektu blob.

Jeśli ta właściwość nie zostanie określona w żądaniu, właściwość zostanie wyczyszczone dla obiektu blob. Kolejne wywołania funkcji Pobierz właściwości obiektu blob nie zwracają tej właściwości, chyba że zostanie jawnie ustawiona w obiekcie blob ponownie.
x-ms-blob-content-md5 Opcjonalny. Ustawia skrót MD5 obiektu blob.

Jeśli ta właściwość nie zostanie określona w żądaniu, właściwość zostanie wyczyszczone dla obiektu blob. Kolejne wywołania funkcji Pobierz właściwości obiektu blob nie zwracają tej właściwości, chyba że zostanie jawnie ustawiona w obiekcie blob ponownie.
x-ms-blob-content-encoding Opcjonalny. Ustawia kodowanie zawartości obiektu blob.

Jeśli ta właściwość nie zostanie określona w żądaniu, właściwość zostanie wyczyszczone dla obiektu blob. Kolejne wywołania funkcji Pobierz właściwości obiektu blob nie zwracają tej właściwości, chyba że zostanie jawnie ustawiona w obiekcie blob ponownie.
x-ms-blob-content-language Opcjonalny. Ustawia język zawartości obiektu blob.

Jeśli ta właściwość nie zostanie określona w żądaniu, właściwość zostanie wyczyszczone dla obiektu blob. Kolejne wywołania funkcji Pobierz właściwości obiektu blob nie zwracają tej właściwości, chyba że zostanie jawnie ustawiona w obiekcie blob ponownie.
x-ms-lease-id:<ID> Wymagane, jeśli obiekt blob ma aktywną dzierżawę. Aby wykonać tę operację na obiekcie blob z aktywną dzierżawą, określ prawidłowy identyfikator dzierżawy dla tego nagłówka.
x-ms-client-request-id Opcjonalny. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB) rejestrowanym w dziennikach podczas konfigurowania 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 Monitorowanie Azure Blob Storage.
x-ms-blob-content-disposition Opcjonalny. Ustawia nagłówek obiektu blob Content-Disposition . Dostępne dla wersji 2013-08-15 lub nowszej.

Pole nagłówka Content-Disposition odpowiedzi zawiera dodatkowe informacje o sposobie przetwarzania ładunku odpowiedzi i może służyć do dołączania dodatkowych metadanych. Jeśli na przykład ustawiono wartość attachment, oznacza to, że agent użytkownika nie powinien wyświetlać odpowiedzi, ale zamiast tego wyświetla okno dialogowe Zapisz jako z nazwą pliku inną niż określona nazwa obiektu blob.

Odpowiedź z operacji Pobierz obiekt blob i Pobierz właściwości obiektu blob zawiera content-disposition nagłówek .
Origin Opcjonalny. Określa źródło, z którego jest wystawiane żądanie. Obecność tego nagłówka powoduje współużytkowanie zasobów między źródłami w odpowiedzi. Aby uzyskać więcej informacji, zobacz Obsługa mechanizmu CORS (współużytkowania zasobów między źródłami) dla usług Azure Storage.

Ta operacja obsługuje również używanie nagłówków warunkowych do ustawiania właściwości 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.

Nagłówki żądań (tylko stronicowe obiekty blob)

W poniższej tabeli opisano nagłówki żądań, które mają zastosowanie tylko do operacji na stronicowych obiektach blob:

Nagłówek żądania Opis
x-ms-blob-content-length: byte value Opcjonalny. Zmienia rozmiar stronicowego obiektu blob na określony rozmiar. Jeśli określona wartość jest mniejsza niż bieżący rozmiar obiektu blob, wszystkie stronicowe obiekty blob z wartościami większymi niż określona wartość są czyszczone.

Tej właściwości nie można użyć do zmiany rozmiaru blokowego obiektu blob lub uzupełnialnych obiektów blob. Ustawienie tej właściwości dla blokowego obiektu blob lub uzupełnialnych obiektów blob zwraca kod stanu 400 (nieprawidłowe żądanie).
x-ms-sequence-number-action: {max, update, increment} Opcjonalne, ale wymagane, jeśli x-ms-blob-sequence-number nagłówek jest ustawiony dla żądania. Ta właściwość dotyczy tylko stronicowych obiektów blob.

Ta właściwość wskazuje, jak usługa powinna modyfikować numer sekwencji obiektu blob. Określ jedną z następujących opcji dla tej właściwości:

- max: Ustawia numer sekwencji na wyższy od wartości dołączonej do żądania i wartość obecnie przechowywaną dla obiektu blob.
- update: ustawia numer sekwencji na wartość dołączona do żądania.
- increment: zwiększa wartość numeru sekwencji o 1. Jeśli określasz tę opcję, nie dołączaj elementu x-ms-blob-sequence-number header. Spowoduje to zwrócenie kodu stanu 400 (nieprawidłowe żądanie).
x-ms-blob-sequence-number: <num> Opcjonalne, ale wymagane, jeśli właściwość jest ustawiona x-ms-sequence-number-action na max wartość lub update. Ta właściwość dotyczy tylko stronicowych obiektów blob.

Właściwość ustawia numer sekwencji obiektu blob. Numer sekwencji to właściwość kontrolowana przez użytkownika, której można użyć do śledzenia żądań i zarządzania problemami współbieżności. Aby uzyskać więcej informacji, zobacz operację Umieszczanie strony .

Użyj tej właściwości razem z elementem x-ms-sequence-number-action , aby zaktualizować numer sekwencji obiektu blob do określonej wartości lub wyższej wartości określonej za pomocą żądania lub aktualnie przechowywanej w obiekcie blob. Ten nagłówek nie powinien być określony, jeśli x-ms-sequence-number-action jest ustawiony na increment, w takim przypadku usługa automatycznie zwiększa numer sekwencji o jeden.

Aby ustawić numer sekwencji na wybraną wartość, ta właściwość musi zostać określona w żądaniu razem z elementem x-ms-sequence-number-action.

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).

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.

Składnia Opis
ETag Zawiera wartość, której można użyć do warunkowego wykonywania operacji. Aby uzyskać więcej informacji, zobacz Określanie nagłówków warunkowych dla operacji usługi Blob Storage . Jeśli wersja żądania to 2011-08-18 lub nowsza, wartość elementu ETag jest ujęta w cudzysłów.
Last-Modified Data/godzina ostatniej modyfikacji obiektu blob. Format daty jest zgodny z dokumentem RFC 1123. Aby uzyskać więcej informacji, zobacz Reprezentacja wartości daty/godziny w nagłówkach.

Każda operacja zapisu obiektu blob (w tym aktualizacje metadanych lub właściwości obiektu blob) zmienia czas ostatniej modyfikacji obiektu blob.
x-ms-blob-sequence-number Jeśli obiekt blob jest stronicowym obiektem blob, bieżący numer sekwencji obiektu blob jest zwracany z tym nagłówkiem.
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 Wskazuje wersję usługi Blob Storage użytą do wykonania żądania. Ten nagłówek jest zwracany w przypadku żądań, które zostały wykonane w wersji 2009-09-19 lub nowszej.
Date Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę zainicjowania odpowiedzi.
Access-Control-Allow-Origin Zwracane, jeśli żądanie zawiera Origin nagłówek, a mechanizm CORS jest włączony z regułą dopasowania. Jeśli istnieje dopasowanie, ten nagłówek zwraca wartość nagłówka żądania źródła.
Access-Control-Expose-Headers Zwracane, jeśli żądanie zawiera Origin nagłówek, a mechanizm CORS jest włączony z regułą dopasowania. Zwraca listę nagłówków odpowiedzi, które mają być widoczne dla klienta lub wystawcy żądania.
Access-Control-Allow-Credentials Zwracany, jeśli żądanie zawiera Origin nagłówek, a mechanizm CORS jest włączony z regułą dopasowania, która nie zezwala na wszystkie źródła. Nagłówek zostanie ustawiony na truewartość .
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.

Treść odpowiedzi

Brak.

Autoryzacja

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

Ważne

Firma Microsoft zaleca używanie Tożsamość Microsoft Entra z tożsamościami zarządzanymi w celu autoryzowania żądań do usługi Azure Storage. Tożsamość Microsoft Entra zapewnia doskonałe zabezpieczenia i łatwość użycia w porównaniu z autoryzacją klucza wspólnego.

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ą dla użytkownika Microsoft Entra, grupy, tożsamości zarządzanej lub jednostki usługi w celu wywołania Set Blob Properties operacji 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 Przypisywanie roli platformy Azure w celu uzyskania dostępu do danych obiektów blob.

Uwagi

Semantyka aktualizowania właściwości obiektu blob jest następująca:

  • Numer sekwencji stronicowego obiektu blob jest aktualizowany tylko wtedy, gdy żądanie spełnia jeden z następujących warunków:

    • Żądanie ustawia x-ms-sequence-number-action wartość na max lub updatei określa wartość nagłówka x-ms-blob-sequence-number .

    • Żądanie ustawia wartość x-ms-sequence-number-actionincrementna , co oznacza, że usługa powinna zwiększać liczbę sekwencji o jeden.

  • Rozmiar stronicowego obiektu blob jest modyfikowany tylko wtedy, gdy żądanie określa wartość nagłówka x-ms-content-length .

  • Aby zmienić rozmiar stronicowego obiektu blob na koncie magazynu w warstwie Premium, nowy rozmiar nie może przekraczać długości zawartości dozwolonej przez istniejącą warstwę. Przed zmianą rozmiaru obiektu blob wywołaj metodę Ustaw warstwę 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.

  • Jeśli żądanie ustawia tylko x-ms-blob-sequence-number wartość lub x-ms-content-length, żadna z innych właściwości obiektu blob nie zostanie zmodyfikowana.

  • Jeśli co najmniej jedna z poniższych właściwości jest ustawiona w żądaniu, wszystkie właściwości są ustawione razem. Jeśli dla właściwości nie podano wartości po ustawieniu co najmniej jednej z nich, ta właściwość zostanie wyczyszczone dla obiektu blob.

    • x-ms-blob-cache-control
    • x-ms-blob-content-type
    • x-ms-blob-content-md5
    • x-ms-blob-content-encoding
    • x-ms-blob-content-language
    • x-ms-blob-content-disposition

Uwaga

W przypadku sygnatury dostępu współdzielonego (SAS) można zastąpić niektóre właściwości przechowywane dla obiektu blob, określając parametry zapytania w ramach sygnatury dostępu współdzielonego. Te właściwości obejmują cache-controlwłaściwości , content-type, content-encoding, content-languagei content-disposition . Aby uzyskać więcej informacji, zobacz Twórca sygnaturę dostępu współdzielonego usługi.

Rozliczenia

Żądania cenowe 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 do innej kategorii rozliczeniowej niż transakcje zapisu. W poniższej tabeli przedstawiono kategorię rozliczeń dla Set Blob Properties żądań na podstawie typu konta magazynu:

Operacja Typ konta magazynu Kategoria rozliczeń
Ustawianie właściwości obiektu blob Blokowy obiekt blob w warstwie Premium
Standardowa ogólnego przeznaczenia, wersja 2		 Inne operacje
Ustawianie właściwości obiektu blob Standardowa ogólnego przeznaczenia, wersja 1 Operacje zapisu

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

Zobacz też