Kontener leasingowy

Operacja ustanawia Lease Container i zarządza blokadą kontenera do operacji usuwania. Czas trwania blokady może wynosić od 15 do 60 sekund lub może być nieskończony.

Możesz wywołać operację Lease Container w jednym z następujących trybów:

  • Acquire, aby ubiegać się o nową umowę najmu.

  • Renew, aby odnowić istniejącą umowę najmu.

  • Change, aby zmienić identyfikację istniejącej umowy najmu.

  • Release, aby zwolnić dzierżawę, jeśli nie jest już potrzebna, tak aby inny klient mógł natychmiast uzyskać umowę najmu pod tym kontenerem.

  • Break, aby zakończyć umowę najmu, ale zapewnić, że inny klient nie może nabyć nowej umowy do czasu wygaśnięcia obecnego okresu najmu.

Note

Działanie jest Lease Container dostępne w wersji 2012-02-12 i nowszych.

Request

Żądanie Lease Container można skonstruować w następujący sposób. Zalecany jest protokół HTTPS. Zastąp wartość myaccount nazwą konta magazynu.

Metoda Żądanie URI Wersja protokołu HTTP
PUT https://myaccount.blob.core.windows.net/mycontainer?comp=lease&restype=container HTTP/1.1

Aby określić pojemnik główny, wpisz $root nazwę kontenera.

Identyfikator URI usługi magazynu emulowanego

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

Metoda Żądanie URI Wersja protokołu HTTP
PUT http://127.0.0.1:10000/mycontainer?comp=lease&restype=container HTTP/1.0

HTTP/1.1

Aby uzyskać więcej informacji, zobacz Use Azurite emulator for local Azure Storage development.

Parametry identyfikatora URI

Możesz określić następujący dodatkowy parametr w URI żądania.

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 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 Optional. 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 jest odnowienie, zmiana lub zwolnienie umowy najmu.

Możesz określić wartość w x-ms-lease-id dowolnym ważnym formacie ciągu GUID. Zobacz Guid Constructor (String), aby uzyskać listę poprawnych formatów.
x-ms-lease-action: <acquire ¦ renew ¦ change ¦ release ¦ break> acquire: Prosi o nową umowę najmu. Jeśli kontener nie ma aktywnej dzierżawy, Blob Storage tworzy umowę najmu na kontenerze i zwraca nowy identyfikator dzierżawy. Jeśli kontener ma aktywny najem, możesz złożyć wniosek o nowy tylko używając aktywnego identyfikatora najmu. Możesz jednak określić nową x-ms-lease duration, w tym minus (-1) dla umowy najmu, która nigdy nie wygasa.

renew: Odnawia umowę najmu. Możesz odnowić umowę najmu, jeśli identyfikator umowy podany w prośbie odpowiada temu powiązanemu z kontenerem. Należy zauważyć, że umowa najmu może zostać odnowiona nawet jeśli wygasła, pod warunkiem, że kontener nie został ponownie wynajęty od czasu wygaśnięcia tej umowy. Po odnowieniu dzierżawy czas trwania dzierżawy jest resetowany.

change: Zmień identyfikator umowy najmu aktywnej umowy najmu. A change musi zawierać aktualny identyfikator umowy najmu w , x-ms-lease-ida nowy ID umowy najmu w x-ms-proposed-lease-id.

release: Zwolnić umowę najmu. Możesz zwolnić umowę najmu, jeśli identyfikator umowy podany w żądaniu odpowiada temu powiązanemu z kontenerem. Zwolnienie dzierżawy pozwala innemu klientowi natychmiast uzyskać umowę najmu kontenera, zaraz po zakończeniu jej uwolnienia.

break: Zerwij dzierżawę, jeśli kontener ma aktywną umowę najmu. Po zerwaniu umowy najmu nie można jej przedłużyć. Każda upoważniona prośba może zerwać umowę najmu. Wniosek nie wymaga podawania pasującego identyfikatora umowy najmu. Gdy umowa najmu zostaje zerwana, okres zerwania umów może wygasnąć. W tym czasie możesz wykonywać break i wynajmować tylko operacje release kontenerowe. Gdy dzierżawa zostanie pomyślnie przerwana, odpowiedź wskazuje interwał w sekundach do momentu uzyskania nowej dzierżawy.

Można również zwolnić zerwaną umowę najmu. Klient może natychmiast nabyć leasing kontenera, który został zwolniony.
x-ms-lease-break-period: N Optional. Dla operacji break ten nagłówek to proponowany czas trwania umowy przed jej zerwaniem, czyli od 0 do 60 sekund. Ten okres przerwy jest stosowany tylko wtedy, gdy jest krótszy niż czas pozostały do końca umowy najmu. W przypadku dłuższego czasu pozostałego czasu dzierżawy jest używany. Nowa umowa najmu nie będzie dostępna przed upływem okresu przerwy, ale można ją zatrzymać dłużej niż ten okres. Jeśli ten nagłówek nie pojawi się przy operacji break , umowa najmu o stałym czasie przestaje być przestawiona po upływie pozostałego okresu najmu, a umowa nieskończona przestaje być natychmiast związana.
x-ms-lease-duration: -1 ¦ n seconds Wymagane dla acquire. Określa czas trwania dzierżawy (w sekundach) lub czas trwania (-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. Okresu najmu nie można zmienić przez użycie renew lub change.
x-ms-proposed-lease-id: <ID> Opcjonalne dla acquire, i wymagane dla change. Proponowany identyfikator dzierżawy w formacie ciągu identyfikatora GUID. Blob Storage zwraca informacje400 (Invalid request), jeśli proponowany identyfikator umowy najmu nie jest w odpowiednim formacie. Zobacz Guid Constructor (String), aby uzyskać listę poprawnych formatów.
Origin Optional. Określa źródło, z którego pochodzi żądanie. Obecność tego nagłówka powoduje powstanie nagłówków współdzielenia zasobów między źródłami (CORS) w odpowiedzi. Szczegóły można znaleźć w obsłudze CORS dla usług magazynowych .
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 warunkowych nagłówków do uruchomienia operacji tylko wtedy, gdy spełniony jest określony warunek. Aby uzyskać więcej informacji, zobacz Określanie nagłówków warunkowych dla operacji usługi Blob Storage.

Treść żądania

None.

Przykładowe żądanie

Poniższy przykładowy wniosek pokazuje, jak uzyskać umowę najmu:

  
Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=lease HTTP/1.1  
  
Request Headers:  
x-ms-version: 2012-02-12  
x-ms-lease-action: acquire  
x-ms-lease-duration: -1  
x-ms-proposed-lease-id: 1f812371-a41d-49e6-b123-f4b542e851c5  
x-ms-date: Thu, 26 Jan 2012 23:30:18 GMT  
Authorization: SharedKey testaccount1:esSKMOYdK4o+nGTuTyeOLBI+xqnqi6aBmiW4XI699+o=  
  

Response

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

Kod stanu

Kody statusu sukcesu zwracane dla operacji dzierżawy są następujące:

  • Acquire: Udana operacja zwraca kod statusu 201 (Utworzony).

  • Renew: Udana operacja zwraca kod statusu 200 (OK).

  • Change: Udana operacja zwraca kod statusu 200 (OK).

  • Release: Udana operacja zwraca kod statusu 200 (OK).

  • Break: Udana operacja zwraca kod statusu 202 (Zaakceptowane).

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

Syntax Description
ETag Dla ETag pojemnika. Ten nagłówek jest zwracany dla żądań złożonych względem wersji 2013-08-15 i późniejszych, a wartość ETag jest w cudzysłowie. Lease Container Operacje wykonywane na wersjach 2013-08-15 i późniejszych nie modyfikują tej właściwości, ale wcześniejsze wersje tak.
Last-Modified Zwrócono w przypadku wniosków złożonych przeciwko wersji 2013-08-15 i późniejszych. Zwraca datę i godzinę ostatniej modyfikacji kontenera. Aby uzyskać więcej informacji, zobacz Reprezentacja wartości daty i godziny w nagłówkach.

Każda operacja modyfikująca kontener, jego właściwości lub metadane aktualizuje ostatni czas modyfikacji. Obejmuje to także ustawienie uprawnień kontenera. Operacje na blobach nie wpływają na ostatnio zmodyfikowany czas kontenera. Lease Container Operacje wykonywane na wersjach 2013-08-15 i późniejszych nie modyfikują tej właściwości, ale wcześniejsze wersje tak.
x-ms-lease-id: <id> Gdy prosisz o najem, Blob Storage zwraca unikalny identyfikator umowy najmu. Podczas trwania umowy należy dołączyć identyfikator umowy do każdego wniosku o usunięcie kontenera lub o odnowienie, zmianę lub zwolnienie umowy najmu.

Udana operacja odnowienia zwraca również identyfikator umowy najmu 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 przy pomyślnym wniosku o zerwanie umowy najmu. Jeśli przerwanie jest natychmiastowe, zwraca się 0.
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 uruchamiania żądania. Ten nagłówek jest zwracany dla żądań wysyłanych dla wersji 2009-09-19 i nowszych.
Date Wartość daty/godziny UTC wskazująca godzinę, o której zainicjowano odpowiedź. Usługa generuje tę wartość.
Access-Control-Allow-Origin Zwraca, jeśli żądanie zawiera Origin nagłówek, a CORS jest włączony z regułą dopasowania. Ten nagłówek zwraca wartość nagłówka żądania początkowego w przypadku dopasowania.
Access-Control-Expose-Headers Zwraca, 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 nagłówek Origin , a CORS jest włączony z regułą dopasowania, która nie pozwala na wszystkie początki. Ten nagłówek będzie ustawiony na .true
x-ms-client-request-id Ten nagłówek 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 jest obecna w żądaniu. Wartość to co najwyżej 1 024 widoczne znaki 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.

Przykładowa odpowiedź

Poniżej znajduje się przykładowa odpowiedź na wniosek o uzyskanie umowy najmu:

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: 2012-02-12  
x-ms-lease-id: 1f812371-a41d-49e6-b123-f4b542e851c5  
Date: Thu, 26 Jan 2012 23:30:18 GMT  
  

Authorization

Autoryzacja jest wymagana, gdy wywołujesz dowolną operację dostępu do danych w Azure Storage. Możesz autoryzować operację Lease Container zgodnie z opisaniem w poniższych sekcjach.

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ń. Zasadą bezpieczeństwa może być użytkownik, grupa, główny element usługi aplikacji lub zarządzana tożsamość Azure. Podmiot zabezpieczeń jest uwierzytelniany przez Microsoft Entra ID, aby zwrócić token OAuth 2.0. Token może być następnie użyty do autoryzacji żądania przeciwko Blob Storage.

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

Następujące działania RBAC są konieczne, aby użytkownik, grupa, zarządzana tożsamość lub podmiot usługi Microsoft Entra wywołały operacjęLease Container, a także najmniej uprzywilejowana wbudowana rola Azure RBAC, która obejmuje tę akcję:

Aby dowiedzieć się więcej o przypisywaniu ról za pomocą Azure RBAC, zobacz Assign an Azure role, aby uzyskać dostęp do danych blob.

Remarks

Dzierżawa kontenera zapewnia wyłączny dostęp do kontenera. Dzierżawa kontenera kontroluje możliwość usunięcia kontenera wyłącznie poprzez operację Delete Container . Aby usunąć kontener z aktywną dzierżawą, klient musi uwzględnić aktywny identyfikator dzierżawy z żądaniem usunięcia. Jeśli ID umowy najmu nie jest uwzględnione, operacja kończy się niepowodzeniem z 412 (warunek wstępny nieudał). Wszystkie pozostałe operacje kontenerowe odnoszą sukces na dzierżawionym kontenerze, bez uwzględnienia identyfikatora dzierżawy. Umowa najmu jest udzielana na czas określony w momencie jej nabycia, który może trwać od 15 do 60 sekund lub na czas nieskończony.

Gdy klient nabywa umowę najmu, zwraca się identyfikator umowy najmu. Blob Storage generuje identyfikator dzierżawy, jeśli nie jest on określony w żądaniu przejęcia. Klient może użyć tego identyfikatora najmu do odnowienia umowy najmu, zmiany jej identyfikatora lub zwolnienia z niej najmu. Poniższy diagram przedstawia możliwe stany dzierżawy oraz polecenia lub zdarzenia powodujące zmiany stanu dzierżawy.

Schemat stanów dzierżawy kontenerów oraz wyzwalaczy zmian stanów.

Umowa najmu może być zawarta w jednym z pięciu stanów, w zależności od tego, czy umowa jest zablokowana czy odblokowana, oraz czy można ją odnowiać w danym stanie. Działania dzierżawy pokazane na poprzednim diagramie powodują przejścia stanów.

Status odnowienia Umowa najmu zamkniętego Nieodblokowana umowa najmu
Odnawialna dzierżawa Dzierżawionych Wygasła
Nieodnawialna umowa najmu Przełomowe Zepsute, dostępne
  • Available, dzierżawa jest odblokowana i można ją nabyć. Dozwolone działania: acquire.

  • Leased, umowa najmu jest zablokowana. Dozwolone akcje: acquire (tylko renewten sam identyfikator najmu), , change, , releaseoraz break.

  • Expired, okres najmu wygasł. Dozwolone działania: acquire, renew, release, oraz .break

  • Breaking, umowa najmu została zerwana, ale umowa będzie nadal blokowana aż do wygaśnięcia okresu przerwy. Dozwolone działania: release oraz break.

  • Broken, umowa najmu została zerwana, a okres przerwy wygasł. Dozwolone działania: acquire, release, oraz break.

Blob Storage zachowuje identyfikator umowy najmu po wygaśnięciu umowy najmu kontenera. Klient może odnowić lub zwolnić umowę najmu, używając swojego wygasłego identyfikatora najmu. Jeśli klient spróbuje odnowić lub zwolnić wygasłą umowę najmu z poprzednim ID najmu i żądanie się nie powiedzie, kontener został ponownie dzierżawiony lub usunięty, ponieważ najem klienta był ostatnio aktywny.

Jeśli umowa najmu wygasa zamiast zostać wyraźnie zwolniona, klient może być zobowiązany do minuty, zanim zostanie uzyskiwana nowa umowa najmu kontenera. Klient może jednak natychmiast odnowić dzierżawę z wygasłym identyfikatorem dzierżawy.

Właściwość Last-Modified-Time kontenera nie jest aktualizowana przez wywołania do Lease Container.

Poniższe tabele przedstawiają wyniki działań dotyczących kontenerów z dzierżawą w różnych stanach dzierżawy. Litery (A), (B) i (C) oznaczają identyfikatory umowy najmu, a (X) identyfikator umowy wygenerowany przez Blob Storage.

Skutki prób użytkowania kontenerów w stanie dzierżawy

Action Available Wynajęty (A) Przełamanie (A) Złamane (A) Termin wygasły (A)
Usuń z pomocą (A) Niepowodzenia (412) Dzierżawione (A), usuwanie się udaje. Złamanie (A), usunięcie się udaje. Niepowodzenia (412) Niepowodzenia (412)
Usuń z pomocą (B) Niepowodzenia (412) Niepowodzenia (409) Niepowodzenia (412) Niepowodzenia (412) Niepowodzenia (412)
Usuń, bez określonej umowy najmu Dostępne, usunięcie się udaje. Niepowodzenia (412) Niepowodzenia (412) Dostępne, usunięcie się udaje. Dostępne, usunięcie się udaje.
Inne operacje z (A) Niepowodzenia (412) Dzierżawione (A), operacja zakończyła się sukcesem Złamanie (A), operacja się powiodła Niepowodzenia (412) Niepowodzenia (412)
Inne operacje z (B) Niepowodzenia (412) Niepowodzenia (409) Niepowodzenia (409) Niepowodzenia (412) Niepowodzenia (412)
Operacje, bez określonej umowy dzierżawy Dostępny, operacja się powiodła Dzierżawione (A), operacja zakończyła się sukcesem Złamanie (A), operacja się powiodła Złamane (A), operacja się powiodła Zakończony (A), operacja zakończona sukcesem

Wyniki operacji leasingowych na kontenerach według stanu dzierżawy

Action Available Wynajęty (A) Przełamanie (A) Złamane (A) Termin wygasły (A)
Acquire, brak proponowanego identyfikatora dzierżawy Wynajęty (X) Niepowodzenia (409) Niepowodzenia (409) Wynajęty (X) Wynajęty (X)
Acquire (A) Wynajęty (A) Dzierżawa (A), nowy okres trwania Niepowodzenia (409) Wynajęty (A) Wynajęty (A)
Acquire (B) Wynajęty (B) Niepowodzenia (409) Niepowodzenia (409) Wynajęty (B) Wynajęty (B)
Break, kropka=0 Niepowodzenia (409) Złamane (A) Złamane (A) Złamane (A) Złamane (A)
Break, okres>0 Niepowodzenia (409) Przełamanie (A) Przełamanie (A) Złamane (A) Złamane (A)
Change, (A) do (B) Niepowodzenia (409) Wynajęty (B) Niepowodzenia (409) Niepowodzenia (409) Niepowodzenia (409)
Change, (B) do (A) Niepowodzenia (409) Wynajęty (A) Niepowodzenia (409) Niepowodzenia (409) Niepowodzenia (409)
Change, (B) do (C) Niepowodzenia (409) Niepowodzenia (409) Niepowodzenia (409) Niepowodzenia (409) Niepowodzenia (409)
Renew (A) Niepowodzenia (409) Wynajęty (A), reset zegara ważności Niepowodzenia (409) Niepowodzenia (409) Wynajęty (A)
Renew (B) Niepowodzenia (409) Niepowodzenia (409) Niepowodzenia (409) Niepowodzenia (409) Niepowodzenia (409)
Release (A) Niepowodzenia (409) Available Available Available Available
Release (B) Niepowodzenia (409) Niepowodzenia (409) Niepowodzenia (409) Niepowodzenia (409) Niepowodzenia (409)
Okres trwania wygasa Available Termin wygasły (A) Złamane (A) Złamane (A) Termin wygasły (A)

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

Operation Typ konta magazynowania Kategoria rozliczeń
Kontener dzierżawy (nabycie, zwolnienie, odnowienie) Obiekt typu blob Premium
Standard ogólnego przeznaczenia wersja 2
Inne operacje
Kontener dzierżawy (nabycie, zwolnienie, odnowienie) Standard o ogólnym przeznaczeniu V1 Operacje odczytu
Kontener dzierżawy (przerwa, zmiana) Obiekt typu blob Premium
Standard ogólnego przeznaczenia wersja 2
Inne operacje
Kontener dzierżawy (przerwa, zmiana) 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

Autoryzowanie żądań do usługi Azure Storage
kody stanu i błędów
Kody błędów usługi Blob Storage
Dzierżawienie obiektu BLOB