マシングループの詳細を表示します。
例:
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
}