調用CLI命令create_machine_group建立Logtail機器組 - Simple Log Service

調用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>]

請求參數

該命令的必選和特有參數描述如下。

參數名稱	數實值型別	是否必選	樣本值	描述
--project_name	String	是	aliyun-test-project	Project名稱。
--group_detail	JSON Object	是	file://./machinegroup.json	機器組設定檔路徑。

關於該命令的全域參數，請參見全域參數。

樣本

建立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地址。如果machine_type配置為userdefined，則此處填寫自訂的標識。如何配置使用者自訂標識，請參見配置使用者自訂標識。
machine_type	機器標識類型。 ip：IP地址機器組。 userdefined：使用者自訂標識機器組。
group_name	機器組名稱。其命名規則如下：同一個Project下，不可重複。只能包含小寫字母、數字、短劃線（-）和底線（_）。必須以小寫字母或者數字開頭和結尾。長度為3~128字元。
group_type	機器群組類型，取值為空白字串。
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參考

CreateMachineGroup