Description
To create an API group, you must firstly create a group which is a basic attribute of the API.
- This API is intended for API providers.
- Up to 100 API groups can be created in each region on a per-user basis.
- Second-level domain names are automatically assigned to API groups for API testing.
- API groups have the region attribute. After you create an API and select a group for the API, the corresponding region is also selected. We recommend that you select the region where your backend services are located for reducing network delay.
- After you create an API group, you can bind a filed custom domain name to the group.
- This API can call up to 50 QPS for a single user.
Request parameters
Name | Type | Required? | Description |
---|---|---|---|
Action | String | Yes | Interface name, which is a required parameter; value: CreateApiGroup. |
GroupName | String | Yes | Group name, which must be globally unique and contain 4–50 characters including Chinese characters, English letters, numbers, and English-style underscores. The group name must start with an English letter or a Chinese character. |
Description | String | No | API group description, which cannot exceed 180 characters. |
Return parameters
Name | Type | Description |
---|---|---|
RequestId | String | Unique request ID. |
GroupID | String | API group ID, which is generated by the system and globally unique. |
GroupName | String | API group name. |
SubDomain | String | Second-level domain name bound to the API group, which is used for API call testing. |
Description | String | API group description. |
Examples
Request example
http://apigateway.cn-hangzhou.aliyuncs.com?Action=CreateApiGroup
&GroupName=Weather
&Description=The weather informations.
&<Public request parameters>
Response example
XML
format
<CreateApiGroupResponse>
<RequestId>FF3B7D81-66AE-47E0-BF69-157DCF187514</RequestId>
<GroupId>523e8dc7bbe04613b5b1d726c2a7889d</GroupId>
<GroupName>Weather</GroupName>
<SubDomain>523e8dc7bbe04613b5b1d726c2a7889d-cn-hangzhou.alicloudapi.com</SubDomain>
<Description>The weather informations</Description>
</CreateApiGroupResponse>
JSON
format
{
"RequestId": "FF3B7D81-66AE-47E0-BF69-157DCF187514",
"GroupId": "523e8dc7bbe04613b5b1d726c2a7889d",
"GroupName": "Weather",
"SubDomain": "523e8dc7bbe04613b5b1d726c2a7889d-cn-hangzhou.alicloudapi.com",
"Description": "The weather informations"
}