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ć metodę Get Blob , aby odczytać migawkę.
Żądanie
Żądanie można skonstruować Get Blob w następujący sposób. Zalecamy korzystanie z 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/myblobhttps://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
Dla identyfikatora 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 Twórca migawkę obiektu blob. |
versionid |
Opcjonalnie, wersja 2019-12-12 lub nowsza. Parametr versionid jest nieprzezroczystą DateTime wartością, która w chwili 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ń. Opcjonalne w przypadku żą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 dla 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 określono obie Range wartości i x-ms-range , usługa używa wartości x-ms-range. Jeśli żaden z zakresów 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 z następujących warunków: — 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 jest określony, ale którykolwiek 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 (Niepowodzenie warunku wstępnego). |
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 rozmiar.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 oba x-ms-range-get-content-md5 nagłówki i x-ms-range-get-content-crc64 są obecne, żą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 źródło, z którego jest wystawiane żądanie. Obecność tego nagłówka powoduje współużytkowanie zasobów między źródłami (CORS) w odpowiedzi. |
x-ms-upn |
Opcjonalny. Wersja 2023-11-03 lub nowsza. Prawidłowe dla kont z włączoną hierarchiczną przestrzenią nazw. Jeśli wartość true, wartości tożsamości użytkownika zwrócone w x-ms-ownernagłówkach , x-ms-group a x-ms-acl nagłówki odpowiedzi zostaną przekształcone z identyfikatorów obiektów Microsoft Entra na główne nazwy użytkowników. Jeśli wartość ma wartość false, są zwracane jako identyfikatory obiektów Microsoft Entra. Wartość domyślna to fałsz. Należy pamiętać, że identyfikatory obiektów grup i aplikacji nie są tłumaczone, ponieważ nie mają unikatowych przyjaznych nazw. |
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 w przypadku spełnienia określonego warunku. 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)
Począwszy 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 odpowiadającego mu zestawu nagłówków) jest opcjonalne. Jeśli obiekt blob został wcześniej zaszyfrowany przy użyciu klucza dostarczonego przez klienta, należy 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 na potrzeby 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 nagłówki standardowe 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 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 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 jakiekolwiek 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 znajdujących się 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, ustawiając Range nagłówek żą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ść ETag jest ujęta w cudzysłów. |
Content-MD5 |
Jeśli obiekt blob ma skrót MD5, a 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 bloku 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 truena , żą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 truezwracany, żadna wartość nie jest zwracana dla nagłówka Content-MD5 .Jeśli x-ms-range-get-content-md5 jest określony bez nagłówka Range , usługa zwraca kod stanu 400 (nieprawidłowe żądanie).Jeśli x-ms-range-get-content-md5 jest ustawiona 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 truena , żą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 jest określony bez nagłówka Range , usługa zwraca kod stanu 400 (nieprawidłowe żądanie).Jeśli x-ms-range-get-content-crc64 jest ustawiona wartość true , gdy zakres przekracza 4 miB, usługa zwraca kod stanu 400 (nieprawidłowe żądanie). |
Content-Encoding |
Zwraca wartość, która została określona dla nagłówka Content-Encoding żądania. |
Content-Language |
Zwraca wartość, która została określona dla nagłówka Content-Language żądania. |
Cache-Control |
Zwrócono, 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 przekazuje 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 jest ustawiony na attachment, wskazuje, ż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 dla 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 pojawia się, jeśli kopia jest oczekująca, jeśli ten obiekt blob nigdy nie był miejscem docelowym operacji lub jeśli ten obiekt blob został zmodyfikowany po zakończonej Copy BlobCopy Blob operacji, która użyła Set Blob Properties, Put Bloblub 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 lub jeśli ten obiekt blob został zmodyfikowany po zakończonej Copy BlobCopy Blob operacji, która użyła Set Blob Propertiesmetody , 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 lub jeśli ten obiekt blob został zmodyfikowany po zakończonej Copy BlobCopy Blob operacji, która użyła Set Blob Propertiesmetody , 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 operacji, 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 lub jeśli ten obiekt blob został zmodyfikowany po zakończonej Copy BlobCopy Blob operacji, która użyła Set Blob Propertiesmetody , 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 operacji, 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 lub jeśli ten obiekt blob został zmodyfikowany po zakończonej Copy BlobCopy Blob operacji, która użyła Set Blob Propertiesmetody , 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 obiektu blob źródłowego, 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, która jest identyfikowana przez 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ą awarii.- 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 pojawia się, 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 Propertiesmetody , 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 jest nieskończona, czy stała. |
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 |
Jednoznacznie 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, która została użyta do wykonania żądania. Dołączone do żądań, które zostały wykonane przy użyciu wersji 2009-09-19 i nowszych. 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. Dołączone do żądań, które są wykonywane przy użyciu wersji 2011-08-18 i nowszych, oraz dla lokalnej usługi magazynu w zestawie SDK w wersji 1.6 i 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 i mechanizm CORS jest włączony z zgodną regułą. Ten nagłówek zwraca wartość nagłówka żądania pochodzenia w przypadku dopasowania. |
Access-Control-Expose-Headers |
Zwracane, jeśli żądanie zawiera Origin nagłówek i mechanizm CORS jest włączony z zgodną regułą. Zwraca listę nagłówków odpowiedzi, które mają być widoczne dla klienta lub wystawcy żądania. |
Vary |
Zwracana 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 |
Zwracane, jeśli żądanie zawiera Origin nagłówek i mechanizm CORS jest włączony z zgodną regułą, 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 zaszyfrowane 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 szyfrowany przy użyciu klucza dostarczonego przez klienta. |
x-ms-encryption-context |
Wersja 2021-08-06 lub nowsza. Jeśli wartość właściwości kontekstu szyfrowania zostanie ustawiona, zwróci ustawioną 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 z zakresem 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 zwróconej 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 im odpowiedziami. Wartość tego nagłówka jest równa wartości x-ms-client-request-id nagłówka, jeśli znajduje się w żądaniu, a wartość nie zawiera więcej niż 1024 widocznych znaków 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 uzyskania 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. Zwrócone tylko dla uzupełnialnych obiektów blob. Jeśli uzupełniony obiekt blob został zapieczętowany, 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 przechowywanie do daty ustawionej na obiekcie blob. Jest to data, do której obiekt blob może być chroniony przed modyfikacją lub usunięciem. Zwracane tylko wtedy, gdy na obiekcie 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 na obiekcie 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 prawnej obiektu blob. Wartość tego nagłówka jest ustawiona na true wartość , jeśli obiekt blob zawiera blokadę prawną, a jej wartość to true. W przeciwnym razie wartość jest ustawiona na false wartość , jeśli obiekt blob zawiera blokadę prawną, a jej wartość to false. |
x-ms-owner |
Wersja 2020-06-12 lub nowsza, tylko dla kont z włączoną hierarchiczną przestrzenią nazw. Zwraca użytkownika właściciela 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 innych w pliku lub katalogu. Każde indywidualne uprawnienie jest w [r,w,x,-]{3} formacie. |
x-ms-acl |
Wersja 2023-11-03 lub nowsza. Tylko dla kont z włączoną hierarchiczną przestrzenią nazw. Zwraca połączoną listę dostępu i domyślną listę kontroli dostępu ustawioną dla użytkownika, grupy i innej w pliku lub katalogu. Każdy wpis kontroli dostępu (ACE) składa się z zakresu, typu, identyfikatora użytkownika lub grupy i uprawnień w formacie [scope]:[type]:[id]:[permissions]. Zakres default wskazuje, że ACE należy do domyślnej listy ACL katalogu. W przeciwnym razie zakres jest niejawny, a ACE należy do listy ACL dostępu. Każde indywidualne uprawnienie jest w [r,w,x,-]{3} formacie. |
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 być albo filedirectory. |
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ę zgodnie z Get Blob poniższym opisem.
Ważne
Firma Microsoft zaleca używanie Tożsamość Microsoft Entra z tożsamościami zarządzanymi w celu autoryzowania żądań do usługi Azure Storage. Tożsamość Microsoft Entra zapewnia doskonałe zabezpieczenia i łatwość użycia w porównaniu z autoryzacją klucza współdzielonego.
Usługa Azure Storage obsługuje używanie Tożsamość Microsoft Entra do autoryzacji żądań do danych obiektów blob. Za pomocą 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 Microsoft Entra użytkownika, grupy, tożsamości zarządzanej lub jednostki usługi w celu wywołania Get Blob operacji oraz najmniej uprzywilejowanej wbudowanej roli RBAC platformy Azure, która obejmuje tę akcję:
- Akcja RBAC platformy Azure:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
- Rola wbudowana z najmniejszymi uprawnieniami:Czytelnik danych obiektów 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 zera 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.
Operacja Get Blob 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 ustalić, 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 kopii dostarczonym przez oryginalne wywołanie metody Copy Blob. Dopasowanie zapewnia, że inna aplikacja nie przerwała kopiowania i uruchomił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 SYGNATURy dostępu współdzielonego do uzyskiwania dostępu do źródłowego obiektu blob, token SAS będzie wyświetlany w nagłówku x-ms-copy-source , gdy Get Blob jest wywoływany w docelowym obiekcie 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 zostały opisane 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, które jest dostarczane 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 | wartość stanu x-ms-copy-status | wartość x-ms-copy-status-description |
|---|---|---|
| Operacja kopiowania została ukończona pomyślnie. | powodzenie | puste |
| Użytkownik przerwał operację kopiowania przed jej ukończeniem. | Przerwane | puste |
| Wystąpił błąd podczas odczytu ze źródłowego obiektu blob podczas operacji kopiowania, ale operacja zostanie ponowiona. | Oczekiwanie | 502 BadGateway "Napotkano błąd umożliwiający ponowienie próby podczas odczytywania źródła. Ponów próbę. Czas niepowodzenia: <czas>" |
| Wystąpił błąd podczas zapisywania w docelowym obiekcie blob operacji kopiowania, ale operacja zostanie ponowiona. | Oczekiwanie | 500 InternalServerError "Napotkano błąd umożliwiający ponowienie próby. Ponów próbę. Czas niepowodzenia: <czas>" |
| Wystąpił nieodwracalny błąd podczas odczytu 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łosi ten podstawowy błąd, zwraca ResourceNotFound wartość w elemecie ErrorCode . Jeśli w odpowiedzi nie pojawił się żaden ErrorCode element, zostanie wyświetlona standardowa reprezentacja ciągu stanu HTTP, na przykład NotFound, . |
| Limit czasu ogranicza wszystkie operacje kopiowania, które upłynęły. (Obecnie limit 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 cen mogą pochodzić od klientów korzystających z interfejsów API usługi Blob Storage bezpośrednio za pośrednictwem interfejsu API REST usługi Blob Storage lub biblioteki klienta usługi Azure Storage. Te żądania naliczają opłaty za transakcję. Typ transakcji wpływa na sposób naliczania opłat za konto. Na przykład transakcje odczytu są naliczane w innej kategorii rozliczeniowej niż transakcje zapisu. W poniższej tabeli przedstawiono kategorię rozliczeń dla 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 rozliczeniowej, zobacz Azure Blob Storage Cennik.
Zobacz też
Autoryzowanie żądań do usługi Azure Storage
Kody stanu i błędów
Kody błędów usługi Blob Storage
Ustawianie limitów czasu dla operacji usługi Blob Storage