Wstawianie obiektu blob

Operacja Put Blob tworzy nowy blok, stronę lub uzupełnialne obiekty blob albo aktualizuje zawartość istniejącego blokowego obiektu blob.

Aktualizowanie istniejącego blokowego obiektu blob zastępuje wszystkie istniejące metadane w obiekcie blob. Częściowe aktualizacje nie są obsługiwane w przypadku obiektu Blob Put; zawartość istniejącego obiektu blob jest zastępowana zawartością nowego obiektu blob. Aby wykonać częściową aktualizację zawartości blokowego obiektu blob, użyj operacji Umieszczanie listy blokowej .

Pamiętaj, że można utworzyć uzupełnialne obiekty blob tylko w wersji 2015-02-21 lub nowszej.

Wywołanie obiektu w celu Put Blob utworzenia stronicowego obiektu blob lub uzupełnialnych obiektów blob inicjuje tylko obiekt blob. Aby dodać zawartość do stronicowego obiektu blob, wywołaj operację Umieszczanie strony . Aby dodać zawartość do dołączanego obiektu blob, wywołaj operację Dołączanie bloku .

Żądanie

Żądanie Put Blob 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 HTTP/1.1

Identyfikator URI usługi magazynu emulowanego

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 HTTP/1.1

Należy pamiętać, że emulator magazynu obsługuje tylko rozmiary obiektów blob do 2 GiB.

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 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ń (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.
Content-Length Wymagane. Długość żądania.

W przypadku stronicowego obiektu blob lub uzupełnialnych obiektów blob wartość tego nagłówka musi być ustawiona na zero, ponieważ obiekt Put Blob jest używany tylko do inicjowania obiektu blob. Aby napisać zawartość do istniejącego stronicowego obiektu blob, wywołaj metodę Umieść stronę. Aby napisać zawartość do uzupełnialnych obiektów blob, wywołaj funkcję Append Block.
Content-Type Opcjonalny. Typ zawartości MIME obiektu blob. Domyślnym typem jest application/octet-stream.
Content-Encoding Opcjonalny. Określa, które kodowania zawartości zostały zastosowane do obiektu blob. Ta wartość jest zwracana do klienta po wykonaniu operacji Get Blob w zasobie obiektu blob. Klient może użyć tej wartości po powrocie do dekodowania zawartości obiektu blob.
Content-Language Opcjonalny. Określa języki naturalne używane przez ten zasób.
Content-MD5 Opcjonalny. Skrót MD5 zawartości obiektu blob. Ten skrót służy do weryfikowania integralności obiektu blob podczas transportu. Po określeniu tego nagłówka usługa magazynu sprawdza skrót, który dotarł do wysłanego. Jeśli dwa skróty nie są zgodne, operacja zakończy się niepowodzeniem z kodem błędu 400 (Nieprawidłowe żądanie).

Po pominięciu w wersji 2012-02-12 lub nowszej usługa Blob generuje skrót MD5.

Wyniki z pobierania obiektów blob, pobierania właściwości obiektów blob i obiektów blob listy obejmują skrót MD5.
x-ms-content-crc64 Opcjonalny. Skrót CRC64 zawartości obiektu blob. Ten skrót służy do weryfikowania integralności obiektu blob podczas transportu. Po określeniu tego nagłówka usługa magazynu sprawdza skrót, który dotarł do wysłanego. Jeśli dwa skróty nie są zgodne, operacja zakończy się niepowodzeniem z kodem błędu 400 (Nieprawidłowe żądanie). Ten nagłówek jest obsługiwany w wersjach 02-02-2019 lub nowszych.

Jeśli istnieją nagłówki Content-MD5 i x-ms-content-crc64, żądanie zakończy się niepowodzeniem z błędem 400 (nieprawidłowe żądanie).
Cache-Control Opcjonalny. Usługa Blob przechowuje tę wartość, ale nie używa jej ani nie modyfikuje.
x-ms-blob-content-type Opcjonalny. Ustaw typ zawartości obiektu blob.
x-ms-blob-content-encoding Opcjonalny. Ustaw kodowanie zawartości obiektu blob.
x-ms-blob-content-language Opcjonalny. Ustaw język zawartości obiektu blob.
x-ms-blob-content-md5 Opcjonalny. Ustaw skrót MD5 obiektu blob.
x-ms-blob-cache-control Opcjonalny. Ustawia kontrolkę pamięci podręcznej obiektu blob.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> Wymagane. Określa typ obiektu blob do utworzenia: blokowy obiekt blob, stronicowy obiekt blob lub uzupełnialne obiekty blob. Obsługa tworzenia uzupełnialnych obiektów blob jest dostępna tylko w wersji 2015-02-21 lub nowszej.
x-ms-meta-name:value Opcjonalny. Pary name-value skojarzone z obiektem blob jako metadanymi.

Należy pamiętać, że począwszy od wersji 2009-09-19 nazwy metadanych muszą być zgodne z regułami nazewnictwa identyfikatorów języka C#.
x-ms-encryption-scope Opcjonalny. Wskazuje zakres szyfrowania używany do szyfrowania zawartości żądania. Ten nagłówek jest obsługiwany w wersjach 2019-02-02 lub nowszych.
x-ms-tags Opcjonalny. Ustawia podane tagi zakodowane w ciągu zapytania w obiekcie blob. Zobacz uwagi, aby uzyskać dodatkowe informacje. Obsługiwane w wersji 2019-12-12 i nowszej.
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-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.
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-access-tier Opcjonalny. Wskazuje warstwę, która ma zostać ustawiona na obiekt blob. W przypadku stronicowych obiektów blob na koncie usługi Premium Storage tylko w wersji 2017-04-17 i nowszej. Sprawdź Premium Storage o wysokiej wydajności i dyskach zarządzanych dla maszyn wirtualnych, aby uzyskać pełną listę obsługiwanych warstw stronicowych obiektów blob. W przypadku blokowych obiektów blob obsługiwane w przypadku kont magazynu obiektów blob lub ogólnego przeznaczenia w wersji 2 tylko w wersji 2018-11-09 i nowszych. Prawidłowe wartości dla warstw blokowych obiektów blob to HotArchive/Cool/. Aby uzyskać szczegółowe informacje na temat warstw blokowych obiektów blob , zobacz Warstwy magazynowania Gorąca, Chłodna i Archiwum.
x-ms-immutability-policy-until-date Wersja 2020-06-12 i nowsza. Określa datę przechowywania do ustawienia w obiekcie blob. Jest to data, do której obiekt blob może być chroniony przed modyfikacją lub usunięciem. Jest zgodny z formatem RFC1123.
x-ms-immutability-policy-mode Wersja 2020-06-12 i nowsza. Określa tryb zasad niezmienności, który ma być ustawiony na obiekcie blob. Prawidłowe wartości to unlocked/locked. unlocked wskazuje, że użytkownik może zmienić zasady, zwiększając lub zmniejszając okres przechowywania do daty. locked wskazuje, że te działania są zabronione.
x-ms-legal-hold Wersja 2020-06-12 i nowsza. Określa archiwizację prawną, która ma być ustawiona na obiekcie blob, prawidłowe wartości to true/false.

Ta operacja obsługuje również używanie nagłówków warunkowych do zapisu 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: bytes Wymagane dla stronicowych obiektów blob. Ten nagłówek określa maksymalny rozmiar stronicowego obiektu blob do 8 TiB. Rozmiar stronicowego obiektu blob musi być wyrównany do granicy 512 bajtów.

Jeśli ten nagłówek jest określony dla blokowego obiektu blob lub uzupełnialnych obiektów blob, usługa Blob zwraca kod stanu 400 (nieprawidłowe żądanie).
x-ms-blob-sequence-number: <num> Opcjonalny. Ustaw tylko dla stronicowych obiektów blob. Numer sekwencji to wartość kontrolowana przez użytkownika, której można użyć do śledzenia żądań. Wartość numeru sekwencji musi należeć do zakresu od 0 do 2^63 –1.Wartość domyślna to 0.
x-ms-access-tier Wersja 2017-04-17 i nowsza. W przypadku stronicowych obiektów blob tylko na koncie magazynu w warstwie Premium. Określa warstwę, która ma zostać ustawiona na obiekcie blob. Sprawdź Premium Storage o wysokiej wydajności i dyski zarządzane dla maszyn wirtualnych, aby uzyskać pełną listę obsługiwanych warstw.
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.

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

Począwszy od wersji 2019-02-02, można określić następujące nagłówki na żądanie szyfrowania obiektu blob przy użyciu klucza dostarczonego przez klienta. Szyfrowanie przy użyciu klucza dostarczonego przez klienta (i odpowiedniego zestawu nagłówków) jest opcjonalne.

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 do szyfrowania. Wartość tego nagłówka musi mieć wartość AES256.

Treść żądania

W przypadku blokowego obiektu blob treść żądania zawiera zawartość obiektu blob.

W przypadku stronicowego obiektu blob lub uzupełnialnych obiektów blob treść żądania jest pusta.

Przykładowe żądanie

W poniższym przykładzie przedstawiono żądanie utworzenia blokowego obiektu blob:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblockblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-content-disposition: attachment; filename="fname.ext"  
x-ms-blob-type: BlockBlob  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 11  
  
Request Body:  
hello world

To przykładowe żądanie tworzy stronicowy obiekt blob i określa maksymalny rozmiar 1024 bajtów. Należy wywołać metodę Put Page (Umieść stronę ), aby dodać zawartość do stronicowego obiektu blob:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/mypageblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: PageBlob  
x-ms-blob-content-length: 1024  
x-ms-blob-sequence-number: 0  
Authorization: SharedKey   
Origin: http://contoso.com  
Vary: Origin  
myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 0  

To przykładowe żądanie tworzy uzupełnialne obiekt blob. Pamiętaj, że należy wywołać funkcję Append Block , aby dodać zawartość do dołączania obiektu blob:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myappendblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: AppendBlob  
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Origin: http://contoso.com  
Vary: Origin  
Content-Length: 0  

Reakcja

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

Kod stanu

Operacja zakończona powodzeniem zwraca kod stanu 201 (utworzono).

Aby uzyskać informacje o kodach 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 nagłówki standardowe są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi Opis
ETag Element ETag zawiera wartość, za pomocą którą klient może wykonywać operacje warunkowe PUT przy użyciu nagłówka If-Match żądania. Jeśli wersja żądania to 2011-08-18 lub nowsza, wartość ETag będzie w cudzysłowie.
Last-Modified Data/godzina ostatniej modyfikacji obiektu blob. Format daty jest zgodny z RFC 1123. Aby uzyskać więcej informacji, zobacz Reprezentacja wartości Date-Time w nagłówkach.

Każda operacja zapisu w obiekcie blob (w tym aktualizacje metadanych lub właściwości obiektu blob) zmienia ostatni zmodyfikowany czas obiektu blob.
Content-MD5 Ten nagłówek jest zwracany dla blokowego obiektu blob, aby klient mógł sprawdzić integralność zawartości komunikatu. Zwracana Content-MD5 wartość jest obliczana przez usługę Blob Service. W wersji 2012-02-12 i nowszej ten nagłówek jest zwracany nawet wtedy, gdy żądanie nie zawiera Content-MD5 ani x-ms-blob-content-md5 nagłówków.
x-ms-content-crc64 Ten nagłówek jest zwracany dla blokowego obiektu blob, aby klient mógł sprawdzić integralność zawartości komunikatu. Zwracana x-ms-content-crc64 wartość jest obliczana przez usługę Blob Service. Ten nagłówek będzie zawsze zwracany od wersji 2019-02-02.
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 lub nowszej.
Date Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę, w której zainicjowano odpowiedź.
Access-Control-Allow-Origin Zwracane, jeśli żądanie zawiera Origin nagłówek i mechanizm CORS jest włączony z zgodną regułą. Ten nagłówek zwraca wartość nagłówka żądania pochodzenia w przypadku dopasowania.
Access-Control-Expose-Headers Zwracane, jeśli żądanie zawiera Origin nagłówek i mechanizm CORS jest włączony z zgodną regułą. Zwraca listę nagłówków odpowiedzi, które mają być widoczne dla klienta lub wystawcy żądania.
Access-Control-Allow-Credentials Zwracane, jeśli żądanie zawiera Origin nagłówek i mechanizm CORS jest włączony z zgodną regułą, która nie zezwala na wszystkie źródła. Ten nagłówek zostanie ustawiony na wartość true.
x-ms-request-server-encrypted: true/false Wersja 2015-12-11 lub nowsza. Wartość tego nagłówka jest ustawiana na true wartość , jeśli zawartość żądania zostanie pomyślnie zaszyfrowana przy użyciu określonego algorytmu i false w inny sposób.
x-ms-encryption-key-sha256 Wersja 2019-02-02 lub nowsza. Ten nagłówek jest zwracany, jeśli żądanie użyło klucza dostarczonego przez klienta do szyfrowania, aby klient mógł upewnić się, że zawartość żądania została pomyślnie zaszyfrowana przy użyciu podanego klucza.
x-ms-encryption-scope Wersja 2019-02-02 lub nowsza. Ten nagłówek jest zwracany, jeśli żądanie użyło zakresu szyfrowania, aby klient mógł upewnić się, że zawartość żądania została pomyślnie zaszyfrowana przy użyciu zakresu szyfrowania.
x-ms-version-id: <DateTime> Wersja 2019-12-12 i nowsza. Ten nagłówek zwraca nieprzezroczystą DateTime wartość, która jednoznacznie identyfikuje obiekt blob. Wartość tego nagłówka wskazuje wersję obiektu blob i może być używana w kolejnych żądaniach dostępu do obiektu blob.

Treść odpowiedzi

Brak.

Przykładowa odpowiedź

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Content-MD5: sQqNsWTgdUEFt6mb5y4/5Q==  
x-ms-content-crc64: 77uWZTolTHU
Date: <date>  
ETag: "0x8CB171BA9E94B0B"  
Last-Modified: <date>  
Access-Control-Allow-Origin: http://contoso.com  
Access-Control-Expose-Headers: Content-MD5  
Access-Control-Allow-Credentials: True  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-version-id: <DateTime>  

Autoryzacja

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

Jeśli żądanie określa tagi z nagłówkiem x-ms-tags żądania, obiekt wywołujący musi spełniać wymagania autoryzacji operacji Ustawianie tagów obiektów blob .

Uwagi

Podczas tworzenia obiektu blob należy określić, czy jest to blokowy obiekt blob, uzupełnialne obiekty blob, czy stronicowy obiekt blob, określając wartość nagłówka x-ms-blob-type . Po utworzeniu obiektu blob nie można zmienić typu obiektu blob, chyba że zostanie usunięty i utworzony ponownie.

W poniższej tabeli opisano maksymalne rozmiary bloków i obiektów blob dozwolone przez wersję usługi.

Wersja usługi Maksymalny rozmiar bloku (za pomocą pozycji Umieść blok) Maksymalny rozmiar obiektu blob (za pośrednictwem pozycji Lista bloków) Maksymalny rozmiar obiektu blob za pośrednictwem pojedynczej operacji zapisu (za pośrednictwem polecenia Put Blob)
Wersja 2019-12-12 lub nowsza 4000 MiB Około 190,7 TiB (4000 bloków MiB X 50 000) 5000 MiB (wersja zapoznawcza)
Wersja 2016-05-31 do wersji 2019-07-07 100 MiB Około 4,75 TiB (100 bloków MiB X 50 000) 256 MiB
Wersje wcześniejsze niż 2016-05-31 4 MiB Około 195 GiB (4 bloki MiB X 50.000) 64 MiB

Jeśli spróbujesz przekazać blokowy obiekt blob, który jest większy niż maksymalny rozmiar dozwolony dla tej wersji usługi lub stronicowy obiekt blob, który jest większy niż 8 TiB, usługa zwraca kod stanu 413 (Żądaj jednostki zbyt duży). Usługa Blob Service zwraca również dodatkowe informacje o błędzie w odpowiedzi, w tym maksymalny rozmiar obiektu blob dozwolony w bajtach.

Aby utworzyć nowy stronicowy obiekt blob, najpierw zainicjuj obiekt blob przez wywołanie Put Blob i określ jego maksymalny rozmiar, do 8 TiB. Podczas tworzenia stronicowego obiektu blob nie należy dołączać zawartości do treści żądania. Po utworzeniu obiektu blob wywołaj metodę Umieść stronę , aby dodać zawartość do obiektu blob lub zmodyfikować go.

Aby utworzyć nowy uzupełnilny obiekt blob, wywołaj metodę Put Blob tworzenia obiektu blob o długości zawartości o zerowej długości bajtów. Po utworzeniu uzupełnialnych obiektów blob wywołaj metodę Append Block , aby dodać zawartość na końcu obiektu blob.

Jeśli wywołasz metodę Put Blob zastąpienia istniejącego obiektu blob o tej samej nazwie, wszystkie migawki skojarzone z oryginalnym obiektem blob zostaną zachowane. Aby usunąć skojarzone migawki, najpierw wywołaj polecenie Usuń obiekt blob , a następnie Put Blob ponownie utwórz obiekt blob.

Obiekt blob ma właściwości niestandardowe (ustawione za pośrednictwem nagłówków), których można użyć do przechowywania wartości skojarzonych ze standardowymi nagłówkami HTTP. Te wartości można następnie odczytać, wywołując metodę Get Blob Properties (Pobierz właściwości obiektu blob) lub modyfikując wywołanie polecenia Set Blob Properties (Ustaw właściwości obiektu blob). Nagłówki właściwości niestandardowych i odpowiedni standardowy nagłówek HTTP są wymienione w poniższej tabeli:

Nagłówek HTTP Niestandardowy nagłówek właściwości obiektu blob
Content-Type x-ms-blob-content-type
Content-Encoding x-ms-blob-content-encoding
Content-Language x-ms-blob-content-language
Content-MD5 x-ms-blob-content-md5
Cache-Control x-ms-blob-cache-control

Semantyka ustawiania utrwalania tych wartości właściwości za pomocą obiektu blob w następujący sposób:

  • Jeśli klient określa nagłówek właściwości niestandardowej, zgodnie z prefiksem x-ms-blob , ta wartość jest przechowywana w obiekcie blob.

  • Jeśli klient określa standardowy nagłówek HTTP, ale nie nagłówek właściwości niestandardowej, wartość jest przechowywana w odpowiedniej właściwości niestandardowej skojarzonej z obiektem blob i jest zwracana przez wywołanie metody Get Blob Properties. Jeśli na przykład klient ustawi Content-Type nagłówek w żądaniu, ta wartość jest przechowywana we właściwości obiektu blob x-ms-blob-content-type .

  • Jeśli klient ustawia zarówno standardowy nagłówek HTTP, jak i odpowiedni nagłówek właściwości w tym samym żądaniu, żądanie PUT używa wartości podanej dla standardowego nagłówka HTTP, ale wartość określona dla nagłówka właściwości niestandardowej jest utrwalana z obiektem blob i zwracana przez kolejne żądania GET.

Jeśli tagi są podane w nagłówku x-ms-tags , muszą być zakodowane w ciągu zapytania. Klucze tagów i wartości muszą być zgodne z wymaganiami dotyczącymi nazewnictwa i długości, jak określono w temacie Ustawianie tagów obiektów blob. x-ms-tags Ponadto nagłówek może zawierać maksymalnie 2 kb tagów. Jeśli wymagana jest więcej tagów, użyj operacji Ustaw tagi obiektów blob .

Jeśli obiekt blob ma aktywną dzierżawę, klient musi określić prawidłowy identyfikator dzierżawy w żądaniu, aby zastąpić obiekt blob. Jeśli klient nie określi identyfikatora dzierżawy lub określa nieprawidłowy identyfikator dzierżawy, usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się). Jeśli klient określa identyfikator dzierżawy, ale obiekt blob nie ma aktywnej dzierżawy, usługa Blob service zwraca również kod stanu 412 (Warunek wstępny nie powiodło się). Jeśli klient określa identyfikator dzierżawy obiektu blob, który jeszcze nie istnieje, usługa Blob service zwróci kod stanu 412 (Warunek wstępny niepowodzenie) dla żądań wysyłanych w wersji 2013-08-15 i nowszych; w przypadku wcześniejszych wersji usługa Blob Service zwróci kod stanu 201 (Utworzono).

Jeśli istniejący obiekt blob z aktywną dzierżawą zostanie zastąpiony przez operację Put Blob , dzierżawa będzie nadal obowiązywać w zaktualizowanym obiekcie blob, dopóki nie wygaśnie lub zostanie wydana.

Put Blob Operacja jest dozwolona 10 minut na ukończenie programu MiB. Jeśli operacja trwa średnio dłużej niż 10 minut na miB, operacja zostanie przekroczona.

Zastąpienie zarchiwizowanego obiektu blob zakończy się niepowodzeniem i zastąpienie hot/cool obiektu blob będzie dziedziczyć warstwę ze starego obiektu blob, jeśli nie podano nagłówka x-ms-access-tier.

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