Uzyskiwanie obiektu blob

  • Artykuł

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ć funkcję Get Blob odczytu migawki.

Żądanie

Żądanie można skonstruować Get Blob w następujący sposób. Zalecamy używanie protokołu HTTPS. Zastąp ciąg myaccount nazwą konta magazynu:

IDENTYFIKATOR URI żądania GET 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

Identyfikator URI usługi magazynu emulowanego

Gdy wysyłasz żądanie względem emulowanej usługi magazynu, określ nazwę hosta emulatora i Azure Blob Storage port jako 127.0.0.1:10000, a następnie nazwę emulowanego konta magazynu:

IDENTYFIKATOR URI żądania GET 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 Use the Azure Storage Emulator for development and testing (Używanie emulatora usługi Azure Storage do programowania i testowania).

Parametry identyfikatora URI

W identyfikatorze URI żądania można określić następujące dodatkowe parametry:

Parametr Opis
snapshot Opcjonalny. Parametr migawki jest nieprzezroczystą DateTime wartością, która, gdy jest obecna, określa migawkę obiektu blob do pobrania. Aby uzyskać więcej informacji na temat pracy z migawkami obiektów blob, zobacz Tworzenie migawki obiektu blob.
versionid Opcjonalnie, wersja 2019-12-12 lub nowsza. Parametr versionid jest nieprzezroczystą DateTime wartością, która w przypadku obecnej określa wersję obiektu blob do pobrania.
timeout Opcjonalny. Parametr jest wyrażony timeout w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji usługi Blob Storage.

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 dla żądań anonimowych. Określa wersję operacji do użycia dla tego żądania. Jeśli ten nagłówek zostanie pominięty dla żądania anonimowego, usługa wykonuje żądanie w wersji 2009-09-19. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji usług Azure Storage.
Range Opcjonalny. Zwróć bajty obiektu blob tylko w określonym zakresie.
x-ms-range Opcjonalny. Zwróć bajty obiektu blob tylko w określonym zakresie. Jeśli zostanie określona wartość i Rangex-ms-range zostanie określona, usługa używa wartości x-ms-range. Jeśli żaden zakres nie zostanie określony, zwracana jest cała zawartość obiektu blob. Aby uzyskać więcej informacji, zobacz Określanie nagłówka zakresu dla operacji usługi Blob Storage.
x-ms-lease-id: <ID> Opcjonalny. Jeśli ten nagłówek jest określony, operacja jest wykonywana 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 zgodny z identyfikatorem dzierżawy obiektu blob.

Jeśli ten nagłówek zostanie określony, ale któryś z tych warunków nie zostanie spełniony, żądanie zakończy się niepowodzeniem, a Get Blob operacja zakończy się niepowodzeniem z kodem stanu 412 (Warunek wstępny nie powiodło się).
x-ms-range-get-content-md5: true Opcjonalny. Gdy ten nagłówek jest ustawiony na true i określony razem z nagłówkiem Range , usługa zwraca skrót MD5 dla zakresu, o ile zakres jest mniejszy lub równy 4 mebibajtów (MiB) w rozmiarze.

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

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

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

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

Jeśli istnieją zarówno x-ms-range-get-content-md5 nagłówki, jak i x-ms-range-get-content-crc64 żądanie kończy się niepowodzeniem z błędem 400 (nieprawidłowe żądanie).

Ten nagłówek jest obsługiwany w wersjach 2019-02-02 i nowszych.
Origin Opcjonalny. Określa pochodzenie, z którego jest wystawiane żądanie. Obecność tego nagłówka powoduje, że nagłówki współużytkowania zasobów między źródłami (CORS) w odpowiedzi.
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 analitycznych po włączeniu rejestrowania analizy magazynu. Zdecydowanie zalecamy używanie tego nagłówka podczas korelowania działań po stronie klienta z żądaniami odbieranymi przez serwer. Aby uzyskać więcej informacji, zobacz About Azure analityka magazynu logging (Informacje o rejestrowaniu usługi Azure analityka magazynu).

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

Od wersji 2019-02-02 można określić następujące nagłówki w żądaniu odczytu obiektu blob zaszyfrowanego przy użyciu klucza dostarczonego przez klienta. Szyfrowanie przy użyciu 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, musisz dołączyć te nagłówki do żądania, aby pomyślnie ukoń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 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.

Reakcja

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

Kod stanu

Operacja pomyślnego odczytania pełnego obiektu blob zwraca kod stanu 200 (OK).

Operacja pomyślnego odczytania określonego zakresu zwraca kod stanu 206 (zawartość częściowa).

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.

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

Każda operacja modyfikując obiekt blob, w tym aktualizację metadanych lub właściwości obiektu blob, zmienia czas ostatniej modyfikacji obiektu blob.
x-ms-creation-time Wersja 2017-11-09 lub nowsza. Data/godzina utworzenia obiektu blob. Format daty jest zgodny z dokumentem RFC 1123.
x-ms-meta-name:value Zestaw par name-value skojarzonych z tym obiektem blob jako metadanych zdefiniowanych przez użytkownika.
x-ms-tag-count Wersja 2019-12-12 lub nowsza. Jeśli obiekt blob ma tagi, ten nagłówek zwraca liczbę tagów przechowywanych w obiekcie blob. Nagłówek nie jest zwracany, jeśli w obiekcie blob nie ma tagów.
Content-Length Liczba bajtów obecnych w treści odpowiedzi.
Content-Type Typ zawartości określony dla obiektu blob. Domyślnym typem zawartości jest application/octet-stream.
Content-Range Wskazuje zakres bajtów zwróconych w przypadku, gdy klient zażądał podzestawu obiektu blob przez ustawienie nagłówka Range żądania.
ETag Zawiera wartość, której można użyć do warunkowego wykonywania operacji. Aby uzyskać więcej informacji, zobacz Określanie nagłówków warunkowych dla operacji usługi Blob Storage. Jeśli wersja żądania to 2011-08-18 lub nowsza, wartość elementu ETag jest ujęta w cudzysłów.
Content-MD5 Jeśli obiekt blob ma skrót MD5 i ta Get Blob operacja polega na odczytaniu pełnego obiektu blob, ten nagłówek odpowiedzi jest zwracany, aby klient mógł sprawdzić integralność zawartości komunikatu.

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

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

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

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

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

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

Jeśli x-ms-range-get-content-crc64 parametr ma wartość true , gdy zakres przekracza 4 MiB, usługa zwraca kod stanu 400 (nieprawidłowe żądanie).
Content-Encoding Zwraca wartość określoną dla nagłówka Content-Encoding żądania.
Content-Language Zwraca wartość określoną dla nagłówka Content-Language żądania.
Cache-Control Zwrócone, jeśli nagłówek został wcześniej określony dla obiektu blob.
Content-Disposition Zwrócono żądania dotyczące wersji 2013-08-15 lub nowszej. Ten nagłówek zwraca wartość określoną dla nagłówka x-ms-blob-content-disposition .

Pole nagłówka Content-Disposition odpowiedzi zawiera dodatkowe informacje o sposobie przetwarzania ładunku odpowiedzi i może służyć do dołączania 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 jest wyświetlane okno dialogowe Zapisz jako z nazwą pliku inną niż określona 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łnialnych obiektów blob.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> Zwraca typ obiektu blob.
x-ms-copy-completion-time: <datetime> Wersja 2012-02-12 lub nowsza. Czas zakończenia ostatniej próby Copy Blob operacji, w której ten obiekt blob był docelowym obiektem blob. Ta wartość może określać czas ukończenia, przerwania lub nieudanej 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 operacji Copy Blob lub jeśli ten obiekt blob został zmodyfikowany po zakończonej Copy Blob operacji, która używa Set Blob PropertiesPut Blob, lub Put Block List.
x-ms-copy-status-description: <error string> Wersja 2012-02-12 lub nowsza. Pojawia się tylko wtedy, gdy x-ms-copy-status jest lub failedpending. Opisuje przyczynę ostatniej krytycznej lub niekrytycznej operacji kopiowania. Ten nagłówek nie jest wyświetlany, jeśli ten obiekt blob nigdy nie był miejscem docelowym operacji Copy Blob lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu Copy Blob operacji, która użyła Set Blob Propertiesoperacji , Put Bloblub Put Block List.
x-ms-copy-id: <id> Wersja 2012-02-12 lub nowsza. Identyfikator ciągu 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 operacji Copy Blob lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu Copy Blob operacji, która użyła Set Blob Propertiesoperacji , Put Bloblub Put Block List.
x-ms-copy-progress: <bytes copied/bytes total> Wersja 2012-02-12 lub nowsza. Zawiera liczbę skopiowanych bajtów oraz łączną liczbę bajtów w źródle w ostatniej próbie Copy Blob , w której ten obiekt blob był docelowym obiektem blob. Może pokazywać skopiowane od 0 do Content-Length bajtów. Ten nagłówek nie jest wyświetlany, jeśli ten obiekt blob nigdy nie był miejscem docelowym operacji Copy Blob lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu Copy Blob operacji, która użyła Set Blob Propertiesoperacji , Put Bloblub Put Block List.
x-ms-copy-source: url Wersja 2012-02-12 lub nowsza. 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 Copy Blob , 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 operacji Copy Blob lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu Copy Blob operacji, która użyła Set Blob Propertiesoperacji , Put Bloblub Put Block List.

Adres URL zwrócony w tym nagłówku zawiera wszystkie parametry żądania, które zostały użyte w operacji kopiowania w źródłowym obiekcie blob, w tym token sygnatury dostępu współdzielonego (SAS), który był używany do uzyskiwania dostępu do źródłowego obiektu blob.
x-ms-copy-status: <pending | success | aborted | failed> Wersja 2012-02-12 lub nowsza. Stan operacji kopiowania identyfikowany przez identyfikator x-ms-copy-id z następującymi wartościami:

- success: Kopiowanie zostało ukończone pomyślnie.
- pending: Kopiowanie jest w toku. Sprawdź x-ms-copy-status-description , czy sporadyczne błędy niekrytyczne spowalniają postęp kopiowania, ale nie powodują niepowodzenia.
- 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 operacji Copy Blob lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu Copy Blob operacji, która używała Set Blob Propertieselementu , Put Bloblub Put Block List.
x-ms-lease-duration: <infinite | fixed> Wersja 2012-02-12 lub nowsza. 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 lub nowsza. Stan dzierżawy obiektu blob.
x-ms-lease-status:<locked | unlocked> Bieżący stan dzierżawy obiektu blob.
x-ms-request-id Unikatowo identyfikuje wykonane żądanie i może służyć do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z operacjami interfejsu API.
x-ms-version Wskazuje wersję usługi Blob Storage użytą do wykonania żądania. Uwzględnione w przypadku żądań, które zostały wykonane przy użyciu wersji 2009-09-19 lub nowszej.

Ten nagłówek jest również zwracany dla żądań anonimowych bez określonej wersji, jeśli kontener został oznaczony do dostępu publicznego przy użyciu usługi Blob Storage w wersji 2009-09-19.
Accept-Ranges: bytes Wskazuje, że usługa obsługuje żądania częściowej zawartości obiektu blob. Uwzględnione w przypadku żądań wysyłanych przy użyciu wersji 2011-08-18 lub nowszej oraz dla lokalnej usługi magazynu w zestawie SDK w wersji 1.6 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 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.
Vary Zwracany z wartością nagłówka po określeniu Origin reguł CORS. Aby uzyskać szczegółowe informacje , zobacz Obsługa mechanizmu CORS dla usług Azure Storage .
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 truewartość .
x-ms-blob-committed-block-count Liczba zatwierdzonych bloków znajdujących się w obiekcie blob. Ten nagłówek jest zwracany tylko dla uzupełnialnych obiektów blob.
x-ms-server-encrypted: true/false Wersja 2015-12-11 lub nowsza. Wartość tego nagłówka jest ustawiana na true wartość , jeśli dane obiektu blob i metadane aplikacji są całkowicie szyfrowane przy użyciu określonego algorytmu. W przeciwnym razie wartość jest ustawiona na false (gdy obiekt blob jest niezaszyfrowany lub jeśli szyfrowane są tylko części obiektu blob lub metadanych aplikacji).
x-ms-encryption-key-sha256 Wersja 2019-02-02 lub nowsza. Ten nagłówek jest zwracany, jeśli obiekt blob jest zaszyfrowany przy użyciu klucza dostarczonego przez klienta.
x-ms-encryption-context Wersja 2021-08-06 lub nowsza. Jeśli ustawiono wartość właściwości kontekstu szyfrowania, zostanie zwrócona ustawiona wartość. Prawidłowe tylko wtedy, gdy hierarchiczna przestrzeń nazw jest włączona dla konta.
x-ms-encryption-scope Wersja 2019-02-02 lub nowsza. Ten nagłówek jest zwracany, jeśli obiekt blob jest szyfrowany przy użyciu zakresu szyfrowania.
x-ms-blob-content-md5 Wersja 2016-05-31 lub nowsza. Jeśli obiekt blob ma skrót MD5, a żądanie zawiera nagłówek zakresu (Zakres lub x-ms-range), ten nagłówek odpowiedzi jest zwracany z wartością wartości MD5 całego obiektu blob. Ta wartość może lub nie może być równa wartości zwracanej w nagłówku Content-MD5, a ta ostatnia jest obliczana z żądanego zakresu.
x-ms-client-request-id 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, ten nagłówek nie jest obecny w odpowiedzi.
x-ms-last-access-time Wersja 2020-02-10 lub nowsza. Wskazuje czas ostatniego uzyskiwania dostępu do danych obiektu blob na podstawie zasad śledzenia czasu ostatniego dostępu konta magazynu. Nagłówek nie jest zwracany, jeśli konto magazynu nie ma zasad śledzenia czasu ostatniego dostępu lub jeśli 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. Zwracane tylko dla uzupełnialnych obiektów blob. Jeśli uzupełnialne obiekty blob zostały zapieczętowane, wartość to true. Aby uzyskać więcej informacji, zobacz Dołączanie foki obiektów blob
x-ms-immutability-policy-until-date Wersja 2020-06-12 lub nowsza. Określa okres przechowywania do daty ustawionej w obiekcie blob. Jest to data, do której obiekt blob może być chroniony przed modyfikacją lub usunięciem. Zwracane tylko wtedy, gdy dla obiektu blob ustawiono zasady niezmienności. Wartość tego nagłówka jest w formacie RFC1123.
x-ms-immutability-policy-mode: unlocked/locked Wersja 2020-06-12 lub nowsza. Zwracane, jeśli dla obiektu blob ustawiono zasady niezmienności. Wartości to unlocked i locked. unlocked wskazuje, że użytkownik może zmienić zasady przez zwiększenie lub zmniejszenie okresu przechowywania do daty. locked wskazuje, że te działania są zabronione.
x-ms-legal-hold: true/false Wersja 2020-06-12 lub nowsza. Ten nagłówek nie jest zwracany, jeśli nie ma archiwizacji ze względów prawnych dla obiektu blob. Wartość tego nagłówka jest ustawiana na true , jeśli obiekt blob zawiera archiwizację ze względów prawnych, a jego wartość to true. W przeciwnym razie wartość jest ustawiana na false , jeśli obiekt blob zawiera archiwizację ze względów prawnych, a jego wartość to false.
x-ms-owner Wersja 2020-06-12 lub nowsza, tylko dla kont z włączoną hierarchiczną przestrzenią nazw. Zwraca właściciela użytkownika pliku lub katalogu.
x-ms-group Wersja 2020-06-12 lub nowsza, tylko dla kont z włączoną hierarchiczną przestrzenią nazw. Zwraca grupę będącą właścicielem pliku lub katalogu.
x-ms-permissions Wersja 2020-06-12 lub nowsza, tylko dla kont z włączoną hierarchiczną przestrzenią nazw. Zwraca uprawnienia ustawione dla "użytkownika", "grupy" i "innego" w pliku lub katalogu. Każde uprawnienie jest w formacie [r,w,x,-].{3}
x-ms-resource-type Wersja 2020-10-02 lub nowsza, tylko dla kont z włączoną hierarchiczną przestrzenią nazw. Zwraca typ zasobu dla ścieżki , która może mieć file wartość lub directory.

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

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

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

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

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

W przypadku uzupełnialnych obiektów blob Get Blob operacja zwraca x-ms-blob-committed-block-count nagłówek. Ten nagłówek wskazuje liczbę zatwierdzonych bloków w obiekcie blob. Nagłówek x-ms-blob-committed-block-count nie jest zwracany dla blokowych obiektów blob ani stronicowych obiektów blob.

Get Blob Operacja może zostać ukończona przez dwie minuty na miB. Jeśli operacja trwa średnio dłużej niż dwie minuty na miB, operacja zostanie przekroczona.

Nagłówek x-ms-version jest wymagany do pobrania obiektu blob należącego do prywatnego kontenera. Jeśli obiekt blob należy do kontenera dostępnego dla pełnego lub częściowego dostępu publicznego, każdy klient może go odczytać bez określania wersji; wersja usługi nie jest wymagana do pobierania obiektu blob należącego do kontenera publicznego. Aby uzyskać więcej informacji, zobacz artykuł Restrict access to containers and blobs (Ograniczanie dostępu do kontenerów i obiektów blob).

Get Blob Operacja na zarchiwizowanym obiekcie blob blokowym zakończy się niepowodzeniem.

Operacje kopiowania

Aby określić, czy Copy Blob operacja została ukończona, najpierw sprawdź, czy x-ms-copy-id wartość nagłówka docelowego obiektu blob jest zgodna z identyfikatorem kopiowania podanym przez oryginalne wywołanie metody Copy Blob. Dopasowanie gwarantuje, że inna aplikacja nie przerwała kopii i rozpoczęła nową Copy Blob operację. Następnie sprawdź x-ms-copy-status: success nagłówek. Należy jednak pamiętać, że wszystkie operacje zapisu w obiekcie blob z wyjątkiem Leaseoperacji , Put Pagei Put Block usuwają wszystkie x-ms-copy-* właściwości z obiektu blob. Te właściwości nie są również kopiowane przez Copy Blob operacje korzystające z usługi Blob Storage w wersjach starszych niż 2012-02-12.

Ostrzeżenie

Adres URL zwrócony w nagłówku x-ms-copy-source zawiera wszystkie parametry żądania, które zostały użyte w operacji kopiowania w źródłowym obiekcie blob. Jeśli używasz tokenu SAS do uzyskiwania dostępu do źródłowego obiektu blob, token SAS pojawi się w nagłówku x-ms-copy-source po Get Blob wywołaniu docelowego obiektu blob.

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

Trzy pola każdej x-ms-copy-status-description wartości opisano w poniższej tabeli:

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 <elemecie ErrorCode> . Jeśli nie <zostanie wyświetlony element 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 ujęta w cudzysłów.

Wartości x-ms-copy-status i x-ms-copy-status-description typowych scenariuszy awarii opisano w poniższej tabeli:

Ważne

Opisy błędów w tej tabeli mogą ulec zmianie bez ostrzeżenia, nawet bez zmiany wersji, więc mogą nie być dokładnie zgodne z tekstem.

Scenariusz x-ms-copy-status wartość x-ms-copy-status-description wartość
Operacja kopiowania została zakończona pomyślnie. powodzenie puste
Użytkownik przerwał operację kopiowania przed jej ukończeniem. Przerwane puste
Wystąpił błąd podczas odczytywania źródłowego obiektu blob podczas operacji kopiowania, ale operacja zostanie ponowiona. Oczekiwanie 502 BadGateway "Napotkano błąd możliwy do ponawiania podczas odczytywania źródła. Ponów próbę. Czas niepowodzenia: <czas>"
Wystąpił błąd podczas zapisywania docelowego obiektu blob operacji kopiowania, ale operacja zostanie ponowiona. Oczekiwanie 500 InternalServerError "Napotkano błąd z możliwością ponawiania prób. Ponów próbę. Czas niepowodzenia: <czas>"
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: Gdy usługa zgłasza ten podstawowy błąd, zwraca ResourceNotFound wartość w elemecie ErrorCode . Jeśli w odpowiedzi nie pojawił się żaden ErrorCode element, zostanie wyświetlony standardowy ciąg reprezentujący stan HTTP, taki jak NotFound, .
Upłynął limit czasu ograniczający wszystkie operacje kopiowania. (Obecnie okres przekroczenia limitu czasu wynosi 2 tygodnie). niepowodzenie 500 OperationCancelled "Kopia przekroczyła maksymalny dozwolony czas".
Operacja kopiowania nie powiodła się zbyt często podczas odczytywania ze źródła i nie spełniała minimalnego stosunku prób do sukcesów. (Ten limit czasu uniemożliwia ponowienie próby bardzo słabego źródła w ciągu dwóch tygodni 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.

Rozliczenia

Żądania cenowe 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 do innej kategorii rozliczeniowej niż transakcje zapisu. W poniższej tabeli przedstawiono kategorię rozliczeń dla Get Blob żądań na podstawie typu konta magazynu:

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

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