すべてのプロダクト
Search
ドキュメントセンター

Simple Log Service:create_machine_group

最終更新日:Aug 27, 2026

SLS CLI を使用してマシングループを作成します。

リクエスト構文

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

はい

file://./machinegroup.json

マシングループ設定ファイルへのパス。

SLS CLI グローバルパラメーターについては、「グローバルパラメーター」をご参照ください。

例

  1. machinegroup.json という名前のファイルを作成します。次の例では、マシングループ名を group_name2 に設定しています。

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

    パラメーター:

    パラメーター

    説明

    machine_list

    マシングループ内のサーバー識別子。

    machine_type

    マシングループ識別子タイプ。有効な値:

    • ip:IP アドレス識別子。

    • userdefined:カスタム ID 識別子。

    group_name

    マシングループ名。要件:

    • プロジェクト内で一意である必要があります。

    • 小文字、数字、ハイフン (-)、アンダースコア (_) のみを含めることができます。

    • 小文字または数字で始まり、小文字または数字で終わる必要があります。

    • 3 文字から 128 文字の長さにする必要があります。

    group_type

    マシングループタイプ。空の文字列 ("") に設定します。

    group_attribute

    マシングループ属性。次の表で説明します。

    group_attribute パラメーター:

    パラメーター

    説明

    groupTopic

    マシングループトピック。

  2. デフォルトアカウントを使用してマシングループ group_name2 を作成します。

    aliyunlog log create_machine_group --project_name="aliyun-test-project" --group_detail="file://./machinegroup.json"

    このコマンドは出力を返しません。

  3. マシングループを確認します。

    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