依名稱取得已部署的服務套件資訊清單

發行項
08/05/2023

取得 Service Fabric 節點上所部署且完全符合指定名稱的服務套件清單。

針對指定應用程式，傳回 Service Fabric 節點上所部署服務套件的相關資訊。針對名稱與參數所指定服務套件名稱完全相符的服務套件，這些是其結果。

要求

方法	要求 URI
GET	`/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetServicePackages/{servicePackageName}?api-version=6.0&timeout={timeout}`

參數

名稱	類型	必要	Location
`nodeName`	字串	是	路徑
`applicationId`	字串	是	路徑
`servicePackageName`	字串	是	路徑
`api-version`	字串	是	查詢
`timeout`	整數 (int64)	No	查詢

`nodeName`

類型：字串
必要：是

節點的名稱。

`applicationId`

類型：字串
必要：是

應用程式的身分識別。這通常是沒有 'fabric:' URI 配置之應用程式的完整名稱。從 6.0 版開始，階層的名稱會以 "~" 字元分隔。例如，如果應用程式名稱是 "fabric:/myapp/app1"，則應用程式識別在 6.0+ 中會是 "myapp~app1"，而在舊版中會是 "myapp/app1"。

`servicePackageName`

類型：字串
必要：是

服務套件的名稱。

`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
InclusiveMaximum： 4294967295
InclusiveMinimum： 1

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

回應

HTTP 狀態碼	描述	回應結構描述
200 (確定)	成功的作業會傳回 200 狀態碼和已部署的服務套件資訊清單。	DeployedServicePackageInfo的陣列
204 (NoContent)	如果未在節點上部署來自應用程式的指定服務套件，則會傳回空的回應。
所有其他狀態碼	詳細的錯誤回應。	FabricError

共用方式為