All Products
Search
Document Center

Tablestore:Delete a tunnel

Last Updated:Sep 29, 2026

Use Tablestore SDK for Go to delete an unused tunnel from a table. A deleted tunnel cannot be restored.

Usage notes

  • Make sure no data is being consumed in the channel before you delete it. Deleting a channel while data consumption is active may cause consumption failures.

  • A deleted channel cannot be restored. Proceed with caution.

Parameters

Request parameters

Parameter

Description

TableName

The name of the data table whose tunnel you want to delete. Call the ListTable operation to get the names of tables in an instance. For more information, see List the names of tables.

TunnelName

The name of the tunnel. Call the ListTunnel operation to get information about all tunnels of a data table. For more information, see Query information about all tunnels of a data table.

Response parameters

Parameter

Description

ResponseInfo

Additional fields returned in the response, including RequestId. RequestId uniquely identifies the request.

Examples

The following code deletes a tunnel from a data table:

req := &tunnel.DeleteTunnelRequest {
   TableName: "<TABLE_NAME>",
   TunnelName: "<TUNNEL_NAME>",
}
_, err := tunnelClient.DeleteTunnel(req)
if err != nil {
   log.Fatal("delete tunnel failed", err)
}

References

  • For information about the API operation that you can call to delete a tunnel, see DeleteTunnel.

  • If an error occurs when you call the DeleteTunnel operation, search for the error cause in Error codes based on the error message and handle the error.