Ustawianie metadanych kontenera

Operacja ta Set Container Metadata ustawia jedną lub więcej zdefiniowanych przez użytkownika par nazw-wartość dla określonego kontenera.

Request

Żądanie może Set 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
PUT 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 usługi Blob jako 127.0.0.1:10000, a następnie nazwę konta emulowanego magazynu:

Metoda Żądanie URI Wersja protokołu HTTP
PUT 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

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

Parametr Description
timeout Optional. Parametr timeout jest wyrażony w sekundach. Więcej informacji można znaleźć w artykule Ustaw limity czasowe dla operacji usług Blob.

Nagłówki żądań

Wymagane i opcjonalne nagłówki żądań zostały opisane w poniższej tabeli:

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-version Wymagane dla wszystkich autoryzowanych żądań. 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> Opcjonalnie, wersja 2012-02-12 i nowsze. Jeśli jest to określone, działa tylko wtedy, Set Container Metadata 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 (Nieudane warunki wstępne).
x-ms-meta-name:value Optional. Para name-value do skojarzenia z kontenerem jako metadanymi.

Każde wywołanie tej operacji zastępuje wszystkie istniejące metadane przypisane do kontenera. Aby usunąć wszystkie metadane z kontenera, wywołaj tę operację bez nagłówków metadanych.

Uwaga: od wersji 2009-09-19 nazwy metadanych muszą być zgodne z regułami nazewnictwa dla identyfikatorów języka C# .
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.

Operacja ta obsługuje również użycie nagłówków warunkowych do ustawiania metadanych kontenera tylko wtedy, gdy spełniony jest określony warunek. Więcej informacji można znaleźć w artykule Określ nagłówki warunkowe dla operacji usług Bloba.

Treść żądania

None.

Przykładowe żądanie

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=metadata HTTP/1.1  
  
Request Headers:  
x-ms-version: 2011-08-18  
x-ms-date: Sun, 25 Sep 2011 22:50:32 GMT  
x-ms-meta-Category: Images  
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

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
ETag Element ETag dla kontenera. Jeśli wersja żądania to 2011-08-18 lub nowsza, wartość ETag jest otoczona cudzysłowem.
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 modyfikująca kontener, jego właściwości lub metadane aktualizuje ostatnią modyfikację, w tym ustawianie uprawnień kontenera. Operacje na blobach nie wpływają na ostatnio zmodyfikowany czas kontenera.
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 Wskazuje wersję usługi Blob, która została użyta do wykonania żądania. Ten nagłówek jest zwracany dla żądań, które zostały wykonane w wersji 2009-09-19 lub nowszej.
Date Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę zainicjowania odpowiedzi.
Access-Control-Allow-Origin Zwraca się, jeśli żądanie zawiera nagłówek Origin i współdzielenie zasobów między źródłami (CORS), jest włączone za pomocą reguły dopasowania. Ten nagłówek zwraca wartość nagłówka żądania źródła, jeśli istnieje dopasowanie.
Access-Control-Expose-Headers Zwraca się, jeśli żądanie zawiera Origin nagłówek, a CORS jest włączony z regułą dopasowania. Zwraca listę nagłówków odpowiedzi, które mają być udostępnione klientowi lub emitentowi żądania.
Access-Control-Allow-Credentials Zwraca się, jeśli żądanie zawiera Origin nagłówek, a CORS jest włączony z regułą dopasowania, która nie pozwala na wszystkie początki. Ten nagłówek ma ustawioną wartość true.
x-ms-client-request-id Ten nagłówek może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi 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 będzie on obecny w odpowiedzi.

Treść odpowiedzi

None.

Authorization

Autoryzacja jest wymagana podczas wywoływania dowolnej operacji dostępu do danych w usłudze Azure Storage. Możesz autoryzować operację Set 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 Set 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

Wywołanie operacji Set Container Metadata nadpisuje wszystkie istniejące metadane powiązane z kontenerem. Nie można zmodyfikować pojedynczej pary nazwa-wartość.

Możesz też ustawić metadane kontenera po jego tworzeniu.

Wywołanie Set Container Metadata aktualizuje ETag i Last-Modified-Time właściwości kontenera. Jeśli żądanie zostało złożone w wersji 2011-08-18, zaktualizowany ETag jest otoczony cudzysłowem.

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ń Set Container Metadata na podstawie typu konta magazynu:

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

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

Informacje dodatkowe

kody stanu i błędów
Kody błędów usługi Blob Service
Ustaw i pobierz właściwości oraz metadane dla zasobów Blob Storage

  • Ostatnia aktualizacja o