创建API分组。
接口说明
创建 API 需要先创建分组,所属分组是 API 的一个基本属性信息。
此功能面向 API 提供者。
每个用户每个区域下最多可创建 100 个分组。
系统自动给分组分配二级域名,用于测试 API。
分组带有区域属性,后续创建 API 选择分组后就选择了区域,为减少网络延时,建议选择与后端服务相同的区域。
创建分组后,可为分组绑定已备案的自定义域名。
该接口调用的 QPS 限制为:单用户 QPS 不超过 50。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
apigateway:CreateApiGroup |
create |
*ApiGroup
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| GroupName |
string |
是 |
分组名称,必须唯一,支持汉字、英文字母、数字、英文格式的下划线,必须以英文字母或汉字开头,4~50 个字符。 |
Weather |
| BasePath |
string |
否 |
api 根路径 |
/qqq |
| Description |
string |
否 |
API 分组描述,不超过 180 个字符。 |
The weather informations. |
| InstanceId |
string |
否 |
实例 ID |
apigateway-cn-v6419k43xxxxx |
| Tag |
array<object> |
否 |
指定规则所适用的对象标签,可设置多个。 |
Key, Value |
|
object |
否 |
|||
| Key |
string |
否 |
标签的 key |
key |
| Value |
string |
否 |
标签的 value |
value |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| TagStatus |
boolean |
标签是否存在,取值:-true:存在-false:不存在 |
True |
| BasePath |
string |
api 根路径 |
/qqq |
| RequestId |
string |
请求唯一标识 |
FF3B7D81-66AE-47E0-BF69-157DCF187514 |
| Description |
string |
API 分组描述 |
The weather informations |
| GroupName |
string |
API 分组名称 |
Weather |
| GroupId |
string |
API 分组 ID,系统生成,全局唯一 |
523e8dc7bbe04613b5b1d726c2a7xx |
| InstanceId |
string |
实例 ID |
apigateway-cn-v6419k43xxxxx |
| SubDomain |
string |
系统给分组绑定的二级域名,用于测试 API 调用 |
523e8dc7bbe04613b5b1d726xxxxxxxx-cn-hangzhou.alicloudapi.com |
| InstanceType |
string |
实例类型
|
VPC_SHARED |
示例
正常返回示例
JSON格式
{
"TagStatus": true,
"BasePath": "/qqq",
"RequestId": "FF3B7D81-66AE-47E0-BF69-157DCF187514",
"Description": "The weather informations",
"GroupName": "Weather",
"GroupId": "523e8dc7bbe04613b5b1d726c2a7xx",
"InstanceId": "apigateway-cn-v6419k43xxxxx",
"SubDomain": "523e8dc7bbe04613b5b1d726xxxxxxxx-cn-hangzhou.alicloudapi.com",
"InstanceType": "VPC_SHARED"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。