Wstawianie obiektu blob

  • Artykuł

Operacja Put Blob tworzy nowy blok, stronę lub uzupełnialne obiekty blob albo aktualizuje zawartość istniejącego blokowego obiektu blob. Operacja Put Blob zastąpi całą zawartość istniejącego obiektu blob o tej samej nazwie.

Podczas aktualizowania istniejącego blokowego obiektu blob wszystkie istniejące metadane obiektu blob są zastępowane. Zawartość istniejącego obiektu blob jest zastępowana zawartością nowego obiektu blob. Aktualizacje częściowe nie są obsługiwane w programie Put Blob. Aby wykonać częściową aktualizację zawartości blokowego obiektu blob, użyj operacji Umieść listę bloków .

Uzupełnialne obiekty blob można utworzyć tylko w wersjach 2015-02-21 i nowszych.

Wywołanie obiektu Put Blob w celu utworzenia stronicowego obiektu blob lub uzupełnialnych obiektów blob inicjuje tylko obiekt blob. Jeśli obiekt blob już istnieje, zawartość zostanie wyczyszczone. Aby dodać zawartość do stronicowego obiektu blob, wywołaj operację Umieść stronę . Aby dodać zawartość do uzupełnialnych obiektów blob, wywołaj operację Dołączanie bloku .

Żądanie

Żądanie można skonstruować Put Blob 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 HTTP/1.1

Żądanie usługi magazynu emulowanego

Gdy wysyłasz żądanie względem emulowanej usługi magazynu, określ nazwę hosta emulatora i port usługi Blob 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

Emulator magazynu obsługuje tylko rozmiary obiektów blob o rozmiarze do 2 gibibajtów (GiB).

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

Nagłówki żądań (wszystkie typy obiektów blob)

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

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.
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ż funkcja Put Blob jest używana 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 Pobierania obiektu blob w zasobie obiektu blob. Po zwróceniu tej wartości klient może użyć jej 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 kończy się niepowodzeniem z kodem błędu 400 (Nieprawidłowe żądanie).

Gdy nagłówek zostanie pominięty w wersji 2012-02-12 lub nowszej, usługa Blob Storage generuje skrót MD5.

Wyniki z poleceń Get Blob, Get Blob Properties i List Blobs 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 kończy się niepowodzeniem z kodem błędu 400 (Nieprawidłowe żądanie). Ten nagłówek jest obsługiwany w wersjach 02-02-2019 i nowszych.

Jeśli istnieją nagłówki Content-MD5 i x-ms-content-crc64, żądanie kończy się niepowodzeniem z błędem 400 (nieprawidłowe żądanie).
Cache-Control Opcjonalny. Usługa Blob Storage 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 nazwa-wartość skojarzone z obiektem blob jako metadane.

Uwaga: 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 i nowszych.
x-ms-encryption-context Opcjonalny. Wartość domyślna to "Empty". Jeśli wartość jest ustawiona, ustawi metadane systemu obiektów blob. Maksymalna długość-1024. Prawidłowe tylko wtedy, gdy hierarchiczna przestrzeń nazw jest włączona dla konta. Ten nagłówek jest obsługiwany w wersjach 2021-08-06 i 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 lub 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 zawiera dodatkowe informacje o sposobie przetwarzania ładunku odpowiedzi i można go użyć do dołączenia dodatkowych metadanych. Jeśli na przykład nagłówek ma wartość attachment, oznacza to, że agent użytkownika nie powinien wyświetlać odpowiedzi. Zamiast tego powinno zostać wyświetlone 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 (CORS) w odpowiedzi. Aby uzyskać więcej informacji, zobacz Obsługa mechanizmu CORS dla usług Azure Storage.
x-ms-client-request-id Opcjonalny. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB), który jest rejestrowany w dziennikach analizy 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 About Storage analytics logging (Informacje o rejestrowaniu analizy magazynu).
x-ms-access-tier Opcjonalny. Warstwa, która ma zostać ustawiona na obiekt blob. W przypadku stronicowych obiektów blob na koncie Premium Storage tylko w wersji 2017-04-17 lub nowszej. Aby uzyskać pełną listę warstw obsługiwanych przez stronicowy obiekt blob, zobacz Magazyn w warstwie Premium o wysokiej wydajności i dyski zarządzane dla maszyn wirtualnych. W przypadku blokowych obiektów blob obsługiwane na kontach magazynu obiektów blob lub ogólnego przeznaczenia w wersji 2 tylko w wersji 2018-11-09 lub nowszej. Prawidłowe wartości warstw blokowych obiektów blob 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 blokowych obiektów blob, zobacz Warstwy magazynowania Gorąca, Chłodna i Archiwum.
x-ms-immutability-policy-until-date Wersja 2020-06-12 lub nowsza. Określa okres przechowywania do daty, który ma zostać ustawiony 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 lub nowsza. Określa tryb zasad niezmienności, który ma być ustawiony w obiekcie blob. Prawidłowe wartości to unlocked i locked. W programie unlockedużytkownicy mogą zmieniać zasady, zwiększając lub zmniejszając okres przechowywania do daty. W przypadku lockedprogramu te działania są zabronione.
x-ms-legal-hold Wersja 2020-06-12 lub nowsza. Określa archiwizację prawną, która ma zostać ustawiona w obiekcie blob. Prawidłowe wartości to true i false.
x-ms-expiry-option Opcjonalny. Wersja 2023-08-03 lub nowsza. Określa opcję daty wygaśnięcia dla żądania. Aby uzyskać więcej informacji, zobacz ExpiryOption. Ten nagłówek jest prawidłowy dla kont z włączoną hierarchiczną przestrzenią nazw.
x-ms-expiry-time Opcjonalny. Wersja 2023-08-03 lub nowsza. Określa czas wygaśnięcia obiektu blob. Format daty wygaśnięcia różni się w zależności od x-ms-expiry-option. Aby uzyskać więcej informacji, zobacz ExpiryOption. Ten nagłówek jest prawidłowy dla kont z włączoną hierarchiczną przestrzenią nazw.

Ta operacja obsługuje również używanie nagłówków warunkowych do zapisywania 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)

Nagłówki żądań, które mają zastosowanie tylko do operacji na stronicowych obiektach blob, zostały opisane w poniższej tabeli:

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 , maksymalnie 8 tebibajtów (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łnialnych obiektów blob, usługa Blob Storage zwraca kod stanu 400 (nieprawidłowe żądanie).
x-ms-blob-sequence-number: <num> Opcjonalny. Ustaw tylko stronicowe obiekty blob. Numer sekwencji jest wartością kontrolowaną 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 lub nowsza. W przypadku stronicowych obiektów blob tylko na koncie magazynu w warstwie Premium. Określa warstwę, która ma zostać ustawiona w obiekcie blob. Aby uzyskać pełną listę obsługiwanych warstw, zobacz Magazyn w warstwie Premium o wysokiej wydajności i dyski zarządzane dla maszyn wirtualnych.
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ść 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.

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

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

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

Poniższy przykład przedstawia żą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  
x-ms-expiry-option: RelativeToNow
x-ms-expiry-time: 30000
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 jako 1024 bajtów. Aby dodać zawartość do stronicowego obiektu blob, należy wywołać metodę Put Page:

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. Aby dodać zawartość do uzupełnialnych obiektów blob, należy wywołać funkcję Append Block:

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

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
ETag Zawiera wartość, która może być używana przez klienta do wykonywania operacji warunkowych PUT przy użyciu nagłówka If-Match żądania. 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.
Content-MD5 Zwrócony dla blokowego obiektu blob, aby klient mógł sprawdzić integralność zawartości komunikatu. Zwrócona Content-MD5 wartość jest obliczana przez usługę Blob Storage. W wersji 2012-02-12 lub 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 Zwrócony dla blokowego obiektu blob, aby klient mógł sprawdzić integralność zawartości komunikatu. Zwrócona x-ms-content-crc64 wartość jest obliczana przez usługę Blob Storage. Ten nagłówek jest zawsze zwracany w wersji 2019-02-02.
x-ms-request-id Unikatowo identyfikuje żądanie, które zostało wykonane, i można go 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. Zwrócono żądania dotyczące 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. Ten nagłówek zwraca wartość nagłówka żądania źródła, jeśli istnieje dopasowanie.
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 ma 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. W przeciwnym razie wartość to false.
x-ms-encryption-key-sha256 Wersja 2019-02-02 lub nowsza. Zwrócone, 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. Zwrócone, jeśli żądanie używa 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 lub 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

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

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 .

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 Put Blob 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

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 on usunięty i utworzony ponownie.

W poniższej tabeli opisano maksymalne dozwolone rozmiary bloków i obiektów blob według wersji usługi:

Wersja usługi Maksymalny rozmiar bloku (za pośrednictwem Put Block) Maksymalny rozmiar obiektu blob (za pośrednictwem Put Block List) Maksymalny rozmiar obiektu blob za pośrednictwem operacji pojedynczego zapisu (za pośrednictwem Put Blobmetody )
Wersja 2019-12-12 lub nowsza 4000 mebibajtów (MiB) Około 190,7 TiB (4000 MiB × 50 000 bloków) 5000 MiB
Wersje 2016-05-31 do 2019-07-07 100 MiB Około 4,75 TiB (100 MiB × 50 000 bloków) 256 MiB
Wersje starsze niż 2016-05-31 4 MiB Około 195 GiB (4 MiB × 50 000 bloków) 64 MiB

Jeśli spróbujesz przekazać blokowy obiekt blob większy niż maksymalny dozwolony rozmiar dla tej wersji usługi lub stronicowy obiekt blob większy niż 8 TiB, usługa zwróci kod stanu 413 (Zbyt duża jednostka żądania). Usługa Blob Storage 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 zainicjuj obiekt blob przez wywołanie Put Blobmetody , a następnie określ maksymalny rozmiar do 8 TiB. Podczas tworzenia stronicowego obiektu blob nie dołączaj zawartości do treści żądania. Po utworzeniu obiektu blob wywołaj metodę Umieść stronę , aby dodać zawartość do obiektu blob lub zmodyfikować ją.

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

Jeśli wywołasz metodę Put Blob zastępowania istniejącego obiektu blob o tej samej nazwie, wszystkie migawki skojarzone z oryginalnym obiektem blob zostaną zachowane. Aby usunąć skojarzone migawki, najpierw wywołaj metodę Delete Blob, a następnie wywołaj Put Blob metodę , aby ponownie utworzyć obiekt blob.

Właściwości niestandardowe obiektu blob

Obiekt blob ma właściwości niestandardowe (ustawiane za pomocą nagłówków), których można użyć do przechowywania wartości skojarzonych ze standardowymi nagłówkami HTTP. Następnie możesz odczytać te wartości, wywołując metodę Pobierz właściwości obiektu blob lub modyfikując je, wywołując polecenie 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 lub utrwalania tych wartości właściwości za pomocą obiektu blob jest następująca:

  • Jeśli klient określa nagłówek właściwości niestandardowej x-ms-blob wskazany przez prefiks, 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 żądania, ta wartość jest przechowywana we właściwości obiektu blob x-ms-blob-content-type .

  • Jeśli klient ustawi 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 i wartości tagów muszą być zgodne z wymaganiami dotyczącymi nazewnictwa i długości określonymi w temacie Set Blob Tags. x-ms-tags Ponadto nagłówek może zawierać maksymalnie 2 kb tagów. Jeśli wymagane 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 dla żądania zastąpienia obiektu blob. Jeśli klient nie określi identyfikatora dzierżawy lub określi nieprawidłowy identyfikator dzierżawy, usługa Blob Storage zwraca kod stanu 412 (Niepowodzenie warunku wstępnego). Jeśli klient określa identyfikator dzierżawy, ale obiekt blob nie ma aktywnej dzierżawy, usługa Blob Storage zwraca również kod stanu 412 (Niepowodzenie warunku wstępnego). Jeśli klient określa identyfikator dzierżawy obiektu blob, który jeszcze nie istnieje, usługa Blob Storage zwraca kod stanu 412 (Niepowodzenie warunku wstępnego) dla żądań wysyłanych w wersji 2013-08-15 lub nowszej. W przypadku wersji starszych niż 2013-08-15 usługa Blob Storage zwraca kod stanu 201 (Utworzony).

Jeśli istniejący obiekt blob z aktywną dzierżawą zostanie zastąpiony przez operację Put Blob , dzierżawa będzie utrzymywana na zaktualizowanym obiekcie blob do momentu wygaśnięcia lub zwolnienia.

Operacja Put Blob jest dozwolona 10 minut na ukończenie miB. Jeśli operacja trwa średnio dłużej niż 10 minut na miB, limit czasu operacji przekracza limit czasu.

Zastępowanie archive obiektu blob kończy się niepowodzeniem i zastąpienie obiektu hot lub cool obiektu blob dziedziczy warstwę ze starego obiektu blob, jeśli x-ms-access-tier nie podano nagłówka.

WygaśnięcieOption

Następujące wartości można wysłać jako nagłówek x-ms-expiry-option . W tym nagłówku nie jest uwzględniana wielkość liter.

Opcja wygaśnięcia Opis
RelativeToNow Ustawia datę wygaśnięcia względem bieżącej godziny. x-ms-expiry-time musi być określona jako liczba milisekund, które upłynęły od chwili obecnej.
Absolute x-ms-expiry-time musi być określony jako czas bezwzględny w formacie RFC 1123.
NeverExpire Ustawia obiekt blob tak, aby nigdy nie wygasał lub usuwał bieżącą datę wygaśnięcia. x-ms-expiry-time nie może być określony.

Semantyka ustawiania daty wygaśnięcia obiektu blob jest następująca:

  • Set Expiry można ustawić tylko w obiekcie blob, a nie w katalogu.
  • Set ExpiryexpiryTime w przeszłości nie jest dozwolone.
  • ExpiryTime Nie można określić parametru expiryOptionNevero wartości .

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 Put Blob żądań na podstawie typu konta magazynu:

Operacja Typ konta magazynu Kategoria rozliczeń
Wstawianie obiektu blob Blokowy obiekt blob w warstwie Premium
Standardowa ogólnego przeznaczenia, wersja 2
Standardowa ogólnego przeznaczenia, wersja 1		 Operacje zapisu

Aby dowiedzieć się więcej o cenach dla określonej kategorii rozliczeniowej, 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 Service
Ustawianie limitów czasu dla operacji usługi Blob Service