请求参数
URL 参数:
参数名称 | 类型 | 是否必须 | 描述 |
groupName | string | 是 | 机器分组名称 |
属性名称 | 类型 | 是否必须 | 描述 |
groupName | string | 是 | 机器分组名称,project 下唯一 |
groupType | string | 否 | 机器分组类型,默认为空 |
machineIdentifyType | string | 是 | 机器标识类型,分为 ip 和 userdefined 两种 |
groupAttribute | object | 是 | 机器分组的属性,默认为空 |
machineList | array | 是 | 具体的机器标识,可以是 ip 或 userdefined-id |
属性名称 | 类型 | 是否必须 | 描述 |
groupTopic | string | 否 | 机器分组的 topic,默认为空 |
externalName | string | 否 | 机器分组所依赖的外部管理标识,默认为空 |
HTTP 状态码 | ErrorCode | ErrorMessage |
404 | GroupNotExist | group {GroupName} not exist |
400 | InvalidParameter | invalid group resource json |
500 | InternalServerError | internal server error |
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
根据您提供的信息,这是关于使用阿里云日志服务(Log Service)中管理机器分组的API接口的描述。下面我将帮助您理解如何构造一个请求来创建或更新机器分组,并解释响应情况。
ip
或 userdefined
。machineIdentifyType
可以是IP地址或自定义ID。无需特定请求头,但需遵循阿里云日志服务API的公共请求头规范,具体参考公共请求头文档。
POST /api/[project_name]/machines/group
Body:
{
"groupName": "testGroup",
"machineIdentifyType": "ip",
"groupAttribute": {
"groupTopic": "optionalTopic",
"externalName": "optionalExternalId"
},
"machineList": ["192.168.1.1", "192.168.1.2"]
}
请确保替换 [project_name]
为您的实际项目名称,并根据需要调整其他参数。此请求将尝试在指定的项目中创建或更新一个名为 testGroup
的机器分组,该分组识别机器通过IP地址,并附带了可选的topic和外部标识以及具体的机器IP列表。
记得在实际调用API前,查阅最新的阿里云日志服务API文档,因为API细节可能会有所更新。