列出目標機器組中與日志服務(wù)連接正常的機器列表。
接口說明
Host 由 Project 名稱和日志服務(wù) Endpoint 構(gòu)成,您需要在 Host 中指定 Project。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
log:ListMachines | get | *Project acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/machinegroup/{#MachineGroupName} |
| 無 |
請求語法
GET /machinegroups/{machineGroup}/machines HTTP/1.1
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
project | string | 是 | Project 名稱。 | ali-test-project |
machineGroup | string | 是 | 機器組名稱。 | test-group |
offset | integer | 否 | 查詢開始行。默認值為 0。 | 0 |
size | integer | 否 | 分頁查詢時,設(shè)置的每頁行數(shù)。默認值為 100,最大值為 500。 | 10 |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"count": 3,
"total": 8,
"machines": [
{
"ip": "192.168.xx.x",
"machine-uniqueid": "3B70F4F1-80F7-46C4-A6C1-100***CEE647",
"lastHeartbeatTime": 1447182247,
"userdefined-id": "無",
"host-id": "test"
}
]
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
HttpStatusCode | ErrorCode | ErrorMessage | 錯誤碼描述 |
---|---|---|---|
404 | ProjectNotExist | Project does not exist. | Project 不存在。 |
404 | MachineGroupNotExist | MachineGroup groupName does not exist. | 機器組不存在。 |
500 | InternalServerError | Specified Server Error Message. | 內(nèi)部服務(wù)調(diào)用錯誤。 |
更多信息,請參見通用錯誤碼。