該介面用於查詢資料庫列表。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| ProjectId |
integer |
是 |
DataWorks 工作空間的 ID。您可以調用 ListProjects ,擷取工作空間 ID。 |
123 |
| DataSourceType |
string |
是 |
資料類型,當前僅支援取值為 emr。 |
emr |
| PageNum |
integer |
否 |
頁碼數。 |
1 |
| PageSize |
integer |
否 |
每頁顯示的條數,預設為 10 條,最大為 100 條。 |
10 |
| ClusterId |
string |
否 |
EMR 叢集的 ID。您可以登入 EMR 的控制台,擷取叢集 ID。 |
abc |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
返回資料結構。 |
||
| RequestId |
string |
請求 ID。 |
abc |
| DatabaseInfo |
object |
資料庫的資訊。 |
|
| TotalCount |
integer |
資料庫的總數。 |
10 |
| DbList |
array<object> |
資料庫列表。 |
|
|
object |
返回資料結構。 |
||
| Type |
string |
資料庫的類型。 |
HIVE |
| CreateTimeStamp |
integer |
建立資料庫的時間。該結果顯示為時間戳記,您可以根據使用的時區將時間戳記轉換為相應日期。 |
1388776825 |
| UUID |
string |
資料庫的唯一標識。 |
32342 |
| ModifiedTimeStamp |
integer |
更新資料庫的時間。 |
1388776837 |
| Name |
string |
資料庫的名稱。 |
name |
| OwnerId |
string |
Owner 的 ID。 |
1232 |
| Location |
string |
儲存資料庫的地址。 |
hdfs://localhost:777/user/hadoop/test.txt |
樣本
正常返回樣本
JSON格式
{
"RequestId": "abc",
"DatabaseInfo": {
"TotalCount": 10,
"DbList": [
{
"Type": "HIVE",
"CreateTimeStamp": 1388776825,
"UUID": "32342",
"ModifiedTimeStamp": 1388776837,
"Name": "name",
"OwnerId": "1232",
"Location": "hdfs://localhost:777/user/hadoop/test.txt"
}
]
}
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | Invalid.Meta.AppNotExist | The MaxCompute project does not exist. | MaxCompute專案不存在。 |
| 400 | InvalidParameter.Meta.CommonError | The specified parameter is invalid. | 請求參數錯誤。 |
| 400 | InvalidParameter.Meta.Illegal | The app guid parameter is invalid. | App參數錯誤。 |
| 400 | InvalidParameter.Meta.IllegalDate | The date format is invalid. | 日期格式錯誤。 |
| 400 | InvalidParameter.Meta.IllegalPageError | The parameter for paging is invalid. | 分頁資訊錯誤。 |
| 400 | InvalidParameter.Meta.NotExist | The object does not exist. | |
| 500 | InternalError.System | An internal system error occurred. Try again later. | |
| 500 | InternalError.UserId.Missing | An internal system error occurred. Try again later. | |
| 500 | InternalError.Meta.NoCalcEngine | An error occurred while retrieving the compute engine based on the MaxCompute project. | |
| 500 | InternalError.Meta.TenantTimeOut | Failed to connect to the interface network. | 介面網路不通。 |
| 500 | InternalError.Meta.Unknown | An unknown error occurred while processing your request. | 未知錯誤。 |
| 403 | Forbidden.Meta.NoTenant | The user is not the owner of any tenants. | 當前的使用者不是任何租戶的所有者。 |
| 403 | Forbidden.Access | Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition. | 沒有許可權,請授權 |
| 429 | Throttling.Api | The request for this resource has exceeded your available limit. | |
| 429 | Throttling.Api.Risk | The request for this resource has exceeded your daily available limit. | |
| 429 | Throttling.System | The DataWorks system is busy. Try again later. | |
| 429 | Throttling.User | Your request is too frequent. Try again later. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。