設定を適用するマシンを一覧表示します。

例：

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"
    ]
}