Umieść obiekt blob z adresu URL

Operacja Put Blob from URL tworzy nowy blokowy obiekt blob, w którym zawartość obiektu blob jest odczytywana z danego adresu URL. Ten interfejs API jest dostępny od wersji 2020-04-08.

Częściowe aktualizacje nie są obsługiwane w przypadku funkcji Put Blob z adresu URL; zawartość istniejącego obiektu blob jest zastępowana zawartością nowego obiektu blob. Aby wykonać częściowe aktualizacje zawartości bloku obiektu blob przy użyciu źródłowego adresu URL, użyj interfejsu API Put Block from URL w połączeniu z put block list.

Rozmiar źródłowego obiektu blob może wynosić maksymalną długość 256 mib.

Żądanie

Żądanie Put Blob from URL 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ń

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.

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. Określa liczbę bajtów przesyłanych w treści żądania. Wartość tego nagłówka musi być ustawiona na zero. Jeśli długość nie jest równa zero, operacja zakończy się niepowodzeniem z kodem stanu 400 (nieprawidłowe żądanie).
x-ms-copy-source:name Wymagane. Określa adres URL źródłowego obiektu blob. Wartość może być adresem URL o długości do 2 KiB, który określa obiekt blob. Wartość powinna być zakodowana w adresie URL, ponieważ jest wyświetlana w identyfikatorze URI żądania. Źródłowy obiekt blob musi być publiczny lub musi być autoryzowany za pośrednictwem sygnatury dostępu współdzielonego. Jeśli źródłowy obiekt blob jest publiczny, do wykonania operacji nie jest wymagana autoryzacja. Jeśli rozmiar źródłowego obiektu blob jest większy niż 256 MiB, żądanie zakończy się niepowodzeniem z 409 (konflikt). Oto kilka przykładów adresów URL obiektów źródłowych:

- https://myaccount.blob.core.windows.net/mycontainer/myblob
- https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>
- https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>
x-ms-copy-source-authorization: <scheme> <signature> Opcjonalny. Określa schemat autoryzacji i podpis dla źródła kopiowania. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
Tylko program nośny schematu jest obsługiwany w przypadku Azure Active Directory.
Ten nagłówek jest obsługiwany w wersjach 2020-10-02 i nowszych
x-ms-blob-type: BlockBlob Wymagane. Określa typ obiektu blob do utworzenia. Musi mieć wartość BlockBlob. Jeśli typ obiektu blob nie BlockBlobjest , operacja zakończy się niepowodzeniem z kodem stanu 400 (nieprawidłowe żądanie).
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.
Cache-Control Opcjonalny. Usługa Blob przechowuje tę wartość, ale nie używa jej ani nie modyfikuje.
x-ms-source-content-md5 Opcjonalny. Skrót MD5 zawartości obiektu blob z identyfikatora URI. Ten skrót służy do weryfikowania integralności obiektu blob podczas transportu danych z identyfikatora URI. Po określeniu tego nagłówka usługa magazynu porównuje skrót zawartości, która dotarła ze źródła kopiowania z tą wartością nagłówka. Po pominięciu usługa Blob generuje skrót MD5.

Jeśli dwa skróty nie są zgodne, operacja zakończy się niepowodzeniem z kodem błędu 400 (Nieprawidłowe żądanie).
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).
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-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-copy-source-tag-option Opcjonalny. Możliwe wartości to REPLACE lub COPY (uwzględniana wielkość liter). Wartość domyślna to REPLACE.

Jeśli zostanie określona wartość COPY, tagi ze źródłowego obiektu blob zostaną skopiowane do docelowego obiektu blob. Źródłowy obiekt blob musi być prywatny, a żądanie musi mieć uprawnienia do pobierania tagów obiektów blob w źródłowym obiekcie blob i ustawiania tagów obiektów blob w docelowym obiekcie blob. Powoduje to dodatkowe wywołanie operacji Pobierz tagi obiektów blob na koncie źródłowym.

Funkcja REPLACE ustawi tagi określone przez x-ms-tags nagłówek w docelowym obiekcie blob. Jeśli funkcja REPLACE i żadne tagi nie są określone przez x-ms-tagsusługę , żadne tagi nie zostaną ustawione na docelowym obiekcie blob. Określanie wartości COPY i x-ms-tags spowoduje wyświetlenie elementu 409 conflict.

Obsługiwane w wersji 2021-04-10 i nowszej.
x-ms-source-if-modified-since Opcjonalny. Wartość DateTime . Określ ten nagłówek warunkowy, aby umieścić obiekt blob tylko wtedy, gdy źródłowy obiekt blob został zmodyfikowany od określonej daty/godziny. Jeśli źródłowy obiekt blob nie został zmodyfikowany, usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się). Nie można określić tego nagłówka, jeśli źródłem jest plik platformy Azure.
x-ms-source-if-unmodified-since Opcjonalny. Wartość DateTime . Określ ten nagłówek warunkowy, aby umieścić obiekt blob tylko wtedy, gdy źródłowy obiekt blob nie został zmodyfikowany od określonej daty/godziny. Jeśli źródłowy obiekt blob został zmodyfikowany, usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się). Nie można określić tego nagłówka, jeśli źródłem jest plik platformy Azure.
x-ms-source-if-match Opcjonalny. Wartość elementu ETag. Określ ten nagłówek warunkowy, aby umieścić źródłowy obiekt blob tylko wtedy, gdy element ETag jest zgodny z określoną wartością. Jeśli wartości ETag nie są zgodne, usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się). Nie można określić tego nagłówka, jeśli źródłem jest plik platformy Azure.
x-ms-source-if-none-match Opcjonalny. Wartość elementu ETag. Określ ten nagłówek warunkowy, aby umieścić obiekt blob tylko wtedy, gdy element ETag nie jest zgodny z określoną wartością. Jeśli wartości są identyczne, usługa Blob service zwraca kod stanu 412 (Warunek wstępny nie powiodło się). Nie można określić tego nagłówka, jeśli źródłem jest plik platformy Azure.
If-Modified-Since Opcjonalny. Wartość DateTime . Określ ten nagłówek warunkowy, aby umieścić obiekt blob tylko wtedy, gdy docelowy obiekt blob został zmodyfikowany od określonej daty/godziny. Jeśli docelowy obiekt blob nie został zmodyfikowany, usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się).
If-Unmodified-Since Opcjonalny. Wartość DateTime . Określ ten nagłówek warunkowy, aby umieścić obiekt blob tylko wtedy, gdy docelowy obiekt blob nie został zmodyfikowany od określonej daty/godziny. Jeśli docelowy obiekt blob został zmodyfikowany, usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się).
If-Match Opcjonalny. Wartość elementu ETag. Określ wartość ETag dla tego nagłówka warunkowego, aby umieścić obiekt blob tylko wtedy, gdy określona wartość ETag jest zgodna z ETag wartością istniejącego docelowego obiektu blob. Jeśli element ETag dla docelowego obiektu blob nie jest zgodny z elementem ETag określonym dla If-Matchelementu , usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się).
If-None-Match Opcjonalny. Wartość ETag lub symbol wieloznaczny (*).

Określ wartość ETag dla tego nagłówka warunkowego, aby umieścić obiekt blob tylko wtedy, gdy określona wartość ETag nie jest zgodna z wartością ETag docelowego obiektu blob.

Określ symbol wieloznaczny (*) do wykonania operacji tylko wtedy, gdy docelowy obiekt blob nie istnieje.

Jeśli określony warunek nie zostanie spełniony, usługa Blob zwraca kod stanu 412 (Warunek wstępny nie powiodło się).
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. Prawidłowe wartości dla warstw blokowych obiektów blob są Hot//CoolArchive obsługiwane na kontach magazynu obiektów blob lub ogólnego przeznaczenia w wersji 2 począwszy od wersji 2018-11-09. Aby uzyskać szczegółowe informacje na temat warstw blokowych obiektów blob , zobacz Warstwy magazynowania Gorąca, Chłodna i Archiwum.

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ń (klucze szyfrowania dostarczone przez klienta)

Następujące nagłówki można określić w żądaniu 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

Brak treści żądania.

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: 2020-04-08  
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-copy-source: https://myaccount.blob.core.windows.net/mycontainer/myblob
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
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 standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi Opis
ETag Element 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. 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.
Content-MD5 Ten nagłówek jest zwracany dla blokowego obiektu blob, aby klient mógł sprawdzić integralność zawartości komunikatu. Zwrócona Content-MD5 wartość jest obliczana przez usługę Blob Service. 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. Zwrócona x-ms-content-crc64 wartość jest obliczana przez usługę Blob Service. Ten nagłówek będzie zawsze zwracany.
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.
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-request-server-encrypted: true/false Wartość tego nagłówka jest ustawiana na true wartość , jeśli zawartość żądania została pomyślnie zaszyfrowana przy użyciu określonego algorytmu i false w inny sposób.
x-ms-encryption-key-sha256 Ten nagłówek jest zwracany, jeśli żądanie użyło 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 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> 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 jego 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

Operacja jest obsługiwana Put Blob from URL2020-04-08 od wersji.

W wersji 2020-10-02 i nowszych autoryzacja Azure Active Directory jest obsługiwana dla źródła operacji kopiowania.

Źródłowy obiekt blob może mieć dowolny typ, w tym blokowy obiekt blob, uzupełnialne obiekty blob lub stronicowy obiekt blob. Docelowy obiekt blob musi jednak być blokowym obiektem blob.

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 Block from URL) Maksymalny rozmiar obiektu blob (za pośrednictwem listy umieszczania bloków) Maksymalny rozmiar obiektu blob za pośrednictwem operacji pojedynczego zapisu (za pomocą polecenia Umieść obiekt blob z adresu URL)
Wersja 2020-04-08 i nowsze 4000 MiB Około 190,7 TiB (4000 bloków MiB X 50 000) 5000 MiB (wersja zapoznawcza)
Wersje wcześniejsze niż 2020-04-08 100 MiB Około 4,75 TiB (100 bloków MiB X 50 000) 256 MiB

Operacja Put Blob from URL zawsze kopiuje cały źródłowy obiekt blob. Kopiowanie zakresu bajtów lub zestawu bloków nie jest obsługiwane. Aby wykonać aktualizacje częściowe, zapoznaj się z artykułem Put Block From URL (Umieść blok z adresu URL). Docelowy obiekt blob może być istniejącym blokowym obiektem blob lub może być nowym obiektem blob utworzonym przez operację.

W przypadku używania blokowego obiektu blob jako obiektu źródłowego jest kopiowana cała zatwierdzona zawartość obiektu blob. Jednak lista bloków nie jest zachowywana, a niezatwierdzone bloki nie są kopiowane. Zawartość docelowego obiektu blob będzie identyczna z zawartością źródła, ale zatwierdzona lista bloków nie zostanie zachowana.

Umieszczanie właściwości obiektu blob i metadanych

Podczas tworzenia blokowego obiektu blob ze źródła kopii standardowe właściwości obiektu blob są domyślnie kopiowane ze źródłowego obiektu blob. Jeśli w żądaniu określono metadane aplikacji, będą przechowywane bez kopiowania źródłowych metadanych obiektu blob. Aby jawnie ustawić wszystkie nagłówki zawartości HTTP, możesz określić odpowiedni nagłówek w żądaniu.

  • Content-Type

  • Content-Encoding

  • Content-Length

  • Cache-Control

  • Content-Disposition

Rozmiar docelowego obiektu blob zawsze odpowiada rozmiarowi źródłowego obiektu blob. Nagłówek Content-Length musi zawierać wartość 0 w żądaniu Put Blob from URL (ponieważ nie ma treści żądania), a właściwość długości zawartości docelowego obiektu blob jest wnioskowana z rozmiaru źródła.

Tagi indeksu obiektów blob

Jeśli tagi docelowego obiektu blob 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 Ustawianie tagów obiektów blob. Ponadto nagłówek x-ms-tags 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 tagi nie są podane w nagłówku x-ms-tags , nie są kopiowane ze źródłowego obiektu blob.

Zakresy szyfrowania i klucze podane przez klienta

Funkcja Put Blob z interfejsu API adresu URL obsługuje zarówno zakresy szyfrowania, jak i klucze podane przez klienta, używając x-ms-encryption-scope odpowiednio nagłówków i x-ms-encryption-key .

x-ms-copy-source Jeśli nagłówek odwołuje się do tego samego źródłowego obiektu blob co docelowy obiekt blob w identyfikatorze URI żądania, operacja Put Blob from URL wykonuje synchroniczne ponowne zapisywanie obiektu blob w miejscu. Umożliwia to ponowne zapisywanie obiektu blob w celu używania innego klucza szyfrowania lub zakresu szyfrowania.

Rozliczenia

Konto docelowe operacji Put Blob z adresu URL jest obciążane opłatą za jedną transakcję w celu zainicjowania zapisu, a konto źródłowe powoduje również naliczenie jednej transakcji dla każdego żądania odczytu do źródła.

Ponadto, jeśli konta źródłowe i docelowe znajdują się w różnych regionach (np. Północno-wschodnie stany USA i Południowe stany USA), przepustowość używana do transferu żądania jest obciążana źródłowym kontem magazynu jako ruch wychodzący. Egress między kontami w tym samym regionie jest bezpłatne.

Na koniec utworzenie nowego obiektu blob o innej nazwie w ramach tego samego konta magazynu korzysta z dodatkowych zasobów magazynu, więc operacja powoduje naliczanie opłaty za użycie pojemności konta magazynu dla tych dodatkowych zasobów.

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