CreateMachineGroup - 创建机器组 - 日志服务

创建一个机器组。

接口说明

Host 由 Project 名称和日志服务 Endpoint 构成，您需要在 Host 中指定 Project。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作

访问级别

资源类型

条件关键字

关联操作

log:CreateMachineGroup

create

*Project

acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/machinegroup/{#MachineGroupName}

无

POST /machinegroups HTTP/1.1

名称	类型	必填	描述	示例值
project	string	是	Project 名称。	ali-test-project
body	object	是	请求体参数。	ali-test-project
groupName	string	是	机器组名称。其命名规则如下：同一个 Project 下，机器组名称不可重复。只能包括小写字母、数字、短划线（-）和下划线（_）。必须以小写字母或者数字开头和结尾。长度为 3-128 字符。	test-machine-group
machineIdentifyType	string	是	机器标识类型。 ip：IP 地址机器组。 userdefined：用户自定义标识机器组。	ip
groupType	string	否	机器组类型，可选值为空。	""
groupAttribute	object	否	机器组的属性。
groupTopic	string	否	机器组的日志主题。	testtopic
externalName	string	否	机器组所依赖的外部管理系统标识。	testgroup
machineList	array	是	机器组的标识信息。如果 machineIdentifyType 配置为 ip，则此处填写服务器的 IP 地址。如果 machineIdentifyType 配置为 userdefined，则此处填写自定义的标识。
	string	否	机器标识，根据机器组类型填写 IP 地址或者用户自定义标识。	192.168.XX.XX

名称

类型

描述

示例值

当前API暂无返回参数

正常返回示例

JSON格式

{}

访问错误中心查看更多错误码。

更多信息，参考变更详情。