调用CreateAppGroup API的参数说明与代码示例-分布式任务调度-阿里云-分布式任务调度(SchedulerX)-阿里云帮助中心

创建应用分组，返回appKey。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

edas:CreateSchedulerxAppGroupCreate

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
AppName	string	是	应用名称。	DocTest
Namespace	string	是	命名空间 ID，在控制台的命名空间页面中获取。	adcfc35d-e2fe-4fe9-bbaa-20e90ffc****
NamespaceSource	string	否	暂不支持，无须填写。	schedulerx
GroupId	string	是	应用 ID，在控制台的应用管理页面中获取。	TestSchedulerx.defaultGroup
RegionId	string	否	地域 ID。	cn-hangzhou
Description	string	否	应用描述。	Test
MaxJobs	integer	否	最大任务数。	1000
NamespaceName	string	否	命名空间名称。	Test
AppKey	string	否	应用 Appkey。	adcExHZviLcl****
MonitorConfigJson	string	否	报警通知的配置，支持以下属性：sendChannel、alarmType 和 webhookIsAtAll。说明此字段的详细说明参见下文关于请求参数的补充说明。	{ "sendChannel": "ding,sms,mail,phone", "alarmType": "Contacts", "webhookIsAtAll": false }
MonitorContactsJson	string	否	报警联系人配置。支持配置报警联系人以及报警联系人组说明此字段的详细说明参见下文关于请求参数的补充说明。	[ {"name": "张三"}, {"name": "李四"} ]
ScheduleBusyWorkers	boolean	否	是否调度繁忙机器。	false
EnableLog	boolean	否	是否开启日志。 true：开启 false：关闭	true
AppType	integer	否	应用类型。 1、普通应用。 2、k8s 应用。	1
AppVersion	integer	否	应用版本，1:基础版，2:专业版	2
NotificationPolicyName	string	否	通知策略名称	test-workday-notification

MonitorConfigJson 补充说明

报警通知的配置，支持以下属性：sendChannel、alarmType 和 webhookIsAtAll。

配置格式

该字段的配置应为 JSON 格式，支持以下属性：

属性说明

发送渠道（sendChannel）：
- 支持多个渠道，使用逗号分隔，选项包括：
  - webhook: ding
  - 短信: sms
  - 邮件: mail
  - 电话: phone
报警类型（alarmType）：
- Contacts: 表示报警联系人
- ContactGroup: 表示报警联系人组
是否 @ 所有成员（webhookIsAtAll）：
- 值为 "true" 或 "false"，指示在发送通知时是否 @ 所有群成员。

示例：

{
    "sendChannel": "ding,sms,mail,phone",
    "alarmType": "Contacts",
    "webhookIsAtAll": true
}

MonitorContactsJson 补充说明

报警联系人配置，根据 alarmType 的不同提供两种格式。

配置格式

该字段应为 JSON 格式，支持两种配置：联系人数组和联系人组对象。

属性说明

当 alarmType 为 Contacts：
- 配置为包含多个联系人对象的数组，每个对象需包含：
  - name: 联系人的名称
当 alarmType 为 ContactGroup：
- 配置为单个对象，包含：
  - name: 联系人组的名称

注意事项

建议提前创建联系人与联系人组。如果未创建，系统会自动生成相应的联系人和联系人组。用户需在“通知联系人”页面配置联系人手机号、邮箱等信息并激活，以确保报警能够正常发送。

示例：

示例 1 (当 alarmType 为 Contacts):

[
    {"name": "张三"},
    {"name": "李四"}
]

示例 2 (当 alarmType 为 ContactGroup):
```
{
    "name": "报警联系人组-1"
}
```

返回参数

名称	类型	描述	示例值
	object
Code	integer	返回码。	200
Message	string	错误信息，仅错误时返回错误信息。	Your request is denied as lack of ssl protect.
RequestId	string	请求唯一 ID。	883AFE93-FB03-4FA9-A958-E750C6DE120C
Success	boolean	创建应用是否成功。取值如下： true：创建应用成功。 false：创建应用失败。	true
Data	object	任务分组信息。
AppGroupId	integer	任务分组 ID。	6607
AppKey	string	应用 AppKey。	adcExHZviL******

示例

正常返回示例

JSON格式

{
  "Code": 200,
  "Message": "Your request is denied as lack of ssl protect.",
  "RequestId": "883AFE93-FB03-4FA9-A958-E750C6DE120C",
  "Success": true,
  "Data": {
    "AppGroupId": 6607,
    "AppKey": "adcExHZviL******"
  }
}

错误码

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

变更历史

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