Bérletmegosztás

A Lease Share művelet létrehoz és kezel egy Zárolást egy Azure-fájlmegosztáson vagy egy megosztási pillanatképen. Ez az API teljes mértékben támogatott, de örökölt felügyeleti API. Ehelyett használja a Fájlmegosztások – Bérlet lehetőséget, amelyet a tárolási erőforrás-szolgáltató (Microsoft.Storage) biztosít. Ha többet szeretne megtudni az erőforrásoknak a tárolási erőforrás-szolgáltató használatával történő programozott használatáról FileShare , tekintse meg a FileShares műveleteit ismertető cikket.

A zárolás időtartama 15–60 másodperc, vagy végtelen lehet. A műveletet az Lease Share alábbi módok egyikével hívhatja meg:

• Acquire: Új bérlet kérése.
• Renew: Meglévő bérlet megújítása.
• Change: Meglévő bérlet azonosítójának módosítása.
• Release: A bérlet felszabadítása, ha már nincs rá szükség, hogy egy másik ügyfél azonnal megszerezhesse a bérletet a fájlmegosztáson.
• Break: A bérlet befejezéséhez, de győződjön meg arról, hogy egy másik ügyfél csak az aktuális bérletidőszak lejártáig szerezhet új bérletet.

Megjegyzés

A Lease Share művelet a 2020-02-10-es és újabb verziókban érhető el.

Protokoll rendelkezésre állása

Engedélyezett fájlmegosztási protokoll	Elérhető
SMB
NFS

Kérés

A kérést az Lease Share alábbiak szerint hozhatja létre. A HTTPS használata ajánlott. Cserélje le a myaccount kifejezést a tárfiók nevére.

Metódus	Kérés URI-ja	HTTP-verzió
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

URI-paraméterek

A kérelem URI-ján a következő további paramétert adhatja meg.

Paraméter	Leírás
timeout	Választható. A timeout paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása Azure Files műveletekhez.

Kérésfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti.

Kérelem fejléce	Leírás
Authorization	Kötelező. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérelmek engedélyezése az Azure Storage-ba.
Date vagy x-ms-date	Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információ: Kérelmek engedélyezése az Azure Storage-ba.
x-ms-version	Választható. A kérelemhez használandó művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása.
x-ms-lease-id: <ID>	A bérlet megújításához, módosításához vagy kiadásához szükséges. A értékét x-ms-lease-id bármilyen érvényes GUID-sztringformátumban megadhatja. Az érvényes formátumok listáját a Guid Konstruktor (sztring) című témakörben találja.
x-ms-lease-action: <action>	acquire: Új bérletet kér. Ha a fájlmegosztásnak nincs aktív bérlete, Azure Files létrehoz egy bérletet a fájlmegosztáson, és új bérletazonosítót ad vissza. Ha a fájlmegosztás aktív bérletet használ, csak az aktív bérletazonosító használatával kérhet új bérletet. Megadhat azonban egy újat x-ms-lease duration, beleértve a negatívat (-1) egy olyan bérlethez, amely soha nem jár le. renew: Megújítja a bérletet. Megújíthatja a bérletet, ha a kérelemben megadott bérletazonosító megegyezik a fájlmegosztáshoz tartozóval. Vegye figyelembe, hogy a bérletet akkor is megújíthatja, ha az lejárt, feltéve, hogy a fájlmegosztást a bérlet lejárata óta nem adták tovább. A bérlet megújításakor a bérlet időtartama visszaáll. change: Módosítsa egy aktív bérlet bérletazonosítóját. A-nek change tartalmaznia kell az aktuális bérletazonosítót a fájlban x-ms-lease-id, és egy új bérletazonosítót a fájlban x-ms-proposed-lease-id. release: Adja ki a bérletet. Felszabadíthatja a bérletet, ha a kérelemben megadott bérletazonosító megegyezik a fájlmegosztáshoz társított bérletazonosítóval. A bérlet felszabadítása lehetővé teszi, hogy egy másik ügyfél azonnal megszerezze a fájlmegosztás bérletét, amint a kiadás befejeződött. break: Megszakítja a bérletet, ha a fájlmegosztás aktív bérletet kapott. A bérlet megszakadása után nem újítható meg. Bármely engedélyezett kérelem megszakíthatja a bérletet. A kérelem nem szükséges egyező bérletazonosító megadásához. Ha egy bérlet megszakad, a bérletmegszakítási időszak lejár, és breakrelease ez idő alatt csak a fájlmegosztáson végezhető műveletek engedélyezettek. Ha egy bérlet sikeresen megszakad, a válasz másodpercek alatt jelzi az időközt, amíg új bérletet nem lehet beszerezni. A megszakított bérlet is felszabadítható. Az ügyfél azonnal beszerezheti a kiadott fájlmegosztási bérletet.
x-ms-lease-break-period: N	Választható. Egy break művelet esetében ez az a javasolt időtartam, amelyet a bérletnek folytatnia kell, mielőtt megszakad, másodpercek alatt, 0 és 60 között. Ez a törési időszak csak akkor használatos, ha rövidebb, mint a bérletben fennmaradó idő. Ha hosszabb ideig tart, a rendszer a bérleten fennmaradó időt használja fel. Az új bérlet nem érhető el a megszakítási időszak lejárta előtt, de a bérlet hosszabb ideig tartható, mint a megszakítási időszak. Ha ez a fejléc nem jelenik meg egy break művelettel, a fennmaradó bérletidőszak letelte után egy rögzített időtartamú bérlet szakad meg, és a végtelen bérletek azonnal megszakadnak.
x-ms-lease-duration: -1	A következőhöz acquireszükséges: . Megadja a bérlet időtartamát másodpercben vagy negatív (-1) egy olyan bérlet esetén, amely soha nem jár le. A nem végtelen bérlet 15 és 60 másodperc között lehet. A vagy a használatával renewchangenem módosítható a bérlet időtartama.
x-ms-proposed-lease-id: <ID>	Nem kötelező a esetében, acquireés kötelező a számára change. Javasolt bérletazonosító GUID sztringformátumban. Azure Blob Storage akkor ad 400 (Invalid request) vissza, ha a javasolt bérletazonosító nem a megfelelő formátumban van. Az érvényes formátumok listáját a Guid Konstruktor (sztring) című témakörben találja.
Origin	Választható. Meghatározza, hogy a kérelem melyik forrásból legyen kibocsátva. Ennek a fejlécnek a jelenléte az eltérő eredetű erőforrások megosztását (CORS) eredményezi a válaszban. További részletekért lásd : CORS-támogatás a Storage-szolgáltatásokhoz .
x-ms-client-request-id	Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kibibyte (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít a naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel. További információ: Azure Files figyelése.

A kérés törzse

Nincsenek.

Mintakérés

Az alábbi mintakérés bemutatja, hogyan szerezhet be bérletet:

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=  

Reagálás

A válasz tartalmaz egy HTTP-állapotkódot és egy válaszfejléceket.

Állapotkód

A bérletműveletek sikerességi állapotkódjai a következők:

• Acquire: A sikeres művelet a 201-ben létrehozott állapotkódot adja vissza.
• Renew: A sikeres művelet a 200-ra (OK) vonatkozó állapotkódot adja vissza.
• Change: A sikeres művelet a 200-ra (OK) vonatkozó állapotkódot adja vissza.
• Release: A sikeres művelet a 200-ra (OK) vonatkozó állapotkódot adja vissza.
• Break: A sikeres művelet a 202-s állapotkódot adja vissza (Elfogadva).

Az állapotkódokkal kapcsolatos információkért lásd: Állapot- és hibakódok.

Válaszfejlécek

A műveletre adott válasz a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.

Syntax	Description
ETag	A ETag fájlmegosztáshoz tartozó.
Last-Modified	A fájlmegosztás utolsó módosításának dátumát és időpontját adja vissza. További információ: Dátum-idő értékek ábrázolása fejlécekben. Minden olyan művelet, amely módosítja a fájlmegosztást, illetve annak tulajdonságait vagy metaadatait, frissíti az utolsó módosítás időpontját. Ez magában foglalja a fájlmegosztás engedélyeinek beállítását is. A blobokon végzett műveletek nem befolyásolják a fájlmegosztás utolsó módosításának időpontját.
x-ms-lease-id: <id>	Amikor bérletet kér, Azure Files egy egyedi bérletazonosítót ad vissza. Amíg a bérlet aktív, meg kell adnia a bérletazonosítót a fájlmegosztás törlésére, illetve a bérlet megújítására, módosítására vagy kiadására vonatkozó kérésekkel. A sikeres megújítási művelet az aktív bérlet bérletazonosítóját is visszaadja.
x-ms-lease-time: seconds	A bérletidőszakban hátralévő hozzávetőleges idő másodpercben. Ez a fejléc csak a bérlet megszakítására irányuló sikeres kérelem esetén lesz visszaadva. Ha a törés azonnali, 0 a függvény visszaadja.
x-ms-request-id	Egyedileg azonosítja a végrehajtott kérést, és a kérés hibaelhárításához használható. További információ: API-műveletek hibaelhárítása.
x-ms-version	A kérelem futtatásához használt FileREST API verzióját jelzi.
Date	Utc dátum/idő érték, amely a válasz indításának időpontját jelzi. A szolgáltatás létrehozza ezt az értéket.
Access-Control-Allow-Origin	Akkor adja vissza, ha a kérelem tartalmaz egy fejlécet Origin , és a CORS engedélyezve van egyező szabmánnyal. Ez a fejléc a forráskérés fejlécének értékét adja vissza egyezés esetén.
Access-Control-Expose-Headers	Akkor adja vissza, ha a kérelem tartalmaz egy fejlécet Origin , és a CORS engedélyezve van egyező szabmánnyal. Visszaadja azoknak a válaszfejléceknek a listáját, amelyeket elérhetővé kell tenni az ügyfélnek vagy a kérés kiállítójának.
Access-Control-Allow-Credentials	Akkor adja vissza, ha a kérelem tartalmaz egy fejlécet Origin , és a CORS engedélyezve van egyező szabálysal, amely nem engedélyezi az összes forrást. Ez a fejléc a következőre van állítva: true.
x-ms-client-request-id	A kérések és a kapcsolódó válaszok hibaelhárítására használható. A fejléc értéke megegyezik a fejléc értékével x-ms-client-request-id , ha az szerepel a kérelemben. Az érték legfeljebb 1024 látható ASCII-karakter lehet. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, az nem jelenik meg a válaszban.

Választörzs

Nincsenek.

Mintaválasz

Az alábbiakban egy mintaválaszt ad vissza egy bérlet beszerzésére irányuló kérelemhez:

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  

Engedélyezés

Ezt a műveletet csak a fióktulajdonos hívhatja meg.

Megjegyzések

A fájlmegosztások bérlete kizárólagos törlési hozzáférést biztosít a fájlmegosztáshoz. A fájlmegosztási műveletek lekérése egy bérelt fájlmegosztáson sikeres lesz a bérletazonosító nélkül. A fájlmegosztási műveletek beállításához szükség lesz a fájlmegosztás bérletazonosítójára. Ha a bérletazonosító nem szerepel a beállított fájlmegosztási műveletekben, a művelet a 412-vel meghiúsul (az előfeltétel nem sikerült). A bérletet a bérlet beszerzésekor megadott időtartamra adják meg, amely 15–60 másodperc, vagy végtelen időtartam lehet.

Amikor egy ügyfél bérletet szerez, a bérletazonosító lesz visszaadva. Azure Files létrehoz egy bérletazonosítót, ha nincs megadva a beolvasási kérelemben. Az ügyfél ezzel a bérletazonosítóval megújíthatja a bérletet, módosíthatja a bérletazonosítóját, vagy felszabadíthatja a bérletet. Az alábbi diagram egy bérlet öt állapotát, valamint a bérletállapot-módosításokat okozó parancsokat vagy eseményeket mutatja be.

A bérlet ezen állapotok bármelyikében lehet, attól függően, hogy a bérlet zárolva vagy feloldva van-e, és hogy a bérlet megújítható-e ebben az állapotban. Az előző ábrán látható bérletműveletek állapotváltásokat okoznak.

Megújítás állapota	Zárolt bérlet	Zárolt bérlet
Megújuló bérlet	Bérelt	Lejárt
Nem megújuló bérlet	Törés	Hibás, elérhető

• Available, a bérlet feloldva van, és megszerezhető. Engedélyezett művelet: acquire.
• Leased, a bérlet zárolva van. Engedélyezett műveletek: acquire (csak ugyanaz a bérletazonosító), renew, , change, releaseés break.
• Expired, a bérlet időtartama lejárt. Engedélyezett műveletek: acquire, renew, releaseés break.
• Breaking, a bérlet megszakadt, de a bérlet a megszakítási időszak lejártáig zárolva marad. Engedélyezett műveletek: release és break.
• Broken, a bérlet megszakadt, és a megszakítási időszak lejárt. Engedélyezett műveletek: acquire, release, és break.

Azure Files a fájlmegosztási bérlet lejártát követően megőrzi a bérletazonosítót. Az ügyfél megújíthatja vagy felszabadíthatja a bérletet a lejárt bérletazonosítójával. Ha az ügyfél megkísérli megújítani vagy kiadni egy lejárt bérletet a korábbi bérletazonosítójával, és a kérés meghiúsul, az azt jelenti, hogy a fájlmegosztást újra lízingelték vagy törölték, mivel a bérlet utolsó aktív volt. Ha a bérlet nem explicit módon, hanem lejár, előfordulhat, hogy az ügyfélnek akár egy percet is várnia kell, mielőtt új bérletet szerezhetne be a fájlmegosztáshoz. Az ügyfél azonban azonnal megújíthatja a bérletet a lejárt bérletazonosítóval.

A fájlmegosztás tulajdonsága Last-Modified-Time nem frissül a következő Lease Sharehívásokkal: .

Az alábbi táblázatok a különböző bérletállapotú tárolókon végzett műveletek eredményeit mutatják be. Az A), (B) és (C) betűk a bérletazonosítókat, az (X) pedig a Azure Files által létrehozott bérletazonosítót jelölik.

A részvényekkel kapcsolatos használati kísérletek eredményei bérletállapot szerint

Művelet	Elérhető	Bérelt (A)	Törés (A)	Hibás (A)	Lejárt (A)
Törlés (A)	Sikertelen (412)	Bérelt (A), törlés sikeres	Kompatibilitástörő (A), törlés sikeres	Sikertelen (412)	Sikertelen (412)
Törlés a (B) használatával	Sikertelen (412)	Sikertelen (409)	Sikertelen (412)	Sikertelen (412)	Sikertelen (412)
Törlés, nincs megadva bérlet	Elérhető, a törlés sikeres	Sikertelen (412)	Sikertelen (412)	Elérhető, a törlés sikeres	Elérhető, a törlés sikeres
Egyéb műveletek az (A) használatával	Sikertelen (412)	A bérelt (A) művelet sikeres	Kompatibilitástörő (A) művelet sikeres	Sikertelen (412)	Sikertelen (412)
Egyéb műveletek a (B) használatával	Sikertelen (412)	Sikertelen (409)	Sikertelen (409)	Sikertelen (412)	Sikertelen (412)
Műveletek, nincs megadva bérlet	Elérhető, a művelet sikeres	A bérelt (A) művelet sikeres	Kompatibilitástörő (A) művelet sikeres	Megszakadt (A), a művelet sikeres	Lejárt (A), a művelet sikeres

A részvények bérletállapot szerinti bérletműveleteinek eredményei

Művelet	Elérhető	Bérelt (A)	Kompatibilitástörő (A)	Hibás (A)	Lejárt (A)
Acquire, nincs javasolt bérletazonosító	Bérelt (X)	Sikertelen (409)	Sikertelen (409)	Bérelt (X)	Bérelt (X)
Acquire (A)	Bérelt (A)	Bérelt (A), új időtartam	Sikertelen (409)	Bérelt (A)	Bérelt (A)
Acquire (B)	Bérelt (B)	Sikertelen (409)	Sikertelen (409)	Bérelt (B)	Bérelt (B)
Break, pont=0	Sikertelen (409)	Hibás (A)	Hibás (A)	Hibás (A)	Hibás (A)
Break, 0. időszak>	Sikertelen (409)	Kompatibilitástörő (A)	Kompatibilitástörő (A)	Hibás (A)	Hibás (A)
Change, (A) –B)	Sikertelen (409)	Bérelt (B)	Sikertelen (409)	Sikertelen (409)	Sikertelen (409)
Change, (B) –(A)	Sikertelen (409)	Bérelt (A)	Sikertelen (409)	Sikertelen (409)	Sikertelen (409)
Change, (B) –(C)	Sikertelen (409)	Sikertelen (409)	Sikertelen (409)	Sikertelen (409)	Sikertelen (409)
Renew (A)	Sikertelen (409)	Bérelt (A), lejárati idő alaphelyzetbe állítása	Sikertelen (409)	Sikertelen (409)	Bérelt (A)
Renew (B)	Sikertelen (409)	Sikertelen (409)	Sikertelen (409)	Sikertelen (409)	Sikertelen (409)
Release (A)	Sikertelen (409)	Elérhető	Elérhető	Elérhető	Elérhető
Release (B)	Sikertelen (409)	Sikertelen (409)	Sikertelen (409)	Sikertelen (409)	Sikertelen (409)
Az időtartam lejár	Elérhető	Lejárt (A)	Hibás (A)	Hibás (A)	Lejárt (A)