Ustawianie i pobieranie właściwości i metadanych dla zasobów usługi Blob Service

Kontenery i obiekty blob obsługują niestandardowe metadane reprezentowane jako nagłówki HTTP. Nagłówki metadanych można ustawić na żądanie, które tworzy nowy kontener lub zasób obiektu blob, lub na żądanie, które jawnie tworzy właściwość w istniejącym zasobie.

Ten temat zawiera następujące tematy podrzędne:

Format nagłówka metadanych

Operacje na metadanych

Standardowe właściwości PROTOKOŁU HTTP dla kontenerów i obiektów blob

Obiekty blob obsługują również tagi, specjalny typ niestandardowych metadanych, które są automatycznie indeksowane przez usługę Blob Service. Aby uzyskać więcej informacji, zobacz Manage and find data on Azure Blob Storage with Blob Index (Zarządzanie danymi i znajdowanie ich na Azure Blob Storage za pomocą indeksu obiektów blob).

Format nagłówka metadanych

Nagłówki metadanych to pary nazwa/wartość. Format nagłówka to:

x-ms-meta-name:string-value  

Począwszy od wersji 2009-09-19, nazwy metadanych muszą być zgodne z regułami nazewnictwa identyfikatorów języka C#.

Nazwy są bez uwzględniania wielkości liter. Należy pamiętać, że nazwy metadanych zachowują wielkość liter, z którymi zostały utworzone, ale nie są uwzględniane wielkości liter podczas ustawiania lub odczytywania. Jeśli co najmniej dwa nagłówki metadanych o tej samej nazwie są przesyłane dla zasobu, usługa Blob zwraca kod stanu 400 (Nieprawidłowe żądanie).

Metadane składają się z par nazwa/wartość. Całkowity rozmiar wszystkich par metadanych może wynosić do 8 KB.

Pary nazwa/wartość metadanych są prawidłowymi nagłówkami HTTP, dlatego są zgodne ze wszystkimi ograniczeniami dotyczącymi nagłówków HTTP.

Operacje na metadanych

Metadane dotyczące obiektu blob lub zasobu kontenera można pobrać lub ustawić bezpośrednio, bez zwracania lub zmieniania zawartości zasobu.

Należy pamiętać, że wartości metadanych można odczytywać lub zapisywać tylko w całości; aktualizacje częściowe nie są obsługiwane. Ustawienie metadanych zasobu spowoduje zastąpienie wszystkich istniejących wartości metadanych dla tego zasobu.

Pobieranie właściwości i metadanych

Operacje GET i HEAD pobierają nagłówki metadanych dla określonego kontenera lub obiektu blob. Te operacje zwracają tylko nagłówki; nie zwracają treści odpowiedzi.

Składnia identyfikatora URI do pobierania nagłówków metadanych w kontenerze jest następująca:

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=container  

Składnia identyfikatora URI do pobierania nagłówków metadanych w obiekcie blob jest następująca:

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata  

Ustawianie nagłówków metadanych

Operacja PUT ustawia nagłówki metadanych w określonym kontenerze lub obiekcie blob, zastępując wszystkie istniejące metadane zasobu. Wywołanie funkcji PUT bez żadnych nagłówków żądania czyści wszystkie istniejące metadane zasobu.

Składnia identyfikatora URI do ustawiania nagłówków metadanych w kontenerze jest następująca:

PUT https://myaccount.blob.core.windows.net/mycontainer?comp=metadata?restype=container  

Składnia identyfikatora URI do ustawiania nagłówków metadanych w obiekcie blob jest następująca:

PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata  

Standardowe właściwości PROTOKOŁU HTTP dla kontenerów i obiektów blob

Kontenery i obiekty blob obsługują również pewne standardowe właściwości protokołu HTTP. Właściwości i metadane są reprezentowane jako standardowe nagłówki HTTP; różnica między nimi znajduje się w nazewnictwie nagłówków. Nagłówki metadanych mają nazwę z prefiksem x-ms-meta- nagłówka i nazwą niestandardową. Nagłówki właściwości używają standardowych nazw nagłówków HTTP określonych w sekcji Definicje pól nagłówka 14 specyfikacji protokołu HTTP/1.1.

Standardowe nagłówki HTTP obsługiwane w kontenerach obejmują:

  • ETag

  • Last-Modified

Standardowe nagłówki HTTP obsługiwane w obiektach blob obejmują:

  • ETag

  • Last-Modified

  • Content-Length

  • Content-Type

  • Content-MD5

  • Content-Encoding

  • Content-Language

  • Cache-Control

  • Origin

  • Range

Zobacz też

Tworzenie kontenera
Pobieranie właściwości kontenera
Ustawianie metadanych kontenera
Wstawianie obiektu blob
Kopiowanie obiektu blob
Pobieranie właściwości obiektu blob
Pobieranie metadanych obiektu blob
Ustawianie metadanych obiektu blob
Pojęcia dotyczące usługi Blob Service
Zarządzanie danymi w usłudze Azure Blob Storage i znajdowanie ich przy użyciu indeksu obiektów blob