Dzierżawienie obiektu blob

  • Artykuł

Operacja Lease Blob tworzy blokadę obiektu blob i zarządza nią na potrzeby operacji zapisu i usuwania. Czas trwania blokady może wynosić od 15 do 60 sekund lub może być nieskończony. W wersjach wcześniejszych niż 2012-02-12 czas trwania blokady wynosi 60 sekund.

Ważne

Począwszy od wersji 2012-02-12, niektóre zachowania Lease Blob operacji różnią się od poprzednich wersji. Na przykład w poprzednich wersjach można odnowić dzierżawę po jej wydaniu. Począwszy od wersji 2012-02-12, to żądanie dzierżawy kończy się niepowodzeniem, ale wywołania używające starszych wersji Lease Blob nadal kończą się powodzeniem. Aby uzyskać listę zmian w zachowaniu tej operacji, zobacz sekcję "Uwagi" w dalszej części tego artykułu.

Operację Lease Blob można wywołać w jednym z następujących trybów:

  • Acquire, aby zażądać nowej dzierżawy.

  • Renew, aby odnowić istniejącą dzierżawę.

  • Change, aby zmienić identyfikator istniejącej dzierżawy.

  • Release, aby zwolnić dzierżawę, jeśli nie jest już potrzebna, aby inny klient mógł natychmiast uzyskać dzierżawę względem obiektu blob.

  • Break, aby zakończyć dzierżawę, ale upewnij się, że inny klient nie może uzyskać nowej dzierżawy do czasu wygaśnięcia bieżącego okresu dzierżawy.

Żądanie

Żądanie można skonstruować Lease Blob w następujący sposób. Zalecane jest użycie 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=lease HTTP/1.1

Identyfikator URI usługi magazynu emulowanego

Po wysłaniu żądania względem emulowanej usługi magazynu określ nazwę hosta emulatora i Azure Blob Storage port jako 127.0.0.1:10000, a następnie nazwę emulowanego konta magazynu.

IDENTYFIKATOR URI żądania PUT Wersja PROTOKOŁU HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=lease HTTP/1.0

HTTP/1.1

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

Parametry identyfikatora URI

W identyfikatorze URI żądania można określić następujący dodatkowy parametr.

Parametr Opis
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ń

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.

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 Opcjonalny. 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> Wymagane do odnowienia, zmiany lub zwolnienia dzierżawy.

Wartość można określić w dowolnym prawidłowym formacie ciągu identyfikatora x-ms-lease-id GUID. Aby uzyskać listę prawidłowych formatów, zobacz Konstruktor guid (ciąg).
x-ms-lease-action: <acquire ¦ renew ¦ change ¦ release ¦ break> acquire: żąda nowej dzierżawy. Jeśli obiekt blob nie ma aktywnej dzierżawy, usługa Blob Storage tworzy dzierżawę obiektu blob i zwraca nowy identyfikator dzierżawy. Jeśli obiekt blob ma aktywną dzierżawę, możesz zażądać tylko nowej dzierżawy przy użyciu aktywnego identyfikatora dzierżawy. Można jednak określić nowy x-ms-lease-durationelement , w tym ujemny (-1) dla dzierżawy, która nigdy nie wygasa.

renew: odnawia dzierżawę. Dzierżawę można odnowić, jeśli identyfikator dzierżawy określony w żądaniu jest zgodny z obiektem blob skojarzonym z obiektem blob. Należy pamiętać, że dzierżawa może zostać odnowiona, nawet jeśli wygasła, o ile obiekt blob nie został zmodyfikowany ani ponownie dzierżawiony od czasu wygaśnięcia tej dzierżawy. Po odnowieniu dzierżawy czas trwania dzierżawy zostanie zresetowany.

change: wersja 2012-02-12 lub nowsza. Zmienia identyfikator dzierżawy aktywnej dzierżawy. Element change musi zawierać bieżący identyfikator dzierżawy w x-ms-lease-idelemencie i nowy identyfikator dzierżawy w pliku x-ms-proposed-lease-id.

release: zwalnia dzierżawę. Dzierżawę można zwolnić, jeśli identyfikator dzierżawy określony na żądaniu jest zgodny z obiektem blob skojarzonym z obiektem blob. Zwolnienie dzierżawy umożliwia innemu klientowi natychmiastowe uzyskanie dzierżawy dla obiektu blob, gdy tylko wydanie zostanie ukończone.

break: przerywa dzierżawę, jeśli obiekt blob ma aktywną dzierżawę. Po przerwaniu dzierżawy nie można jej odnowić. Każde autoryzowane żądanie może przerwać dzierżawę; żądanie nie jest wymagane do określenia zgodnego identyfikatora dzierżawy. Po przerwaniu dzierżawy okres przerwania dzierżawy może upłynąć, w tym czasie break i release są jedynymi operacjami dzierżawy, które można wykonać w obiekcie blob. Gdy dzierżawa zostanie pomyślnie przerwana, odpowiedź wskazuje interwał w sekundach do momentu uzyskania nowej dzierżawy.

Dzierżawa, która została przerwana, można również zwolnić, w takim przypadku inny klient może natychmiast uzyskać dzierżawę obiektu blob.
x-ms-lease-break-period: N Opcjonalny. Wersja 2012-02-12 lub nowsza. break W przypadku operacji jest to proponowany czas trwania sekund, który dzierżawa powinna być kontynuowana, zanim zostanie przerwana, od 0 do 60 sekund. Ten okres przerwania jest używany tylko wtedy, gdy jest krótszy niż czas pozostały w dzierżawie. Jeśli czas pozostały w dzierżawie jest dłuższy. Nowa dzierżawa nie będzie dostępna przed wygaśnięciem okresu przerwania, ale dzierżawa może być przechowywana przez dłuższy niż okres przerwania. Jeśli ten nagłówek nie jest wyświetlany z operacją break , przerwy dzierżawy o stałym czasie trwania po upływie pozostałego okresu dzierżawy i nieskończone przerwy dzierżawy natychmiast.
x-ms-lease-duration: -1 ¦ n seconds Wersja 2012-02-12 lub nowsza. Dozwolone i wymagane tylko w acquire operacji. Określa czas trwania dzierżawy, w sekundach lub ujemny (-1) dla dzierżawy, która nigdy nie wygasa. Dzierżawa nieskończenie nieskończona może należeć do zakresu od 15 do 60 sekund. Nie można zmienić czasu trwania dzierżawy przy użyciu polecenia renew lub change.
x-ms-proposed-lease-id: <ID> Wersja 2012-02-12 lub nowsza. Opcjonalne dla acquireelementu , i wymagane dla changeelementu . Proponowany identyfikator dzierżawy w formacie ciągu GUID. Usługa Blob Storage zwraca wartość 400 (Invalid request) , jeśli proponowany identyfikator dzierżawy nie jest w poprawnym formacie. Aby uzyskać listę prawidłowych formatów, zobacz Konstruktor guid (ciąg).
Origin Opcjonalny. Określa pochodzenie, z którego jest wystawiane żądanie. Obecność tego nagłówka powoduje, że nagłówki współużytkowania zasobów między źródłami (CORS) w odpowiedzi. Aby uzyskać szczegółowe informacje , zobacz obsługa mechanizmu CORS dla usług Storage .
x-ms-client-request-id Opcjonalny. Udostępnia 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 Monitorowanie Azure Blob Storage.

Ta operacja obsługuje również użycie nagłówków warunkowych do uruchomienia operacji 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

Brak.

Przykładowe żądanie

Następujące przykładowe żądanie pokazuje, jak uzyskać dzierżawę:

  
Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=lease HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-lease-action: acquire  
x-ms-lease-duration: -1  
x-ms-proposed-lease-id: 1f812371-a41d-49e6-b123-f4b542e851c5  
x-ms-date: <date>  
Authorization: SharedKey testaccount1:esSKMOYdK4o+nGTuTyeOLBI+xqnqi6aBmiW4XI699+o=

Reakcja

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

Kod stanu

Kody stanu powodzenia zwracane dla operacji dzierżawy są następujące:

  • Acquire: Operacja zakończona pomyślnie zwraca kod stanu 201 (Utworzony).

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

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

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

  • Break: Pomyślna operacja zwraca kod stanu 202 (Zaakceptowano).

Aby uzyskać informacje o kodach 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.

Składnia Opis
ETag Zawiera wartość, której można użyć do warunkowego wykonywania operacji. Aby uzyskać więcej informacji, zobacz Określanie nagłówków warunkowych dla operacji usługi Blob Storage .

Ten nagłówek jest zwracany dla żądań wysyłanych w wersji 2013-08-15 lub nowszej, a ETag wartość jest w cudzysłowie.

Operacja Lease Blob nie modyfikuje tej właściwości.
Last-Modified Data/godzina ostatniej modyfikacji obiektu blob. Aby uzyskać więcej informacji, zobacz Reprezentacja wartości daty i godziny w nagłówkach.

Każda operacja zapisu obiektu blob, w tym aktualizacje metadanych lub właściwości obiektu blob, zmienia czas ostatniej modyfikacji obiektu blob. Operacja Lease Blob nie modyfikuje tej właściwości.
x-ms-lease-id: <id> W przypadku żądania dzierżawy usługa Blob Storage zwraca unikatowy identyfikator dzierżawy. Gdy dzierżawa jest aktywna, musisz uwzględnić identyfikator dzierżawy z dowolnym żądaniem zapisu w obiekcie blob lub odnowić, zmienić lub zwolnić dzierżawę.

Pomyślna operacja odnawiania zwraca również identyfikator dzierżawy dla aktywnej dzierżawy.
x-ms-lease-time: seconds Przybliżony czas pozostały w okresie dzierżawy w sekundach. Ten nagłówek jest zwracany tylko w przypadku pomyślnego żądania przerwania dzierżawy. Jeśli przerwa jest natychmiastowa, 0 jest zwracana.
x-ms-request-id Ten nagłówek jednoznacznie 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 Wskazuje wersję usługi Blob Storage używaną do uruchomienia żądania. Ten nagłówek jest zwracany w przypadku żądań wysyłanych w wersji 2009-09-19 lub nowszej.
Date Wartość daty/godziny UTC wskazująca godzinę, o której zainicjowano odpowiedź. Usługa generuje tę wartość.
Access-Control-Allow-Origin Zwracany, jeśli żądanie zawiera Origin nagłówek, a mechanizm CORS jest włączony z regułą dopasowania. Ten nagłówek zwraca wartość nagłówka żądania źródła w przypadku dopasowania.
Access-Control-Expose-Headers Zwracany, jeśli żądanie zawiera Origin nagłówek, a mechanizm CORS jest włączony z regułą dopasowania. Zwraca listę nagłówków odpowiedzi, które mają być widoczne dla klienta lub wystawcy żądania.
Access-Control-Allow-Credentials Zwracany, jeśli żądanie zawiera Origin nagłówek, a mechanizm CORS jest włączony z regułą dopasowania, która nie zezwala na wszystkie źródła. Ten nagłówek jest ustawiony na truewartość .
x-ms-client-request-id Ten nagłówek 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 jest obecna w żądaniu. Wartość jest najwyżej 1024 widocznymi znakami 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.

Przykładowa odpowiedź

Poniżej przedstawiono przykładową odpowiedź na żądanie uzyskania dzierżawy:

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: cc6b209a-b593-4be1-a38a-dde7c106f402  
x-ms-version: 2015-02-21  
x-ms-lease-id: 1f812371-a41d-49e6-b123-f4b542e851c5  
Date: <date>

Autoryzacja

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

Dzierżawa obiektu blob zapewnia wyłączny dostęp do zapisu i usuwania obiektu blob. Aby zapisać w obiekcie blob z aktywną dzierżawą, klient musi uwzględnić aktywny identyfikator dzierżawy z żądaniem zapisu. Dzierżawa jest udzielana przez czas określony podczas pozyskiwania dzierżawy. Ten czas trwania może wynosić od 15 do 60 sekund lub nieskończony czas trwania.

Gdy klient uzyskuje dzierżawę, zwracany jest identyfikator dzierżawy. Usługa Blob Storage generuje identyfikator dzierżawy, jeśli nie został określony w żądaniu uzyskania. Klient może użyć tego identyfikatora dzierżawy do odnowienia dzierżawy, zmiany identyfikatora dzierżawy lub zwolnienia dzierżawy.

Gdy dzierżawa jest aktywna, identyfikator dzierżawy musi być uwzględniony w żądaniu dla dowolnej z następujących operacji:

Jeśli identyfikator dzierżawy nie jest uwzględniony, te operacje kończą się niepowodzeniem dla dzierżawionego obiektu blob z wartością 412 – Precondition failed.

Następujące operacje kończą się powodzeniem w dzierżawionych obiektach blob bez uwzględniania identyfikatora dzierżawy:

Nie jest konieczne uwzględnienie identyfikatora dzierżawy dla GET operacji na obiekcie blob, który ma aktywną dzierżawę. Jednak wszystkie GET operacje obsługują parametr warunkowej dzierżawy, gdzie operacja jest kontynuowana tylko wtedy, gdy identyfikator dzierżawy dołączony do żądania jest prawidłowy.

Wszystkie operacje kontenera są dozwolone w kontenerze zawierającym obiekty blob z aktywną dzierżawą, w tym usuwanie kontenera. W związku z tym kontener można usunąć, nawet jeśli obiekty blob w nim mają aktywne dzierżawy. Użyj operacji dzierżawy kontenera , aby kontrolować prawa do usuwania kontenera.

Stany dzierżawy

Na poniższym diagramie przedstawiono pięć stanów dzierżawy oraz polecenia lub zdarzenia, które powodują zmiany stanu dzierżawy.

Diagram przedstawiający stany dzierżawy obiektów blob i wyzwalacze zmiany stanu.

Dzierżawa może znajdować się w jednym z tych stanów na podstawie tego, czy dzierżawa jest zablokowana, czy odblokowana, i czy dzierżawa jest odnawialna w tym stanie. Akcje dzierżawy pokazane na powyższym diagramie powodują przejścia stanu.

Stan odnowienia Zablokowana dzierżawa Odblokowana dzierżawa
Odnawialna dzierżawa Dzierżawionych Wygasłe
Dzierżawa nieodnawiona Kluczowa Uszkodzone, dostępne

  • Available: dzierżawa jest odblokowana i można jej uzyskać. Dozwolona akcja: acquire.

  • Leased: dzierżawa jest zablokowana. Dozwolone akcje: acquire (ten sam identyfikator dzierżawy), renew, change, releasei break.

  • Expired: czas trwania dzierżawy wygasł. Dozwolone akcje: acquire, renew, releasei break.

  • Breaking: Dzierżawa została przerwana, ale dzierżawa będzie nadal blokowana do momentu wygaśnięcia okresu przerwania. Dozwolone akcje: release i break.

  • Broken: Dzierżawa została przerwana, a okres przerwania wygasł. Dozwolone akcje: acquire, releasei break.

Po wygaśnięciu dzierżawy identyfikator dzierżawy jest utrzymywany przez usługę Blob Storage do momentu ponownego zmodyfikowania lub dzierżawy obiektu blob. Klient może podjąć próbę odnowienia lub zwolnienia dzierżawy przy użyciu wygasłego identyfikatora dzierżawy. Jeśli operacja zakończy się pomyślnie, oznacza to, że obiekt blob nie został zmieniony od czasu ostatniego prawidłowego identyfikatora dzierżawy.

Jeśli klient spróbuje odnowić lub zwolnić dzierżawę przy użyciu poprzedniego identyfikatora dzierżawy, a żądanie zakończy się niepowodzeniem, obiekt blob został zmodyfikowany lub dzierżawiony ponownie od czasu ostatniego uaktywnienia dzierżawy klienta. Klient musi następnie uzyskać nową dzierżawę obiektu blob.

Jeśli dzierżawa wygaśnie, a nie zostanie jawnie zwolniona, klient może poczekać do minuty, zanim zostanie uzyskana nowa dzierżawa dla obiektu blob. Jednak klient może natychmiast odnowić dzierżawę przy użyciu identyfikatora dzierżawy, jeśli obiekt blob nie został zmodyfikowany.

Należy pamiętać, że nie można udzielić dzierżawy dla migawki obiektu blob, ponieważ migawki są tylko do odczytu. Żądanie dzierżawy względem migawki powoduje wyświetlenie kodu stanu 400 (nieprawidłowe żądanie).

Właściwość obiektu blob Last-Modified-Time nie jest aktualizowana przez wywołania elementu Lease Blob.

W poniższych tabelach przedstawiono wyniki akcji dotyczących obiektów blob z dzierżawami w różnych stanach dzierżawy. Litery (A), (B) i (C) reprezentują identyfikatory dzierżaw, a (X) reprezentuje identyfikator dzierżawy generowany przez usługę Blob Storage.

Wyniki prób użycia obiektów blob według stanu dzierżawy

Akcja Dostępne Dzierżawione (A) Niezgodność (A) Przerwane (A) Wygasłe (A)
Pisanie przy użyciu (A) Niepowodzenie (412) Dzierżawione (A), zapis kończy się powodzeniem Przerwanie (A), powodzenie zapisu Niepowodzenie (412) Niepowodzenie (412)
Zapis za pomocą (B) Niepowodzenie (412) Niepowodzenie (409) Niepowodzenie (412) Niepowodzenie (412) Niepowodzenie (412)
Zapis, brak określonej dzierżawy Dostępne, zapis kończy się powodzeniem Niepowodzenie (412) Niepowodzenie (412) Dostępne, zapis kończy się powodzeniem Dostępne, zapis kończy się powodzeniem
Odczyt z (A) Niepowodzenie (412) Dzierżawione (A), odczyt kończy się powodzeniem Niezgodność (A), odczyt kończy się powodzeniem Niepowodzenie (412) Niepowodzenie (412)
Odczyt z (B) Niepowodzenie (412) Niepowodzenie (409) Niepowodzenie (409) Niepowodzenie (412) Niepowodzenie (412)
Odczyt, brak określonej dzierżawy Dostępne, odczyt kończy się powodzeniem Dzierżawione (A), odczyt kończy się powodzeniem Niezgodność (A), odczyt kończy się powodzeniem Przerwane (A), odczyt kończy się powodzeniem Wygasłe (A), odczyt kończy się powodzeniem

Wyniki operacji dzierżawy obiektów blob według stanu dzierżawy

Akcja Dostępne Dzierżawione (A) Niezgodność (A) Przerwane (A) Wygasłe (A)
Acquire, brak proponowanego identyfikatora dzierżawy Dzierżawione (X) Niepowodzenie (409) Niepowodzenie (409) Dzierżawione (X) Dzierżawione (X)
Acquire (A) Dzierżawione (A) Dzierżawiony (A), nowy czas trwania Niepowodzenie (409) Dzierżawione (A) Dzierżawione (A)
Acquire (B) Dzierżawione (B) Niepowodzenie (409) Niepowodzenie (409) Dzierżawione (B) Dzierżawione (B)
Break, period=0 Niepowodzenie (409) Przerwane (A) Przerwane (A) Przerwane (A) Przerwane (A)
Break, okres>0 Niepowodzenie (409) Niezgodność (A) Niezgodność (A) Przerwane (A) Przerwane (A)
Change, (A) do (B) Niepowodzenie (409) Dzierżawione (B) Niepowodzenie (409) Niepowodzenie (409) Niepowodzenie (409)
Change, (B) do (A) Niepowodzenie (409) Dzierżawione (A) Niepowodzenie (409) Niepowodzenie (409) Niepowodzenie (409)
Change, (B) do (C) Niepowodzenie (409) Niepowodzenie (409) Niepowodzenie (409) Niepowodzenie (409) Niepowodzenie (409)
Renew (A) Niepowodzenie (409) Dzierżawione (A), resetowanie zegara wygaśnięcia Niepowodzenie (409) Niepowodzenie (409) Dzierżawione(A), jeśli obiekt blob nie został zmodyfikowany.

Kończy się niepowodzeniem (409), jeśli obiekt blob został zmodyfikowany.
Renew (B) Niepowodzenie (409) Niepowodzenie (409) Niepowodzenie (409) Niepowodzenie (409) Niepowodzenie (409)
Release (A) Niepowodzenie (409) Dostępne Dostępne Dostępne Dostępne
Release (B) Niepowodzenie (409) Niepowodzenie (409) Niepowodzenie (409) Niepowodzenie (409) Niepowodzenie (409)
Czas trwania wygasa Dostępne Wygasłe (A) Przerwane (A) Przerwane (A) Wygasłe (A)

Zmiany w dzierżawie obiektu blob wprowadzone w wersji 2012-02-12

Poniższa lista określa zmiany Lease Blob zachowania wprowadzone w wersji 2012-02-12.

  • Wywołanie do Lease Blob uzyskania dzierżawy musi teraz zawierać nagłówek czasu trwania dzierżawy. Jeśli spróbujesz uzyskać dzierżawę bez określenia czasu trwania dzierżawy, usługa zwróci wartość 400 Bad Request – Missing required header.

  • Nie można już odnowić dzierżawy po jej wydaniu. Jeśli spróbujesz to zrobić, usługa zwróci wartość 409 Conflict – The lease ID specified did not match the lease ID for the blob. Aplikacje, które nazwały wydanie, a następnie nazywane odnawianiem, muszą teraz zapisać ETag wywołanie wydania. Następnie aplikacje muszą wywoływać pozyskiwanie z nagłówkiem warunkowym If-Match , aby uzyskać dzierżawę tylko wtedy, gdy obiekt blob nie zmieni się.

  • Nie można już przerwać dzierżawy po jej wydaniu. Jeśli spróbujesz to zrobić, usługa zwróci wartość 409 Conflict – There is currently no lease on the blob.

  • Teraz możesz przerwać niezgodną lub przerwaną dzierżawę, co sprawia, że operacje przerwania są idempotentne. W poprzednich wersjach nie powiodło się to z programem 409 Conflict – The lease has already been broken and cannot be broken again. Ta zmiana pozwala skrócić czas trwania przerwy. Jeśli przerwiesz dzierżawę, która jest w stanie przerwania i uwzględnisz krótszy czas trwania niż pozostały okres przerwania, używany jest krótszy czas trwania.

Rozliczenia

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

Operacja Typ konta magazynu Kategoria rozliczeń
Dzierżawa obiektu blob (pozyskiwanie, wydawanie, odnawianie) Blokowy obiekt blob w warstwie Premium
Standardowa ogólnego przeznaczenia, wersja 2		 Inne operacje
Dzierżawa obiektu blob (pozyskiwanie, wydawanie, odnawianie) Standardowa ogólnego przeznaczenia, wersja 1 Operacje odczytu
Dzierżawa obiektu blob (przerwa, zmiana) Blokowy obiekt blob w warstwie Premium
Standardowa ogólnego przeznaczenia, wersja 2		 Inne operacje
Dzierżawa obiektu blob (przerwa, zmiana) Standardowa ogólnego przeznaczenia, wersja 1 Operacje zapisu

Zobacz też

new-blob-lease-features-infinite-leases-smaller-lease-times-and-more.aspx)
Autoryzowanie żądań do usługi Azure Storage
Kody stanu i błędów
Kody błędów usługi Blob Storage
Kontener dzierżawy