手動將資料表掛載到指定業務目錄，用於修正錯誤的目錄掛載；Replace=true 時先解除該資料表其他已有目錄關係（改掛）
介面說明
手動將資料表掛載到指定業務目錄，用於修正錯誤的目錄掛載；單掛載語意（掛新目錄會自動解除舊目錄），只能掛到葉子目錄；不傳 CategoryId 與 CategoryPath 時退化為純解除綁定。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求文法
POST / HTTP/1.1請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| DbId |
string |
是 |
資料庫 ID，可以呼叫 ListDatabases 介面獲取。 |
1*** |
| Tid |
integer |
否 |
租戶 ID。 說明
取自系統右上角頭像處懸停顯示的租戶 ID 資訊，詳情請參見查看租戶資訊。 |
3*** |
| TableName |
string |
是 |
資料表名稱。 |
order_info |
| CategoryId |
integer |
否 |
目標葉子目錄 ID，與 CategoryPath 二選一（優先生效），可透過 ListAssetCategories 查詢；與 CategoryPath 都不傳時僅解除該資料表現有目錄。 |
123 |
| CategoryPath |
string |
否 |
目標目錄路徑（層級用 / 分隔），逐層定位已有目錄，最深 4 層；最終目錄必須是葉子目錄。 |
業務域/交易/訂單 |
| ParentCategoryId |
integer |
否 |
CategoryPath 的起始父目錄 ID，留空表示從根目錄開始。 |
100 |
| CreateMissingCategory |
boolean |
否 |
CategoryPath 對應目錄不存在時是否逐層建立，預設 false 直接回報 404，避免誤傳路徑憑空建立目錄。 |
false |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
返回內容。 |
||
| RequestId |
string |
Id of the request |
0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931 |
| ErrorCode |
string |
錯誤碼。 |
UnknownError |
| ErrorMessage |
string |
錯誤訊息。 |
UnknownError |
| Success |
boolean |
請求是否成功，返回值如下：
|
true |
| Data |
object |
掛載結果。 |
|
| TableId |
integer |
資料表 ID。 |
1760934XXX |
| CategoryId |
integer |
最終掛載到的目錄 ID；純解除綁定（不傳目錄參數）時為空。 |
FC-0F46B2A2E4FA22AF |
| NewlyMounted |
boolean |
是否新建了掛載關係，false 表示資料表與目標目錄的關係已存在。 |
|
| RemovedCategoryIds |
array |
本次被解除綁定的原目錄 ID 列表（單掛載語意下掛新目錄會自動解除舊目錄）。 |
|
|
integer |
本次被解除綁定的原目錄 ID。 |
123 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931",
"ErrorCode": "UnknownError",
"ErrorMessage": "UnknownError",
"Success": true,
"Data": {
"TableId": 0,
"CategoryId": 0,
"NewlyMounted": false,
"RemovedCategoryIds": [
123
]
}
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。