Manually mounts a table to a specified business folder to correct an incorrect folder mounting. When Replace is set to true, existing folder relationships of the table are unbound first (remount).
Operation description
Manually mounts a table to a specified business folder to correct an incorrect folder mounting. This operation uses single-mount semantics (mounting to a new folder automatically unbinds the old folder) and only allows mounting to leaf folders. If neither CategoryId nor CategoryPath is specified, the operation degrades to a pure unbind operation.
Try it now
Test
RAM authorization
Request syntax
POST / HTTP/1.1Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| DbId |
string |
Yes |
The database ID. You can call the ListDatabases operation to query the database ID. |
1*** |
| Tid |
integer |
No |
The tenant ID. Note
You can view the tenant ID by hovering over the profile icon in the upper-right corner of the console. For more information, see View tenant information. |
3*** |
| TableName |
string |
Yes |
The table name. |
order_info |
| CategoryId |
integer |
No |
The ID of the target leaf folder. Specify either this parameter or CategoryPath (this parameter takes priority). You can query the ID by calling ListAssetCategories. If neither this parameter nor CategoryPath is specified, the operation only unbinds the existing folder of the table. |
123 |
| CategoryPath |
string |
No |
The path of the target folder (levels separated by /). The path locates existing folders level by level, with a maximum depth of 4 levels. The final folder must be a leaf folder. |
BusinessDomain/Transaction/Order |
| ParentCategoryId |
integer |
No |
The ID of the parent folder from which CategoryPath starts. Leave empty to start from the root folder. |
100 |
| CreateMissingCategory |
boolean |
No |
Specifies whether to create folders level by level if the folder specified by CategoryPath does not exist. Default value: false, which returns a 404 error to prevent accidental folder creation from an incorrect path. |
false |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response content. |
||
| RequestId |
string |
Id of the request |
0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931 |
| ErrorCode |
string |
The error code. |
UnknownError |
| ErrorMessage |
string |
The error message. |
UnknownError |
| Success |
boolean |
Indicates whether the request was successful. Valid values:
|
true |
| Data |
object |
The mount result. |
|
| TableId |
integer |
The table ID. |
1760934XXX |
| CategoryId |
integer |
The ID of the folder to which the table is finally mounted. This value is empty for a pure unbind operation (when no folder parameter is specified). |
FC-0F46B2A2E4FA22AF |
| NewlyMounted |
boolean |
Indicates whether a new mount relationship was created. A value of false indicates that the relationship between the table and the target folder already exists. |
|
| RemovedCategoryIds |
array |
The list of original folder IDs that were unbound during this operation. Under single-mount semantics, mounting to a new folder automatically unbinds the old folder. |
|
|
integer |
The ID of the original folder that was unbound during this operation. |
123 |
Examples
Success response
JSON format
{
"RequestId": "0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931",
"ErrorCode": "UnknownError",
"ErrorMessage": "UnknownError",
"Success": true,
"Data": {
"TableId": 0,
"CategoryId": 0,
"NewlyMounted": false,
"RemovedCategoryIds": [
123
]
}
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.