Określanie warunkowych nagłówków dla operacji usług Blob

Kilka operacji usług Blob obsługuje użycie warunkowych nagłówków. Możesz określić nagłówki warunkowe, aby wykonały operację tylko wtedy, gdy spełniony jest określony warunek.

Usługa Blob spełnia specyfikację protokołu HTTP/1.1 dla warunkowych nagłówków.

Obsługiwane nagłówki warunkowe

Obsługiwane nagłówki warunkowe opisano w poniższej tabeli.

Określanie warunkowych nagłówków dla operacji odczytu usług blob w wersji 2013-08-15 lub nowszej

Począwszy od wersji 2013-08-15, operacje Get Blob i Get Blob Properties obsługują wiele warunkowych nagłówków. Możesz określić dowolną kombinację obsługiwanych nagłówków warunkowych. Usługa Blob ocenia te warunki według następującego wyrażenia:

If-Match && If-Unmodified-Since && (If-None-Match || If-Modified-Since)

Możesz także podać wiele wartości oddzielonych przecinkami dla If-Match i If-None-Match. Jeśli określisz wiele wartości dla If-Match, usługa Blob wykonuje operację logiczną OR na wszystkich podanych wartościach przed wyliczeniem całego wyrażenia. Jeśli określisz wiele wartości dla if-None-Match, usługa wykonuje operację logiczną AND przed wyliczeniem całego wyrażenia. Określenie wielu wartości dla If-Modified-Since i If-Unmodified-Since nie jest obsługiwane i skutkuje kodem błędu 400 (Bad Request).

Ta funkcja jest włączona, aby spełnić wymagania HTTP/1.1. Obsługuje także sytuacje, gdy Content Delivery Network (CDN) lub serwer proxy dodaje dodatkowe nagłówki warunkowe do zapytania w trakcie lotu. Poniższe przykłady ilustrują kilka różnych kombinacji nagłówków warunkowych.

Przykład 1:

Rozważmy żądanie Get Blob zawierające If-Match nagłówki i If-Modified-Since . Poniższa tabela pokazuje wynik, jeśli nagłówki są oceniane indywidualnie, oraz wynik, jeśli są one oceniane łącznie.

Przykład 2:

Rozważmy żądanie zawierające If-None-Match i If-Modified-Since nagłówki.

Przykład 3:

Rozważmy żądanie zawierające If-Modified-Since, If-Match, oraz If-Unmodified-Since nagłówki.

Przykład 4:

Rozważmy żądanie zawierające If-Modified-Since, If-None-Match, If-Unmodified-Since, oraz If-Match nagłówki.

Określ nagłówki warunkowe dla operacji odczytu w wersjach sprzed 2013-08-15 oraz dla operacji zapisu (we wszystkich wersjach)

Wywołując operacje odczytu usługi Blob (Get Blob i Get Blob Properties) z wersjami starszymi niż 2013-08-15 oraz wywołując dowolną operację zapisu, niezależnie od wersji, należy pamiętać o następujących kwestiach:

• Jeśli żądanie określa zarówno nagłówki , If-None-Match jak i If-Modified-Since , jest oceniane na podstawie kryteriów określonych w .If-None-Match

• Jeśli żądanie określa zarówno nagłówki , If-Match jak i If-Unmodified-Since , jest oceniane na podstawie kryteriów określonych w .If-Match

• Z wyjątkiem dwóch wcześniej wymienionych kombinacji nagłówków warunkowych, żądanie może określić tylko jeden nagłówek warunkowy. Wskazanie więcej niż jednego nagłówka warunkowego skutkuje kodem statusowym 400 (Bad Request).

• Jeśli odpowiedź zawiera ETag, zweryfikowaj wersję żądania i odpowiedzi przed przetworzeniem ETag. Na przykład wersje 2011-08-18 i późniejsze zwracają cytowany ETag, ale starsze wersje tego nie robią. Upewnij się, że Twoja aplikacja może przetworzyć oba formaty ETag przed ich oceną.

• RFC 2616 pozwala na wiele wartości ETag w jednym nagłówku, ale żądania do usługi Blob mogą zawierać tylko jedną wartość ETag. Wskazanie więcej niż jednej wartości ETag daje kod statusu 400 (Bad Request).

Operacje wspierające nagłówki warunkowe

Operacje obsługujące nagłówki warunkowe opisano w poniższej tabeli.

Poniższe operacje danych usług Blob obecnie nie obsługują warunkowych nagłówków:

• Przerwij kopiowanie

• Tworzenie kontenera

• Znajdowanie obiektów blob według tagów

• uzyskiwanie listy ACL kontenerów

• Pobierz metadane kontenera

• Pobierz właściwości kontenera

• Lista blobów

• Kontenery Listy

• Umieść blok

• Przywróć usunięty obiekt blob

Kody odpowiedzi HTTP dla operacji obsługujących nagłówki warunkowe

Jeśli żądanie zawiera nagłówek warunkowy, a żądany zasób nie spełnia określonego warunku, usługa Blob zwraca kod odpowiedzi HTTP. Zwracane kody odpowiedzi są zgodne ze specyfikacją protokołu HTTP/1.1 (RFC 2616).

Metody w bibliotece klienta Azure .NET przekształcają te kody odpowiedzi na błędy na obiekt StorageException.

Operacje odczytu

Poniższa tabela przedstawia kody odpowiedzi zwracane dla niespełnionego warunku dla każdego nagłówka warunkowego, gdy operacja jest operacją odczytu. Operacje czytania używają czasowników GET lub HEAD.

Dla wyników przy użyciu wielu nagłówków z wersjami 2013-08-15 lub nowszymi odwołaj się na poprzednie przykłady.

Operacje zapisu

Poniższa tabela przedstawia kody odpowiedzi zwracane dla niespełnionego warunku dla każdego nagłówka warunkowego, gdy operacja jest operacją zapisu. Operacje zapisu używają czasowników PUT lub DELETE.

Operacje kopiowania

Poniższa tabela przedstawia kody odpowiedzi zwracane dla niespełnionego warunku dla każdego nagłówka warunkowego, gdy operacja jest operacją kopiowania. Operacja Copy Blob wykorzystuje czasowniki PUT.

Operacje warunkowe tagów

Oprócz standardowych nagłówków warunkowych HTTP obsługiwanych przez usługę Blob, kilka operacji obsługuje także warunki dotyczące tagów na zasobu blob.

Jeśli x-ms-if-tags nagłówek warunkowy lub x-ms-source-if-tags jest obecny w żądaniu i wychodzi TagsPredicate do false, usługa Blob zwraca kod błędu 412 (Wstępny Failed) dla operacji.

Dzwoniący musi mieć pozwolenie na odczytywanie tagów na blobie, aby użyć x-ms-if-tags nagłówków warunkowych lub x-ms-source-if-tags (al).

Tagi Składnia predykatów

Usługa Blob obsługuje podzbiór gramatyki klauzuli ANSI SQL WHERE dla wartości nagłówka TagsPredicate . Obsługiwane są następujące operatory:

Wszystkie wartości tagów są ciągami znaków, a obsługiwane binarne operatory relacyjne wykorzystują leksykograficzne sortowanie wartości tagów. Aby wspierać typy danych niebędące ciągami tekstowymi, w tym liczby i daty, konieczne jest zastosowanie odpowiedniego dosypywania i sortowalnego formatowania. Wartości tagów muszą być zapakowane w pojedyncze cudzysłowy.

Jeśli nazwy tagów są zwykłymi identyfikatorami SQL, mogą być obecne bez ucieczki. Jeśli zawierają znaki specjalne, muszą być wyznaczane podwójnymi cudzysłowami, takimi jak "TagName" = 'TagValue'.

Wyrażenia mogą zawierać porównania dla wielu nazw i wartości tagów. Nawiasy (( i )) mogą być używane do grupowania wyrażeń logicznych i kontrolowania kanonicznego porządku działania. A TagsPredicate może zawierać maksymalnie 10 operacji logicznych.

Usługa przechowywania odrzuca każde żądanie zawierające nieprawidłowe wyrażenie o kodie błędu 400 (Złe żądanie).

Zobacz też

Koncepcje usług blob