設定を適用するマシンを一覧表示します。
例:
GET /configs/{configName}/machinegroups
リクエスト構文
GET /configs/{configName}/machinegroups HTTP/1.1
Authorization: <AuthorizationString>
Date: <GMT Date>
Host: <Project Endpoint>
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1
リクエストパラメーター
URL パラメーター:
パラメーター名 | データ型 | 必須/省略可能 | 説明 |
---|---|---|---|
ConfigName | string | 必須 | 設定名 |
GetAppliedMachineGroups API には特別なレスポンスヘッダーはありません。 Log Service API のパブリックリクエストヘッダーの詳細については、「パブリックリクエストヘッダー」をご参照ください。
レスポンスヘッダーGetAppliedMachineGroups API には特別なレスポンスヘッダーはありません。 Log Service API のパブリックレスポンスヘッダーの詳細については、「パブリックレスポンスヘッダー」をご参照ください。
レスポンス要素リクエストが成功すると、レスポンスボディには特定のマシングループのすべてのマシンの一覧が含まれます。 次の形式で 一覧表示します。
エラーコード
名前 | データ型 | 説明 |
---|---|---|
count | Integer | 返されるマシン グループの数。 |
machinegroups | String Array | 返されるマシングループの名前一覧。 |
{
"count":2,
"machinegroups":
["group1","group2"]
}
また、 一般的なエラーコード に加えて、GetAppliedMachineGroups API から以下の特別なエラーコードが返される場合があります。
HTTP ステータスコード | エラーコード | エラー メッセージ |
---|---|---|
404 | GroupNotExist | group {GroupName} が存在しません。 |
500 | InternalServerError | 内部サーバーエラー |
例
リクエスト例:
GET /configs/logtail-config-sample/machinegroups
Header:
{
"Content-Length": 0,
"x-log-signaturemethod": "hmac-sha1",
"x-log-bodyrawsize": 0,
"User-Agent": "log-python-sdk-v-0.6.0",
"Host": "ali-test-project.cn-hangzhou-devcommon-intranet.sls.aliyuncs.com",
"Date": "Mon, 09 Nov 2015 09:51:38 GMT",
"x-log-apiversion": "0.6.0",
"Authorization": "LOG <yourAccessKeyId>:<yourSignature>"
}
レスポンス例
Header :
{
"content-length": "41",
"server": "nginx/1.6.1",
"connection": "close",
"date": "Mon, 09 Nov 2015 09:51:38 GMT",
"content-type": "application/json",
"x-log-requestid": "56406CAA99248CAA230BE828"
}
Body:
{
"count": 1,
"machinegroups":
[
"sample-group"
]
}