İngilizce dilinde oku

Aracılığıyla paylaş

Path - Lease

  • Başvuru
Hizmet:
Storage Services
API Sürümü:
2023-08-03

Kira Yolu
Yola yazma ve silme erişimini kısıtlamak için bir kira oluşturun ve yönetin. Bu işlem koşullu HTTP isteklerini destekler. Daha fazla bilgi için bkz. Blob Hizmeti İşlemleri için Koşullu Üst Bilgileri Belirtme.

POST https://{accountName}.{dnsSuffix}/{filesystem}/{path}
İsteğe bağlı parametrelerle: 
POST https://{accountName}.{dnsSuffix}/{filesystem}/{path}?timeout={timeout}

URI Parametreleri

Name İçinde Gerekli Tür Description
accountName
 path True

string

Azure Depolama hesabı adı.
dnsSuffix
 path True

string

Azure Data Lake Storage uç noktası için DNS son eki.
filesystem
 path True

string

minLength: 3
maxLength: 63
pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$

Dosya sistemi tanımlayıcısı.
path
 path True

string

Dosya veya dizin yolu.
timeout
 query

integer (int32)

minimum: 1

saniye olarak isteğe bağlı bir işlem zaman aşımı değeri. Süre, istek hizmet tarafından alındığında başlar. İşlem tamamlanmadan önce zaman aşımı değeri geçtiğinde işlem başarısız olur.

İstek Başlığı

Name Gerekli Tür Description
x-ms-lease-action True

PathLeaseAction

Beş kiralama eylemi vardır: "acquire", "break", "change", "renew" ve "release". Yeni bir kiralama almak için "acquire" kullanın ve "x-ms-proposed-lease-id" ve "x-ms-lease-duration" belirtin. Mevcut kiralamayı kesmek için "break" kullanın. Kira bozulduğunda, kira kesme süresinin geçmesine izin verilir ve bu süre boyunca dosyada kesme ve serbest bırakma dışında hiçbir kiralama işlemi gerçekleştirilemez. Kira başarıyla kesildiğinde, yanıt yeni bir kira alınıncaya kadar saniye cinsinden aralığı gösterir. Etkin bir kiranın kira kimliğini değiştirmek için "change" komutunu kullanın ve "x-ms-lease-id" içinde geçerli kira kimliğini ve "x-ms-proposed-lease-id" içinde yeni kira kimliğini belirtin. Mevcut kiralamayı yenilemek için "renew" komutunu kullanın ve "x-ms-lease-id" değerini belirtin. Kiralamayı serbest bırakmak için "release" komutunu kullanın ve "x-ms-lease-id" değerini belirtin.
x-ms-lease-duration

integer (int32)

Kira süresi, kiralama almak için gereklidir ve kiranın süresini saniye cinsinden belirtir. Kiralama süresi 15 ile 60 saniye arasında veya sonsuz kiralama için -1 olmalıdır.
x-ms-lease-break-period

integer (int32)

Kira kesme süresi, kirayı kesmek için isteğe bağlıdır ve kiranın kesme süresini saniye cinsinden belirtir. Kira kesme süresi 0 ile 60 saniye arasında olmalıdır.
x-ms-lease-id

string

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

"x-ms-lease-action" "renew", "change" veya "release" olduğunda gereklidir. Yenileme ve sürüm eylemleri için, bunun geçerli kira kimliğiyle eşleşmesi gerekir.
x-ms-proposed-lease-id

string

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

"x-ms-lease-action" "acquire" veya "change" olduğunda gereklidir. İşlem başarılı olursa bu kira kimliğiyle bir kiralama alınır.
If-Match

string

Opsiyonel. ETag değeri. yalnızca kaynağın ETag değeri belirtilen değerle eşleşiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. ETag tırnak içinde belirtilmelidir.
If-None-Match

string

Opsiyonel. ETag değeri veya özel joker karakter ("*") değeri. yalnızca kaynağın ETag değeri belirtilen değerle eşleşmiyorsa işlemi gerçekleştirmek için bu üst bilgiyi belirtin. ETag tırnak içinde belirtilmelidir.
If-Modified-Since

string

Opsiyonel. Bir tarih/saat değeri. yalnızca kaynak belirtilen tarih ve saatten sonra değiştirilmişse işlemi gerçekleştirmek için bu üst bilgiyi belirtin.
If-Unmodified-Since

string

Opsiyonel. Bir tarih/saat değeri. yalnızca kaynak belirtilen tarih ve saatten sonra değiştirilmediyse işlemi gerçekleştirmek için bu üst bilgiyi belirtin.
x-ms-client-request-id

string

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

Sorun giderme ve bağıntı için analiz günlüklerine kaydedilmiş bir UUID.
x-ms-date

string

İstek için Eşgüdümlü Evrensel Saati (UTC) belirtir. Bu, paylaşılan anahtar yetkilendirmesi kullanılırken gereklidir.
x-ms-version

string

İsteği işlemek için kullanılan REST protokolünün sürümünü belirtir. Bu, paylaşılan anahtar yetkilendirmesi kullanılırken gereklidir.

Yanıtlar

Name Tür Description
200 OK

"Yenile", "değiştir" veya "yayın" eylemi başarılı oldu.

Üst Bilgiler

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

Yeni bir kira oluşturuldu. "Alma" eylemi başarılı oldu.

Üst Bilgiler

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

"Kesme" kiralama eylemi başarılı oldu.

Üst Bilgiler

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

DataLakeStorageError

Bir hata oluştu. Olası HTTP durumu, kod ve ileti dizeleri aşağıda listelenmiştir:

  • 400 Hatalı İstek, ContentLengthMustBeZero, "content-length istek üst bilgisi sıfır olmalıdır."
  • 400 Hatalı İstek, InvalidAuthenticationInfo, "Kimlik doğrulama bilgileri doğru biçimde verilmedi. Yetkilendirme üst bilgisinin değerini denetleyin."
  • 400 Hatalı İstek, InvalidFlushPosition, "Karşıya yüklenen veriler bitişik değil veya konum sorgu parametresi değeri, karşıya yüklenen verileri ekledikten sonra dosyanın uzunluğuna eşit değil."
  • 400 Hatalı İstek, InvalidHeaderValue, "HTTP üst bilgilerinden birinin değeri doğru biçimde değil."
  • 400 Hatalı İstek, GeçersizHttpVerb, "Belirtilen HTTP fiili geçersiz- sunucu tarafından tanınmıyor."
  • 400 Hatalı İstek, InvalidInput, "İstek girişlerinden biri geçerli değil."
  • 400 Hatalı İstek, InvalidPropertyName, "Özellik adı boş olamaz."
  • 400 Hatalı İstek, InvalidPropertyName, "Özellik adı geçersiz karakterler içeriyor."
  • 400 Hatalı İstek, InvalidQueryParameterValue, "İstek URI'sinde belirtilen sorgu parametrelerinden birinin değeri geçersiz."
  • 400 Hatalı İstek, InvalidResourceName, "Belirtilen kaynak adı geçersiz karakterler içeriyor."
  • 400 Hatalı İstek, InvalidSourceUri, "Kaynak URI geçersiz."
  • 400 Hatalı İstek, InvalidUri, "İstek URI'si geçersiz."
  • 400 Hatalı İstek, MissingRequiredHeader, "Bu istek için zorunlu olan bir HTTP üst bilgisi belirtilmemiş."
  • 400 Hatalı İstek, MissingRequiredQueryParameter, "Bu istek için zorunlu olan bir sorgu parametresi belirtilmedi."
  • 400 Hatalı İstek, MultipleConditionHeadersNotSupported, "Birden çok koşul üst bilgisi desteklenmiyor."
  • 400 Hatalı İstek, OutOfRangeInput, "İstek girişlerinden biri aralık dışında."
  • 400 Hatalı İstek, OutOfRangeQueryParameterValue, "İstek URI'sinde belirtilen sorgu parametrelerinden biri izin verilen aralığın dışında."
  • 400 Hatalı İstek, DesteklenmeyenHeader, "İstekte belirtilen üst bilgilerden biri desteklenmiyor."
  • 400 Hatalı İstek, DesteklenmeyenQueryParameter, "İstek URI'sinde belirtilen sorgu parametrelerinden biri desteklenmiyor."
  • 400 Hatalı İstek, UnsupportedRestVersion, "Belirtilen Rest Sürümü Desteklenmiyor."
  • 403 Yasak, AccountIsDisabled, "Belirtilen hesap devre dışı."
  • 403 Yasak, AuthorizationFailure, "Bu isteğin bu işlemi gerçekleştirme yetkisi yok."
  • 403 Yasak, InsufficientAccountPermissions, "Erişilen hesap bu işlemi yürütmek için yeterli izinlere sahip değil."
  • 404 Bulunamadı, DosyaSistemNotFound, "Belirtilen dosya sistemi yok."
  • 404 Bulunamadı, PathNotFound, "Belirtilen yol yok."
  • 404 Bulunamadı, RenameDestinationParentPathNotFound, "Hedef yolun üst dizini yok."
  • 404 Bulunamadı, ResourceNotFound, "Belirtilen kaynak yok."
  • 404 Bulunamadı, SourcePathNotFound, "Yeniden adlandırma işleminin kaynak yolu yok."
  • 405 Yöntemine İzin Verilmiyor, DesteklenmiyorHttpVerb, "Kaynak belirtilen HTTP fiilini desteklemiyor."
  • 409 Conflict, DestinationPathIsBeingDeleted, "Belirtilen hedef yol silinmek üzere işaretlenmiş."
  • 409 Conflict, DirectoryNotEmpty, "Boş olmayan bir dizini silmek için özyinelemeli sorgu parametre değeri true olmalıdır."
  • 409 Conflict, FilesystemAlreadyExists, "Belirtilen dosya sistemi zaten var."
  • 409 Conflict, FilesystemBeingDeleted, "Belirtilen dosya sistemi siliniyor."
  • 409 Conflict, InvalidDestinationPath, "Belirtilen yol veya yolun bir öğesi var ve kaynak türü bu işlem için geçersiz." * 409 Conflict, InvalidFlushOperation, "Kaynak Blob Hizmeti API'si tarafından oluşturuldu veya değiştirildi ve Data Lake Storage Hizmeti API'si tarafından yazılamaz."
  • 409 Conflict, InvalidRenameSourcePath, "Kaynak dizin, hedef dizinle aynı olamaz ve hedef, kaynak dizinin alt dizini olamaz."
  • 409 Conflict, InvalidSourceOrDestinationResourceType, "Kaynak ve hedef kaynak türü aynı olmalıdır."
  • 409 Conflict, LeaseAlreadyPresent, "Zaten bir kira var."
  • 409 Conflict, LeaseIdMismatchWithLeaseOperation, "Belirtilen kira kimliği belirtilen kiralama işlemine sahip kaynağın kira kimliğiyle eşleşmedi."
  • 409 Conflict, LeaseIsAlreadyBroken, "Kira zaten bozuk ve yeniden bozulamaz."
  • 409 Conflict, LeaseIsBreakingAndCannotBeAcquired, "Kira kimliği eşleşti, ancak kira şu anda bozuluyor ve bozulana kadar alınamıyor."
  • 409 Conflict, LeaseIsBreakingAndCannotBeChanged, "Kira kimliği eşleşti, ancak kira şu anda kırılıyor ve değiştirilemez."
  • 409 Conflict, LeaseIsBrokenAndCannotBeRenewed, "Kira kimliği eşleşti, ancak kira açıkça bozuldu ve yenilenemiyor."
  • 409 Conflict, LeaseNameMismatch, "Belirtilen kira adı varolan kira adıyla eşleşmedi."
  • 409 Conflict, LeaseNotPresentWithLeaseOperation, "Kira kimliği belirtilen kiralama işlemiyle birlikte yok."
  • 409 Conflict, PathAlreadyExists, "Belirtilen yol zaten var."
  • 409 Conflict, PathConflict, "Belirtilen yol veya yolun bir öğesi var ve kaynak türü bu işlem için geçersiz."
  • 409 Conflict, SourcePathIsBeingDeleted, "Belirtilen kaynak yol silinecek şekilde işaretlendi."
  • 409 Conflict, ResourceTypeMismatch, "İstekte belirtilen kaynak türü kaynağın türüyle eşleşmiyor."
  • 412 Önkoşul Başarısız Oldu, ConditionNotMet, "HTTP koşullu üst bilgileri kullanılarak belirtilen koşul karşılanmadı."
  • 412 Önkoşul Başarısız Oldu, LeaseIdMismatch, "Belirtilen kira kimliği kaynağın kira kimliğiyle eşleşmedi."
  • 412 Önkoşul Başarısız Oldu, LeaseIdMissing, "Kaynakta şu anda bir kira var ve istekte kira kimliği belirtilmedi."
  • 412 Önkoşul Başarısız Oldu, LeaseNotPresent, "Şu anda kaynakta kira yok."
  • 412 Önkoşul Başarısız Oldu, LeaseLost, "Kira kimliği belirtildi, ancak kaynak için kiranın süresi doldu."
  • 412 Önkoşul Başarısız, SourceConditionNotMet, "HTTP koşullu üst bilgileri kullanılarak belirtilen kaynak koşul karşılanmadı."
  • 413 İstek Varlığı Çok Büyük, RequestBodyTooLarge, "İstek gövdesi çok büyük ve izin verilen maksimum sınırı aşıyor."
  • 416 İstenen Aralık Satisfiable Değil, InvalidRange, "Belirtilen aralık kaynağın geçerli boyutu için geçersiz."
  • 500 İç Sunucu Hatası, InternalError, "Sunucu bir iç hatayla karşılaştı. Lütfen isteği yeniden deneyin."
  • 500 İç Sunucu Hatası, OperationTimedOut, "İşlem izin verilen süre içinde tamamlanamadı."
  • 503 Hizmet Kullanılamıyor, ServerBusy, "Çıkış hesap sınırını aştı."
  • 503 Hizmet Kullanılamıyor, ServerBusy, "Giriş hesap sınırını aştı."
  • 503 Hizmet Kullanılamıyor, ServerBusy, "Saniyedeki işlemler hesap sınırını aşmış."
  • 503 Hizmet Kullanılamıyor, ServerBusy, "Sunucu şu anda istekleri alamıyor. Lütfen isteğinizi yeniden deneyin."

Üst Bilgiler

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

Tanımlar

Name Description
DataLakeStorageError
Error

Hizmet hatası yanıt nesnesi.
PathLeaseAction

Beş kiralama eylemi vardır: "acquire", "break", "change", "renew" ve "release". Yeni bir kiralama almak için "acquire" kullanın ve "x-ms-proposed-lease-id" ve "x-ms-lease-duration" belirtin. Mevcut kiralamayı kesmek için "break" kullanın. Kira bozulduğunda, kira kesme süresinin geçmesine izin verilir ve bu süre boyunca dosyada kesme ve serbest bırakma dışında hiçbir kiralama işlemi gerçekleştirilemez. Kira başarıyla kesildiğinde, yanıt yeni bir kira alınıncaya kadar saniye cinsinden aralığı gösterir. Etkin bir kiranın kira kimliğini değiştirmek için "change" komutunu kullanın ve "x-ms-lease-id" içinde geçerli kira kimliğini ve "x-ms-proposed-lease-id" içinde yeni kira kimliğini belirtin. Mevcut kiralamayı yenilemek için "renew" komutunu kullanın ve "x-ms-lease-id" değerini belirtin. Kiralamayı serbest bırakmak için "release" komutunu kullanın ve "x-ms-lease-id" değerini belirtin.

DataLakeStorageError

Object
Name Tür Description
error

Error

Hizmet hatası yanıt nesnesi.

Error

Object

Hizmet hatası yanıt nesnesi.

Name Tür Description
code

string

Hizmet hata kodu.
message

string

Hizmet hata iletisi.

PathLeaseAction

Listeleme

Beş kiralama eylemi vardır: "acquire", "break", "change", "renew" ve "release". Yeni bir kiralama almak için "acquire" kullanın ve "x-ms-proposed-lease-id" ve "x-ms-lease-duration" belirtin. Mevcut kiralamayı kesmek için "break" kullanın. Kira bozulduğunda, kira kesme süresinin geçmesine izin verilir ve bu süre boyunca dosyada kesme ve serbest bırakma dışında hiçbir kiralama işlemi gerçekleştirilemez. Kira başarıyla kesildiğinde, yanıt yeni bir kira alınıncaya kadar saniye cinsinden aralığı gösterir. Etkin bir kiranın kira kimliğini değiştirmek için "change" komutunu kullanın ve "x-ms-lease-id" içinde geçerli kira kimliğini ve "x-ms-proposed-lease-id" içinde yeni kira kimliğini belirtin. Mevcut kiralamayı yenilemek için "renew" komutunu kullanın ve "x-ms-lease-id" değerini belirtin. Kiralamayı serbest bırakmak için "release" komutunu kullanın ve "x-ms-lease-id" değerini belirtin.

Değer Description
acquire
break
change
release
renew