Pobieranie właściwości kontenera

Operacja zwraca Get Container Properties wszystkie metadane zdefiniowane przez użytkownika oraz właściwości systemowe dla określonego kontenera. Zwrócone dane nie zawierają listy blobów kontenera.

Request

Żądanie może Get Container Properties 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 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 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 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 or 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 Properties gdy dzierżawa kontenera jest aktywna i odpowiada temu ID. Jeśli nie ma aktywnej umowy najmu lub dowód tożsamości się nie zgadza, zwraca się 412 (Warunek wstępny niespełniony).
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ć więcej informacji na temat kodów 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 .

Nagłówek odpowiedzi Description
x-ms-meta-name:value Zwraca ciąg znaków zawierający parę nazwy/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. Aby uzyskać więcej informacji, zobacz Reprezentowanie wartości daty/godziny 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-lease-status: <locked ¦ unlocked> Wersja 2012-02-12 i nowsze. Stan dzierżawy kontenera.
x-ms-lease-state: <available ¦ leased ¦ expired ¦ breaking ¦ broken> Wersja 2012-02-12 i nowsze. Stan dzierżawy kontenera.
x-ms-lease-duration: <infinite ¦ fixed > Wersja 2012-02-12 i nowsze, tylko gdy kontener jest dzierżawiony. Określa, czy dzierżawa kontenera ma czas trwania nieskończony czy stały.
x-ms-request-id Unikalnie identyfikuje złożone żądanie i może być użyty do jego rozwiązywania problemów. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z operacjami interfejsu API.
x-ms-version Wersja 2009-09-19 i nowsze. Wskazuje wersję usługi Blob, która jest używana do wykonania żądania.

Zwracano także dla anonimowych żądań bez określonej wersji, jeśli kontener był oznaczony do publicznego dostępu przy użyciu usługi Blob w wersji 2009-09-19.
Date Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę zainicjowania odpowiedzi.
x-ms-blob-public-access Wersja 2016-05-31 i nowsze. Wskazuje, czy dane w kontenerze mogą być dostępne publicznie oraz jaki jest poziom dostępu. Możliwe wartości to:

kontener: Oznacza pełny publiczny dostęp do odczytu kontenera i danych blob. Klienci mogą wyliczać obiekty blob w kontenerze za pośrednictwem żądania anonimowego, ale nie mogą wyliczać kontenerów na koncie magazynu.

BLOB: Oznacza publiczny dostęp do odczytu dla blobów. Dane BLOB w tym kontenerze mogą być odczytywane anonimowo, ale dane kontenera nie są dostępne. Klienci nie mogą wyliczać obiektów blob w kontenerze za pośrednictwem żądania anonimowego.

Jeśli ten nagłówek nie zostanie zwrócony w odpowiedzi, kontener jest prywatny dla właściciela konta.
x-ms-has-immutability-policy Wersja 2017-11-09 i nowsze. Wskazuje, czy kontener ma ustawione zasady niezmienności. Wartość ta dotyczy true sytuacji, gdy polityka jest ustawiona lub false jeśli nie jest ustalana.
x-ms-has-legal-hold Wersja 2017-11-09 i nowsze. Wskazuje, czy kontener ma blokadę prawną. Wartość polega na tym true , że posiada jeden lub więcej legalnych holdów oraz false jeśli nie ma żadnych legalnych holdów.
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 znajduje się w żądaniu, nie jest obecny w odpowiedzi.

Treść odpowiedzi

None.

Przykładowa odpowiedź

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Transfer-Encoding: chunked  
x-ms-meta-Name: StorageSample  
Date: Sun, 25 Sep 2016 12:43:08 GMT  
ETag: "0x8CAFB82EFF70C46"  
Last-Modified: Sun, 25 Sep 2016 10:42:18 GMT  
x-ms-version: 2016-05-31
x-ms-blob-public-access: blob  
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 Properties 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 Properties 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

None. Zobacz informacje o rozliczeniach , aby uzyskać szczegóły dotyczące wpływu tej operacji na koszty.

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 Properties na podstawie typu konta magazynu:

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

Informacje dodatkowe

Operacje na kontenerach

  • Ostatnia aktualizacja o