调用CreateAppGroup创建应用分组_分布式任务调度 SchedulerX(SchedulerX)-阿里云帮助中心

创建应用分组，返回appKey。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
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	否	报警配置 JSON 字段。关于此字段的详细说明参见下文关于请求参数的补充说明。	{"sendChannel":"sms,ding"}
MonitorContactsJson	string	否	报警联系人 JSON 格式。	[{"userName":"张三","userPhone":"89756******"},{"userName":"李四","ding":"http://www.example.com"}]
ScheduleBusyWorkers	boolean	否	是否调度繁忙机器。	false
EnableLog	boolean	否	是否开启日志。 true：开启 false：关闭	true
AppType	integer	否	应用类型。 1、普通应用。 2、k8s 应用。	1
AppVersion	integer	否	应用版本，1:基础版，2:专业版	2

关于请求参数的补充说明

报警通道如下，配置多个逗号分隔。

webhook：ding
短信：sms
邮件：mail
电话：phone

例如：{"sendChannel":"ding,sms,mail,phone"}

返回参数

名称	类型	描述	示例值
	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	long	任务分组 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******"
  }
}

错误码

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

变更历史

变更时间

变更内容概要

操作

2024-06-05

OpenAPI 入参发生变更

看变更集

变更项	变更内容
入参	OpenAPI 入参发生变更。
	新增入参：AppVersion
	删除入参：Version

2024-05-29

OpenAPI 入参发生变更

看变更集

变更项	变更内容
入参	OpenAPI 入参发生变更。
	新增入参：Version

2023-03-30

API 内部配置变更，不影响调用

看变更集

变更项	变更内容
	API 内部配置变更，不影响调用。

2022-01-13

OpenAPI 入参发生变更、OpenAPI 返回结构发生变更

看变更集

变更项	变更内容
入参	OpenAPI 入参发生变更。
	新增入参：AppKey
	新增入参：MonitorConfigJson
	新增入参：MonitorContactsJson
出参	OpenAPI 返回结构发生变更。

示例 Demo

package com.alibaba.schedulerx.pop;

import com.alibaba.schedulerx.common.util.JsonUtil;

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.schedulerx2.model.v20190430.CreateAppGroupRequest;
import com.aliyuncs.schedulerx2.model.v20190430.CreateAppGroupResponse;

public class TestCreateAppGroup {

    public static void main(String[] args) throws Exception {
        // OpenAPI 的接入点，具体查看上表支持地域列表以及购买机器地域填写。
        String regionId = "cn-shanghai";
        //鉴权使用的 AccessKeyId，由阿里云官网控制台获取。
        String accessKeyId = "<yourAccessKeyId>";
        //鉴权使用的 AccessKeySecret，由阿里云官网控制台获取。
        String accessKeySecret = "<yourAccessKeySecret>";
        //产品名称
        String productName ="schedulerx2";
        //对照支持地域列表选择 Domain 填写。
        String domain ="schedulerx.cn-shanghai.aliyuncs.com";
        //构建 OpenAPI 客户端。
        DefaultProfile.addEndpoint(regionId, productName, domain);
        DefaultProfile defaultProfile = DefaultProfile.getProfile(regionId, accessKeyId, accessKeySecret);
        DefaultAcsClient client = new DefaultAcsClient(defaultProfile);
        
        CreateAppGroupRequest request = new CreateAppGroupRequest();
        request.setNamespace("xxxxxx");
        request.setNamespaceName("xxxx");
        request.setAppName("xxxx");
        request.setDescription("xxx");
        request.setGroupId("xxx");

        //发送请求。
        CreateAppGroupResponse response = client.getAcsResponse(request);
        if (!response.getSuccess()) {
            System.out.println(response.getMessage());
            System.out.println("createApp: "+response.getRequestId());
        } else {
            System.out.println(JsonUtil.toJson(response));
        }
    }
    
}