AddTable

Adds a table for a tabular data connector.

Operation description

• Before a RAM user can call this operation, they must obtain the AliyunBailianDataFullAccess API permission, which includes the `sfm:AddTable` permission, and join a workspace. An Alibaba Cloud account can call this operation without authorization. Use the latest version of the Alibaba Cloud Model Studio SDK to call this operation.

• This operation is not idempotent.

Rate limiting: This operation is subject to rate limiting. Do not exceed a frequency of 10 calls per second. If a call is rate-limited, try again later.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage. Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

HELPCODEESCAPE-plaintext
POST /{WorkspaceId}/datacenter/table HTTP/1.1

Path Parameters

Parameter	Type	Required	Description	Example
WorkspaceId	string	Yes	The ID of the workspace. For more information about how to obtain a workspace ID, see Use workspaces.	llm-3shx2gu255oqxxxx

Request parameters

Parameter	Type	Required	Description	Example
TableName	string	Yes	The table name.	ads_wjjr_basc_enterprise_di
ConnectorId	string	Yes	The connector ID.	connector-d51861492df64257
TableColumns	array	Yes	The information about the columns in the table.
	object	Yes	The information about a single column.
ColumnName	string	Yes	The column name.	column1
ColumnDesc	string	No	The column description.	desc
DataType	string	Yes	The data type.	string

Response elements

Element	Type	Description	Example
	object	The data returned.
Code	string	The error code.	Index.Forbidden
Data	object	The data returned.
TableId	string	The table ID.	table_b6ddc67e7df14db38b74ef5e2e0fe24e_12792097
Message	string	The error message.	Required parameter(%s) missing or invalid, please check the request parameters.
RequestId	string	The ID of the request.	778C0B3B-03C1-5FC1-A947-36EDD13606AB
Status	string	The status code of the request.	200
Success	boolean	Indicates whether the request was successful. Valid values: - true: The request was successful. - false: The request failed.	True

Examples

Success response

JSON format

HELPCODEESCAPE-json
{
  "Code": "Index.Forbidden",
  "Data": {
    "TableId": "table_b6ddc67e7df14db38b74ef5e2e0fe24e_12792097"
  },
  "Message": "Required parameter(%s) missing or invalid, please check the request parameters.",
  "RequestId": "778C0B3B-03C1-5FC1-A947-36EDD13606AB",
  "Status": "200",
  "Success": true
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.