Required. The table's name field is used to identify the table to rename. Format: projects/{project_id_or_number}/locations/{locationId}/catalogs/{catalogId}/databases/{databaseId}/tables/{tableId}
Request body
The request body contains data with the following structure:
JSON representation
{"newName": string}
Fields
newName
string
Required. The new name for the specified table, must be in the same database. Format: projects/{project_id_or_number}/locations/{locationId}/catalogs/{catalogId}/databases/{databaseId}/tables/{tableId}
Response body
If successful, the response body contains an instance of Table.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-02 UTC."],[[["This endpoint allows you to rename a table within a specific database using its unique identifier, the table's `name`."],["The request is made using a `POST` HTTP request to a URL defined by the gRPC Transcoding syntax, which includes path parameters for specifying the table's location."],["The request body requires a JSON structure with a `newName` field that defines the table's new name, with the new name following the same structure as the original name."],["A successful request will return a response body containing the updated Table object, providing confirmation of the rename operation."],["To successfully rename the table, the request must be authenticated with either the `https://www.googleapis.com/auth/bigquery` or `https://www.googleapis.com/auth/cloud-platform` OAuth scopes, and the caller must have the `biglake.tables.update` IAM permission."]]],[]]
