Bérlettároló
A Lease Container
művelet létrehozza és kezeli a tároló zárolását a törlési műveletekhez. A zárolás időtartama 15–60 másodperc, vagy végtelen lehet.
A műveletet az Lease Container
alábbi módok egyikével hívhatja meg:
Acquire
lehetőséget, hogy új bérletet kérjen.Renew
lehetőséget egy meglévő bérlet megújításához.Change
elemet egy meglévő bérlet azonosítójának módosításához.Release
lehetőséget, hogy felszabadítsa a bérletet, ha már nincs rá szükség, hogy egy másik ügyfél azonnal megszerezhesse a bérletet a tárolón.Break
, a bérlet megszüntetéséhez, de győződjön meg arról, hogy egy másik ügyfél nem szerezhet új bérletet az aktuális bérletidőszak lejártáig.
Megjegyzés
A Lease Container
művelet a 2012-02-12-es és újabb verziókban érhető el.
Kérés
A kérést az Lease Container
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.blob.core.windows.net/mycontainer?comp=lease&restype=container |
HTTP/1.1 |
A gyökértároló megadásához adja meg $root
a nevet a tároló neveként.
Emulált tárolási szolgáltatás URI-ja
Amikor kérést küld az emulált tárolási szolgáltatásra, adja meg az emulátor gazdanevét és Azure Blob Storage portot 127.0.0.1:10000
, majd az emulált tárfiók nevét.
Metódus | Kérés URI-ja | HTTP-verzió |
---|---|---|
PUT |
http://127.0.0.1:10000/mycontainer?comp=lease&restype=container |
HTTP/1.0 HTTP/1.1 |
További információ: Az Azurite Emulator használata helyi Azure Storage-fejlesztéshez.
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 Blob Storage-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: <acquire ¦ renew ¦ change ¦ release ¦ break> |
acquire : Új bérletet kér. Ha a tárolónak nincs aktív bérlete, a Blob Storage létrehoz egy bérletet a tárolón, és egy új bérletazonosítót ad vissza. Ha a tároló 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 tárolóhoz tartozóval. Vegye figyelembe, hogy a bérlet akkor is megújítható, ha lejárt, feltéve, hogy a tárolót 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 tárolóhoz tartozóval. A bérlet felszabadítása lehetővé teszi, hogy egy másik ügyfél azonnal megszerezze a tároló bérletét, amint a kiadás befejeződött.break : Megszakítja a bérletet, ha a tároló 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érletszakadási időszak lejárhat. Ez idő alatt csak a tárolón hajthat végre break és release adhat bérbe műveleteket. 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 beszerezhet egy felszabadított tárolóbérletet. |
x-ms-lease-break-period: N |
Választható. Művelet break esetén ez a fejléc az a javasolt időtartam, amelyet a bérletnek folytatnia kell a megszakítás előtt, 0 és 60 másodperc 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. A megszakítási időszak lejárta előtt nem lesz elérhető új bérlet, de a bérlet a megszakítási időszaknál hosszabb ideig tartható. 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 ¦ n seconds |
A következőhöz acquire szü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 renew change nem 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. A Blob Storage akkor ad 400 (Invalid request) vissza értéket, 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 Blob Storage figyelése. |
Ez a művelet a feltételes fejlécek használatát is támogatja a művelet futtatásához, ha egy adott feltétel teljesül. További információ: Feltételes fejlécek megadása Blob Storage-műveletekhez.
A kérés törzse
Nincsenek.
Mintakérés
A következő mintakérés bemutatja, hogyan szerezhet be bérletet:
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=
Reagálás
A válasz egy HTTP-állapotkódot és válaszfejléceket tartalmaz.
Állapotkód
A bérletműveletek sikerességi állapotkódjai a következők:
Acquire
: A sikeres művelet visszaadja a 201(Létrehozva) állapotkódot.Renew
: A sikeres művelet a 200 -os állapotkódot adja vissza (OK).Change
: A sikeres művelet a 200 -os állapotkódot adja vissza (OK).Release
: A sikeres művelet a 200 -os állapotkódot adja vissza (OK).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 tárolóhoz. A rendszer ezt a fejlécet adja vissza a 2013-08-15-ös és újabb verzióval kapcsolatos kérésekhez, és az ETag érték idézőjelekben van megadva.
Lease Container a 2013-08-15-ös és újabb verzióval végzett műveletek nem módosítják ezt a tulajdonságot, de a korábbi verziók igen. |
Last-Modified |
A 2013-08-15-ös és újabb verzióval kapcsolatos kérések visszaadva. A tároló 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 tárolót, illetve annak tulajdonságait vagy metaadatait, frissíti az utolsó módosítás időpontját. Ebbe beletartozik a tároló engedélyeinek beállítása is. A blobokon végzett műveletek nincsenek hatással a tároló utolsó módosításának időpontjára. Lease Container a 2013-08-15-ös és újabb verzióval végzett műveletek nem módosítják ezt a tulajdonságot, de a korábbi verziók igen. |
x-ms-lease-id: <id> |
Amikor bérletet kér, a Blob Storage egy egyedi bérletazonosítót ad vissza. Amíg a bérlet aktív, meg kell adnia a bérletazonosítót a tároló 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 fennmaradó hozzávetőleges idő másodpercben. Ez a fejléc csak a bérlet megszakítására irányuló sikeres kérés esetén lesz visszaadva. Ha a törés azonnali, a függvény 0-t ad vissza. |
x-ms-request-id |
Ez a fejléc 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érés futtatásához használt Blob Storage-verziót jelzi. Ez a fejléc lesz visszaadva a 2009-09-19-es és újabb verzióval kapcsolatos kérésekhez. |
Dátum | UTC dátum/idő érték, amely a válasz indításának időpontját jelzi. Ezt az értéket a szolgáltatás hozza létre. |
Access-Control-Allow-Origin |
Akkor adja vissza, ha a kérelem tartalmaz fejlécet Origin , és a CORS engedélyezve van egy megfelelő 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 fejlécet Origin , és a CORS engedélyezve van egy megfelelő szabmánnyal. Azon válaszfejlécek listáját adja vissza, 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 fejlécet Origin , és a CORS engedélyezve van egy olyan egyező szabmánnyal, amely nem engedélyezi az összes forrást. Ez a fejléc a következőre lesz állítva: true . |
x-ms-client-request-id |
Ezzel a fejléccel elháríthatja a kéréseket és a megfelelő válaszokat. Ennek a fejlécnek az értéke megegyezik a x-ms-client-request-id fejléc értékével, 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, akkor 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éréshez:
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
Engedélyezés
Az azure storage-beli adathozzáférési műveletek meghívásakor engedélyezésre van szükség. A műveletet a Lease Container
következő szakaszokban leírtak szerint engedélyezheti.
Fontos
A Microsoft a Microsoft Entra ID felügyelt identitásokkal való használatát javasolja az Azure Storage felé irányuló kérések engedélyezéséhez. Microsoft Entra ID a megosztott kulcsos hitelesítéshez képest kiemelkedő biztonságot és könnyű használatot biztosít.
Az Azure Storage támogatja a Microsoft Entra ID használatát a blobadatokra irányuló kérések engedélyezéséhez. A Microsoft Entra ID azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) adhat engedélyeket egy rendszerbiztonsági tagnak. A rendszerbiztonsági tag lehet felhasználó, csoport, alkalmazás-szolgáltatásnév vagy Azure által felügyelt identitás. A rendszerbiztonsági tag hitelesítését a Microsoft Entra ID végzi egy OAuth 2.0-jogkivonat visszaadásához. A jogkivonat ezután a Blob Storage-ra irányuló kérések engedélyezésére használható.
További információ a Microsoft Entra ID használatával történő engedélyezésről: Blobokhoz való hozzáférés engedélyezése Microsoft Entra ID használatával.
Engedélyek
A következő RBAC-műveletek szükségesek ahhoz, hogy egy Microsoft Entra felhasználó, csoport, felügyelt identitás vagy szolgáltatásnév meghívhassa a Lease Container
műveletet, valamint a legkevésbé emelt jogosultságú beépített Azure RBAC-szerepkörhöz, amely tartalmazza ezt a műveletet:
- Azure RBAC-művelet: Microsoft.Storage/storageAccounts/blobServices/containers/write
- Legkevésbé kiemelt beépített szerepkör: Storage-blobadatok közreműködője
A szerepkörök Azure RBAC használatával történő hozzárendelésével kapcsolatos további információkért lásd: Azure-szerepkör hozzárendelése blobadatokhoz való hozzáféréshez.
Megjegyzések
A tároló bérlete kizárólagos törlési hozzáférést biztosít a tárolóhoz. A tárolóbérlet csak a Tároló törlése művelettel szabályozza a tároló törlésének lehetőségét. Ha aktív bérlettel rendelkező tárolót szeretne törölni, az ügyfélnek tartalmaznia kell az aktív bérlet azonosítóját a törlési kérelemmel. Ha a bérletazonosító nem szerepel a bérletben, a művelet 412-vel meghiúsul (az előfeltétel nem sikerült). Minden más tárolóművelet sikeres egy bérelt tárolón, a bérletazonosító nélkül. A bérletet a bérlet beszerzésekor megadott időtartamra biztosítják, amely 15 és 60 másodperc között lehet, vagy végtelen időtartam.
Amikor egy ügyfél bérletet szerez be, a bérletazonosító lesz visszaadva. A Blob Storage létrehoz egy bérletazonosítót, ha nincs megadva a beszerzé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 ábra egy bérlet lehetséges állapotát, valamint a bérletállapot változásait okozó parancsokat vagy eseményeket mutatja be.
A bérletek az öt állam egyikében lehetnek attól függően, hogy a bérlet zárolva van vagy feloldva van, és hogy a bérlet megújítható-e ebben az állapotban. Az előző diagramon 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 beszerezhető. Engedélyezett művelet:acquire
.Leased
, a bérlet zárolva van. Engedélyezett műveletek:acquire
(csak bérletazonosító),renew
,change
,release
ésbreak
.Expired
, a bérlet időtartama lejárt. Engedélyezett műveletek:acquire
,renew
,release
ésbreak
.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
ésbreak
.Broken
, a bérlet megszakadt, és a megszakítási időszak lejárt. Engedélyezett műveletek:acquire
,release
ésbreak
.
A Blob Storage fenntartja a bérletazonosítót a tárolóbérlet lejártát követően. 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 felszabadítani egy lejárt bérletet a korábbi bérletazonosítójával, és a kérés sikertelen, akkor a tárolót újra bérletbe adták vagy törölték, mivel az ügyfél bérlete utoljára aktív volt.
Ha egy bérlet lejár ahelyett, hogy explicit módon felszabadulna, előfordulhat, hogy az ügyfélnek akár egy percet is várnia kell, mielőtt új bérletet szerezhetne be a tárolóhoz. Az ügyfél azonban azonnal megújíthatja a bérletet a lejárt bérletazonosítóval.
A tároló tulajdonságát Last-Modified-Time
nem frissítik a hívásai Lease Container
.
Az alábbi táblázatok a különböző bérletállapotú bérletekkel rendelkező tárolók műveleteinek eredményeit mutatják be. Az A), a (B) és a (C) betűk a bérletazonosítókat, az (X) pedig a Blob Storage által létrehozott bérletazonosítót jelölik.
Tárolók használati kísérleteinek eredményei bérletállapot szerint
Művelet | Elérhető | Bérelt (A) | Kompatibilitástörő (A) | Hibás (A) | Lejárt (A) |
---|---|---|---|---|---|
Törlés az (A) használatával | 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 tárolók 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) | Lízingelt (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 , period=0 |
Sikertelen (409) | Hibás (A) | Hibás (A) | Hibás (A) | Hibás (A) |
Break , 0. időszak> |
Sikertelen (409) | Törés (A) | Törés (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) | Lízingelt (A), lejárati óra 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) |
Számlázás
A díjszabási kérések a Blob Storage API-kat használó ügyfelektől, közvetlenül a Blob Storage REST API-ból vagy egy Azure Storage-ügyfélkódtárból származhatnak. Ezek a kérések tranzakciónkénti díjakat halmoznak fel. A tranzakció típusa befolyásolja a fiók terhelését. Az olvasási tranzakciók például más számlázási kategóriába tartoznak, mint az írási tranzakciók. Az alábbi táblázat a tárfiók típusa alapján a kérelmek számlázási kategóriáját Lease Container
mutatja be:
Művelet | Tárfiók típusa | Számlázási kategória |
---|---|---|
Bérlettároló (beszerzés, kiadás, megújítás) | Prémium szintű blokkblob Standard általános célú v2 |
Egyéb műveletek |
Bérlettároló (beszerzés, kiadás, megújítás) | Standard általános célú v1 | Olvasási műveletek |
Bérlettároló (törés, módosítás) | Prémium szintű blokkblob Standard általános célú v2 |
Egyéb műveletek |
Bérlettároló (törés, módosítás) | Standard általános célú v1 | Írási műveletek |
A megadott számlázási kategória díjszabásával kapcsolatos további információkért lásd: Azure Blob Storage Díjszabás.
Lásd még
Kérések engedélyezése az Azure Storage-ba
Állapot- és hibakódok
Blob Storage-hibakódok
Blobbérlet