Uzyskiwanie obiektu blob

Operacja Get Blob odczytuje lub pobiera obiekt blob z systemu, w tym jego metadane i właściwości. Możesz również wywołać wywołanie Get Blob , aby odczytać migawkę.

Żądanie

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

GET Method Request URI Wersja PROTOKOŁU HTTP
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>

HTTP/1.0

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 127.0.0.1:10000 nazwę emulowanej konta magazynu:

GET Method Request URI Wersja PROTOKOŁU HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.0

HTTP/1.1

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 URI

W żądaniu URI można określić następujące dodatkowe parametry.

Parametr Opis
snapshot Opcjonalny. Parametr migawki jest nieprzezroczystą DateTime wartością, która, jeśli istnieje, określa migawkę obiektu blob do pobrania. Aby uzyskać więcej informacji na temat pracy z migawkami obiektów blob, zobacz Creating a Snapshot of a Blob (Tworzenie migawki obiektu blob).
versionid Opcjonalnie, wersja 2019-12-12 i nowsze. Parametr versionid jest nieprzezroczystą DateTime wartością, która, jeśli istnieje, określa wersję obiektu blob do pobrania.
timeout Opcjonalny. Parametr timeout 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ń, opcjonalnie w przypadku żądań anonimowych. 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).
Range Opcjonalny. Zwraca tylko bajty obiektu blob w określonym zakresie.
x-ms-range Opcjonalny. Zwraca tylko bajty obiektu blob w określonym zakresie. Jeśli określono zarówno wartości , jak i Range , usługa używa wartości x-ms-range x-ms-range . Jeśli żadna z tych wartości nie zostanie określona, zostanie zwrócona cała zawartość obiektu blob. Aby uzyskać więcej informacji, zobacz Specifying the Range Header for Blob Service Operations (Określanie nagłówka zakresu dla operacji usługi Blob Service).
x-ms-lease-id: <ID> Opcjonalny. Jeśli ten nagłówek jest określony, operacja zostanie wykonana tylko wtedy, gdy zostaną spełnione oba następujące warunki:

— Dzierżawa obiektu blob jest obecnie aktywna.
— Identyfikator dzierżawy określony w żądaniu jest taki, jak identyfikator obiektu blob.

Jeśli ten nagłówek jest określony i oba te warunki nie są spełnione, żądanie nie powiedzie się, a operacja nie powiedzie się z kodem Get Blob stanu 412 (Niepowodzenie warunku wstępnego).
x-ms-range-get-content-md5: true Opcjonalny. Jeśli ten nagłówek jest ustawiony na wartość i określony razem z nagłówkiem, usługa zwraca skrót MD5 dla zakresu, o ile zakres jest mniejszy lub równy true Range 4 MiB.

Jeśli ten nagłówek jest określony bez Range nagłówka, usługa zwraca kod stanu 400 (Złe żądanie).

Jeśli ten nagłówek jest ustawiony na wartość , gdy zakres przekracza 4 MiB, usługa zwraca kod stanu true 400 (Złe żądanie).
x-ms-range-get-content-crc64: true Opcjonalny. Jeśli ten nagłówek jest ustawiony na wartość i określony razem z nagłówkiem, usługa zwraca skrót CRC64 dla zakresu, o ile zakres jest mniejszy lub równy true Range 4 MiB.

Jeśli ten nagłówek jest określony bez Range nagłówka, usługa zwraca kod stanu 400 (Złe żądanie).

Jeśli ten nagłówek jest ustawiony na wartość , gdy zakres przekracza 4 MiB, usługa zwraca kod stanu true 400 (Złe żądanie).

Jeśli istnieją nagłówki i , żądanie nie powiedzie się z x-ms-range-get-content-md5 x-ms-range-get-content-crc64 400 (Złym żądaniem).

Ten nagłówek jest obsługiwany w wersjach 2019-02-02 lub nowszych.
Origin Opcjonalny. Określa źródło, z którego jest wystawiane żądanie. Obecność tego nagłówka powoduje powstanie nagłówków współużytkowania zasobów między źródłami (CORS) w odpowiedzi.
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ń).

Ta operacja obsługuje również używanie nagłówków warunkowych do odczytywania 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ń (klucze szyfrowania dostarczane przez klienta)

Począwszy od wersji 2019-02-02, w żądaniu można określić następujące nagłówki, aby odczytać obiekt blob zaszyfrowany za pomocą klucza dostarczonego przez klienta. Szyfrowanie za pomocą klucza dostarczonego przez klienta (i odpowiedniego zestawu nagłówków) jest opcjonalne. Jeśli obiekt blob został wcześniej zaszyfrowany przy użyciu klucza dostarczonego przez klienta, te nagłówki muszą zostać uwzględnione w żądaniu, aby pomyślnie zakończyć operację odczytu.

Nagłówek żądania Opis
x-ms-encryption-key Wymagane. Klucz szyfrowania AES-256 zakodowany w formacie Base64.
x-ms-encryption-key-sha256 Opcjonalny. 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

Brak.

Reakcja

Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi, która zawiera zawartość obiektu blob.

Kod stanu

Pomyślna operacja odczytu pełnego obiektu blob zwraca kod stanu 200 (OK).

Pomyślna operacja odczytu określonego zakresu zwraca kod stanu 206 (zawartość częściowa).

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.

Składnia Opis
Last-Modified Data/godzina ostatniej modyfikacji obiektu blob. Format daty jest zgodny ze specyfikacjiĄ RFC 1123.

Każda operacja modyfikująca obiekt blob, w tym aktualizacja metadanych lub właściwości obiektu blob, zmienia czas ostatniej modyfikacji obiektu blob.
x-ms-creation-time Wersja 2017-11-09 i nowsze. Data/godzina utworzenia obiektu blob. Format daty jest zgodny ze specyfikacjiĄ RFC 1123.
x-ms-meta-name:value Zestaw par nazwa-wartość skojarzonych z tym obiektem blob jako metadane zdefiniowane przez użytkownika.
x-ms-tag-count Wersja 2019-12-12 lub nowsza. Jeśli obiekt blob ma jakiekolwiek tagi, zwraca liczbę tagów przechowywanych w obiekcie blob. Ten nagłówek nie jest zwracany, jeśli w obiekcie blob nie ma tagów.
Content-Length Liczba bajtów w treści odpowiedzi.
Content-Type Typ zawartości określony dla obiektu blob. Domyślny typ zawartości to application/octet-stream .
Content-Range Wskazuje zakres bajtów zwróconych w przypadku, gdy klient zażądał podzestawu obiektu blob przez ustawienie Range nagłówka żądania.
ETag Tag ETag zawiera wartość, która umożliwia warunkowe wykonywanie operacji. 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). Jeśli wersja żądania to 2011-08-18 lub nowsza, wartość ETag będzie w cudzysłowie.
Content-MD5 Jeśli obiekt blob ma skrót MD5 i ta operacja ma na celu odczytanie pełnego obiektu blob, zostanie zwrócony ten nagłówek odpowiedzi, aby klient może sprawdzić integralność Get Blob zawartości wiadomości.

W wersji 2012-02-12 i nowszej program ustawia wartość skrótu MD5 blokowego obiektu blob, nawet jeśli żądanie nie zawiera nagłówka Put Blob Put Blob MD5.

Jeśli żądanie ma odczytać określony zakres i ustawiono wartość , żądanie zwraca skrót MD5 dla zakresu, o ile rozmiar zakresu jest mniejszy lub równy x-ms-range-get-content-md5 true 4 MiB.

Jeśli żaden z tych zestawów warunków nie ma wartości true, dla nagłówka nie jest zwracana Content-MD5 żadna wartość.

Jeśli x-ms-range-get-content-md5 zostanie określony bez Range nagłówka, usługa zwraca kod stanu 400 (Złe żądanie).

Jeśli wartość jest ustawiona na wartość , gdy zakres przekracza x-ms-range-get-content-md5 true 4 MiB, usługa zwraca kod stanu 400 (Złe żądanie).
x-ms-content-crc64 Jeśli żądanie ma odczytać określony zakres i ustawiono wartość , żądanie zwraca skrót CRC64 dla zakresu, o ile rozmiar zakresu jest mniejszy lub równy x-ms-range-get-content-crc64 true 4 MiB.

Jeśli x-ms-range-get-content-crc64 zostanie określony bez Range nagłówka, usługa zwraca kod stanu 400 (Złe żądanie).

Jeśli wartość jest ustawiona na wartość , gdy zakres przekracza x-ms-range-get-content-crc64 true 4 MiB, usługa zwraca kod stanu 400 (Złe żądanie).
Content-Encoding Ten nagłówek zwraca wartość określoną dla Content-Encoding nagłówka żądania.
Content-Language Ten nagłówek zwraca wartość określoną dla Content-Language nagłówka żądania.
Cache-Control Ten nagłówek jest zwracany, jeśli został wcześniej określony dla obiektu blob.
Content-Disposition Zwracany w przypadku żądań względem wersji 2013-08-15 i nowszych. Ten nagłówek zwraca wartość określoną dla x-ms-blob-content-disposition nagłówka.

Pole nagłówka odpowiedzi zawiera dodatkowe informacje na temat sposobu przetwarzania ładunku odpowiedzi, a także może służyć do Content-Disposition dołączania dodatkowych metadanych. Jeśli na przykład zostanie ustawiona wartość , oznacza to, że użytkownik-agent nie powinien wyświetlać odpowiedzi, ale zamiast tego wyświetlić okno dialogowe Zapisz jako z nazwą pliku inną niż określona attachment nazwa obiektu blob.
x-ms-blob-sequence-number Bieżący numer sekwencji stronicowego obiektu blob.

Ten nagłówek nie jest zwracany dla blokowych obiektów blob ani uzupełnianych obiektów blob.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> Zwraca typ obiektu blob.
x-ms-copy-completion-time: <datetime> Wersja 2012-02-12 i nowsze. Czas zakończenia ostatniej próby operacji, Copy Blob w której ten obiekt blob był docelowym obiektem blob. Ta wartość może określać czas zakończonej, przerwanej lub zakończonej niepowodzeniem próby kopiowania. Ten nagłówek nie jest wyświetlany, jeśli kopia jest oczekująca, jeśli ten obiekt blob nigdy nie był miejscem docelowym w operacji lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu operacji przy użyciu Copy Blob Copy Blob operacji , lub Set Blob Properties Put Blob Put Block List .
x-ms-copy-status-description: <error string> Wersja 2012-02-12 i nowsze. Pojawia się tylko x-ms-copy-status wtedy, gdy failed jest lub pending . Opisuje przyczynę ostatniego błędu operacji kopiowania krytycznego lub nie krytycznego. Ten nagłówek nie jest wyświetlany, jeśli ten obiekt blob nigdy nie był miejscem docelowym w operacji lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu operacji przy Copy Blob Copy Blob użyciu , lub Set Blob Properties Put Blob Put Block List .
x-ms-copy-id: <id> Wersja 2012-02-12 i nowsze. Identyfikator ciągu dla ostatniej próby Copy Blob operacji, w której ten obiekt blob był docelowym obiektem blob. Ten nagłówek nie jest wyświetlany, jeśli ten obiekt blob nigdy nie był miejscem docelowym w operacji lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu operacji przy Copy Blob Copy Blob użyciu , lub Set Blob Properties Put Blob Put Block List .
x-ms-copy-progress: <bytes copied/bytes total> Wersja 2012-02-12 i nowsze. Zawiera liczbę skopiowanych bajtów i łączną liczbę bajtów w źródle w ostatniej próbie operacji, w której ten obiekt Copy Blob blob był docelowym obiektem blob. Może pokazywać wartości z wartości od 0 Content-Length do skopiowanych bajtów. Ten nagłówek nie jest wyświetlany, jeśli ten obiekt blob nigdy nie był miejscem docelowym w operacji lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu operacji przy Copy Blob Copy Blob użyciu , lub Set Blob Properties Put Blob Put Block List .
x-ms-copy-source: url Wersja 2012-02-12 i nowsze. Adres URL o długości do 2 KiB określający źródłowy obiekt blob lub plik używany w ostatniej próbie operacji, w której ten obiekt Copy Blob blob był docelowym obiektem blob. Ten nagłówek nie jest wyświetlany, jeśli ten obiekt blob nigdy nie był miejscem docelowym w operacji lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu operacji przy Copy Blob Copy Blob użyciu , lub Set Blob Properties Put Blob Put Block List .

Adres URL zwrócony w tym nagłówku zawiera wszystkie parametry żądania używane w operacji kopiowania źródłowego obiektu blob, w tym token SAS używany do uzyskiwania dostępu do źródłowego obiektu blob.
x-ms-copy-status: <pending | success | aborted | failed> Wersja 2012-02-12 i nowsze. Stan operacji kopiowania identyfikowanej przez identyfikator x-ms-copy-id z tymi wartościami:

- success: kopiowanie zostało ukończone pomyślnie.
- pending: kopiowanie jest w toku. Sprawdź, czy sporadyczne błędy inne niż krytyczne spowalniają postęp kopiowania, ale x-ms-copy-status-description nie powodują błędu.
- aborted: kopiowanie zostało zakończone przez Abort Copy Blob .
- failed: kopiowanie nie powiodło się. Aby uzyskać szczegółowe informacje o niepowodzeniu, zobacz x-ms-copy-status-description.

Ten nagłówek nie jest wyświetlany, jeśli ten obiekt blob nigdy nie był miejscem docelowym w operacji lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu operacji przy użyciu Copy Blob Copy Blob , lub Set Blob Properties Put Blob Put Block List .
x-ms-lease-duration: <infinite | fixed> Wersja 2012-02-12 i nowsze. Gdy obiekt blob jest dzierżawiony, określa, czy dzierżawa ma nieskończony, czy stały czas trwania.
x-ms-lease-state: <available | leased | expired | breaking | broken> Wersja 2012-02-12 i nowsze. Stan dzierżawy obiektu blob.
x-ms-lease-status:<locked | unlocked> Bieżący stan dzierżawy obiektu blob.
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. Uwzględnione w przypadku żądań w wersji 2009-09-19 i nowszej.

Ten nagłówek jest również zwracany w przypadku anonimowych żądań bez określonej wersji, jeśli kontener został oznaczony do publicznego dostępu przy użyciu wersji 2009-09-19 Blob service.
Accept-Ranges: bytes Wskazuje, że usługa obsługuje żądania zawartości częściowych obiektów blob. Uwzględnione w przypadku żądań w wersji 2011-08-18 i nowszej oraz dla lokalnej usługi magazynu w zestawie SDK w wersji 1.6 lub nowszej.
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.
Vary Zwracana z wartością Origin nagłówka, gdy określono reguły CORS. Aby uzyskać szczegółowe informacje, zobacz Obsługa Storage CORS.
Access-Control-Allow-Credentials Zwracana, jeśli żądanie zawiera nagłówek, a funkcja CORS jest włączona z regułą dopasowania, która Origin nie zezwala na wszystkie źródła. Ten nagłówek zostanie ustawiony na wartość true.
x-ms-blob-committed-block-count Liczba zatwierdzone bloki obecne w obiekcie blob. Ten nagłówek jest zwracany tylko dla uzupełnianych obiektów blob.
x-ms-server-encrypted: true/false Wersja 2015-12-11 lub nowsza. Wartość tego nagłówka jest ustawiona na , jeśli dane obiektu blob i metadane aplikacji są true całkowicie zaszyfrowane przy użyciu określonego algorytmu. W przeciwnym razie wartość jest ustawiona na (gdy obiekt blob jest niezaszyfrowany lub jeśli szyfrowane są tylko części metadanych obiektu false blob/aplikacji).
x-ms-encryption-key-sha256 Wersja 2019-02-02 lub nowsza. Ten nagłówek jest zwracany, jeśli obiekt blob jest szyfrowany przy użyciu klucza dostarczonego przez klienta.
x-ms-encryption-scope Wersja 2019-02-02 lub nowsza. Ten nagłówek jest zwracany, jeśli obiekt blob jest zaszyfrowany przy użyciu zakresu szyfrowania.
x-ms-blob-content-md5 Począwszy od wersji 2016-05-31, jeśli obiekt blob ma skrót MD5 i jeśli żądanie zawiera nagłówek zakresu (zakres lub zakres x-ms), ten nagłówek odpowiedzi jest zwracany z wartością MD5 całego obiektu blob. Ta wartość może być równa wartości zwracanej w nagłówku Content-MD5, z tą ostatnią obliczoną na podstawie żądanego zakresu.
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.
x-ms-last-access-time Wersja 2020-02-10 lub nowsza. Wskazuje czas ostatniego uzyskania dostępu do danych obiektu blob na podstawie zasad śledzenia czasu ostatniego dostępu konta magazynu. Nagłówek nie zostanie zwrócony, jeśli konto magazynu nie ma zasad śledzenia czasu ostatniego dostępu lub zasady są wyłączone. Aby uzyskać informacje na temat ustawiania zasad śledzenia czasu ostatniego dostępu konta magazynu, zobacz Interfejs API usługi Blob Service.
x-ms-blob-sealed Wersja 2019-12-12 lub nowsza, zwracana tylko dla uzupełnianych obiektów blob. Jeśli uzupełnialny obiekt blob został zapieczętowany, wartość byłaby prawdziwa, zobacz Seal Append Blobs (Zapieczętuj uzupełnialne obiekty blob)
x-ms-immutability-policy-until-date Wersja 2020-06-12 lub nowsza. Określa datę przechowywania do ustawioną dla obiektu blob. Jest to data, do której obiekt blob może być chroniony przed modyfikacją lub usunięciem. Zwracana tylko wtedy, gdy dla obiektu blob ustawiono zasady niezmienności. Wartość tego nagłówka to RFC1123.
x-ms-immutability-policy-mode: unlocked/locked Wersja 2020-06-12 lub nowsza. Tryb zasad niezmienności, zwracany, jeśli dla obiektu blob ustawiono zasady niezmienności. 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 akcje są zabronione.
x-ms-legal-hold: true/false Wersja 2020-06-12 lub nowsza. Ten nagłówek nie jest zwracany, jeśli obiekt blob nie ma żadnego prawnie wstrzymanego konta. Wartość tego nagłówka jest ustawiona na wartość true, jeśli obiekt blob zawiera wstrzymanie ze względu na prawo, a jego wartość to true. W przeciwnym razie wartość jest ustawiona na wartość false, jeśli obiekt blob zawiera wstrzymanie ze względu na prawo i jego wartość false.

Treść odpowiedzi

Treść odpowiedzi zawiera zawartość obiektu blob.

Przykładowa odpowiedź

Status Response:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-blob-type: BlockBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Vary: Origin  
Last-Modified: <date>  
x-ms-version: 2015-02-21  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>  
  

Autoryzacja

Jeśli lista kontroli dostępu (ACL) kontenera jest ustawiona w taki sposób, aby zezwalać na anonimowy dostęp do obiektu blob, każdy klient może wywołać tę operację. Jeśli kontener jest prywatny, tę operację może wykonać właściciel konta i każda osoba mająca sygnaturę dostępu współdzielonych z uprawnieniami do odczytu obiektu blob.

Uwagi

W przypadku stronicowego obiektu blob operacja na zakresie stron, które nie mają jeszcze zawartości lub które zostały wyczyszone, zwraca Get Blob zera dla tych bajtów.

Jeśli wywołasz obiekt stronicowego obiektu blob bez określonego zakresu, usługa zwróci zakres stron do wartości Get Blob określonej dla x-ms-blob-content-length nagłówka. W przypadku wszystkich stron bez zawartości usługa zwraca zera dla tych bajtów.

W przypadku uzupełnianego obiektu blob Get Blob operacja zwraca x-ms-blob-committed-block-count nagłówek . Ten nagłówek wskazuje liczbę zatwierdzone bloki w obiekcie blob. Nagłówek x-ms-blob-committed-block-count nie jest zwracany dla blokowych lub stronicowych obiektów blob.

Operacja Get Blob może zakończyć się przez 2 minuty na mib. Jeśli operacja trwa średnio dłużej niż 2 minuty na mib, operacja przejmie czas.

Nagłówek x-ms-version jest wymagany do pobrania obiektu blob, który należy do prywatnego kontenera. Jeśli obiekt blob należy do kontenera, który jest dostępny do pełnego lub częściowego dostępu publicznego, każdy klient może odczytać go bez określania wersji; Wersja usługi nie jest wymagana do pobierania obiektu blob, który należy do kontenera publicznego. Aby uzyskać więcej informacji, zobacz Ograniczanie dostępu do kontenerów i obiektów blob.

A Get Blob w zarchiwizowany blokowy obiekt blob nie powiedzie się.

Operacje kopiowania

Aby ustalić, czy operacja została zakończona, najpierw sprawdź, czy wartość nagłówka docelowego obiektu blob jest taka, jak identyfikator kopii podany przez Copy Blob x-ms-copy-id oryginalne wywołanie obiektu Copy Blob . Dopasowanie gwarantuje, że inna aplikacja nie przerwać kopiowania i uruchomić nową Copy Blob operację. Następnie sprawdź x-ms-copy-status: success nagłówek. Należy jednak pamiętać, że wszystkie operacje zapisu na obiekcie blob z wyjątkiem Lease operacji i Put Page Put Block usuwają x-ms-copy-* wszystkie właściwości z obiektu blob. Te właściwości nie są również kopiowane przez operacje, które używają wersji wcześniejszych niż Copy Blob 2012-02-12.

Ostrzeżenie

Adres URL zwrócony w nagłówku zawiera wszystkie parametry żądania używane x-ms-copy-source w operacji kopiowania źródłowego obiektu blob. Jeśli token sygnatury dostępu współdzielonego jest używany do uzyskiwania dostępu do źródłowego obiektu blob, ten token SAS pojawi się w nagłówku, gdy zostanie wywołany w docelowym x-ms-copy-source Get Blob obiekcie blob.

Gdy x-ms-copy-status: failed pojawi się w odpowiedzi, zawiera więcej informacji o x-ms-copy-status-description Copy Blob niepowodzeniu.

W poniższej tabeli opisano trzy pola każdej x-ms-copy-status-description wartości.

Składnik Opis
Kod stanu HTTP Standardowa 3-cyfrowa liczba całkowita określająca błąd.
Kod błędu Słowo kluczowe opisujące błąd dostarczany przez platformę Azure w <> ErrorCode. Jeśli nie <errorcode, zostanie użyte słowo kluczowe zawierające standardowy tekst błędu skojarzony z 3-cyfrowym kodem stanu > HTTP w specyfikacji HTTP. Zobacz Typowe kody błędów interfejsu API REST.
Informacje Szczegółowy opis błędu w cudzysłowie.

W poniższej tabeli x-ms-copy-status opisano wartości x-ms-copy-status-description i typowych scenariuszy awarii.

Ważne

Wyświetlany tutaj tekst opisu może ulec zmianie bez ostrzeżenia, nawet bez zmiany wersji, więc nie należy polegać na dopasowywaniu tego dokładnego tekstu.

Scenariusz wartość x-ms-copy-status wartość x-ms-copy-status-description
Operacja kopiowania została zakończona pomyślnie. powodzenie puste
Użytkownik przerwano operację kopiowania przed jej ukończeniem. Przerwane puste
Wystąpił błąd podczas odczytywania ze źródłowego obiektu blob podczas operacji kopiowania, ale operacja zostanie ponoowana. Oczekiwanie 502 BadGateway "Encountered a retryable error when reading the source. Ponowi próbę. Czas awarii: <> czasu "
Wystąpił błąd podczas zapisywania do docelowego obiektu blob operacji kopiowania, ale operacja zostanie ponoowana. Oczekiwanie 500 InternalServerError "Encountered a retryable error. Ponowi próbę. Czas awarii: <> czasu "
Wystąpił nieodwracalny błąd podczas odczytywania ze źródłowego obiektu blob operacji kopiowania. niepowodzenie 404 ResourceNotFound "Kopiowanie nie powiodło się podczas odczytywania źródła".

Uwaga: Podczas raportowania tego błędu bazowego platforma Azure zwraca ResourceNotFound wartość w ErrorCode elemencie . Jeśli w odpowiedzi nie pojawił się żaden element, zostanie wyświetlony ErrorCode standardowy ciąg reprezentacji stanu HTTP, taki NotFound jak .
Limit czasu, który ogranicza wszystkie operacje kopiowania, które upłynął. (Obecnie limit czasu wynosi 2 tygodnie). niepowodzenie 500 OperationCancelled "Kopia przekroczyła maksymalny dozwolony czas".
Operacja kopiowania zbyt często nie powiodła się podczas odczytywania ze źródła i nie spełniała minimalnego stosunku prób do sukcesów. (Ten limit czasu uniemożliwia ponawianie próby bardzo słabego źródła przez 2 tygodnie przed niepowodzeniem). niepowodzenie 500 OperationCancelled "Kopiowanie nie powiodło się podczas odczytywania źródła".

x-ms-last-access-time śledzi czas uzyskiwania dostępu do danych obiektu blob na podstawie zasad śledzenia czasu ostatniego dostępu konta magazynu. Uzyskiwanie dostępu do metadanych obiektu blob nie zmienia czasu ostatniego dostępu.

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