調用ListServiceVersions介面擷取版本列表。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
要求標頭
該介面使用公用要求標頭,無特殊要求標頭。請參見公用請求參數文檔。
請求文法
GET /services/{serviceName}/versions
請求參數
| 名稱 | 類型 | 位置 | 是否必選 | 樣本值 | 描述 |
| serviceName | String | Path | 是 | service_name | 服務的名稱。 |
| limit | Integer | Query | 否 | 20 | 限定此次返回資源的數量。如果不設定,預設返回20,最大不能超過100。返回結果可以小於指定的數量,但不會多於指定的數量。 |
| nextToken | String | Query | 否 | nextservice | 用來返回更多結果。第一次查詢不需要提供這個參數,後續查詢的Token從返回結果中擷取。 |
| startKey | String | Query | 否 | nextservice | 設定結果從startKey之後(包括startKey)按版本號碼排序的第一個開始返回。 |
| direction | String | Query | 否 | BACKWARD | 限定返回的版本排序方向。
|
返回資料
| 名稱 | 類型 | 樣本值 | 描述 |
| direction | String | BACKWARD | 返回的版本排序方向。
|
| nextToken | String | null | 用來返回更多結果。 說明 如果這個值沒有返回,則說明沒有更多結果。 |
| versions | Array | 版本列表。 |
|
| createdTime | String | 2020-03-16T06:23:50Z | 服務版本的建立時間。 |
| description | String | test_description | 服務的版本描述。 |
| lastModifiedTime | String | 2020-07-15T06:12:31Z | 服務的版本上一次被更新的時間。 |
| versionId | String | 1 | 服務的版本號碼。 |
樣本
請求樣本
GET /2016-08-15/services/service_name/versions HTTP/1.1
公用要求標頭
正常返回樣本
JSON 格式
HTTP/1.1 200 OK
公用回應標頭
{
"versions": [
{
"versionId": "4",
"description": "test_description",
"createdTime": "2020-07-15T06:13:25Z",
"lastModifiedTime": "2020-07-15T06:13:25Z"
},
{
"versionId": "3",
"description": "test_description",
"createdTime": "2020-07-15T06:12:31Z",
"lastModifiedTime": "2020-07-15T06:12:31Z"
},
{
"versionId": "2",
"description": "test_description",
"createdTime": "2020-03-16T06:23:50Z",
"lastModifiedTime": "2020-03-16T06:23:50Z"
}
],
"nextToken": null,
"direction": "BACKWARD"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。