依識別碼取得映射存放區上傳會話

發行項
08/05/2023

依識別碼取得映射存放區上傳會話。

取得由指定識別碼識別的映射存放區上傳會話。使用者可以在上傳期間隨時查詢上傳會話。

要求

方法	要求 URI
GET	`/ImageStore/$/GetUploadSession?api-version=6.0&session-id={session-id}&timeout={timeout}`

參數

名稱	類型	必要	Location
`api-version`	字串	是	查詢
`session-id`	字串 (uuid)	是	查詢
`timeout`	整數 (int64)	No	查詢

`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 (確定)	成功的作業會傳回 200 狀態碼和要求的影像存放區上傳會話資訊。	UploadSession
所有其他狀態碼	詳細的錯誤回應。	FabricError

範例

依指定的識別碼取得映射存放區上傳會話的相關資訊

此範例示範如何依指定的識別碼取得影像存放區上傳會話。

要求

GET http://localhost:19080/ImageStore/$/GetUploadSession?api-version=6.0&session-id=4a2340e8-d8d8-497c-95fe-cdaa1052f33b

200 回應

主體

{
  "UploadSessions": [
    {
      "StoreRelativePath": "SwaggerTest\\Common.dll",
      "SessionId": "4a2340e8-d8d8-497c-95fe-cdaa1052f33b",
      "FileSize": "2097152",
      "ModifiedDate": "2017-09-28T17:06:37.26Z",
      "ExpectedRanges": [
        {
          "StartPosition": "0",
          "EndPosition": "402128"
        },
        {
          "StartPosition": "730105",
          "EndPosition": "2097151"
        }
      ]
    }
  ]
}

共用方式為