Updated on 2022-02-21 GMT+08:00

Querying Details of an API Version

Function

This API is used to query the details of a specified API version.

URI

The following table lists the HTTP/HTTPS request method and URI of the API.

Table 1 HTTP/HTTPS request method and URI

Request Method

URI

GET

/v1.0/apigw/apis/versions/{version_id}

The following table lists the parameter in the URI.

Table 2 Parameter description

Parameter

Mandatory

Type

Description

version_id

Yes

String

API version ID

Request

N/A

Response

Table 3 Parameter description

Parameter

Type

Description

id

String

API ID

name

String

API name

group_id

String

ID of the API group to which the API belongs

group_name

String

Name of the API group to which the API belongs

status

Integer

API status

type

Integer

API type

version

String

API version

req_protocol

String

Request protocol

req_method

String

Request method

req_uri

String

Access address

auth_type

String

Security authentication mode

auth_opt

Object

Security authentication mode parameter

authorizer_id

String

ID of the frontend custom authorizer

match_mode

String

Matching mode

register_time

Timestamp

Time when the API is registered

update_time

Timestamp

Time when the API was last modified

remark

String

Description of the API

bakend_type

String

Backend type

run_env_name

String

Name of the environment in which the API has been published

run_env_id

String

ID of the environment in which the API has been published

publish_id

String

ID of the publication record

arrange_necessary

Integer

Indicates whether orchestration is required.

tag

String

Service name tag, which is to be discarded

tags

[]String

API tags

cors

Bool

Indicates whether CORS is supported.

body_remark

String

Description of the API request body, which can be an example request body, media type, or parameter information

result_normal_sample

String

Example response for a successful request

result_failure_sample

String

Example response for a failed request

response_id

String

ID of the gateway response

sl_domain

String

Subdomain name of the API group

sl_domains

Array of strings

List of subdomain names bound to the API group

version_id

String

API version

publish_time

Timestamp

Time when the API version is published

backend_api

Dictionary

Web backend details

mock_info

Dictionary

Mock backend details

func_info

Dictionary

FunctionGraph backend details

req_params

Dictionary

Request parameter list

backend_params

Dictionary

Backend parameter list

Table 4 Parameter description of backend_api

Parameter

Type

Description

id

String

Web backend ID

status

Integer

Web backend status

url_domain

String

Backend endpoint

version

String

Backend version

req_protocol

String

Request protocol

req_method

String

Request method

req_uri

String

Access address

timeout

Integer

Timeout duration in milliseconds

register_time

Timestamp

Time when the web backend is registered

update_time

Timestamp

Time when the web backend was last modified

remark

String

Description of the backend

vpc_status

String

Indicates whether to use a VPC channel.

vpc_info

String

VPC channel information

authorizer_id

String

ID of the backend custom authorizer

Table 5 Parameter description of mock_info

Parameter

Type

Description

id

String

Mock backend ID

status

Integer

Mock backend status

version

String

Backend version

result_content

String

Mock response

register_time

Timestamp

Time when the Mock backend is registered

update_time

Timestamp

Time when the Mock backend was last modified

remark

String

Description of the backend

Table 6 Parameter description of func_info

Parameter

Type

Description

id

String

Function ID

status

Integer

Function status

version

String

Function version

function_urn

String

Function URN

invocation_type

String

Invocation mode, which can be async or sync

register_time

Timestamp

Time when the function is registered

update_time

Timestamp

Time when the function was last updated

timeout

Integer

Timeout duration in milliseconds

remark

String

Description of the function

Table 7 Parameter description of req_params

Parameter

Type

Description

id

String

Parameter ID

name

String

Parameter name

type

String

Parameter type

location

String

Parameter location

default_value

String

Default value

sample_value

String

Example value

required

Integer

Indicates whether the parameter is mandatory.

valid_enable

Integer

Indicates whether validity check is enabled.

remark

String

Description of the parameter

enumerations

String

Enumerated value

min_num

Integer

Minimum value, which is valid when the parameter type is NUMBER

max_num

Integer

Maximum value, which is valid when the parameter type is NUMBER

min_size

Integer

Minimum length

max_size

Integer

Maximum length

regular

String

Regular expression validation rule

json_schema

String

JSON validation rule

Table 8 Parameter description of backend_params

Parameter

Type

Description

id

String

Parameter ID

req_param_id

String

ID of the request parameter to which the backend parameter is mapped

name

String

Parameter name

location

String

Parameter location

origin

Integer

Parameter type

value

Integer

Parameter value

remark

String

Description of the parameter

Table 9 Parameter description of auth_opt

Parameter

Type

Description

app_code_auth_type

String

Indicates whether AppCode authentication is enabled.

Example response:

{
  "name": "test",
  "type": 1,
  "version": "V0.0.1",
  "req_protocol": "HTTPS",
  "req_method": "GET",
  "req_uri": "/test/{project_id}",
  "auth_type": "APP",
  "auth_opt": {
    "app_code_auth_type": "HEADER"
  },
  "tags": ["APIG-SN-test", "test"],
  "cors": false,
  "match_mode": "NORMAL",
  "backend_type": "HTTP",
  "group_id": "f71f69876f90456ca6fd18ed012fdc11",
  "result_normal_sample": "hello world!",
  "id": "81efcfd94b8747a0b21e8c04144a4e8c",
  "status": 1,
  "arrange_necessary": 2,
  "register_time": "2018-08-15T03:41:11.0239936Z",
  "update_time": "2018-08-15T03:41:11.0239936Z",
  "group_name": "group0002",
  "sl_domain": "a8be0e466f0e4d8bb18ebd15402cdd66.apigw.example.com",
  "sl_domains": ["a8be0e466f0e4d8bb18ebd15402cdd66.apigw.example.com", "a8be0e466f0e4d8bb18ebd15402cdd66.apigw.example.cn"],
  "version_id": "69b7492e2855487398d45733b9d6147a",
  "publish_time": "2018-08-24T03:10:14Z",
  "backend_api": {
    "url_domain": "xxxxxxxxx",
    "req_protocol": "HTTP",
    "req_method": "GET",
    "req_uri": "/test",
    "timeout": 1000,
    "vpc_status": 2,
    "id": "3442ffd031814e3a8f133a9f1ea08453",
    "status": 1,
    "register_time": "2018-08-15T03:41:11.1019236Z",
    "update_time": "2018-08-15T03:41:11.1019236Z"
  },
  "req_params": [
    {
      "name": "project_id",
      "type": "STRING",
      "location": "PATH",
      "required": 1,
      "valid_enable": 2,
      "id": "593c5560e0924e00af08fb458f850ecb"
    },
    {
      "name": "city",
      "type": "STRING",
      "location": "QUERY",
      "required": 2,
      "valid_enable": 2,
      "id": "e0b91bc81ae54f8ea850848d782d6e1e"
    }
  ],
  "backend_params": [
    {
      "name": "project_id",
      "location": "QUERY",
      "origin": "REQUEST",
      "value": "project_id",
      "id": "44e03de2351e43a8b18ba9ec1e71d2e9",
      "req_param_id": "593c5560e0924e00af08fb458f850ecb"
    },
    {
      "name": "city",
      "location": "QUERY",
      "origin": "REQUEST",
      "value": "city",
      "id": "b60fbcb5b86f4f5c8705c445b9bd6325",
      "req_param_id": "e0b91bc81ae54f8ea850848d782d6e1e"
    }
  ]
}

Status Codes

Table 10 Status codes

Status Code

Description

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Server Internal Error