調用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" ] }
錯誤碼
如果返回報錯信息,請參見具體接口的錯誤碼處理。更多信息,請參見錯誤碼。