创建API分组

功能介绍

API分组是API的管理单元，一个API分组等同于一个服务入口，创建API分组时，返回一个子域名作为访问入口。建议一个API分组下的API具有一定的相关性。

专享版API网关已经陆续开放V2版本的接口，请优先使用V2版本接口管理您的API。

URI

HTTP/HTTPS请求方法以及URI如下表所示。

表1 HTTP/HTTPS请求方法以及URI
请求方法	URI
POST	/v1/{project_id}/apigw/instances/{instance_id}/api-groups

URI中的参数说明如下表所示。

表2 参数说明
名称	是否必选	类型	说明
project_id	是	String	项目ID。可从控制台“我的凭证”中获取region下项目ID，管理员权限可查询。
instance_id	是	String	实例ID，可从API网关控制台的专享版实例信息中获取。

请求消息

表3 参数说明
名称	是否必选	类型	说明
name	是	String	API分组的名称。长度为3 ~ 64位的字符串，字符串由中文、英文字母、数字、“_”组成，且只能以英文或中文开头。说明：中文字符必须为UTF-8或者unicode编码。
remark	否	String	API分组描述。长度最大不超过255个字符。说明：中文字符必须为UTF-8或者unicode编码。

请求消息样例：

{
	"name": "api_group_001",
	"remark": "分组1"
}

响应消息

表4 参数说明
名称	类型	说明
id	String	编号
name	String	名称
status	Integer	状态
sl_domain	String	系统默认分配的子域名
register_time	Timestamp	创建时间
update_time	Timestamp	最近修改时间
remark	String	描述
on_sell_status	Integer	是否已上架云商店： 1：已上架 2：未上架 3：审核中
call_limits	Integer	流控时长内分组下的API的总访问次数限制，默认不限，请根据服务的负载能力自行设置
time_interval	Integer	流控时长
time_unit	String	流控的时间单位
url_domains	字典数据类型	分组上绑定的独立域名列表
is_default	Integer	是否为默认分组，默认为非默认分组： 1：默认分组 2：非默认分组

响应消息样例：

{
	"id": "7efb2b91-155a-4f6a-9f45-c5c95a6e4950",
	"name": "api_group_001",
	"status": 1,
	"sl_domain": "0e91b83b-0774-4e8e-b187-2d695ed4743b.apigw.example.com",
	"remark": "分组1",
	"register_time": "2017-12-28T11:44:53.831282304Z",
	"update_time": "2017-12-28T11:44:53.831283436Z",
	"on_sell_status": 2,
        "is_default": 2
}