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ć 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 Range x-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 true wartość , żą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 Properties Put 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 failed pending . 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 Properties operacji , Put Blob lub 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 Properties operacji , Put Blob lub 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 Properties operacji , Put Blob lub 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 Properties operacji , Put Blob lub 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 Properties elementu , Put Blob lub 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 true wartość . |
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ę:
- Akcja RBAC platformy Azure:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
- Najmniej uprzywilejowana wbudowana rola:Czytelnik danych obiektu blob usługi Storage
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 Lease
operacji , Put Page
i 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