Description
For querying the list of historical versions of a specified API.
- This function is intended for API activators. Only released APIs have the historical version records.
- You can call this interface to obtain the API historical version numbers which can be used for calling other interfaces.
Request parameters
Name | Type | Required? | Description |
---|---|---|---|
Action | String | Yes | Operation interface, which is a required parameter; value: DescribeApiHistories. |
GroupId | String | Yes | ID of the specified group. |
ApiId | String | No | ID of the specified API. |
ApiName | String | No | API name (fuzzy matching). |
StageName | String | No | Stage name; values:
|
PageSize | Integer | No | Number of lines per page set at paging query; maximum value: 100; default value: 10. |
PageNumber | Integer | No | The page number specified for query; default value: 1; the starting number: 1. |
Return parameters
Name | Type | Description |
---|---|---|
RequestId | String | ID of the current request. |
TotalCount | Integer | Total number of returned results. |
PageNumber | Integer | Page number specified to be returned. |
PageSize | Integer | Specified total number of results returned per page. |
ApiHisItems | ApiHisItem | Returned API information, in an array consisting of ApiHisItem. |
Examples
Request example
https://apigateway.cn-qingdao.aliyuncs.com/?Action=DescribeApiHistories
&ApiName=weather
&pageSize=15
&pageNumber=3
&<Public request parameters>
Response example
XML
format
<DescribeApiHistoriesResponse>
<ApiHisItems>
<ApiHisItem>
<RegionId>cn-qingdao</RegionId>
<GroupId>63be9002440b4778a61122f14c2b2bbb</GroupId>
<GroupName>myGroup3</GroupName>
<ApiId>c076144d7878437b8f82fb85890ce6a0</ApiId>
<ApiName> Obtain the object list</ApiName>
<StageName>release</StageName>
<HistoryVersion>20160705104552292</HistoryVersion>
<Status>DISABLE</Status>
<Description> Display the object list on multiple pages</Description>
<DeployedTime>2016-07-23T08:28:48Z</DeployedTime>
</ApiHisItem>
<ApiHisItem>
<RegionId>cn-qingdao</RegionId>
<GroupId>1084f9034c744137901057206b39d2b6</GroupId>
<GroupName>myGroup2</GroupName>
<ApiId>5af418828f0344a3b588c0cc1331a3bc</ApiId>
<ApiName> Create object</ApiName>
<StageName>release</StageName>
<HistoryVersion>20160705104552393</HistoryVersion>
<Status>DISABLE</Status>
<Description> Create object interface</Description>
<DeployedTime>2016-07-20T08:28:48Z</DeployedTime>
</ApiHisItem>
</ApiHisItems>
<PageNumber>3</PageNumber>
<PageSize>15</PageSize>
<TotalCount>32</TotalCount>
<RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BZ003</RequestId>
</DescribeApiHistoriesResponse>
JSON
format
{
"ApiHisItems": {
"ApiHisItem": [
{
"RegionId": "cn-qingdao",
"GroupId": "63be9002440b4778a61122f14c2b2bbb",
"GroupName": "myGroup3",
"ApiId": "c076144d7878437b8f82fb85890ce6a0",
"ApiName": " Obtain the object list",
"StageName": "release",
"HistoryVersion": "20160705104552292",
"Status": "DISABLE",
"Description": " Display the object list on multiple pages",
"DeployedTime": "2016-07-23T08:28:48Z"
},
{
"RegionId": "cn-qingdao",
"GroupId": "1084f9034c744137901057206b39d2b6",
"GroupName": "myGroup2",
"ApiId": "5af418828f0344a3b588c0cc1331a3bc",
"ApiName": " Create object",
"StageName": "release",
"HistoryVersion": "20160705104552393",
"Status": "DISABLE",
"Description": " Create object interface",
"DeployedTime": "2016-07-20T08:28:48Z"
}
]
},
"PageNumber": 3,
"PageSize": 15,
"TotalCount": 32,
"RequestId":"CEF72CEB-54B6-4AE8-B225-F876FF7BZ003"
}