Sdílená složka zapůjčení

Operace Lease Share vytvoří a spravuje zámek sdílené složky Azure nebo snímku sdílené složky. Toto rozhraní API je plně podporované, ale je to starší verze rozhraní API pro správu. Místo toho použijte sdílené složky – zapůjčení poskytnuté poskytovatelem prostředků úložiště (Microsoft.Storage). Další informace o programové interakci s prostředky pomocí poskytovatele prostředků úložiště najdete v tématu Operace se sdílenýmiFileShare složkami.

Doba trvání zámku může být 15 až 60 sekund nebo může být nekonečná. Operaci můžete volat Lease Share v jednom z následujících režimů:

• Acquire: Chcete-li požádat o nové zapůjčení.
• Renew: Obnovení existujícího zapůjčení.
• Change: Změna ID existujícího zapůjčení
• Release: Uvolnit zapůjčení, pokud už není potřeba, aby jiný klient mohl okamžitě získat zapůjčení sdílené složky.
• Break: Chcete-li ukončit zapůjčení, ale zajistit, aby jiný klient nemohl získat nové zapůjčení, dokud neuplyne aktuální doba zapůjčení.

Poznámka

Operace Lease Share je dostupná ve verzi 2020-02-10 a novější.

Dostupnost protokolu

Povolený protokol sdílené složky	K dispozici.
SMB
NFS

Žádost

Požadavek můžete sestavit Lease Share následujícím způsobem. Doporučuje se https. Nahraďte myaccount názvem vašeho účtu úložiště.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
PUT	https://myaccount.file.core.windows.net/myshare?comp=lease&restype=share	HTTP/1.1
PUT	https://myaccount.file.core.windows.net/myshare?comp=lease&sharesnapshot=<DateTime>&restype=share	HTTP/1.1

Parametry identifikátoru URI

V identifikátoru URI požadavku můžete zadat následující další parametr.

Parametr	Popis
timeout	Nepovinný parametr. Parametr se timeout vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace Azure Files.

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Hlavička požadavku	Popis
Authorization	Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
Date nebo x-ms-date	Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
x-ms-version	Nepovinný parametr. Určuje verzi operace, která se má pro tento požadavek použít. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-lease-id: <ID>	Vyžaduje se k prodloužení, změně nebo uvolnění zapůjčení. Hodnotu můžete zadat v libovolném platném x-ms-lease-id formátu řetězce GUID. Seznam platných formátů najdete v tématu Konstruktor Guid (String).
x-ms-lease-action: <action>	acquire: Požádá o nové zapůjčení. Pokud sdílená složka nemá aktivní zapůjčení, Azure Files vytvoří zapůjčení sdílené složky a vrátí nové ID zapůjčení. Pokud má sdílená složka aktivní zapůjčení, můžete o nové zapůjčení požádat pouze pomocí ID aktivního zapůjčení. Můžete ale zadat nový x-ms-lease duration, včetně záporné hodnoty (-1) pro zapůjčení, jehož platnost nikdy nevyprší. renew: Prodlouží zapůjčení. Zapůjčení můžete obnovit, pokud ID zapůjčení zadané v žádosti odpovídá ID přidružené ke sdílené složce. Mějte na paměti, že zapůjčení můžete obnovit i v případě, že vypršela jeho platnost, pokud se sdílená složka od vypršení zapůjčení znovu nepronajala. Při obnovení zapůjčení se resetují hodiny doby trvání zapůjčení. change: Změňte ID zapůjčení aktivního zapůjčení. Objekt change musí obsahovat aktuální ID zapůjčení v x-ms-lease-ida nové ID zapůjčení v x-ms-proposed-lease-id. release: Uvolněte zapůjčení. Zapůjčení můžete uvolnit, pokud ID zapůjčení zadané v žádosti odpovídá ID přidruženému ke sdílené složce. Uvolnění zapůjčení umožní jinému klientovi okamžitě získat zapůjčení sdílené složky, jakmile se vydání dokončí. break: Pokud má sdílená složka aktivní zapůjčení, přerušte zapůjčení. Když je zapůjčení přerušené, nepůjde obnovit. Jakákoli autorizovaná žádost může zapůjčení přerušit. Požadavek není nutný k zadání odpovídajícího ID zapůjčení. Pokud dojde k přerušení zapůjčení, může uplynout období přerušení zapůjčení a breakrelease jsou to jediné operace, které můžete se sdílenou složkou během této doby provádět. Když se zapůjčení úspěšně přeruší, odpověď indikuje interval v sekundách, než bude možné získat nové zapůjčení. Můžete také uvolnit zapůjčení, které bylo přerušeno. Klient může okamžitě získat zapůjčení sdílené složky, které bylo uvolněno.
x-ms-lease-break-period: N	Nepovinný parametr. break U operace se jedná o navrhovanou dobu trvání, po které by zapůjčení mělo pokračovat, než se přeruší ( v sekundách od 0 do 60). Toto období přestávky se použije jenom v případě, že je kratší než zbývající doba zapůjčení. Pokud je delší, použije se zbývající čas zapůjčení. Nové zapůjčení není k dispozici před vypršením doby pozastavení, ale zapůjčení může být drženo déle, než je tato doba přestávky. Pokud se tato hlavička nezobrazí u break operace, zapůjčení s pevnou dobou trvání se po uplynutí zbývající doby zapůjčení přeruší a nekonečné zapůjčení se okamžitě přeruší.
x-ms-lease-duration: -1	Vyžaduje se pro acquire. Určuje dobu zapůjčení v sekundách nebo zápornou dobu (-1) pro zapůjčení, jehož platnost nikdy nevyprší. Nenekonečná zapůjčení může být mezi 15 a 60 sekund. Dobu zapůjčení není možné změnit pomocí nebo renewchange.
x-ms-proposed-lease-id: <ID>	Volitelné pro acquirea povinné pro change. Navrhované ID zapůjčení ve formátu řetězce GUID Azure Blob Storage vrátí400 (Invalid request), pokud navrhované ID zapůjčení není ve správném formátu. Seznam platných formátů najdete v tématu Konstruktor Guid (String).
Origin	Nepovinný parametr. Určuje původ, ze kterého je žádost vystavena. Přítomnost této hlavičky má za následek hlavičky sdílení prostředků mezi zdroji (CORS) v odpovědi. Podrobnosti najdete v tématu Podpora CORS pro služby Storage .
x-ms-client-request-id	Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování Azure Files.

Text požadavku

Žádné

Ukázkový požadavek

Následující ukázkový požadavek ukazuje, jak získat zapůjčení:

Request Syntax:  
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=lease HTTP/1.1  
  
Request Headers:  
x-ms-version: 2020-02-10  
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=  

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Stavový kód

Stavové kódy úspěchu vrácené pro operace zapůjčení jsou následující:

• Acquire: Úspěšná operace vrátí stavový kód 201 (Vytvořeno).
• Renew: Úspěšná operace vrátí stavový kód 200 (OK).
• Change: Úspěšná operace vrátí stavový kód 200 (OK).
• Release: Úspěšná operace vrátí stavový kód 200 (OK).
• Break: Úspěšná operace vrátí stavový kód 202 (přijato).

Informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Syntax	Description
ETag	Pro ETag sdílenou složku.
Last-Modified	Vrátí datum a čas poslední změny sdílené složky. Další informace najdete v tématu Znázornění hodnot data a času v záhlavích. Každá operace, která upraví sdílenou složku nebo její vlastnosti či metadata, aktualizuje čas poslední změny. To zahrnuje nastavení oprávnění sdílené složky. Operace s objekty blob nemají vliv na čas poslední změny sdílené složky.
x-ms-lease-id: <id>	Když požádáte o zapůjčení, Azure Files vrátí jedinečné ID zapůjčení. Když je zapůjčení aktivní, musíte ID zapůjčení zahrnout do všech žádostí o odstranění sdílené složky nebo o prodloužení, změnu nebo uvolnění zapůjčení. Operace úspěšného obnovení také vrátí ID zapůjčení aktivního zapůjčení.
x-ms-lease-time: seconds	Přibližný zbývající čas v období zapůjčení (v sekundách). Tato hlavička se vrátí pouze v případě úspěšného požadavku na přerušení zapůjčení. Pokud je přerušení okamžité, 0 vrátí se hodnota .
x-ms-request-id	Jednoznačně identifikuje požadavek, který byl proveden, a lze ho použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
x-ms-version	Označuje verzi rozhraní FileREST API použitou ke spuštění požadavku.
Date	Hodnota data a času UTC, která označuje čas, kdy byla odpověď zahájena. Tato služba vygeneruje tuto hodnotu.
Access-Control-Allow-Origin	Vrátí se, pokud požadavek obsahuje hlavičku Origin a CORS je povolené s odpovídajícím pravidlem. Tato hlavička vrátí hodnotu hlavičky požadavku původu v případě shody.
Access-Control-Expose-Headers	Vrátí se, pokud požadavek obsahuje hlavičku Origin a CORS je povolené s odpovídajícím pravidlem. Vrátí seznam hlaviček odpovědi, které mají být zpřístupněny klientovi nebo vystaviteli požadavku.
Access-Control-Allow-Credentials	Vrátí se, pokud požadavek obsahuje hlavičku Origin a CORS je povolený s odpovídajícím pravidlem, které nepovoluje všechny zdroje. Tato hlavička je nastavená na true.
x-ms-client-request-id	Dá se použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě x-ms-client-request-id hlavičky, pokud se nachází v požadavku. Hodnota je maximálně 1 024 viditelných znaků ASCII. Pokud se hlavička x-ms-client-request-id v požadavku nenachází, v odpovědi se nezobrazí.

Text odpovědi

Žádné

Ukázková odpověď

Následuje ukázková odpověď na žádost o získání zapůjčení:

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: cc6b209a-b593-4be1-a38a-dde7c106f402  
x-ms-version: 2020-02-10  
x-ms-lease-id: 1f812371-a41d-49e6-b123-f4b542e851c5  
Date: Thu, 26 Jan 2012 23:30:18 GMT  

Autorizace

Tuto operaci může volat pouze vlastník účtu.

Poznámky

Zapůjčení sdílené složky poskytuje výhradní přístup k odstranění sdílené složky. Operace získání sdílené složky budou u zapůjčené sdílené složky úspěšné bez zahrnutí ID zapůjčení. Operace nastavení sdílené složky budou vyžadovat ID zapůjčení sdílené složky. Pokud id zapůjčení není součástí operací nastavených sdílených složek, operace selže s chybou 412 (Předběžná podmínka selhala). Zapůjčení se uděluje na dobu uvedenou při získání zapůjčení, což může být 15 až 60 sekund nebo nekonečná doba trvání.

Když klient získá zapůjčení, vrátí se ID zapůjčení. Azure Files vygeneruje ID zapůjčení, pokud není zadané v žádosti o získání. Klient může toto ID zapůjčení použít k obnovení zapůjčení, změně ID zapůjčení nebo k uvolnění zapůjčení. Následující diagram znázorňuje pět stavů zapůjčení a příkazy nebo události, které způsobují změny stavu zapůjčení.

Zapůjčení může být v libovolném z těchto stavů na základě toho, jestli je zapůjčení uzamčené nebo odemčené a jestli je zapůjčení v daném stavu obnovitelné. Akce zapůjčení zobrazené v předchozím diagramu způsobují přechody stavu.

Stav prodloužení	Uzamčené zapůjčení	Odemknuté zapůjčení
Obnovitelná leasing	Pronajatých	Platnost vypršela
Neobnovitelný pronájem	Narušující	Nefunkční, k dispozici

• Available, zapůjčení je odemknuté a lze jej získat. Povolená akce: acquire.
• Leased, zapůjčení je uzamčeno. Povolené akce: acquire (pouze stejné ID zapůjčení), renew, change, releasea break.
• Expired, doba trvání zapůjčení vypršela. Povolené akce: acquire, renew, releasea break.
• Breaking, zapůjčení bylo přerušeno, ale zapůjčení bude dál uzamčeno, dokud neuplyne doba přerušení. Povolené akce: release a break.
• Broken, zapůjčení bylo přerušeno a vypršela doba přerušení. Povolené akce: acquire, releasea break.

Azure Files ID zapůjčení zachová i po vypršení platnosti zapůjčení sdílené složky. Klient může prodloužit nebo uvolnit zapůjčení pomocí ID zapůjčení, jehož platnost vypršela. Pokud se klient pokusí obnovit nebo uvolnit zapůjčení s předchozím ID zapůjčení, jehož platnost vypršela, a požadavek selže, znamená to, že sdílená složka byla znovu zapůjčena nebo odstraněna, protože její zapůjčení bylo naposledy aktivní. Pokud zapůjčení nevyprší explicitně, může se stát, že klient bude muset počkat až jednu minutu, než bude možné získat nové zapůjčení sdílené složky. Klient ale může zapůjčení okamžitě obnovit s ID zapůjčení, jehož platnost vypršela.

Vlastnost sdílené Last-Modified-Time složky se neaktualizuje voláním Lease Share.

Následující tabulky ukazují výsledky akcí s kontejnery s zapůjčením v různých stavech zapůjčení. Písmena (A), (B) a (C) představují ID zapůjčení a (X) představuje ID zapůjčení vygenerované Azure Files.

Výsledky pokusů o použití akcií podle stavu zapůjčení

Akce	K dispozici.	Zapůjčeno (A)	Lámání (A)	Nefunkční (A)	Platnost vypršela (A)
Odstranit pomocí (A)	Selhání (412)	Zapůjčeno (A), odstranění proběhlo úspěšně	Přerušení (A), odstranění proběhlo úspěšně	Selhání (412)	Selhání (412)
Odstranit pomocí (B)	Selhání (412)	Selhání (409)	Selhání (412)	Selhání (412)	Selhání (412)
Odstranit, nezadá se zapůjčení	K dispozici, odstranění proběhlo úspěšně	Selhání (412)	Selhání (412)	K dispozici, odstranění proběhlo úspěšně	K dispozici, odstranění proběhlo úspěšně
Další operace s (A)	Selhání (412)	Zapůjčeno (A), operace je úspěšná	Přerušení (A), operace je úspěšná	Selhání (412)	Selhání (412)
Další operace s (B)	Selhání (412)	Selhání (409)	Selhání (409)	Selhání (412)	Selhání (412)
Operace, nezadá se zapůjčení	K dispozici, operace je úspěšná	Zapůjčeno (A), operace je úspěšná	Přerušení (A), operace je úspěšná	Přerušeno (A), operace je úspěšná	Vypršela (A), operace je úspěšná

Výsledky operací zapůjčení akcií podle stavu zapůjčení

Akce	K dispozici.	Zapůjčeno (A)	Rozbít (A)	Poškozené (A)	Vypršela (A)
Acquire, žádné navrhované ID zapůjčení	Zapůjčeno (X)	Selhání (409)	Selhání (409)	Zapůjčeno (X)	Zapůjčeno (X)
Acquire (A)	Zapůjčeno (A)	Zapůjčeno (A), nová doba trvání	Selhání (409)	Zapůjčeno (A)	Zapůjčeno (A)
Acquire (B)	Zapůjčeno (B)	Selhání (409)	Selhání (409)	Zapůjčeno (B)	Zapůjčeno (B)
Break, tečka=0	Selhání (409)	Poškozené (A)	Poškozené (A)	Poškozené (A)	Poškozené (A)
Break, období>0	Selhání (409)	Rozbít (A)	Rozbít (A)	Poškozené (A)	Poškozené (A)
Change, (A) až (B)	Selhání (409)	Zapůjčeno (B)	Selhání (409)	Selhání (409)	Selhání (409)
Change, (B) až (A)	Selhání (409)	Zapůjčeno (A)	Selhání (409)	Selhání (409)	Selhání (409)
Change, (B) až (C)	Selhání (409)	Selhání (409)	Selhání (409)	Selhání (409)	Selhání (409)
Renew (A)	Selhání (409)	Zapůjčeno (A), resetování hodin vypršení platnosti	Selhání (409)	Selhání (409)	Zapůjčeno (A)
Renew (B)	Selhání (409)	Selhání (409)	Selhání (409)	Selhání (409)	Selhání (409)
Release (A)	Selhání (409)	K dispozici.	K dispozici.	K dispozici.	K dispozici.
Release (B)	Selhání (409)	Selhání (409)	Selhání (409)	Selhání (409)	Selhání (409)
Doba trvání vyprší.	K dispozici.	Vypršela (A)	Poškozené (A)	Poškozené (A)	Vypršela (A)