查詢已綁定配額服務器
更新時間 2025-07-09 15:29:13
最近更新時間: 2025-07-09 15:29:13
分享文章
接口功能介紹
綁定了企業版配額的自選服務器列表
接口約束
此功能為收費功能。確認已經購買系統配額，并且開啟服務器防護。如果沒有購買配額，可按照頁面提示進行購買。如果沒有開啟防護，請在服務器列表頁開啟機器防護。
URI
POST /v1/quota/quotaHosts
路徑參數
無
Query參數
無
請求參數
請求頭header參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| regionid | 是 | String | 資源池id | 100054c0416811e9a6690242ac110002 | |
| urlType | 是 | String | 請求地址類型。CTAPI | CTAPI | |
| Content-Type | 是 | String | Content-Type | application/json |
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| currentPage | 是 | Integer | 當前頁 | 1 | |
| pageSize | 是 | Integer | 每頁條數 | 10 | |
| param | 否 | String | param為服務器名稱或ip，允許任意字符或數字，也可以為空。1-服務器名稱 2-服務器ip 5-agentGuid | cust | |
| azName | 否 | String | AZ名稱；azName包含數字、字母和特殊符號 | 1 | |
| regionId | 否 | String | 區域ID | 9035c530814611e990660242ac110002 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | String | 狀態碼 200-成功 | ||
| error | String | 返回碼CTCSSCN_000000 :成功;CTCSSCN_000001:失敗;CTCSSCN_000003：用戶未簽署協議，安全衛士系統無法正常使用;CTCSSCN_000004：鑒權錯誤;CTCSSCN_000005：用戶沒有付費版配額，功能不可用 | CTCSSCN_000000 | |
| message | String | 返回信息 | 成功 | |
| returnObj | Object | 返回對象 | map |
表 map
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| total | Integer | 總記錄數 | 100 | |
| pageNum | Integer | 頁碼 | 1 | |
| pageSize | Integer | 頁大小 | 10 | |
| list | Array of Objects | 服務器列表信息 | serverlist | |
| pages | Integer | 總頁數 | 1 |
表 serverlist
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| agentGuid | String | AgentGuid | 2F828AAE-55BF-410D-B393-C053AC8742F4 | |
| custName | String | 服務器名稱 | vm-1634888455-0003 | |
| agentIp | String | 私網IP | 172.31.0.71 | |
| status | Integer | 服務器狀態，開機中,重啟中,升級中,已關機,運行中,重建中,錯誤,已凍結,已到期,刪除中,關機中 | 1 |
枚舉參數
無
請求示例
請求url
無
請求頭header
{"regionid": "100054c0416811e9a6690242ac110002","Content-Type":"application/json","urlType": "CTAPI"}
請求體body
{"currentPage":1,"pageSize":10,"param":"192.168.0.97","paramType":"2"}
響應示例
{"statusCode": "200","error": "CTCSSCN_000000","message": "查詢成功!","returnObj": {"total": 1,"list": [{"agentGuid": "1DA7B4D3-70BA-4038-B161-A90C7BF74DE1","custName": "P-96b7-gOMI","agentIp": "192.168.0.97","status": "運行中"}],"pageNum": 1,"pageSize": 10,"size": 0,"startRow": 0,"endRow": 0,"pages": 0,"prePage": 0,"nextPage": 0,"isFirstPage": false,"isLastPage": false,"hasPreviousPage": false,"hasNextPage": false,"navigatePages": 0,"navigatepageNums": null,"navigateFirstPage": 0,"navigateLastPage": 0}}
狀態碼
請參考
錯誤碼
請參考
