調用ListAliases介面擷取別名列表。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
要求標頭
該介面使用公用要求標頭,無特殊要求標頭。請參見公用請求參數文檔。
請求文法
GET /services/{serviceName}/aliases
請求參數
| 名稱 | 類型 | 位置 | 是否必選 | 樣本值 | 描述 |
| serviceName | String | Path | 是 | service_name | 服務的名稱。 |
| limit | Integer | Query | 否 | 20 | 限定此次返回資源的數量。如果不設定,預設返回20,最大不能超過100。返回結果可以小於指定的數量,但不能多於指定的數量。 |
| nextToken | String | Query | 否 | nextService | 用來返回更多結果。第一次查詢不需要提供這個參數,後續查詢的Token從返回結果中擷取。 |
| prefix | String | Query | 否 | prefix_text | 限定返回的資源名稱,名稱必須以Prefix作為首碼,例如Prefix是a,則返回的資源名均是以a開始的。 |
| startKey | String | Query | 否 | nextService | 設定結果從startKey之後(包括startKey)按字母排序的第一個開始返回。 |
返回資料
| 名稱 | 類型 | 樣本值 | 描述 |
| aliases | Array | 別名的列表。 |
|
| additionalVersionWeight | Map | 別名指向的灰階版本以及灰階權重。
|
|
| Float | 1 | 流量權重,取值範圍[0,1]。 |
|
| aliasName | String | alias_test | 別名的名稱。 |
| createdTime | String | 2020-04-21T09:08:44Z | 別名的建立時間。 |
| description | String | test_description | 別名的描述。 |
| lastModifiedTime | String | 2020-04-21T09:08:44Z | 別名上一次被更新的時間。 |
| serviceName | String | service_name | 服務的名稱。 |
| versionId | String | 2 | 別名指向的版本。 |
| nextToken | String | nextService | 用來返回更多的查詢結果。如果這個值沒有返回,則說明沒有更多結果。 |
樣本
請求樣本
GET /2016-08-15/services/service_name/aliases HTTP/1.1
公用要求標頭
正常返回樣本
JSON 格式
HTTP/1.1 200 OK
公用回應標頭
{
"aliases": [
{
"aliasName": "alias_test",
"versionId": "2",
"description":"test_description ",
"additionalVersionWeight": {},
"createdTime": "2020-04-21T09:08:44Z",
"lastModifiedTime": "2020-04-21T09:08:44Z"
},
{
"aliasName": "alias_test",
"versionId": "2",
"description":"test_description",
"additionalVersionWeight": null,
"createdTime": "2020-07-27T06:37:29Z",
"lastModifiedTime": "2020-07-27T06:37:29Z"
}
]
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。