Share via

Path - Lease

  • Referencia
Service:
Storage Services
API Version:
2023-08-03

Bérlet elérési útja
Hozzon létre és kezeljen egy bérletet az elérési út írási és törlési hozzáférésének korlátozásához. Ez a művelet támogatja a feltételes HTTP-kéréseket. További információ: Feltételes fejlécek megadása Blob Service-műveletekhez.

POST https://{accountName}.{dnsSuffix}/{filesystem}/{path}
With optional parameters: 
POST https://{accountName}.{dnsSuffix}/{filesystem}/{path}?timeout={timeout}

URI-paraméterek

Name In Kötelező Típus Description
accountName
 path True

string

Az Azure Storage-fiók neve.
dnsSuffix
 path True

string

A Azure Data Lake Storage végpont DNS-utótagja.
filesystem
 path True

string

A fájlrendszer azonosítója.

Regex pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$
path
 path True

string

A fájl vagy könyvtár elérési útja.
timeout
 query

integer

int32

Nem kötelező művelet időtúllépési értéke másodpercben. Az időszak akkor kezdődik, amikor a kérést a szolgáltatás megkapja. Ha az időtúllépési érték a művelet befejeződése előtt eltelik, a művelet meghiúsul.

Kérelem fejléce

Name Kötelező Típus Description
x-ms-lease-action True

PathLeaseAction

Öt bérletművelet létezik: "acquire", "break", "change", "renew" és "release". Az új bérlet beszerzéséhez használja a "acquire" kifejezést, és adja meg az "x-ms-proposed-lease-id" és az "x-ms-lease-duration" értéket. Meglévő bérlet megszakításához használja a "törést". Ha egy bérlet megszakad, a bérletmegszakítási időszak eltelhet, és ez idő alatt a fájlon nem végezhető el a bérletművelet, kivéve a megszakítást és a kiadást. 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. Az aktív bérlet bérletazonosítójának módosításához használja a "change" kifejezést, és adja meg az aktuális bérletazonosítót az "x-ms-lease-id" mezőben, az "x-ms-proposed-lease-id" új bérletazonosítóját pedig. Meglévő bérlet megújításához használja a "renew" (megújítás) lehetőséget, és adja meg az "x-ms-lease-id" azonosítót. A bérlet kiadásához használja a "release" kifejezést, és adja meg az "x-ms-lease-id" azonosítót.
x-ms-lease-duration

integer

int32

A bérlet megszerzéséhez a bérlet időtartama szükséges, és a bérlet időtartamát másodpercben határozza meg. A bérlet időtartamának 15 és 60 másodperc, végtelen bérlet esetén pedig -1 között kell lennie.
x-ms-lease-break-period

integer

int32

A bérlet megszakítási időszaka nem kötelező a bérlet megszakításához, és a bérlet megszakítási időtartamát adja meg másodpercben. A bérlettörés időtartama 0 és 60 másodperc között lehet.
x-ms-lease-id

string

Akkor szükséges, ha az "x-ms-lease-action" értéke "renew", "change" vagy "release". A megújítási és kiadási műveletek esetében ennek meg kell egyeznie az aktuális bérletazonosítóval.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-proposed-lease-id

string

Akkor szükséges, ha az "x-ms-lease-action" "acquire" vagy "change" típusú. Ha a művelet sikeres, a rendszer ezzel a bérletazonosítóval szerez be egy bérletet.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
If-Match

string

Választható. Egy ETag érték. Adja meg ezt a fejlécet a művelet végrehajtásához, ha az erőforrás ETagje megegyezik a megadott értékkel. Az ETaget idézőjelek között kell megadni.
If-None-Match

string

Választható. ETag-érték vagy speciális helyettesítő karakter ("*") érték. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás ETagje nem egyezik meg a megadott értékkel. Az ETaget idézőjelek között kell megadni.
If-Modified-Since

string

Választható. Egy dátum- és időérték. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás a megadott dátum és idő óta módosult.
If-Unmodified-Since

string

Választható. Egy dátum- és időérték. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás nem lett módosítva a megadott dátum és idő óta.
x-ms-client-request-id

string

Az elemzési naplókban a hibaelhárításhoz és a korrelációhoz rögzített UUID.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-date

string

Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. Erre megosztott kulcs engedélyezésekor van szükség.
x-ms-version

string

A kérelem feldolgozásához használt REST protokoll verzióját adja meg. Erre megosztott kulcs engedélyezésekor van szükség.

Válaszok

Name Típus Description
200 OK

A "renew", "change" vagy "release" művelet sikeres volt.

Headers

  • Date: string
  • ETag: string
  • Last-Modified: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-lease-id: string
201 Created

Létrejött egy új bérlet. A "beszerzés" művelet sikeres volt.

Headers

  • Date: string
  • ETag: string
  • Last-Modified: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-lease-id: string
202 Accepted

A "megszakítás" bérletművelet sikeres volt.

Headers

  • ETag: string
  • Last-Modified: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-lease-time: string
Other Status Codes

DataLakeStorageError

Hiba történt. A lehetséges HTTP-állapotok, -kód- és üzenetsztringek az alábbiakban láthatók:

  • 400 Bad Request, ContentLengthMustBeZero, "A Content-Length kérés fejlécének nullának kell lennie."
  • 400 Bad Request, InvalidAuthenticationInfo, "A hitelesítési adatok nem a megfelelő formátumban adhatók meg. Ellenőrizze az Engedélyezési fejléc értékét."
  • 400 Bad Request, InvalidFlushPosition, "A feltöltött adatok nem folytonosak, vagy a pozíció lekérdezési paraméter értéke nem egyenlő a fájl hosszával a feltöltött adatok hozzáfűzése után."
  • 400 Bad Request, InvalidHeaderValue, "Az egyik HTTP-fejléc értéke nem a megfelelő formátumú."
  • 400 Hibás kérés, ÉrvénytelenHttpVerb, "A megadott HTTP-parancs érvénytelen – a kiszolgáló nem ismeri fel."
  • 400 Bad Request, InvalidInput, "Az egyik kérés bemenete érvénytelen."
  • 400 Bad Request, InvalidPropertyName, "A tulajdonságnév nem lehet üres."
  • 400 Bad Request, InvalidPropertyName, "A tulajdonságnév érvénytelen karaktereket tartalmaz."
  • 400 Bad Request, InvalidQueryParameterValue, "A kérelem URI-jában megadott lekérdezési paraméterek egyikének értéke érvénytelen."
  • 400 Hibás kérelem, InvalidResourceName, "A megadott erőforrásnév érvénytelen karaktereket tartalmaz."
  • 400 Hibás kérelem, InvalidSourceUri, "A forrás URI érvénytelen."
  • 400 Hibás kérelem, InvalidUri, "A kérelem URI-ja érvénytelen."
  • 400 Bad Request, MissingRequiredHeader, "A kéréshez kötelező HTTP-fejléc nincs megadva."
  • 400 Bad Request, MissingRequiredQueryParameter, "A kéréshez kötelező lekérdezési paraméter nincs megadva."
  • 400 Hibás kérés, MultipleConditionHeadersNotSupported, "Több feltételfejléc nem támogatott."
  • 400 Bad Request, OutOfRangeInput, "Az egyik kérés bemenete kívül esik a tartományon."
  • 400 Bad Request, OutOfRangeQueryParameterValue, "A kérelem URI-jában megadott egyik lekérdezési paraméter kívül esik a megengedett tartományon."
  • 400 Bad Request, UnsupportedHeader, "A kérelemben megadott fejlécek egyike nem támogatott."
  • 400 Bad Request, UnsupportedQueryParameter, "A kérelem URI-jában megadott egyik lekérdezési paraméter nem támogatott."
  • 400 Hibás kérés, Nem támogatottRestVersion, "A megadott rest verzió nem támogatott."
  • 403 Tiltott, AccountIsDisabled, "A megadott fiók le van tiltva."
  • 403 Tiltott, AuthorizationFailure, "Ez a kérelem nem jogosult a művelet végrehajtására."
  • 403 Tiltott, InsufficientAccountPermissions: "A hozzáférés alatt álló fiók nem rendelkezik a művelet végrehajtásához szükséges engedélyekkel."
  • 404 Nem található, FilesystemNotFound, "A megadott fájlrendszer nem létezik."
  • 404 Nem található, PathNotFound, "A megadott elérési út nem létezik."
  • 404 Nem található, RenameDestinationParentPathNotFound, "A célútvonal szülőkönyvtára nem létezik."
  • 404 Nem található, ResourceNotFound, "A megadott erőforrás nem létezik."
  • 404 Nem található, SourcePathNotFound, "Az átnevezési művelet forrásútvonala nem létezik."
  • 405 Method Not Allowed, UnsupportedHttpVerb, "Az erőforrás nem támogatja a megadott HTTP-parancsot."
  • 409 Conflict, DestinationPathIsBeingDeleted, "A megadott célútvonal törölendőként van megjelölve."
  • 409 Conflict, DirectoryNotEmpty, "A rekurzív lekérdezési paraméter értékének igaznak kell lennie egy nem üres könyvtár törléséhez."
  • 409 Conflict, FilesystemAlreadyExists, "A megadott fájlrendszer már létezik."
  • 409 Conflict, FilesystemBeingDeleted, "A megadott fájlrendszer törölve van."
  • 409 Conflict, InvalidDestinationPath, "A megadott elérési út vagy az elérési út egy eleme létezik, és az erőforrástípusa érvénytelen ehhez a művelethez." * 409 Conflict, InvalidFlushOperation, "Az erőforrást a Blob Service API hozta létre vagy módosította, és a Data Lake Storage Service API nem tudja írni."
  • 409 Conflict, InvalidRenameSourcePath, "A forráskönyvtár nem lehet ugyanaz, mint a célkönyvtár, és a cél nem lehet a forráskönyvtár alkönyvtára."
  • 409 Conflict, InvalidSourceOrDestinationResourceType, "A forrás és a cél erőforrástípusának azonosnak kell lennie."
  • 409 Conflict, LeaseAlreadyPresent, "Már létezik bérlet."
  • 409 Conflict, LeaseIdMismatchWithLeaseOperation, "A megadott bérletazonosító nem egyezett meg az erőforrás bérletazonosítójával a megadott bérletművelettel."
  • 409 Conflict, LeaseIsAlreadyBroken, "A bérlet már megszakadt, és nem törhető meg újra."
  • 409 Conflict, LeaseIsBreakingAndCannotBeAcquired, "A bérletazonosító megfelelt, de a bérlet jelenleg kompatibilitástörő állapotban van, és nem szerezhető be, amíg meg nem törik."
  • 409 Conflict, LeaseIsBreakingAndCannotBeChanged, "A bérlet azonosítója megfelelt, de a bérlet jelenleg kompatibilitástörő állapotban van, és nem módosítható."
  • 409 Conflict, LeaseIsBrokenAndCannotBeRenewed: "A bérletazonosító megfelelt, de a bérlet explicit módon megszakadt, és nem újítható meg."
  • 409 Conflict, LeaseNameMismatch, "A megadott bérletnév nem egyezett meg a meglévő bérletnévvel."
  • 409 Conflict, LeaseNotPresentWithLeaseOperation, "A bérletazonosító nincs jelen a megadott bérletművelettel."
  • 409 Conflict, PathAlreadyExists, "A megadott elérési út már létezik."
  • 409 Ütközés, PathConflict, "A megadott elérési út vagy az elérési út egy eleme létezik, és az erőforrástípusa érvénytelen ehhez a művelethez."
  • 409 Conflict, SourcePathIsBeingDeleted, "A megadott forrásútvonal törölve van".
  • 409 Conflict, ResourceTypeMismatch, "A kérelemben megadott erőforrástípus nem egyezik meg az erőforrás típusával."
  • 412 Az előfeltétel meghiúsult, ConditionNotMet, "A HTTP feltételes fejléc(ek) használatával megadott feltétel nem teljesül."
  • 412 Az előfeltétel meghiúsult, LeaseIdMismatch, "A megadott bérletazonosító nem egyezett meg az erőforrás bérletazonosítójával."
  • 412 Az előfeltétel meghiúsult, LeaseIdMissing: "Jelenleg bérlet van az erőforráson, és nincs megadva bérletazonosító a kérelemben."
  • 412 Az előfeltétel meghiúsult, LeaseNotPresent: "Jelenleg nincs bérlet az erőforráson."
  • 412 Az előfeltétel meghiúsult, LeaseLost, "A bérletazonosító meg lett adva, de az erőforrás bérlete lejárt."
  • 412 Az előfeltétel sikertelen, SourceConditionNotMet, "A HTTP feltételes fejléc(ek) használatával megadott forrásfeltétel nem teljesül."
  • 413 Request Entity Too Large, RequestBodyTooLarge: "A kérelemtörzs túl nagy, és meghaladja a megengedett maximális korlátot."
  • 416 A kért tartomány nem megfelelő, InvalidRange: "A megadott tartomány érvénytelen az erőforrás aktuális méretéhez."
  • 500 Belső kiszolgálóhiba, InternalError: "A kiszolgáló belső hibát észlelt. Próbálkozzon újra a kéréssel."
  • 500 Belső kiszolgálóhiba, OperationTimedOut: "A művelet nem hajtható végre a megengedett időn belül."
  • 503 Szolgáltatás nem érhető el, ServerBusy: "A kimenő forgalom túllépte a fiókkorlátot."
  • 503 A szolgáltatás nem érhető el, ServerBusy: "A bejövő forgalom túllépte a fiókkorlátot."
  • 503 Szolgáltatás nem érhető el, ServerBusy: "A másodpercenkénti műveletek túllépik a fiókkorlátot."
  • 503 Szolgáltatás nem érhető el, ServerBusy: "A kiszolgáló jelenleg nem tud kéréseket fogadni. Próbálkozzon újra a kéréssel."

Headers

  • x-ms-request-id: string
  • x-ms-version: string

Definíciók

Name Description
DataLakeStorageError
Error

A szolgáltatáshiba-válasz objektum.
PathLeaseAction

Öt bérletművelet létezik: "acquire", "break", "change", "renew" és "release". Az új bérlet beszerzéséhez használja a "acquire" kifejezést, és adja meg az "x-ms-proposed-lease-id" és az "x-ms-lease-duration" értéket. Meglévő bérlet megszakításához használja a "törést". Ha egy bérlet megszakad, a bérletmegszakítási időszak eltelhet, és ez idő alatt a fájlon nem végezhető el a bérletművelet, kivéve a megszakítást és a kiadást. 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. Az aktív bérlet bérletazonosítójának módosításához használja a "change" kifejezést, és adja meg az aktuális bérletazonosítót az "x-ms-lease-id" mezőben, az "x-ms-proposed-lease-id" új bérletazonosítóját pedig. Meglévő bérlet megújításához használja a "renew" (megújítás) lehetőséget, és adja meg az "x-ms-lease-id" azonosítót. A bérlet kiadásához használja a "release" kifejezést, és adja meg az "x-ms-lease-id" azonosítót.

DataLakeStorageError

Name Típus Description
error

Error

A szolgáltatáshiba-válasz objektum.

Error

A szolgáltatáshiba-válasz objektum.

Name Típus Description
code

string

A szolgáltatás hibakódja.
message

string

A szolgáltatás hibaüzenete.

PathLeaseAction

Öt bérletművelet létezik: "acquire", "break", "change", "renew" és "release". Az új bérlet beszerzéséhez használja a "acquire" kifejezést, és adja meg az "x-ms-proposed-lease-id" és az "x-ms-lease-duration" értéket. Meglévő bérlet megszakításához használja a "törést". Ha egy bérlet megszakad, a bérletmegszakítási időszak eltelhet, és ez idő alatt a fájlon nem végezhető el a bérletművelet, kivéve a megszakítást és a kiadást. 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. Az aktív bérlet bérletazonosítójának módosításához használja a "change" kifejezést, és adja meg az aktuális bérletazonosítót az "x-ms-lease-id" mezőben, az "x-ms-proposed-lease-id" új bérletazonosítóját pedig. Meglévő bérlet megújításához használja a "renew" (megújítás) lehetőséget, és adja meg az "x-ms-lease-id" azonosítót. A bérlet kiadásához használja a "release" kifejezést, és adja meg az "x-ms-lease-id" azonosítót.

Name Típus Description
acquire

string

break

string

change

string

release

string

renew

string