创建服务组。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
gemp:CreateServiceGroup |
create |
*全部资源
|
无 | 无 |
请求语法
POST /services/group/insert HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求 Body。 |
|
| serviceGroupName |
string |
是 |
服务组名称。 |
我的服务组 |
| userIds |
array |
是 |
用户 ID。 |
|
|
integer |
是 |
用户 ID。 |
65 |
|
| enableWebhook |
string |
是 |
是否开启 webhook:
|
ENABLE |
| webhookType |
string |
是 |
webhookType:
|
DING_GROUP |
| serviceGroupDescription |
string |
否 |
服务描述。 |
这个是一个服务描述 |
| webhookLink |
string |
是 |
webhook 地址。 |
https://oapi.ding****.com/robot/send?access_token=**** |
| monitorSourceTemplates |
array<object> |
否 |
监控源消息模版。 |
|
|
object |
否 |
监控源消息模版。 |
||
| templateId |
integer |
否 |
消息模版 ID。 |
111 |
| monitorSourceId |
integer |
否 |
监控源 ID。 |
111 |
| monitorSourceName |
string |
否 |
监控源名称。 |
zabbix |
| templateContent |
string |
否 |
模版内容。 |
xx |
| clientToken |
string |
否 |
幂等号。 |
C4BE3837-1A13-413B-A225-2C88188E8A43 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
响应结构。 |
||
| requestId |
string |
请求 ID。 |
C4BE3837-1A13-413B-A225-2C88188E8A43 |
| data |
object |
服务组 ID。 |
1 |
| serviceGroupId |
integer |
服务组 ID。 |
1000 |
示例
正常返回示例
JSON格式
{
"requestId": "C4BE3837-1A13-413B-A225-2C88188E8A43",
"data": {
"serviceGroupId": 1000
}
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | ServiceGroupWebHookLinkAlreadyExisted | The webhook link is already in use. | webhooklink已经被使用 |
| 400 | ServiceGroupNameAlreadyExisted | The service group name is already in use. | 服务组名字已经被使用 |
| 400 | AddServiceGroupFail | Failed to add the service group. | 添加服务组失败 |
| 405 | openFailed | open Failed | 灰度开通阶段,如需开通请联系我们 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。