マシングループ情報を更新します。マシン グループに設定を適用した場合、マシンがマシングループに追加または削除を行うと、設定が自動的に追加または削除されます。
例:
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"
}