Updates the information about a table, such as the table folder, level, and category. This API operation will be replaced soon. We recommend that you do not call this API operation.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes UpdateTableModelInfo

The operation that you want to perform.

FirstLevelThemeId Long Yes 101

The ID of the first-level table folder.

LevelId Long Yes 101

The ID of the table level.

RegionId String Yes cn-shanghai

The ID of the region where the service is activated.

SecondLevelThemeId Long Yes 101

The ID of the second-level table folder.

TableGuid String Yes odps.test.table1

The globally unique identifier (GUID) of the table. Specify the GUID in the format of odps.{projectName}.{tableName}.

LevelType Integer No 1

The type of the table level. Valid values: 1 and 2. A value of 1 indicates the logical level. A value of 2 indicates the physical level.

Response parameters

Parameter Type Example Description
RequestId String abcde

The ID of the request.

UpdateResult Boolean true

Indicates whether the request is successful.

Examples

Sample requests

http(s)://[Endpoint]/?Action=UpdateTableModelInfo
&FirstLevelThemeId=101
&LevelId=101
&RegionId=cn-shanghai
&SecondLevelThemeId=101
&TableGuid=odps.test.table1
&<Common request parameters>

Sample success responses

XML format 

<RequestId>abcde</RequestId>
<UpdateResult>true</UpdateResult>

JSON format 

{
    "RequestId": "abcde",
    "UpdateResult": true
}

Error codes

HTTP status code Error code Error message Description
500 InternalError.System An internal system error occurred. Try again later. The error message returned because an internal error has occurred. Try again later.
500 InternalError.UserId.Missing An internal system error occurred. Try again later. The error message returned because an internal error has occurred. Try again later.
429 Throttling.Api The request for this resource has exceeded your available limit. The error message returned because the number of requests for the resource has exceeded the upper limit.
429 Throttling.Api.Risk The request for this resource has exceeded your daily available limit. The error message returned because the number of requests per day for the resource has exceeded the upper limit.
429 Throttling.System The DataWorks system is busy. Try again later. The error message returned because the DataWorks system is busy. Try again later.
429 Throttling.User Your request is too frequent. Try again later. The error message returned because excessive requests have been submitted within a short period of time. Try again later.
403 Forbidden.Access Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition. The error message returned because you are not allowed to perform this operation. Activate DataWorks Enterprise Edition or DataWorks Ultimate Edition.

For a list of error codes, visit the API Error Center.