該介面用於擷取引擎執行個體的基本中繼資料資訊。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| AppGuid |
string |
否 |
引擎 ID，格式為 |
odps.some_engine_name |
| ClusterId |
string |
否 |
EMR 叢集的 clusterId。 |
abc |
| DatabaseName |
string |
否 |
EMR 叢集的資料庫。 |
abc |
| DataSourceType |
string |
否 |
資料類型，包括 odps 和 emr。 |
emr |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
返回結果。 |
||
| RequestId |
string |
請求 ID。 |
0bc1411515937**** |
| Data |
object |
基本中繼資料資訊。 |
|
| Type |
string |
資料庫類型。 |
hive |
| Comment |
string |
備忘。 |
備忘 |
| CreateTime |
integer |
建立引擎的時間。 |
1541576644000 |
| ProjectId |
integer |
工作空間 ID。 |
22 |
| ProjectName |
string |
工作空間的名稱。 |
test |
| AppGuid |
string |
引擎 ID，格式為 |
odps.engine_name |
| OwnerName |
string |
工作空間 Owner 的名稱。 |
my_name |
| OwnerId |
string |
工作空間 Owner 的雲帳號 ID。 |
userId |
| EnvType |
integer |
環境類型：0 表示非生產表，1 表示生產表。 |
1 |
| ProjectNameCn |
string |
工作空間的顯示名稱。 |
測試專案 |
| Endpoint |
string |
服務地址 Endpoint。 |
http://service.odpsstg.aliyun-inc.com/ |
| ClusterBizId |
string |
emr 叢集 id。 |
abc |
| Name |
string |
資料庫名稱。 |
abc |
| Location |
string |
emr 資料庫對應資料存放區地址。 |
hdfs:// |
| TenantId |
integer |
租戶 ID。 |
233 |
| ModifyTime |
integer |
修改引擎的時間。 |
1541576644000 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "0bc1411515937****",
"Data": {
"Type": "hive",
"Comment": "備忘",
"CreateTime": 1541576644000,
"ProjectId": 22,
"ProjectName": "test",
"AppGuid": "odps.engine_name",
"OwnerName": "my_name",
"OwnerId": "userId",
"EnvType": 1,
"ProjectNameCn": "測試專案",
"Endpoint": "http://service.odpsstg.aliyun-inc.com/",
"ClusterBizId": "abc",
"Name": "abc",
"Location": "hdfs://",
"TenantId": 233,
"ModifyTime": 1541576644000
}
}錯誤碼
|
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 | InternalError.UserId.Missing | An internal system error occurred. Try again later. | |
| 400 | InternalError.Meta.NoCalcEngine | An error occurred while retrieving the compute engine based on the MaxCompute project. | 使用者輸入的 project 不正確 |
| 400 | InvalidParameter.Meta.NotExist | The data does not exist. | 資料不存在。 |
| 500 | InternalError.System | An internal system error occurred. Try again later. | |
| 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. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。