調用CLI命令修改機器組資訊。
請求文法
aliyunlog log update_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 update_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": 1622105480, "groupAttribute": { "externalName": "", "groupTopic": "topic x", "osType": "", "policy": "", "region": "" }, "groupName": "group_name2", "groupType": "", "lastModifyTime": 1622105480, "machineIdentifyType": "userdefined", "machineList": [ "machine1", "machine2" ] }
錯誤碼
如果返回報錯資訊,請參見具體介面的錯誤碼處理。更多資訊,請參見錯誤碼。