Pobieranie metadanych kontenera

Operacja zwraca Get Container Metadata wszystkie metadane zdefiniowane przez użytkownika dla kontenera.

Request

Żądanie może Get Container Metadata być skonstruowane w następujący sposób. Zalecamy używanie protokołu HTTPS. Zastąp myaccount nazwą swojego konta pamięci:

Metoda Żądanie URI Wersja protokołu HTTP
GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=metadata HTTP/1.1

Emulowane żądanie usługi magazynu

Gdy wysyłasz żądanie do usługi emulowanej pamięci masowej, podaj nazwę hosta emulatora i port Azure Blob Storage jako 127.0.0.1:10000, a następnie nazwę konta emulowanego storage:

Metoda Żądanie URI Wersja protokołu HTTP
GET/HEAD http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=metadata HTTP/1.1

Aby uzyskać więcej informacji, zobacz Use the Azurite emulator for local Azure Storage development (Używanie emulatora Azurite do lokalnego programowania w usłudze Azure Storage).

Parametry identyfikatora URI

Na URI żądania można określić następujące dodatkowe parametry:

Parametr Description
timeout Optional. Parametr timeout jest wyrażony 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 Description
Authorization Required. 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 Required. Określa uniwersalny czas koordynowany (UTC) dla żądania. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
x-ms-lease-id: <ID> Opcjonalnie, wersja 2012-02-12 i nowsze. Jeśli jest to określone, działa tylko wtedy, Get Container Metadata gdy dzierżawa kontenera jest aktywna i odpowiada temu ID. Jeśli nie ma aktywnej umowy najmu lub ID się nie zgadza, zwracany jest kod błędu 412 (Nieudane warunki wstępne).
x-ms-version Wymagane dla wszystkich autoryzowanych wniosków, opcjonalne dla 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-client-request-id Optional. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB), który jest rejestrowany w dziennikach podczas konfigurowania rejestrowania. Zdecydowanie zalecamy używanie tego nagłówka do korelowania działań po stronie klienta z żądaniami odbieranymi przez serwer. Aby uzyskać więcej informacji, zobacz Monitor Azure Blob Storage.

Treść żądania

None.

Response

Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.

Kod stanu

Pomyślna operacja zwraca kod stanu 200 (OK).

Aby uzyskać informacje o kodach stanu, zobacz Stan i kody błędów.

Nagłówki odpowiedzi

Odpowiedź dla tej operacji 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 .

Syntax Description
x-ms-meta-name:value Zwraca ciąg znaków zawierający parę imię-wartość powiązaną z kontenerem jako metadane.
ETag Tag encji dla kontenera. Jeśli wersja żądania to 2011-08-18 lub nowsza, wartość ETag jest ujęta w cudzysłów.
Last-Modified Zwraca datę i godzinę ostatniej modyfikacji kontenera. Format daty jest zgodny ze standardem RFC 1123. Więcej informacji można znaleźć w artykule Reprezentacja wartości Date-Time w nagłówkach.

Każda operacja, która modyfikuje kontener lub jego właściwości lub metadane, aktualizuje czas ostatniej modyfikacji. Operacje na blobach nie wpływają na ostatni zmodyfikowany czas kontenera.
x-ms-request-id Ten nagłówek jednoznacznie identyfikuje żądanie, które zostało wykonane i może służyć do rozwiązywania problemów z żądaniem. Więcej informacji można znaleźć w artykule Rozwiązywanie problemów z operacjami API.
x-ms-version Wersja usługi, która została użyta do wykonania żądania. Ten nagłówek jest zwracany dla żądań wysyłanych dla wersji 2009-09-19 i nowszych.

Nagłówek jest również zwracany dla anonimowych żądań bez określonej wersji, jeśli kontener był oznaczony do publicznego dostępu przy użyciu wersji usługi 2009-09-19.
Date Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę zainicjowania odpowiedzi.
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 nagłówka x-ms-client-request-id, jeśli znajduje się w żądaniu, a wartość nie zawiera więcej niż 1024 widocznych znaków ASCII. Jeśli nagłówek x-ms-client-request-id nie występuje w żądaniu, ten nagłówek nie pojawia się w odpowiedzi.

Treść odpowiedzi

None.

Przykładowa odpowiedź

  
Response Status:  
HTTP/1.1 200 OK  
  
Response headers:  
Transfer-Encoding: chunked  
x-ms-meta-AppName: StorageSample  
Date: Sun, 25 Sep 2011 23:43:08 GMT  
ETag: "0x8CAFB82EFF70C46"  
Last-Modified: Sun, 25 Sep 2011 19:42:18 GMT  
x-ms-version: 2011-08-18  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

Authorization

Autoryzacja jest wymagana podczas wywoływania dowolnej operacji dostępu do danych w usłudze Azure Storage. Możesz autoryzować operację Get Container Metadata zgodnie z poniższym opisem.

Important

Firma Microsoft zaleca używanie identyfikatora Entra firmy Microsoft z tożsamościami zarządzanymi w celu autoryzowania żądań do usługi Azure Storage. Identyfikator Entra firmy Microsoft zapewnia lepsze zabezpieczenia i łatwość użycia w porównaniu z autoryzacją klucza współdzielonego.

Usługa Azure Storage obsługuje używanie Microsoft Entra ID do autoryzacji żądań do danych blob. Za pomocą identyfikatora Entra firmy Microsoft 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 Microsoft Entra ID, aby zwrócić token 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 o autoryzacji przy użyciu identyfikatora Entra firmy Microsoft, zobacz Autoryzowanie dostępu do obiektów blob przy użyciu identyfikatora Entra firmy Microsoft.

Uprawnienia

Poniżej wymieniono akcję RBAC niezbędną dla użytkownika microsoft Entra, grupy, tożsamości zarządzanej lub jednostki usługi w celu wywołania operacji Get Container Metadata oraz najmniej uprzywilejowanej wbudowanej roli 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 Assign an Azure role for access to blob data.

Remarks

Ta operacja zwraca jedynie metadane zdefiniowane przez użytkownika na kontenerze. Aby również zwrócić właściwości systemu, wywołaj Pobierz właściwości kontenera.

Billing

Żą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 z 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 żądań Get Container Metadata na podstawie typu konta magazynu:

Operation Typ konta magazynowania Kategoria rozliczeń
Pobieranie metadanych kontenera Obiekt typu blob Premium
Standard ogólnego przeznaczenia wersja 2		 Inne operacje
Pobieranie metadanych kontenera Standard o ogólnym przeznaczeniu V1 Operacje odczytu

Aby dowiedzieć się więcej o cenach dla określonej kategorii rozliczeń, zobacz Cennik usługi Azure Blob Storage.

Informacje dodatkowe

Operacje na kontenerach

  • Ostatnia aktualizacja o