Ustawianie właściwości obiektu blob

Operacja Set Blob Properties ustawia właściwości systemu w obiekcie blob.

Żądanie

Żądanie Set Blob Properties można skonstruować w następujący sposób. Zalecane jest użycie 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 emulowanej Storage

Podczas wysyłania żądania względem emulowanej usługi magazynu określ nazwę hosta emulatora i port usługi Blob Service 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 Using the Azure Storage Emulator for Development and Testing (Korzystanie z usługi Azure Storage Emulator na potrzeby programowania i testowania).

Parametry identyfikatora URI

W identyfikatorze 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 Service.

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 usług Azure Storage Services.
x-ms-blob-cache-control Opcjonalny. Modyfikuje ciąg kontrolki 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 właściwości obiektu blob nie będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona na 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 właściwości obiektu blob nie będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona na 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 właściwości obiektu blob nie będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona na 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 właściwości obiektu blob nie będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona na 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 właściwości obiektu blob nie będą zwracać tej właściwości, chyba że zostanie jawnie ustawiona na 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. Udostępnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem 1 znaków KiB 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 and Azure Logging: Using Logs to Track Storage Requests (Informacje o rejestrowaniu analityka magazynu i rejestrowaniu platformy Azure: używanie dzienników do śledzenia żądań Storage).
x-ms-blob-content-disposition Opcjonalny. Ustawia nagłówek obiektu blob Content-Disposition . Dostępne dla wersji 2013-08-15 i nowszych.

Pole nagłówka Content-Disposition odpowiedzi przekazuje dodatkowe informacje na temat przetwarzania ładunku odpowiedzi, a także może służyć do dołączania dodatkowych metadanych. Jeśli na przykład ustawiono attachmentwartość , oznacza to, że agent-użytkownik nie powinien wyświetlać odpowiedzi, ale zamiast tego wyświetli okno dialogowe Zapisz jako z nazwą inną niż określona nazwa obiektu blob.

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

Ta operacja obsługuje również używanie nagłówków warunkowych do ustawiania właściwości obiektu blob tylko wtedy, gdy spełniony jest określony warunek. Aby uzyskać więcej informacji, zobacz Określanie nagłówków warunkowych dla operacji usługi Blob Service.

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

W poniższej tabeli opisano nagłówki żądań stosowane tylko dla 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 strony powyżej określonej wartości zostaną wyczyszczone.

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 zmodyfikować 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ść, która jest obecnie przechowywana dla obiektu blob.
- update: ustawia numer sekwencji na wartość dołączona do żądania.
- increment: zwiększa wartość numeru sekwencji o 1. Jeśli określisz tę opcję, nie dołącz parametru x-ms-blob-sequence-number header; w ten sposób zostanie zwrócony kod 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 lub update. Ta właściwość dotyczy tylko stronicowych obiektów blob.

Ta 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 do wyższych wartości określonych za pomocą żądania lub aktualnie przechowywanych w obiekcie blob. Nie należy określać tego nagłówka, jeśli x-ms-sequence-number-action jest ustawiony na incrementwartość ; w tym przypadku usługa automatycznie zwiększa liczbę sekwencją o jeden.

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

Nagłówki żądań (klucze szyfrowania dostarczone przez klienta)

Począwszy od wersji 2019-02-02, następujące nagłówki można określić na żądanie zaszyfrowania obiektu blob przy użyciu klucza dostarczonego przez klienta. Szyfrowanie przy użyciu klucza dostarczonego przez klienta (i odpowiadającego mu zestawu nagłówków) jest opcjonalne. Jeśli obiekt blob został wcześniej zaszyfrowany przy użyciu klucza dostarczonego przez klienta, te nagłówki muszą zostać dołączone do żądania, aby pomyślnie ukończyć operację zapisu.

Nagłówek żądania Opis
x-ms-encryption-key Wymagane. Klucz szyfrowania AES-256 zakodowany w formacie Base64.
x-ms-encryption-key-sha256 Wymagane. Skrót SHA256 zakodowany w formacie Base64 klucza szyfrowania.
x-ms-encryption-algorithm: AES256 Wymagane. Określa algorytm do użycia na potrzeby szyfrowania. Wartość tego nagłówka musi mieć wartość AES256.

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ć informacje o kodach stanu, zobacz Status and Error Codes (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 Element 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 Service . Jeśli wersja żądania to 2011-08-18 lub nowsza, wartość elementu ETag będzie znajdować się w cudzysłowie.
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 Date-Time 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 Ten nagłówek 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 Wskazuje wersję usługi Blob Service używaną do wykonania żądania. Ten nagłówek jest zwracany w przypadku żądań wysyłanych w wersji 2009-09-19 lub nowszej.
Date Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę, o której zainicjowano odpowiedź.
Access-Control-Allow-Origin Zwracane, jeśli żądanie zawiera Origin nagłówek, a mechanizm CORS jest włączony z regułą dopasowania. Ten nagłówek zwraca wartość nagłówka żądania źródła w przypadku dopasowania.
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. Ten nagłówek zostanie ustawiony na wartość true.
x-ms-client-request-id Ten nagłówek 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ść jest najwyżej 1024 widocznymi znakami ASCII. x-ms-client-request-id Jeśli nagłówek nie istnieje w żądaniu, ten nagłówek nie będzie obecny w odpowiedzi.

Treść odpowiedzi

Brak.

Autoryzacja

Ta operacja może być wywoływana tylko przez właściciela konta i przez każdego, kto ma sygnaturę dostępu współdzielonego, która ma uprawnienia do zapisu w tym obiekcie blob lub jego kontenerze.

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 update, a także określa wartość nagłówka x-ms-blob-sequence-number .

    • Żądanie ustawia x-ms-sequence-number-actionincrementwartość na , wskazując, ż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 dozwoloną długość zawartości, zobacz Premium Storage o wysokiej wydajności i dyskach zarządzanych dla maszyn wirtualnych.

  • Jeśli żądanie ustawia tylko x-ms-blob-sequence-number i/lub x-ms-content-length, i nie ma żadnych innych właściwości, żadne inne właściwości obiektu blob nie są modyfikowane.

  • Jeśli co najmniej jedna z poniższych właściwości jest ustawiona w żądaniu, wszystkie te właściwości są ustawiane razem. Jeśli dla danej właściwości nie podano wartości, gdy ustawiono co najmniej jedną z właściwości wymienionych poniżej, 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

Należy pamiętać, że w przypadku sygnatury dostępu współdzielonego 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 Tworzenie sygnatury dostępu współdzielonego usługi.

Zobacz też

Autoryzowanie żądań do usługi Azure Storage
Kody stanu i błędów