Querying API Group Details¶
Function¶
This API is used to query the details of an API group.
Calling Method¶
For details, see Calling APIs.
URI¶
GET /v2/{project_id}/apigw/instances/{instance_id}/api-groups/{group_id}
Parameter | Mandatory | Type | Description |
---|---|---|---|
project_id | Yes | String | Project ID. For details about how to obtain it, see Obtaining a Project ID. |
instance_id | Yes | String | Gateway ID, which can be obtained from the gateway information on the APIG console. |
group_id | Yes | String | API group ID. |
Request Parameters¶
Parameter | Mandatory | Type | Description |
---|---|---|---|
X-Auth-Token | Yes | String | User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token. |
Response Parameters¶
Status code: 200
Parameter | Type | Description |
---|---|---|
id | String | ID. |
name | String | API group name. |
status | Integer | Status.
Enumeration values:
|
sl_domain | String | Subdomain name that APIG automatically allocates to the API group. |
register_time | String | Creation time. |
update_time | String | Last modification time. |
on_sell_status | Integer | Indicates whether the API group has been listed on KooGallery.
Not supported currently. |
url_domains | Array of UrlDomain objects | Independent domain names bound to the API group. |
sl_domain_access_enabled | Boolean | Whether the debugging domain name is accessible. Options: true and false. Default: true |
sl_domains | Array of strings | Automatically allocated subdomain names. |
remark | String | Description. |
call_limits | Integer | Total number of times all APIs in the API group can be accessed. Consider the payload capacity of the backend service when setting this parameter. By default, there is no limit on the number of API calls. Currently, this parameter is not supported. |
time_interval | Integer | Period of time for limiting the number of API calls. Currently, this parameter is not supported. |
time_unit | String | Time unit for limiting the number of API calls. Currently, this parameter is not supported. |
is_default | Integer | Indicates whether the API group is the default group.
|
version | String | Group version.
The default value is V1. This parameter is not supported currently. |
roma_app_id | String | ID of the integration application to which the API group belongs. This parameter is required when the group version is V2. Currently, this parameter is not supported. |
roma_app_name | String | Name of the integration application to which the API group belongs. Currently, this parameter is not supported. |
Parameter | Type | Description |
---|---|---|
id | String | Domain ID. |
domain | String | Domain name. |
cname_status | Integer | CNAME resolution status of the domain name.
|
ssl_id | String | SSL certificate ID. |
ssl_name | String | SSL certificate name. |
min_ssl_version | String | Minimum SSL version. TLS 1.1 and TLS 1.2 are supported. Default: TLSv1.1 Enumeration values:
|
verified_client_certificate_enabled | Boolean | Whether to enable client certificate verification. This parameter is available only when a certificate is bound. It is enabled by default if trusted_root_ca exists, and disabled if trusted_root_ca does not exist. Default: false |
is_has_trusted_root_ca | Boolean | Whether a trusted root certificate (CA) exists. The value is true if trusted_root_ca exists in the bound certificate. Default: false |
Status code: 400
Parameter | Type | Description |
---|---|---|
error_code | String | Error code. |
error_msg | String | Error message. |
Status code: 401
Parameter | Type | Description |
---|---|---|
error_code | String | Error code. |
error_msg | String | Error message. |
Status code: 403
Parameter | Type | Description |
---|---|---|
error_code | String | Error code. |
error_msg | String | Error message. |
Status code: 404
Parameter | Type | Description |
---|---|---|
error_code | String | Error code. |
error_msg | String | Error message. |
Status code: 500
Parameter | Type | Description |
---|---|---|
error_code | String | Error code. |
error_msg | String | Error message. |
Example Requests¶
None
Example Responses¶
Status code: 200
OK
{
"update_time" : "2020-07-31T06:55:55Z",
"name" : "api_group_001",
"on_sell_status" : 2,
"remark" : "API group 1",
"sl_domains" : [ "c77f5e81d9cb4424bf704ef2b0ac7600.apic.****.com", "c77f5e81d9cb4424bf704ef2b0ac7600.apic.****.cn" ],
"sl_domain" : "c77f5e81d9cb4424bf704ef2b0ac7600.apic.****.com",
"id" : "c77f5e81d9cb4424bf704ef2b0ac7600",
"register_time" : "2020-07-31T06:55:55Z",
"status" : 1,
"is_default" : 2,
"sl_domain_access_enabled" : true
}
Status code: 400
Bad Request
{
"error_code" : "APIG.2012",
"error_msg" : "Invalid parameter value,parameterName:name. Please refer to the support documentation"
}
Status code: 401
Unauthorized
{
"error_code" : "APIG.1002",
"error_msg" : "Incorrect token or token resolution failed"
}
Status code: 403
Forbidden
{
"error_code" : "APIG.1005",
"error_msg" : "No permissions to request this method"
}
Status code: 404
Not Found
{
"error_code" : "APIG.3030",
"error_msg" : "The instance does not exist;id:eddc4d25480b4cd6b512f270a1b8b341"
}
Status code: 500
Internal Server Error
{
"error_code" : "APIG.9999",
"error_msg" : "System error"
}
Status Codes¶
Status Code | Description |
---|---|
200 | OK |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
500 | Internal Server Error |
Error Codes¶
See Error Codes.