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

  • Artykuł

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 podtopy:

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 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 nazw/wartości. 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órą zostały utworzone, ale nie są uwzględniane wielkości liter podczas ustawiania lub odczytywania. Jeśli dla zasobu są przesyłane co najmniej dwa nagłówki metadanych o tej samej nazwie, usługa Blob service zwraca kod stanu 400 (Nieprawidłowe żądanie).

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

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

Operacje na metadanych

Metadane zasobu obiektu blob lub 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; częściowe aktualizacje nie są obsługiwane. Ustawienie metadanych zasobu zastępuje wszystkie istniejące 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. Operacja HEAD zwraca tylko nagłówki; nie zwraca treści odpowiedzi.

Składnia identyfikatora URI 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 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 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 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, jak określono 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