マシングループの詳細を表示します。

例:

GET /machinegroups/{groupName}

リクエスト構文

GET /machinegroups/{groupName} HTTP/1.1
Authorization: <AuthorizationString> 
Date: <GMT Date>
Host: <Project Endpoint>
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1

リクエストパラメーター

URL パラメーター:
パラメーター名 データ型 必須/省略可能 説明
groupName string 必須 マシングループの名前
リクエストヘッダー

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

レスポンスヘッダー

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

レスポンス要素
属性名 データ型 説明
groupName string 同じプロジェクト内で一意のマシングループ名
groupType string マシングループタイプ (空または Armory)。デフォルトは空
machineIdentifyType string マシングループタイプ (空または Armory)。デフォルトは空
groupAttribute 4) JSON object IP およびユーザー定義 ID を含むマシン識別タイプ
machineList json array IP アドレスまたはユーザー定義 ID を指定できる特定のマシン識別情報
createTime int マシングループの作成時刻
lastModifyTime int マシングループの最後の更新時刻

groupAttribute の説明

属性名 データ型 必須/省略可能 説明
groupTopic string 省略可能 通常は設定されないマシン グループのトピック
externalName string 省略可能 マシングループが依存する外部システム (Armory) の IDマシンのグループ化が依存する外部管理システム (アーモリー) の ID
{
    "groupName": "test-machine-group",
    "groupType": "",
    "groupAttribute": {
        "externalName": "testgroup",
        "groupTopic": "testtopic"
    },
    "machineIdentifyType": "ip",
    "machineList": [
        \"127.0.0.1\
        \"127.0.0.2\"
    ],
    "createTime": 1447178253,
    "lastModifyTime": 1447178253
}
エラーコード

Log Service API の一般的なエラー コードに加えて、 GetMachineGroup API から次の 特別なエラー コード が返される場合があります。

HTTP ステータスコード エラーコード エラーメッセージ
404 GroupNotExist group {GroupName} が存在しません。
500 InternalServerError 内部サーバーエラー

リクエスト例:
GET /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:34:44 GMT",
    "Content-Length": "0",
    "x-log-signaturemethod": "hmac-sha1",
    "User-Agent": "sls-java-sdk-v-0.6.0",
    "Content-Type": "application/x-protobuf",
    "x-log-bodyrawsize": "0"
}
レスポンス例:
HTTP/1.1 200 OK
Header :
{
    "Date": "Tue, 10 Nov 2015 18:15:23 GMT",
    "Content-Length": "239",
    "x-log-requestid": "5642343B99248CB36D0060B8",
    "Connection": "close",
    "Content-Type": "application/json",
    "Server": "nginx/1.6.1"
}
Body :
{
    "groupName": "test-machine-group",
    "groupType": "",
    "groupAttribute": {
        "externalName": "testgroup",
        "groupTopic": "testtopic"
    },
    "machineIdentifyType": "ip",
    "machineList": [
        \"127.0.0.1\
        \"127.0.0.2\"
    ],
    "createTime": 1447178253,
    "lastModifyTime": 1447178253
}