Pobieranie właściwości obiektu blob

  • Artykuł

Operacja Get Blob Properties zwraca wszystkie metadane zdefiniowane przez użytkownika, standardowe właściwości HTTP i właściwości systemu dla obiektu blob. Nie zwraca zawartości obiektu blob.

Żądanie

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

Identyfikator URI żądania HEAD 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.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 HEAD Wersja PROTOKOŁU HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob 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 Opcjonalny. Wersja 2019-12-12 lub nowsza. Parametr versionid jest nieprzezroczystą DateTime wartością, która, gdy jest obecna, 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. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji usług Azure Storage.
x-ms-lease-id: <ID> Opcjonalny. Jeśli ten nagłówek jest określony, operacja jest wykonywana tylko wtedy, Get Blob Properties 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 któryś z tych warunków nie zostanie spełniony, żądanie zakończy się niepowodzeniem, a Get Blob Properties operacja zakończy się niepowodzeniem z kodem stanu 412 (Warunek wstępny nie powiodło się).
x-ms-upn Opcjonalny. Wersja 2020-06-12 lub nowsza. Prawidłowe dla kont z włączoną hierarchiczną przestrzenią nazw. Jeśli wartości tożsamości użytkownika zwrócone w obiekcie x-ms-owner są prawdziwe, są przekształcane z identyfikatorów obiektów Microsoft Entra na główne nazwy użytkownika. Jeśli wartości są fałszywe, 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 zwracania właściwości obiektów blob i metadanych tylko wtedy, gdy określony warunek zostanie spełniony. 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, należy dołączyć te nagłówki do żądania, aby operacja odczytu mogła zostać ukończona pomyślnie.

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 i zestaw nagłówków odpowiedzi.

Kod stanu

Operacja zakończona powodzeniem zwraca kod stanu 200 (OK).

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 nagłówki w poniższej tabeli. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie nagłówki standardowe są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi Opis
Last-Modified Data/godzina ostatniej modyfikacji obiektu blob. Format daty jest zgodny z RFC 1123. Aby uzyskać więcej informacji, zobacz Reprezentacja wartości daty/godziny w nagłówkach.

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. Aby uzyskać więcej informacji, zobacz Reprezentacja wartości daty/godziny w nagłówkach.
x-ms-meta-name:value Zestaw par name-value, które odpowiadają metadanym zdefiniowanym przez użytkownika skojarzonym z tym obiektem blob.
x-ms-tag-count Wersja 2019-12-12 lub nowsza. Jeśli obiekt blob ma tagi, zwraca liczbę tagów przechowywanych w obiekcie blob. Ten nagłówek nie jest zwracany, jeśli w obiekcie blob nie ma tagów.
x-ms-blob-type:<BlockBlob\|PageBlob\|AppendBlob> Typ obiektu blob.
x-ms-copy-completion-time:<datetime> Wersja 2012-02-12 lub nowsza. Czas ostatniej próby Copy Blob wykonania 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 oczekuje, 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 Propertieselementu , 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ę 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 używającej Set Blob Propertieselementu , 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, gdzie 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 używającej Set Blob Propertieselementu , Put Bloblub Put Block List.
x-ms-copy-progress: <bytes copied/bytes total> Wersja 2012-02-12 lub nowsza. Zawiera liczbę skopiowanych bajtów i łączną liczbę bajtów w źródle w ostatniej próbie Copy Blob operacji, gdzie ten obiekt blob był docelowym obiektem blob. Może pokazywać z zakresu od 0 do Content-Length skopiowanych 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 używającej Set Blob Propertieselementu , 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, który określa źródłowy obiekt blob, który był używany w ostatniej próbie Copy Blob operacji, gdzie 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 używającej Set Blob Propertieselementu , Put Bloblub Put Block List.
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 utrudniają postęp kopiowania, ale nie powodują niepowodzenia.
- aborted: Kopiowanie zostało zakończone przez .Abort Copy Blob
- failed: Kopiowanie nie powiodło się. Zobacz x-ms-copy-status-description , aby uzyskać szczegółowe informacje o błędach.

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 używającej Set Blob Propertiesoperacji , Put Bloblub Put Block List.
x-ms-incremental-copy: true Wersja 2016-05-31 lub nowsza. Uwzględniane, jeśli obiekt blob jest przyrostowym obiektem blob kopiowania.
x-ms-copy-destination-snapshot:<datetime> Wersja 2016-05-31 lub nowsza. Uwzględniane, jeśli obiekt blob jest przyrostowym kopią obiektu blob lub przyrostową migawką kopii, jeśli x-ms-copy-status to powodzenie. Czas migawki ostatniej pomyślnej migawki kopiowania przyrostowego dla tego obiektu blob.
x-ms-lease-duration: <infinite \| fixed> Gdy obiekt blob jest dzierżawiony, określa, czy dzierżawa ma nieskończony, czy stały czas trwania. Uwzględnione w przypadku żądań korzystających z wersji 2012-02-12 i nowszych.
x-ms-lease-state: <available \| leased \| expired \| breaking \| broken> Stan dzierżawy obiektu blob. Uwzględnione w przypadku żądań korzystających z wersji 2012-02-12 i nowszych.
x-ms-lease-status:<locked\| unlocked> Stan dzierżawy obiektu blob.
Content-Length Rozmiar obiektu blob w bajtach. W przypadku stronicowego obiektu blob ten nagłówek zwraca wartość x-ms-blob-content-length nagłówka przechowywanego w obiekcie blob.
Content-Type Typ zawartości określony dla obiektu blob. Jeśli nie określono żadnego typu zawartości, domyślnym typem zawartości jest application/octet-stream.
Etag Element 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 Content-MD5 Jeśli nagłówek został ustawiony dla 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ść MD5 blokowego obiektu blob, nawet jeśli Put Blob żądanie nie zawiera nagłówka MD5.
Content-Encoding Content-Encoding Jeśli nagłówek żądania został wcześniej ustawiony dla obiektu blob, ta wartość jest zwracana w tym nagłówku.
Content-Language Content-Language Jeśli nagłówek żądania został wcześniej ustawiony dla obiektu blob, ta wartość jest zwracana w tym nagłówku.
Content-Disposition Content-Disposition Jeśli nagłówek żądania został wcześniej ustawiony dla obiektu blob, ta wartość jest zwracana w tym nagłówku dla żądań względem wersji 2013-08-15 lub nowszej.

Pole nagłówka Content-Disposition odpowiedzi zawiera dodatkowe informacje o sposobie przetwarzania ładunku odpowiedzi, a także może służyć do dołączania dodatkowych metadanych. Jeśli na przykład nagłówek jest ustawiony na attachment, oznacza to, że agent użytkownika nie powinien wyświetlać odpowiedzi, ale zamiast tego wyświetli okno dialogowe Zapisz jako.
Cache-Control Cache-Control Jeśli nagłówek żądania został wcześniej ustawiony dla obiektu blob, ta wartość jest zwracana w tym nagłówku.
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.

Ten nagłówek nie jest zwracany dla blokowych obiektów blob.
x-ms-request-id Ten nagłówek jednoznacznie identyfikuje wykonane żądanie i można go 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żywaną do wykonania żądania. Ten nagłówek jest zwracany w przypadku żądań wysyłanych w 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.
Date Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę zainicjowania odpowiedzi.
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 2013-08-15 lub nowszej.
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 metadanych obiektu blob/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-access-tier Wersja 2017-04-17 lub nowsza. Warstwa stronicowego obiektu blob na koncie Premium Storage lub warstwie blokowego obiektu blob na koncie usługi Blob Storage lub ogólnego przeznaczenia w wersji 2. Aby uzyskać listę dozwolonych warstw stronicowych obiektów blob w warstwie Premium, zobacz Premium Storage o wysokiej wydajności i dyski zarządzane dla maszyn wirtualnych. W przypadku konta usługi Blob Storage lub ogólnego przeznaczenia w wersji 2 prawidłowe wartości to Hot, Cool, Coldi Archive. Uwaga:Cold warstwa jest obsługiwana w wersji 2021-12-02 lub nowszej. Aby uzyskać szczegółowe informacje na temat warstw warstwowych na poziomie blokowych obiektów blob konta obiektów blob w warstwach Gorąca, Chłodna i Archiwum, zobacz Warstwy magazynowania na poziomie konta obiektów blob w warstwie Gorąca, Chłodna i Archiwum.
x-ms-access-tier-inferred: true Wersja 2017-04-17 lub nowsza. W przypadku stronicowych obiektów blob tylko na koncie Premium Storage. Jeśli warstwa dostępu nie jest jawnie ustawiona na obiekcie blob, warstwa jest wnioskowana na podstawie jego długości zawartości, a ten nagłówek jest zwracany z wartością true. W przypadku blokowych obiektów blob w usłudze Blob Storage lub konta ogólnego przeznaczenia w wersji 2, jeśli obiekt blob nie ma ustawionej warstwy dostępu, możesz wywnioskować warstwę z właściwości konta magazynu. Ten nagłówek jest ustawiany tylko wtedy, gdy wywnioskowana jest warstwa blokowych obiektów blob.
x-ms-archive-status Wersja 2017-04-17 lub nowsza. W przypadku magazynu obiektów blob lub konta ogólnego przeznaczenia w wersji 2 prawidłowe wartości to rehydrate-pending-to-hot, rehydrate-pending-to-cooli rehydrate-pending-to-cold. Jeśli obiekt blob jest ponownie wypełniania i jest niekompletny, ten nagłówek jest zwracany, co oznacza, że ponowne wypełnianie oczekuje i wyświetla warstwę docelową. Aby uzyskać szczegółowe informacje na temat warstw warstwowych na poziomie blokowego konta obiektów blob w warstwie Standardowa, zobacz Warstwy magazynowania Gorąca, Chłodna i Archiwum.
x-ms-access-tier-change-time Wersja 2017-04-17 lub nowsza. Wskazuje czas ostatniej zmiany warstwy obiektu. Ten nagłówek jest zwracany tylko wtedy, gdy kiedykolwiek ustawiono warstwę blokowego obiektu blob. Format daty jest zgodny z dokumentem RFC 1123. Aby uzyskać więcej informacji, zobacz Reprezentacja wartości daty/godziny w nagłówkach. Aby uzyskać więcej informacji na temat warstw blokowych na poziomie blokowych obiektów blob konta obiektów blob w warstwie Standardowa, zobacz Warstwy magazynowania Gorąca, Chłodna i Archiwum.
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 jest obecna w żądaniu, a wartość wynosi co najwyżej 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-rehydrate-priority Wersja 2019-12-12 lub nowsza. Jeśli obiekt jest w stanie oczekiwania na ponowne wypełnianie, ten nagłówek jest zwracany z priorytetem ponownego wypełniania. Prawidłowe wartości to High/Standard. Aby uzyskać szczegółowe informacje na temat warstw na poziomie blokowych obiektów blob konta obiektów blob w warstwach magazynowania gorąca, chłodna i archiwum.
x-ms-or-{policy-id}_{rule-id} Wersja 2019-12-12 lub nowsza, zwrócona tylko dla blokowych obiektów blob. policy-id to wartość identyfikatora GUID reprezentująca identyfikator zasad replikacji obiektów na koncie magazynu. rule-id to wartość identyfikatora GUID reprezentująca identyfikator reguły zasad w kontenerze obiektów blob. Jeśli konto jest ObjectReplicationwłączone, wartość tego nagłówka reprezentuje stan replikacji obiektu blob z podanymi zasadami i identyfikatorami reguł albo complete lub failed.
x-ms-or-policy-id Wersja 2019-12-12 lub nowsza, zwrócona tylko dla blokowych obiektów blob. Jeśli konto jest ObjectReplicationwłączone, wartość tego nagłówka reprezentuje zasady, które zarządzają replikacją.
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 zasady są wyłączone. Aby uzyskać informacje na temat ustawiania zasad śledzenia czasu ostatniego dostępu konta magazynu, zobacz Interfejs API usługi Blob Storage.
x-ms-blob-sealed Wersja 2019-12-12 lub nowsza, zwrócona tylko dla uzupełnialnych obiektów blob. Jeśli uzupełniony obiekt blob został zapieczętowany, wartość będzie prawdziwa. 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 datę "przechowywania do" ustawioną 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 RFC1123 formatem.
x-ms-immutability-policy-mode: unlocked/locked Wersja 2020-06-12 lub nowsza. Tryb zasad niezmienności zwracany, jeśli na obiekcie 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 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 wartość true , jeśli obiekt blob zawiera blokadę prawną, a jej wartość jest prawdziwa. W przeciwnym razie wartość jest ustawiona na wartość false, jeśli obiekt blob zawiera blokadę prawną i jej wartość false.
x-ms-owner Wersja 2020-06-12 lub nowsza. Tylko w przypadku 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 w przypadku kont z włączoną hierarchiczną przestrzenią nazw. Zwraca grupę właścicieli pliku lub katalogu.
x-ms-permissions Wersja 2020-06-12 lub nowsza. Tylko w przypadku kont z włączoną hierarchiczną przestrzenią nazw. Zwraca uprawnienia ustawione dla użytkownika, grupy i innych 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 w przypadku kont z włączoną hierarchiczną przestrzenią nazw. Zwraca typ zasobu dla ścieżki, która może być albo filedirectory.
x-ms-expiry-time Wersja 2020-02-10 lub nowsza. Tylko w przypadku kont z włączoną hierarchiczną przestrzenią nazw. Zwraca czas wygaśnięcia ustawiony na obiekcie blob. Jest zwracany tylko dla plików, które mają ustawiony czas wygaśnięcia.

Treść odpowiedzi

Brak.

Przykładowa odpowiedź

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-meta-Name: myblob.txt  
x-ms-meta-DateUploaded: <date>  
x-ms-blob-type: AppendBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CAE97120C1FF22"  
Accept-Ranges: bytes  
x-ms-blob-committed–block-count: 1  
x-ms-version: 2015-02-21  
Last-Modified: <date>  
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 Properties poniższym opisem.

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 wymieniono akcję RBAC niezbędną do wywołania Get Blob Properties operacji przez użytkownika, grupę lub jednostkę usługi Microsoft Entra oraz najmniej uprzywilejowaną wbudowaną rolę RBAC platformy Azure, która obejmuje 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

Aby określić, czy Copy Blob operacja została zakończona, najpierw sprawdź, czy x-ms-copy-id wartość nagłówka jest zgodna z identyfikatorem kopiowania dostarczonym 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 wcześniejszych wersji niż 2012-02-12.

x-ms-copy-status-description zawiera więcej informacji o Copy Blob niepowodzeniu. Wartości x-ms-copy-status-description są 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 dostarczony przez platformę Azure w <elemecie ErrorCode> . Jeśli nie <zostanie wyświetlony element ErrorCode> , zostanie użyte słowo kluczowe ze standardowym tekstem błędu skojarzonym z 3-cyfrowym kodem stanu HTTP w specyfikacji HTTP. Aby uzyskać więcej informacji, zobacz Typowe kody błędów interfejsu API REST.
Informacje Szczegółowy opis błędu ujętego 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

Poniższe opisy błędów mogą ulec zmianie bez ostrzeżenia, nawet bez zmiany wersji, więc tekst może nie być dokładnie zgodny.

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 błąd bazowy, zwraca ResourceNotFound wartość w <elemecie ErrorCode> . Jeśli w odpowiedzi nie <pojawi się żaden element ErrorCode> , 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 dwa 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 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 Properties żądań na podstawie typu konta magazynu:

Operacja Typ konta magazynu Kategoria rozliczeń
Pobieranie właściwości obiektu blob Blokowy obiekt blob w warstwie Premium
Standardowa ogólnego przeznaczenia, wersja 2		 Inne operacje
Pobieranie właściwości obiektu blob 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