Dosya Öbeklerini Karşıya Yükle

Makale
08/05/2023

Görüntü deposu göreli yoluna bir dosya öbekleri yükler.

Belirtilen karşıya yükleme oturumu kimliği ve görüntü deposu göreli yolu ile görüntü deposuna bir dosya öbekleri yükler. Bu API, kullanıcının dosya yükleme işlemini sürdürmesine olanak tanır. ağ kesintisi olduğunda kullanıcının karşıya yüklemeyi sıfırdan yeniden başlatması gerekmez. Dosya boyutu büyükse bu seçeneği kullanın.

Devam ettirilebilir bir dosya karşıya yükleme işlemi gerçekleştirmek için kullanıcının dosyayı birden çok öbeklere ayırması ve bu öbekleri tek tek görüntü deposuna yüklemesi gerekir. Öbeklerin sırayla karşıya yüklenmesi gerekmez. Görüntü deposu göreli yolu tarafından temsil edilen dosya zaten varsa, karşıya yükleme oturumu işlendiğinde dosyanın üzerine yazılır.

İstek

Yöntem	İstek URI'si
PUT	`/ImageStore/{contentPath}/$/UploadChunk?api-version=6.0&session-id={session-id}&timeout={timeout}`

Parametreler

Ad	Tür	Gerekli	Konum
`contentPath`	string	Yes	Yol
`Content-Range`	string	Yes	Üst bilgi
`api-version`	string	Yes	Sorgu
`session-id`	dize (uuid)	Yes	Sorgu
`timeout`	integer (int64)	No	Sorgu

`contentPath`

Tür: dize
Gerekli: Evet

Görüntü deposundaki dosya veya klasörün kökünden göreli yolu.

`Content-Range`

Tür: dize
Gerekli: Evet

Görüntü deposuna dosya öbekleri yüklenirken İçerik Aralığı üst bilgi alanının yapılandırılması ve istekle gönderilmesi gerekir. Biçim "bayt {First-Byte-Position}-{Last-Byte-Position}/{File-Length}" gibi görünmelidir. Örneğin, Content-Range:bytes 300-5000/20000, kullanıcının 300 ile 5.000 arasında bayt gönderdiğini ve toplam dosya uzunluğunun 20.000 bayt olduğunu gösterir.

`api-version`

Tür: dize
Gerekli: Evet
Varsayılan: 6.0

API sürümü. Bu parametre gereklidir ve değeri '6.0' olmalıdır.

Service Fabric REST API sürümü, API'nin tanıtıldığı veya değiştirildiği çalışma zamanı sürümünü temel alır. Service Fabric çalışma zamanı API'nin birden fazla sürümünü destekler. Bu, API'nin desteklenen en son sürümüdür. Daha düşük bir API sürümü geçirilirse, döndürülen yanıt bu belirtimde belgelenenden farklı olabilir.

Buna ek olarak çalışma zamanı, çalışma zamanının geçerli sürümüne kadar desteklenen en son sürümden daha yüksek olan tüm sürümleri kabul ediyor. Bu nedenle, en son API sürümü 6.0 ise ancak çalışma zamanı 6.1 ise, istemcileri yazmayı kolaylaştırmak için çalışma zamanı bu API için sürüm 6.1'i kabul eder. Ancak API'nin davranışı, belgelenen 6.0 sürümüne göre olacaktır.

`session-id`

Tür: dize (uuid)
Gerekli: Evet

Dosya karşıya yükleme için kullanıcı tarafından oluşturulan GUID. İşlenene kadar tüm dosya öbeklerini izleyen bir görüntü deposu karşıya yükleme oturumu tanımlar.

`timeout`

Tür: tamsayı (int64)
Gerekli: Hayır
Varsayılan: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

İşlemi saniyeler içinde gerçekleştirmek için sunucu zaman aşımı. Bu zaman aşımı, istemcinin istenen işlemin tamamlanmasını beklemeye istekli olduğu süreyi belirtir. Bu parametre için varsayılan değer 60 saniyedir.

Yanıtlar

HTTP Durum Kodu	Description	Yanıt Şeması
200 (Tamam)	Başarılı bir işlem HTTP 200 Tamam durum kodunu döndürür.
Diğer tüm durum kodları	Ayrıntılı hata yanıtı.	Doku Oluşturucu

Aracılığıyla paylaş