Megosztás a következőn keresztül:

Fájltömb feltöltése

  • Cikk

Feltölt egy fájlrészletet a képtároló relatív elérési útjára.

Feltölt egy fájlrészletet a képtárolóba a megadott feltöltési munkamenet-azonosítóval és a képtároló relatív elérési útjával. Ez az API lehetővé teszi a felhasználó számára a fájlfeltöltési művelet folytatását. a felhasználónak nem kell teljesen újraindítania a fájlfeltöltést, ha hálózati megszakítás történik. Akkor használja ezt a beállítást, ha a fájl mérete nagy.

A folytatható fájlfeltöltés végrehajtásához a felhasználónak több adattömbre kell bontania a fájlt, és egyenként fel kell töltenie ezeket az adattömböket a képtárolóba. Az adattömböket nem kell sorrendben feltölteni. Ha a képtároló relatív elérési útja által képviselt fájl már létezik, a feltöltési munkamenet véglegesítésekor felülírja.

Kérés

Metódus Kérés URI-ja
PUT /ImageStore/{contentPath}/$/UploadChunk?api-version=6.0&session-id={session-id}&timeout={timeout}

Paraméterek

Név Típus Kötelező Hely
contentPath sztring Igen Elérési út
Content-Range sztring Igen Fejléc
api-version sztring Igen Lekérdezés
session-id sztring (uuid) Igen Lekérdezés
timeout egész szám (int64) No Lekérdezés

contentPath

Típus: sztring
Kötelező: Igen

A képtároló fájljának vagy mappájának relatív elérési útja a gyökérkönyvtárból.

Content-Range

Típus: sztring
Kötelező: Igen

Amikor fájltömböket tölt fel a képtárolóba, a Content-Range fejlécmezőt konfigurálni kell, és kéréssel kell elküldeni. A formátumnak a következőképpen kell kinéznie: "bájt {First-Byte-Position}-{Last-Byte-Position}/{File-Length}". A Content-Range:300-5000/20000 például azt jelzi, hogy a felhasználó 300–5000 bájtot küld, a fájl teljes hossza pedig 20 000 bájt.

api-version

Típus: sztring
Kötelező: Igen
Alapértelmezett: 6.0

Az API verziója. Ez a paraméter kötelező, értéke pedig "6.0".

A Service Fabric REST API-verziója azon a futtatókörnyezeti verzión alapul, amelyben az API-t bevezették vagy módosították. A Service Fabric-futtatókörnyezet az API több verzióját is támogatja. Ez az API legújabb támogatott verziója. Ha egy alacsonyabb API-verziót ad át, a visszaadott válasz eltérhet az ebben a specifikációban dokumentálttól.

Emellett a futtatókörnyezet minden olyan verziót elfogad, amely magasabb, mint a legújabb támogatott verzió, egészen a futtatókörnyezet aktuális verziójáig. Tehát ha a legújabb API-verzió a 6.0, de ha a futtatókörnyezet 6.1, az ügyfelek írásának megkönnyítése érdekében a futtatókörnyezet elfogadja az API 6.1-es verzióját. Az API viselkedése azonban a dokumentált 6.0-s verziónak megfelelően fog változni.

session-id

Típus: sztring (uuid)
Kötelező: Igen

A felhasználó által a fájlfeltöltéshez létrehozott GUID. Egy képtároló feltöltési munkamenetét azonosítja, amely nyomon követi az összes fájlrészletet a véglegesítése előtt.

timeout

Típus: egész szám (int64)
Kötelező: Nem
Alapértelmezett: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

A művelet végrehajtásának kiszolgálói időtúllépése másodpercben. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc.

Válaszok

HTTP-állapotkód Description Válaszséma
200 (OK) A sikeres művelet a HTTP 200 OK állapotkódot adja vissza.
Minden más állapotkód A részletes hibaválasz.
 Hálóerror