リクエスト構文
POST /machinegroups 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" : "testgroup",
"groupType" : "",
"groupAttribute" : {
"externalName" : "testgroup",
"groupTopic": "testgrouptopic"
},
"machineIdentifyType" : "ip",
"machineList" : [
"test-ip1",
"test-ip2"
]
}
リクエストパラメーター
ボディパラメータ
パラメーター名 | データ型 | 必須/省略可能 | 説明 |
---|---|---|---|
Groupname | string | 必須 | 同じプロジェクト内で一意のマシングループ名。 |
groupType | string | 省略可能 | マシングループタイプ (デフォルトは空) |
machineIdentifyType | string | 必須 | IP およびユーザー定義 ID を含むマシン識別タイプ |
groupAttribute | object | 必須 | マシン グループ属性 (デフォルトでは空) |
machineList | array | 必須 | IP アドレスまたはユーザー定義 ID を指定できる特定のマシン ID |
groupAttribute description
属性名 | データ型 | 必須/省略可能 | 説明 |
---|---|---|---|
groupTopic | string | 省略可能 | マシン グループのトピック (デフォルトは空) |
externalName | string | 省略可能 | マシングループが依存する外部 ID (デフォルトでは空) |
CreateMachineGroup API には特別なリクエストヘッダーはありません。 Log Service API のパブリックリクエストヘッダーの詳細については、「パブリックリクエストヘッダー」をご参照ください。
レスポンスヘッダーCreateMachineGroup API には特別なレスポンスヘッダーはありません。 Log Service API のパブリックレスポンスヘッダーの詳細については、「パブリックレスポンスヘッダー」をご参照ください。
レスポンス要素返される HTTP ステータス コードは 200 です。
エラーコードLog Service API の 一般的なエラー コード の他に、 CreateMachineGroup API から次の特別のエラー コードが返される場合があります。
HTTP ステータスコード | エラーコード | エラーメッセージ |
---|---|---|
400 | MachineGroupAlreadyExist | グループ {GroupName} が既に存在します |
400 | InvalidParameter | 無効なグループ リソース json |
500 | InternalServerError | 内部サーバー エラー |
例
リクエスト例
POST /machinegroups 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 17:57:33 GMT",
"Content-Length": "187",
"x-log-signaturemethod": "hmac-sha1",
"Content-MD5": "82033D507DEAAD72067BB58DFDCB590D",
"User-Agent": "sls-java-sdk-v-0.6.0",
"Content-Type": "application/json",
"x-log-bodyrawsize": "0"
}
Body :
{
"groupName": "test-machine-group",
"groupType": "",
"machineIdentifyType": "ip",
"groupAttribute": {
"groupTopic": "testtopic",
"externalName": "testgroup"
},
"machineList": [
\"127.0.0.1\
\"127.0.0.2\"
]
}
レスポンス例
HTTP/1.1 200 OK
Header :
{
"Date": "Tue, 10 Nov 2015 17:57:33 GMT",
"Content-Length": "0",
"x-log-requestid": "5642300D99248CB76D005D36",
"Connection": "close",
"Server": "nginx/1.6.1"
}