Ustawianie tagów obiektów blob

  • Artykuł

Operacja Set Blob Tags ustawia tagi zdefiniowane przez użytkownika dla określonego obiektu blob jako co najmniej jedną parę klucz-wartość.

Żądanie

Żądanie Set Blob Tags może być skonstruowane w następujący sposób. Zalecamy korzystanie z protokołu HTTPS. Zastąp ciąg myaccount nazwą konta magazynu:

Identyfikator URI żądania PUT Wersja PROTOKOŁU HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags&versionid=<DateTime>		 HTTP/1.1

Parametry identyfikatora URI

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

Parametr Opis
versionid Opcjonalnie w wersji 2019-12-12 lub nowszej. Parametr versionid jest nieprzezroczystą DateTime wartością, która w chwili obecnej określa wersję obiektu blob do pobrania.
timeout Opcjonalny. Parametr jest wyrażony timeout w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji usługi Blob Storage.

Nagłówki żądań

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

Nagłówek żądania Opis
Authorization Wymagane. 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 Wymagane. Określa dla żądania godzinę w formacie uniwersalnego czasu koordynowanego (UTC). 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 dla usług Azure Storage.
Content-Length Wymagane. Długość zawartości żądania w bajtach. Ten nagłówek odnosi się do długości zawartości dokumentu tagów, a nie samego obiektu blob.
Content-Type Wymagane. Wartość tego nagłówka powinna mieć wartość application/xml; charset=UTF-8.
Content-MD5 Opcjonalny. Skrót MD5 zawartości żądania. Ten skrót służy do weryfikowania integralności zawartości żądania podczas transportu. Jeśli dwa skróty nie są zgodne, operacja kończy się niepowodzeniem z kodem błędu 400 (Nieprawidłowe żądanie).

Ten nagłówek jest skojarzony z zawartością żądania, a nie z zawartością samego obiektu blob.
x-ms-content-crc64 Opcjonalny. Skrót CRC64 zawartości żądania. Ten skrót służy do weryfikowania integralności zawartości żądania podczas transportu. Jeśli dwa skróty nie są zgodne, operacja kończy się niepowodzeniem z kodem błędu 400 (Nieprawidłowe żądanie).

Ten nagłówek jest skojarzony z zawartością żądania, a nie z zawartością samego obiektu blob.

Jeśli istnieją zarówno Content-MD5 nagłówki, jak i x-ms-content-crc64 żądanie kończy się niepowodzeniem z kodem błędu 400 (Nieprawidłowe żądanie).
x-ms-lease-id:<ID> Wymagane, jeśli obiekt blob ma aktywną dzierżawę.

Aby wykonać tę operację na obiekcie blob z aktywną dzierżawą, określ prawidłowy identyfikator dzierżawy dla tego nagłówka. Jeśli prawidłowy identyfikator dzierżawy nie zostanie określony w żądaniu, operacja zakończy się niepowodzeniem z kodem stanu 403 (Zabronione).
x-ms-client-request-id Opcjonalny. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB) rejestrowanym 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 Monitorowanie Azure Blob Storage.

Ta operacja obsługuje x-ms-if-tags nagłówek warunkowy w celu ustawienia tagów obiektów blob tylko wtedy, gdy zostanie spełniony określony warunek. Aby uzyskać więcej informacji, zobacz Określanie nagłówków warunkowych dla operacji usługi Blob Storage.

Treść żądania

Format treści żądania jest następujący:

<?xml version="1.0" encoding="utf-8"?>  
<Tags>  
    <TagSet>  
        <Tag>  
            <Key>tag-name-1</Key>  
            <Value>tag-value-1</Value>  
        </Tag>  
        <Tag>  
            <Key>tag-name-2</Key>  
            <Value>tag-value-2</Value>  
        </Tag>  
    </TagSet>  
</Tags>

Treść żądania musi być dobrze sformułowanym dokumentem XML UTF-8 i zawierać zestaw tagów reprezentujący tagi dla obiektu blob.

Zestaw tagów może zawierać nie więcej niż 10 tagów. W kluczach tagów i wartościach jest rozróżniana wielkość liter. Klucze tagów muszą zawierać od 1 do 128 znaków, a wartości tagów muszą zawierać od 0 do 256 znaków. Prawidłowe znaki klucza i wartości tagu obejmują:

  • Małe i wielkie litery (a-z, A-Z)
  • Cyfry (0–9)
  • Spacja ( )
  • Plus (+), minus (-), kropka (.), ukośnik (/), dwukropek (:), równa się (=) i podkreślenie (_)

Reakcja

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

Kod stanu

Pomyślna operacja zwraca kod stanu 204 (Brak zawartości).

Aby uzyskać więcej informacji na temat kodów stanu, zobacz Kody stanu i błędów.

Nagłówki odpowiedzi

Odpowiedź na tę operację 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 Opis
x-ms-request-id Unikatowo identyfikuje wykonane żądanie i może służyć do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z operacjami interfejsu API.
x-ms-version Wersja usługi Blob Storage, która została użyta do wykonania żądania.
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 odpowiedziami. Wartość tego nagłówka jest równa wartości x-ms-client-request-id nagłówka, jeśli jest obecna w żądaniu, a wartość zawiera nie więcej niż 1024 widoczne znaki ASCII. x-ms-client-request-id Jeśli nagłówek nie znajduje się w żądaniu, nie będzie on obecny w odpowiedzi.

Treść odpowiedzi

Brak.

Autoryzacja

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

Usługa Azure Storage obsługuje autoryzację żądań do danych obiektów blob przy użyciu Tożsamość Microsoft Entra. Dzięki Tożsamość Microsoft Entra 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 Tożsamość Microsoft Entra w celu zwrócenia tokenu 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 na temat autoryzacji przy użyciu Tożsamość Microsoft Entra, zobacz Autoryzowanie dostępu do obiektów blob przy użyciu Tożsamość Microsoft Entra.

Uprawnienia

Poniżej przedstawiono akcję RBAC niezbędną do wywołania Set Blob Tags operacji przez użytkownika, grupę lub jednostkę usługi Microsoft Entra oraz najmniej uprzywilejowaną wbudowaną rolę RBAC platformy Azure obejmującą tę akcję:

Aby dowiedzieć się więcej na temat przypisywania ról przy użyciu kontroli dostępu opartej na rolach platformy Azure, zobacz Przypisywanie roli platformy Azure w celu uzyskania dostępu do danych obiektów blob.

Uwagi

Ta operacja jest obsługiwana Set Blob Tags w interfejsie API REST w wersji 2019-12-12 lub nowszej.

W przypadku kont z włączoną hierarchiczną przestrzenią nazw operacja nie jest obsługiwana, Set Blob Tags ponieważ tagi obiektów blob nie są obsługiwane dla kont hierarchicznych przestrzeni nazw.

Operacja Set Blob Tags zastępuje wszystkie istniejące tagi w obiekcie blob. Aby usunąć wszystkie tagi z obiektu blob, wyślij Set Blob Tags żądanie z pustym <TagSet>elementem .

Ta operacja nie aktualizuje elementu ETag ani czasu ostatniej modyfikacji obiektu blob. Istnieje możliwość ustawienia tagów w zarchiwizowanym obiekcie blob.

Usługa magazynu zachowuje silną spójność między obiektem blob a jego tagami. Zmiany tagów obiektów blob są natychmiast widoczne dla kolejnych Get Blob Tags operacji na obiekcie blob. Jednak indeks pomocniczy jest ostatecznie spójny. Zmiany tagów obiektu blob mogą nie być natychmiast widoczne dla Find Blobs by Tags operacji.

Jeśli żądanie zawiera nieprawidłowe tagi, usługa Blob Storage zwraca kod stanu 400 (nieprawidłowe żądanie).

Rozliczenia

Żą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 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 w innej kategorii rozliczeniowej niż transakcje zapisu. W poniższej tabeli przedstawiono kategorię rozliczeń dla Set Blob Tags żądań na podstawie typu konta magazynu:

Operacja Typ konta magazynu Kategoria rozliczeń
Ustawianie tagów obiektów blob Blokowy obiekt blob w warstwie Premium
Standardowa ogólnego przeznaczenia, wersja 2		 Inne operacje
Ustawianie tagów obiektów blob Standardowa ogólnego przeznaczenia, wersja 1 Operacje zapisu

Aby dowiedzieć się więcej o cenach dla określonej kategorii rozliczeniowej, zobacz Azure Blob Storage Cennik.

Zobacz też

Zarządzanie danymi usługi Blob Storage i znajdowanie ich za pomocą tagów indeksu obiektów blob
Autoryzowanie żądań do usługi Azure Storage
Kody stanu i błędów
Kody błędów usługi Blob Storage