マシンのグループを作成して、ログの収集および設定の転送を行うことができます。

リクエスト構文

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