解析服務

發行項
07/19/2023

解析 Service Fabric 資料分割。

解析 Service Fabric 服務分割區，以取得服務複本的端點。

要求

方法	要求 URI
GET	`/Services/{serviceId}/$/ResolvePartition?api-version=6.0&PartitionKeyType={PartitionKeyType}&PartitionKeyValue={PartitionKeyValue}&PreviousRspVersion={PreviousRspVersion}&timeout={timeout}`

參數

名稱	類型	必要	Location
`serviceId`	字串	是	路徑
`api-version`	字串	是	查詢
`PartitionKeyType`	整數	No	查詢
`PartitionKeyValue`	字串	No	查詢
`PreviousRspVersion`	字串	No	查詢
`timeout`	整數 (int64)	No	查詢

`serviceId`

類型：字串
必要：是

服務的身分識別。此識別碼通常是不含 'fabric:' URI 配置的服務完整名稱。從 6.0 版開始，階層的名稱會以 "~" 字元分隔。例如，如果服務名稱是 "fabric:/myapp/app1/svc1"，那麼在 6.0 以上的版本中，服務識別為 "myapp~app1~svc1"，在舊版中則為 "myapp/app1/svc1"。

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

`PartitionKeyType`

類型：整數
必要：否

資料分割的索引鍵類型。如果服務的分割區配置是 Int64Range 或 Named，就必須設定此參數。可能的值如下。

無 (1) - 表示未指定 PartitionKeyValue 參數。這適用於分割區配置為 Singleton 的分割區。這是預設值。值為 1。
Int64Range (2) - 指出 PartitionKeyValue 參數是 int64 資料分割索引鍵。這適用於分割區配置為 Int64Range 的分割區。值為 2。
具名 (3) - 指出 PartitionKeyValue 參數是分割區的名稱。這適用於分割區配置為 Named 的分割區。此值為 3。

`PartitionKeyValue`

類型：字串
必要：否

資料分割索引鍵。如果服務的分割區配置是 Int64Range 或 Named，就必須設定此項目。這不是分割區識別碼，而是整數金鑰值或分割區識別碼的名稱。例如，如果您的服務使用從 0 到 10 的定界分割，它們的 PartitionKeyValue 就會是該範圍內的整數。請查詢服務描述以查看範圍或名稱。

`PreviousRspVersion`

類型：字串
必要：否

先前所收到回應中 [版本] 欄位的值。如果使用者知道先前取得的結果已過時，就必須設定此項目。

`timeout`

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

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

回應

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

共用方式為