修改API分组
功能介绍
修改API分组属性。其中name和remark可修改,其他属性不可修改。
URI
HTTP/HTTPS请求方法以及URI如下表所示。
| 请求方法 | URI |
|---|---|
| PUT | /v1.0/apigw/api-groups/{id} |
URI中的参数说明如下表所示。
| 名称 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| id | 是 | String | API分组的编号 |
请求消息
| 名称 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| name | 是 | String | 名称。 长度为3 ~ 64位的字符串,字符串由中文、英文字母、数字、“_”组成,且只能以中文或英文开头。 说明: 中文字符必须为UTF-8或者unicode编码。 |
| remark | 否 | String | 描述。 字符串长度最大不超过255。 说明: 中文字符必须为UTF-8或者unicode编码。 |
请求消息样例:
{
"name": "api_group_001",
"remark": "分组001"
} 响应消息
| 名称 | 类型 | 说明 |
|---|---|---|
| id | String | 编号 |
| name | String | 名称 |
| status | Integer | 状态 |
| sl_domain | String | 系统默认分配的子域名 |
| sl_domains | String | 系统默认分配的子域名列表 |
| register_time | Timestamp | 创建时间 |
| update_time | Timestamp | 最近修改时间 |
| remark | String | 描述 |
| call_limits | Integer | 流控时长内分组下的API的总访问次数限制,默认不限,请根据服务的负载能力自行设置 |
| time_interval | Integer | 流控时长 |
| time_unit | String | 流控的时间单位 |
| url_domains | Array of UrlDomainsResp objects | 分组上绑定的独立域名列表 |
| on_sell_status | Integer | 是否已上架云商店:
|
| is_default | Integer | 是否为默认分组,默认为非默认分组:
|
| 名称 | 类型 | 说明 |
|---|---|---|
| id | String | 域名编号 |
| domain | String | 访问域名 |
| cname_status | Integer | 域名cname状态:
|
| ssl_id | String | SSL证书编号 |
| ssl_name | String | SSL证书名称 |
响应消息样例:
{
"id": "7efb2b91-155a-4f6a-9f45-c5c95a6e4950",
"name": "api_group_001",
"status": 1,
"sl_domain": "0e91b83b-0774-4e8e-b187-2d695ed4743b.apigw.example.com",
"sl_domains": ["0e91b83b-0774-4e8e-b187-2d695ed4743b.apigw.example.com","0e91b83b-0774-4e8e-b187-2d695ed4743b.apigw.example.cn"],
"remark": "分组001",
"register_time": "2017-12-28T11:44:53Z",
"update_time": "2017-12-28T11:49:01.048600577Z",
"on_sell_status": 2,
"is_default": 2
} 状态码
| 状态码 | 说明 |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 409 | Conflict |
| 500 | Server Internal Error |