Method: projects.locations.catalogs.databases.tables.rename

重命名由表 ID 指定的现有表。

HTTP 请求

POST https://biglake.googleapis.com/v1/{name=projects/*/locations/*/catalogs/*/databases/*/tables/*}:rename

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。该表的 name 字段用于标识要重命名的表。格式：projects/{project_id_or_number}/locations/{locationId}/catalogs/{catalogId}/databases/{databaseId}/tables/{tableId}

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "newName": string
}
字段
newName

string

必需。指定表的新 name 必须位于同一数据库中。格式：projects/{project_id_or_number}/locations/{locationId}/catalogs/{catalogId}/databases/{databaseId}/tables/{tableId}

响应正文

如果成功，则响应正文包含一个 Table 实例。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • biglake.tables.update

如需了解详情，请参阅 IAM 文档。