マシングループ情報を更新します。マシン グループに設定を適用した場合、マシンがマシングループに追加または削除を行うと、設定が自動的に追加または削除されます。

例：

PUT /machinegroups/{groupName}

リクエスト構文

PUT /machinegroups/{groupName} HTTP/1.1
Authorization: <AuthorizationString> 
Content-Type:application/json
Content-Length:<Content Length>
Content-MD5<:<Content MD5>
Date: <GMT Date>
Host: <Project Endpoint>
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1
{
    "groupName": "test-machine-group",
    "groupType" : "",
    "groupAttribute" : {
        "externalName" : "testgroup",
        "groupTopic": "testgrouptopic"
    },
    "machineIdentifyType" : "ip",
    "machineList" : [
        "test-ip1",
        "test-ip2"
    ]
}

リクエストパラメーター

URL パラメーター：
パラメータ名 データ型 必須/省略可能 説明
groupName string 必須 マシン グループ名
ボディパラメータ：
属性名 データ型 必須/省略可能 説明
groupName String 必須 同じプロジェクト内で一意のマシングループ名。
groupType string 省略可能 マシン グループタイプ (デフォルトは空)
machineIdentifyType string 必須 IP およびユーザー定義 ID を含むマシン識別タイプ。
groupAttribute object 必須 マシングループ属性 (デフォルトは空)
machineList array 必須 IP アドレスまたはユーザー定義 ID を指定できる特定のマシン ID。
groupAttribute の説明
属性名 データ型 必須/省略可能 説明
groupTopic string 省略可能 マシン グループのトピック (デフォルトは空)
externalName string 省略可能 マシングループが依存する外部 ID (デフォルトは空)
リクエストヘッダー

UpdateMachineGroup API には特別なレスポンスヘッダーはありません。 Log Service API のパブリックリクエストヘッダーの詳細については、「パブリックリクエストヘッダー」をご参照ください。

レスポンスヘッダー

UpdateMachineGroup API には特別なレスポンスヘッダーはありません。 Log Service API のパブリックレスポンスヘッダーの詳細については、「パブリックレスポンスヘッダー」をご参照ください。

レスポンス要素

返される HTTP ステータス コードは 200 です。

エラーコード

Log Service API の 一般的なエラー コード の他に、 UpdateMachineGroup API から次の特殊なエラー コードが返される場合があります。

HTTP ステータスコード エラーコード エラーメッセージ
404 GroupNotExist グループ {GroupName} が存在しません
400 InvalidParameter 無効なグループ リソース json
500 InternalServerError 内部サーバー エラー

例

リクエスト例 
PUT /machinegroups/test-machine-group HTTP/1.1
Header :
{
    "x-log-apiversion": "0.6.0",
    "Authorization": "LOG <yourAccessKeyId>:<yourSignature>",
    "Host": "ali-test-project.cn-hangzhou-devcommon-intranet.sls.aliyuncs.com",
    "Date": "Tue, 10 Nov 2015 18:41:43 GMT",
    "Content-Length": "194",
    "x-log-signaturemethod": "hmac-sha1",
    "Content-MD5": "2CEBAEBE53C078891527CB70A855BAF4",
    "User-Agent": "sls-java-sdk-v-0.6.0",
    "Content-Type": "application/json",
    "x-log-bodyrawsize": "0"
}
Body :
{
    "groupName": "test-machine-group",
    "groupType": "",
    "machineIdentifyType": "userdefined",
    "groupAttribute": {
        "groupTopic": "testtopic2",
        "externalName": "testgroup2"
    },
    "machineList": [
        "uu_id_1",
        "uu_id_2"
    ]
}
レスポンス例： 
HTTP/1.1 200 OK
Header :
{
    "Date": "Tue, 10 Nov 2015 18:41:43 GMT",
    "Content-Length": "0",
    "x-log-requestid": "56423A6799248CA57B00035C",
    "Connection": "close",
    "Server": "nginx/1.6.1"
}