create_machine_group - Simple Log Service - Alibaba Cloud ドキュメントセンター

マシングループを作成します。

リクエスト構文

aliyunlog log create_machine_group --project_name=<value> --group_detail=<value> [--access-id=<value>] [--access-key=<value>] [--sts-token=<value>] [--region-endpoint=<value>] [--client-name=<value>] [--jmes-filter=<value>] [--format-output=<value>] [--decode-output=<value>]

リクエストパラメーター

次の表に、create_machine_groupコマンドに必要なパラメーターと具体的なパラメーターを示します。

パラメーター	データ型	必須	例	説明
-- project_name	String	課金されます	aliyun-test-project	プロジェクトの名前。
-- group_detail	JSON Object	課金されます	ファイル: //./machinegroup.json	マシングループの構成ファイルのパス。

Log Serviceコマンドラインインターフェイス (CLI) のグローバルパラメーターの詳細については、「グローバルパラメーター」をご参照ください。

例

マシングループ名がgroup_name2であるmachinegroup.jsonという名前のファイルを作成します。次の例は、machinegroup.jsonファイルの内容を示しています。

{
  "machine_list": [
    "machine1",
    "machine2"
  ],
  "machine_type": "userdefined",
  "group_name": "group_name2",
  "group_type": "",
  "group_attribute": {
    "groupTopic": "topic x"
  }
}

下表に、各パラメーターを説明します。

パラメーター	説明
machine_list	マシングループ内のサーバーの識別子。 machineIdentifyTypeパラメーターをipに設定した場合、マシングループ内のサーバーのIPアドレスを入力します。 machineIdentifyTypeパラメーターをuserdefinedに設定した場合、カスタムIDを入力します。カスタムIDを設定する方法の詳細については、「カスタムIDベースのマシングループの作成」をご参照ください。
machine_type	マシングループ識別子のタイプ。有効な値： ip: マシングループはIPアドレスを識別子として使用します。 userdefined: マシングループはカスタムIDを識別子として使用します。
group_name	マシングループの名前。名前の条件は以下の通りです。名前はプロジェクト内で一意である必要があります。名前には、小文字、数字、ハイフン ( - )、アンダースコア ( _ ) のみ使用できます。名前の先頭と末尾は、小文字または数字である必要があります。名前は3〜128文字である必要があります。
group_type	マシングループのタイプ。有効値: null。
group_attribute	マシングループの属性。 group_attributeパラメーターの詳細については、次の表をご参照ください。

group_attributeのパラメーターを次の表に示します。

パラメーター	説明
groupTopic	マシングループのトピック。

デフォルトのアカウントを使用して、group_name2という名前のマシングループを作成します。
```
aliyunlog log create_machine_group --project_name="aliyun-test-project" --group_detail="file://./machinegroup.json"
```
コマンドを実行すると、応答は返されません。

作成したマシングループを照会します。以下のコマンドを実行します。

aliyunlog log get_machine_group --project_name="aliyun-test-project" --group_name="group_name2"

次の出力が返されます。

{
  "createTime": 1622104319,
  "groupAttribute": {
    "externalName": "",
    "groupTopic": "topic x",
    "osType": "",
    "policy": "",
    "region": ""
  },
  "groupName": "group_name2",
  "groupType": "",
  "lastModifyTime": 1622104319,
  "machineIdentifyType": "userdefined",
  "machineList": [
    "machine1",
    "machine2"
  ]
}

エラーコード

エラーメッセージが返された場合は、関連するAPI操作のエラーコードに基づいてエラーを修正します。詳細については、エラーコードをご参照ください。

API リファレンス

CreateMachineGroup