调用CreateServiceGroup创建服务组-阿里云帮助中心

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求头

该接口使用公共请求头，无特殊请求头。请参见公共请求参数文档。

请求语法

POST /services/group/insert HTTP/1.1

请求参数


名称	类型	位置	是否必选	示例值	描述
	Object	Body	否		A short description of struct
serviceGroupName	String	Body	是	我的服务组	服务小组名称
userIds	Array of Long	Body	是	65	用户id
enableWebhook	String	Body	是	ENABLE	是否开启webhook DISABLE关闭 ENABLE开启
webhookType	String	Body	是	WEIXIN_GROUP 微信群 DING_GROUP	webhookType WEIXIN_GROUP 微信 DING_GROUP 钉钉
serviceGroupDescription	String	Body	否	这个是一个服务描述	服务描述
webhookLink	String	Body	是	WWWWWWW	webhooklink
monitorSourceTemplates	Array	Body	否		监控源消息模版
templateId	Long	Body	否	111	消息模版ID
monitorSourceId	Long	Body	否	111	监控源ID
monitorSourceName	String	Body	否	zabbix	监控源名字
templateContent	String	Body	否	xx	模版内容
clientToken	String	Body	否	C4BE3837-1A13-413B-A225-2C88188E8A43	幂等号

返回数据


名称	类型	示例值	描述
requestId	String	C4BE3837-1A13-413B-A225-2C88188E8A43	Id of the request
data	Object		服务组ID
serviceGroupId	Long	1000	服务组ID

示例

请求示例

POST /services/group/insert HTTP/1.1
Host:gemp.aliyuncs.com
Content-Type:application/json

{
  "serviceGroupName" : "我的服务组",
  "userIds" : [ 65 ],
  "enableWebhook" : "ENABLE",
  "webhookType" : "WEIXIN_GROUP 微信群 DING_GROUP",
  "serviceGroupDescription" : "这个是一个服务描述",
  "webhookLink" : "WWWWWWW",
  "monitorSourceTemplates" : [ {
    "templateId" : 111,
    "monitorSourceId" : 111,
    "monitorSourceName" : "zabbix",
    "templateContent" : "xx"
  } ],
  "clientToken" : "C4BE3837-1A13-413B-A225-2C88188E8A43"
}

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateServiceGroupResponse>
    <requestId>C4BE3837-1A13-413B-A225-2C88188E8A43</requestId>
    <data>
        <serviceGroupId>1000</serviceGroupId>
    </data>
</CreateServiceGroupResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "requestId" : "C4BE3837-1A13-413B-A225-2C88188E8A43",
  "data" : {
    "serviceGroupId" : 1000
  }
}

错误码


HttpCode	错误码	错误信息	描述
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.	添加服务组失败

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