依名稱取得應用程式類型資訊清單

發行項
07/19/2023

取得 Service Fabric 叢集中完全符合指定名稱的應用程式類型清單。

傳回 Service Fabric 叢集中已佈建或正在佈建之應用程式類型的相關資訊。這些結果會是名稱完全符合指定為參數之名稱且符合所指定查詢參數的應用程式類型。會傳回符合應用程式類型名稱之應用程式類型的所有版本，而且每一個版本都會傳回為一個應用程式類型。回應包括名稱、版本、狀態，以及應用程式類型的其他詳細資料。這是分頁式查詢，表示如果並非所有應用程式類型都可以放入一頁，則會傳回一頁結果，以及可用來取得下一頁的接續權杖。例如，如果有 10 個應用程式類型，但一頁只能容納前 3 個應用程式類型，或結果數目上限已設定為 3，則會傳回 3 個。若要存取其餘的結果，請在下一個查詢中使用所傳回的接續權杖來取出後續頁面。如果沒有後續頁面，則會傳回空的接續權杖。

要求

方法	要求 URI
GET	`/ApplicationTypes/{applicationTypeName}?api-version=6.0&ApplicationTypeVersion={ApplicationTypeVersion}&ExcludeApplicationParameters={ExcludeApplicationParameters}&ContinuationToken={ContinuationToken}&MaxResults={MaxResults}&timeout={timeout}`

參數

名稱	類型	必要	Location
`applicationTypeName`	字串	是	路徑
`api-version`	字串	是	查詢
`ApplicationTypeVersion`	字串	No	查詢
`ExcludeApplicationParameters`	boolean	No	查詢
`ContinuationToken`	字串	No	查詢
`MaxResults`	整數 (int64)	No	查詢
`timeout`	整數 (int64)	No	查詢

`applicationTypeName`

類型：字串
必要：是

應用程式類型的名稱。

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

`ApplicationTypeVersion`

類型：字串
必要：否

應用程式類型的版本。

`ExcludeApplicationParameters`

類型：布林值
必要：否
預設：false

指定是否將從結果中排除應用程式參數的旗標。

`ContinuationToken`

類型：字串
必要：否

接續權杖參數可用來取得下一組結果。當來自系統的結果無法放入單一回應中時，API 的回應中會包含具有非空白值的接續權杖。當此值傳遞至下一個 API 呼叫時，API 會傳回下一組結果。如果沒有任何進一步的結果，接續權杖就不會包含值。此參數的值不能經過 URL 編碼。

`MaxResults`

類型：整數 (int64)
必要：否
預設：0
InclusiveMinimum： 0

分頁式查詢時傳回的最大結果數目。此參數定義傳回結果數目的上限。根據設定中所定義的訊息大小限制上限，如果所傳回的結果無法放入訊息中，則它們可以小於指定的結果上限。如果此參數為零或未指定，則分頁式查詢會在傳回訊息中盡可能包含較多結果。

`timeout`

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

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

回應

HTTP 狀態碼	描述	回應結構描述
200 (確定)	叢集中的應用程式類型清單。	PagedApplicationTypeInfoList
所有其他狀態碼	詳細的錯誤回應。	FabricError

共用方式為