共用方式為


上傳檔案

將檔案的內容上傳至映射存放區。

將檔案的內容上傳至映射存放區。 如果檔案夠小而足以在連線失敗時再次上傳,請使用此 API。 檔案的資料必須新增至要求本文。 內容將會上傳至指定的路徑。 映射存放區服務會使用標記檔案來指出資料夾的可用性。 標記檔案是名為 「_.dir」 的空白檔案。 上傳資料夾中的所有檔案時,影像存放區服務會產生標記檔案。 使用 File-by-File 方法在 REST 中上傳應用程式套件時,映射存放區服務不知道應用程式套件的檔案階層;您需要為每個資料夾建立標記檔案,並最後上傳它,讓影像存放區服務知道資料夾已完成。

要求

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

參數

名稱 類型 必要 Location
contentPath 字串 路徑
api-version 字串 查詢
timeout 整數 (int64) No 查詢

contentPath

類型:字串
必要:是

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


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 版本。


timeout

類型:整數 (int64)
必要:否
預設60
InclusiveMaximum4294967295
InclusiveMinimum1

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

回應

HTTP 狀態碼 描述 回應結構描述
200 (確定) 如果上傳要求成功,伺服器會傳回 HTTP 200 OK 狀態碼。
所有其他狀態碼 詳細的錯誤回應。
FabricError