Wstawianie obiektu blob

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

Zaktualizowanie istniejącego blokowego obiektu blob zastępuje wszystkie istniejące metadane obiektu blob. Aktualizacje częściowe nie są obsługiwane w przypadku funkcji Umieść obiekt blob; zawartość istniejącego obiektu blob jest zastępowana zawartością nowego obiektu blob. Aby przeprowadzić częściową aktualizację zawartości blokowego obiektu blob, użyj operacji Umieść listę zablokowanych.

Pamiętaj, że uzupełnialne obiekty blob można tworzyć tylko w wersji 2015-02-21 i nowszych.

Wywołanie do obiektu w Put Blob celu utworzenia stronicowego obiektu blob lub uzupełnialnego obiektu blob inicjuje tylko obiekt blob. Aby dodać zawartość do stronicowego obiektu blob, wywołaj operację Umieść stronę. Aby dodać zawartość do uzupełnianego obiektu blob, wywołaj operację Dołącz blok.

Żądanie

Żądanie Put Blob może zostać skonstruowane w następujący sposób. Protokół HTTPS jest zalecany. Zastąp myaccount nazwą swojego konta magazynu:

PUT Method Request URI Wersja PROTOKOŁU HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob HTTP/1.1

Emulowany adres URI usługi magazynu

Podczas tworzenia żądania względem emulowanej usługi magazynu określ nazwę hosta emulatora i port Blob service jako , a następnie nazwę 127.0.0.1:10000 emulowanej konta magazynu:

PUT Method Request URI 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 obiekty blob o rozmiarze do 2 GiB.

Aby uzyskać więcej informacji, zobacz Using the Azure Storage Emulator for Development and Testing (Używanie usługi Azure Storage Emulator for Development and Testing).

Parametry identyfikatora URI

W żądaniu URI 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 Versioning for the Azure Storage Services (Wersjeusług Azure Storage Services).
Content-Length Wymagane. Długość żądania.

W przypadku stronicowego obiektu blob lub uzupełnianego obiektu blob wartość tego nagłówka musi być ustawiona na zero, ponieważ put blob jest używany tylko do inicjowania obiektu blob. Aby zapisać zawartość do istniejącego stronicowego obiektu blob, wywołaj wywołanie Put Page. Aby zapisać zawartość do uzupełnianego obiektu blob, wywołaj blok dołączania.
Content-Type Opcjonalny. Typ zawartości MIME obiektu blob. Domyślny typ to application/octet-stream .
Content-Encoding Opcjonalny. Określa, które kodowanie zawartości zostało zastosowane do obiektu blob. Ta wartość jest zwracana do klienta, gdy operacja Pobierz obiekt blob jest wykonywana na zasobie obiektu blob. Klient może użyć tej wartości po zwróceniu, aby zdekodować zawartość 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 sprawdzania integralności obiektu blob podczas transportu. Gdy ten nagłówek jest określony, usługa magazynu sprawdza skrót, który dotarł do wysłanego nagłówka. Jeśli te dwa skróty nie są zgodne, operacja nie powiedzie się z kodem błędu 400 (Złe żądanie).

W przypadku pominięcia w wersji 2012-02-12 lub nowszej Blob service generuje skrót MD5.

Wyniki z pól Get Blob (Pobierzobiekt blob), Get Blob Properties (Pobierzwłaściwości obiektu blob) i List Blobs (Lista obiektów blob) zawierają skrót MD5.
x-ms-content-crc64 Opcjonalny. Skrót CRC64 zawartości obiektu blob. Ten skrót służy do sprawdzania integralności obiektu blob podczas transportu. Gdy ten nagłówek jest określony, usługa magazynu sprawdza skrót, który dotarł do wysłanego nagłówka. Jeśli te dwa skróty nie są zgodne, operacja nie powiedzie się z kodem błędu 400 (Złe żądanie). Ten nagłówek jest obsługiwany w wersji 02-02-2019 lub nowszej.

Jeśli istnieją nagłówki Content-MD5 i x-ms-content-crc64, żądanie nie powiedzie się z 400 (złe żądanie).
Cache-Control Opcjonalny. Ten Blob service przechowuje tę wartość, ale nie używa ani nie modyfikuje jej.
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, stronicowy obiekt blob lub uzupełnialne obiekty blob. Obsługa tworzenia uzupełnialne obiekty blob jest dostępna tylko w wersji 2015-02-21 i nowszych.
x-ms-meta-name:value Opcjonalny. Pary nazwa-wartość skojarzone z obiektem blob jako metadane.

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 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 Content-Disposition blob. Dostępne w wersji 2013-08-15 i nowszych.

Pole nagłówka odpowiedzi zawiera dodatkowe informacje na temat sposobu przetwarzania ładunku odpowiedzi, a także może służyć Content-Disposition do dołączania dodatkowych metadanych. Jeśli na przykład ustawiono wartość , oznacza to, że użytkownik-agent nie powinien wyświetlać odpowiedzi, ale zamiast tego wyświetlać okno dialogowe Zapisz jako z nazwą pliku inną niż określona attachment 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 powstanie nagłówków udostępniania zasobów między źródłami w odpowiedzi. Aby uzyskać szczegółowe informacje, zobacz Obsługa Storage CORS.
x-ms-client-request-id Opcjonalny. Zapewnia wygenerowaną przez klienta nieprzezroczystą wartość z limitem znaków 1 KiB, który jest rejestrowany w dziennikach analizy 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 Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests (Informacje o rejestrowaniu usługi Azure Analytics i rejestrowaniu na platformie Azure: używanie dzienników do śledzenia Storage żądań).
x-ms-access-tier Opcjonalny. Wskazuje warstwę, która ma zostać ustawiona dla obiektu blob. Stronicowe obiekty blob na koncie magazynu w chmurze Premium są dostępne tylko w wersji 2017-04-17 i nowszej. Aby uzyskać pełną listę obsługiwanych warstw stronicowych obiektów blob, sprawdź dyski Premium Storage i zarządzane dla maszyn wirtualnych o wysokiej wydajności. W przypadku blokowych obiektów blob obsługiwanych na kontach usługi Blob Storage lub kontach ogólnego przeznaczenia w wersji 2 tylko w wersji 2018-11-09 i nowszej. Prawidłowe wartości dla warstw blokowych obiektów blob to Hot / Cool / Archive . 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 nowsze. Określa datę "przechowywania do" do ustawienia dla obiektu 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 nowsze. Określa tryb zasad niezmienności do ustawienia dla obiektu blob. Prawidłowe wartości to unlocked / locked . unlocked wskazuje, że użytkownik może zmienić zasady, zwiększając lub zmniejszając datę przechowywania do. locked wskazuje, że te akcje są zabronione.
x-ms-legal-hold Wersja 2020-06-12 i nowsze. Określa wstrzymanie ze względu na prawo, które ma zostać ustawione dla obiektu 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 określony warunek jest spełniony. Aby uzyskać więcej informacji, zobacz Specifying Conditional Headers for Blob Service Operations(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ń, które mają zastosowanie tylko do operacji na stronicowych obiektach blob.

Nagłówek żądania Opis
x-ms-blob-content-length: bytes Wymagane w przypadku 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-bajtowej.

Jeśli ten nagłówek jest określony dla blokowego obiektu blob lub uzupełnianego obiektu blob, Blob service zwraca kod stanu 400 (Złe żądanie).
x-ms-blob-sequence-number: <num> Opcjonalny. Ustawienie tylko dla stronicowych obiektów blob. Numer sekwencji to kontrolowana przez użytkownika wartość, która umożliwia śledzenie żądań. Wartość numeru sekwencji musi być z wartości od 0 do 2^63-1. Wartość domyślna to 0.
x-ms-access-tier Wersja 2017-04-17 i nowsze. W przypadku stronicowych obiektów blob tylko na koncie magazynu w chmurze w chmurze Premium. Określa warstwę, która ma zostać ustawiona dla obiektu blob. Aby uzyskać pełną listę obsługiwanych warstw, Premium Storage o wysokiej wydajności dla maszyn wirtualnych i dysków zarządzanych.
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 nagłówka, jeśli jest obecny w żądaniu, a wartość jest co najwyżej 1024 widocznych znaków x-ms-client-request-id ASCII. Jeśli nagłówek x-ms-client-request-id nie jest obecny w żądaniu, ten nagłówek nie będzie obecny w odpowiedzi.

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

Począwszy od wersji 2019-02-02, w żądaniu można określić następujące nagłówki w celu zaszyfrowania obiektu blob przy użyciu klucza dostarczonego przez klienta. Szyfrowanie za pomocą 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 klucza szyfrowania zakodowany w formacie Base64.
x-ms-encryption-algorithm: AES256 Wymagane. Określa algorytm używany do szyfrowania. Wartość tego nagłówka musi być AES256 .

Treść żądania

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

W przypadku stronicowego obiektu blob lub uzupełnianego obiektu blob treść żądania jest pusta.

Przykładowe żądanie

W poniższym przykładzie pokazano żą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 jego maksymalny rozmiar na 1024 bajty. Należy pamiętać, że należy wywołać pozycję 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 obiekty blob. Należy pamiętać, że należy wywołać blok dołączania, aby dodać zawartość do uzupełnianego 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

Pomyślna operacja 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 standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi Opis
ETag Tag ETag zawiera wartość, za pomocą których klient może wykonywać operacje PUT warunkowe przy użyciu If-Match nagłówka żą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 ze dokumencie RFC 1123. Aby uzyskać więcej informacji, zobacz Representation of Date-Time Values in Headers(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.
Content-MD5 Ten nagłówek jest zwracany dla blokowego obiektu blob, dzięki czemu klient może sprawdzić integralność zawartości wiadomości. Zwracana Content-MD5 wartość jest obliczana przez Blob service. W wersji 2012-02-12 i nowszych ten nagłówek jest zwracany nawet wtedy, gdy żądanie nie zawiera Content-MD5 x-ms-blob-content-md5 nagłówków ani .
x-ms-content-crc64 Ten nagłówek jest zwracany dla blokowego obiektu blob, dzięki czemu klient może sprawdzić integralność zawartości wiadomości. Zwracana x-ms-content-crc64 wartość jest obliczana przez Blob service. Ten nagłówek będzie zawsze zwracany od wersji 2019-02-02.
x-ms-request-id Ten nagłówek unikatowo 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 Troubleshooting API Operations (Rozwiązywanie problemów z operacjami interfejsu API).
x-ms-version Wskazuje wersję pliku Blob service do wykonania żądania. Ten nagłówek jest zwracany w przypadku żądań względem wersji 2009-09-19 i nowszych.
Date Wartość daty/czasu UTC wygenerowana przez usługę, która wskazuje czas, o której została zainicjowana odpowiedź.
Access-Control-Allow-Origin Zwracany, jeśli żądanie zawiera nagłówek, a Origin funkcja CORS jest włączona z regułą dopasowywania. Ten nagłówek zwraca wartość nagłówka żądania źródła w przypadku dopasowania.
Access-Control-Expose-Headers Zwracany, jeśli żądanie zawiera nagłówek, a Origin funkcja CORS jest włączona z regułą dopasowywania. 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 nagłówek, a funkcja CORS jest włączona z regułą dopasowania, Origin 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 ustawiona na , jeśli zawartość żądania została pomyślnie zaszyfrowana przy true użyciu określonego algorytmu i false w przeciwnym razie.
x-ms-encryption-key-sha256 Wersja 2019-02-02 lub nowsza. Ten nagłówek jest zwracany, jeśli żądanie używa klucza dostarczonego przez klienta do szyfrowania, dzięki czemu klient może 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żywa zakresu szyfrowania, dzięki czemu klient może 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 nowsze. Ten nagłówek zwraca DateTime nieprzezroczystą wartość, która unikatowo identyfikuje obiekt blob. Wartość tego nagłówka wskazuje wersję obiektu blob i może być używana w kolejnych żądaniach w celu uzyskania 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ółdzielonych, który ma uprawnienia do zapisu do tego obiektu blob lub jego kontenera.

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

Uwagi

Podczas tworzenia obiektu blob należy określić, czy jest to blokowy obiekt blob, uzupełniający obiekt blob, czy stronicowy obiekt blob, określając wartość x-ms-blob-type nagłówka. Po utworzeniu obiektu blob nie można zmienić typu obiektu blob, chyba że zostanie on 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 pośrednictwem bloku Put) Maksymalny rozmiar obiektu blob (za pośrednictwem listy bloków put) Maksymalny rozmiar obiektu blob za pośrednictwem pojedynczej operacji zapisu (za pośrednictwem put blob)
Wersja 2019-12-12 i nowsze 4000 MiB Około 190,7 TiB (4000 MiB x 50 000 bloków) 5000 MiB (wersja zapoznawcza)
Wersja od 2016-05-31 do wersji 2019-07-07 100 MiB Około 4,75 TiB (100 MiB x 50 000 bloków) 256 MiB
Wersje wcześniejsze niż 2016-05-31 4 miB Około 195 GiB (4 mib x 50 000 bloków) 64 MiB

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

Aby utworzyć nowy stronicowy obiekt blob, najpierw zaimicjuj obiekt blob, wywołując go i określając jego maksymalny rozmiar Put Blob do 8 TiB. Podczas tworzenia stronicowego obiektu blob nie uwzględniaj zawartości w treści żądania. Po utworzeniu obiektu blob wywołaj pozycję Umieść stronę, aby dodać zawartość do obiektu blob lub zmodyfikować go.

Aby utworzyć nowy uzupełniany obiekt blob, wywołaj wywołanie , aby Put Blob utworzyć obiekt blob o długości zawartości 0 bajtów. Po utworzeniu uzupełnianego obiektu blob wywołaj blok dołączania, aby dodać zawartość na końcu obiektu blob.

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

Obiekt blob ma właściwości niestandardowe (ustawiane 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 mogą być następnie odczytywane przez wywołanie funkcji Pobierz właściwości obiektu bloblub zmodyfikowane przez wywołanie funkcji 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 Nagłówek niestandardowej 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 niestandardowy nagłówek właściwości wskazywany przez prefiks, ta wartość x-ms-blob jest przechowywana wraz z obiektem 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 Get Blob Properties . Jeśli na przykład klient ustawia nagłówek żądania, ta wartość jest Content-Type przechowywana we właściwości x-ms-blob-content-type obiektu blob.

  • 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 x-ms-tags nagłówku, muszą być zakodowane w ciągu zapytania. Klucze i wartości tagów muszą być zgodne z wymaganiami w zakresie nazewnictwa i długości określonymi w części Ustawianie tagów obiektów blob. Ponadto nagłówek x-ms-tags może zawierać do 2 kb tagów. Jeśli jest wymaganych 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śli nieprawidłowy identyfikator dzierżawy, Blob service zwraca kod stanu 412 (Niepowodzenie warunku wstępnego). Jeśli klient określa identyfikator dzierżawy, ale obiekt blob nie ma aktywnej dzierżawy, Blob service zwraca również kod stanu 412 (Niepowodzenie warunku wstępnego). Jeśli klient określi identyfikator dzierżawy obiektu blob, który jeszcze nie istnieje, usługa Blob service zwróci kod stanu 412 (Niepowodzenie warunku wstępnego) dla żądań w wersji 2013-08-15 i nowszych; w poprzednich wersjach Blob service zwróci kod stanu 201 (Utworzono).

Jeśli istniejący obiekt blob z aktywną dzierżawą zostanie zastąpiony przez operację, dzierżawa będzie trwała na zaktualizowanym obiekcie blob, dopóki nie Put Blob wygaśnie lub nie zostanie zwolniona.

Do Put Blob ukończenia operacji jest dozwolone 10 minut na mib. Jeśli operacja trwa średnio dłużej niż 10 minut na mib, limit czasu operacji zostanie ubożny.

Nadpisanie zarchiwizowany obiekt blob nie powiedzie się i jeśli nie podano nagłówka hot / x-ms-access-tier, jego nadpisanie spowoduje dziedziczenie warstwy ze starego obiektu cool blob.

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 dla operacji usługi Blob Service