Function
This API is used to delete a specified table.
URI
- URI format
DELETE /v1.0/{project_id}/databases/{database_name}/tables/{table_name}
- Parameter description
Table 1 URI parameters Parameter
Mandatory
Type
Description
project_id
Yes
String
Project ID, which is used for resource isolation. For details about how to obtain its value, see Obtaining a Project ID.
database_name
Yes
String
Name of the database where the table to be deleted resides.
table_name
Yes
String
Name of the table to be deleted.
Table 2 query parameter description Parameter
Mandatory
Type
Description
async
No
Boolean
Specifies whether to delete the database in asynchronous mode. The value can be true or false. Default value: false.
The following is an example of the URL containing the query parameter:
DELETE /v1.0/{project_id}/databases/{database_name}/tables/{table_name}?async={is_async}
Request
None
Response
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
is_success |
No |
Boolean |
Indicates whether the request is successfully executed. Value true indicates that the request is successfully executed. |
message |
No |
String |
System prompt. If execution succeeds, the parameter setting may be left blank. |
job_mode |
No |
String |
Job execution mode. The options are as follows:
|
Example Request
None
Example Response
{
"is_success": true,
"message": ""
}
Status Codes
Table 4 describes the status code.
Error Codes
If an error occurs when this API is invoked, the system does not return the result similar to the preceding example, but returns the error code and error information. For details, see Error Codes.