上傳檔案區塊

將檔案區塊上傳至映射存放區相對路徑。

使用指定的上傳會話識別碼和映射存放區相對路徑，將檔案區塊上傳至映射存放區。 此 API 可讓使用者繼續檔案上傳作業。 使用者不需要在網路中斷時從頭開始重新開機檔案上傳。 如果檔案大小很大，請使用此選項。

若要執行可繼續的檔案上傳，使用者必須將檔案分成多個區塊，並將這些區塊上傳至映射存放區一對一。 區塊不需要依序上傳。 如果映射存放區相對路徑所代表的檔案已經存在，上傳會話認可時將會覆寫該檔案。

要求

方法	要求 URI
PUT	/ImageStore/{contentPath}/$/UploadChunk?api-version=6.0&session-id={session-id}&timeout={timeout}

參數

名稱	類型	必要	Location
contentPath	字串	是	路徑
Content-Range	字串	Yes	標頭
api-version	字串	是	查詢
session-id	字串 (uuid)	是	查詢
timeout	整數 (int64)	No	查詢

---

contentPath

類型：字串
必要：是

映像存放區中檔案或資料夾與其根的相對路徑。

---

Content-Range

類型：字串
必要：是

將檔案區塊上傳至映射存放區時，必須設定 Content-Range 標頭欄位，並以要求傳送。 格式看起來應該像 「bytes {First-Byte-Position}-{Last-Byte-Position}/{File-Length}」。 例如，Content-Range：bytes 300-5000/20000 表示使用者正在傳送位元組 300 到 5，000，而檔案長度總計為 20，000 個位元組。

---

api-version

類型：字串
必要：是
預設：6.0

API 的版本。 這是必要參數，其值必須是 '6.0'。

Service Fabric REST API 版本是以 API 引進或變更的執行時間版本為基礎。 Service Fabric 執行時間支援多個版本的 API。 這是 API 的最新支援版本。 如果傳遞較低的 API 版本，傳回的回應可能會與本規格中所述的回應不同。

此外，執行時間也接受高於最新支援版本的任何版本，最高為目前版本的執行時間。 因此，如果最新的 API 版本是 6.0，但如果執行時間是 6.1，為了更容易撰寫用戶端，執行時間將會接受該 API 6.1 版。 不過，API 的行為會根據記載的 6.0 版本。

---

session-id

類型：字串 (uuid)
必要：是

使用者針對檔案上傳所產生的 GUID。 它會識別映射存放區上傳會話，以追蹤所有檔案區塊，直到認可為止。

---

timeout

類型：整數 (int64)
必要：否
預設：60
InclusiveMaximum： 4294967295
InclusiveMinimum： 1

用來執行作業的伺服器逾時 (以秒為單位)。 此逾時指定了用戶端願意等候要求作業完成的持續時間。 這個參數的預設值是 60 秒。

回應

HTTP 狀態碼	描述	回應結構描述
200 (確定)	成功的作業會傳回 HTTP 200 OK 狀態碼。
所有其他狀態碼	詳細的錯誤回應。	FabricError