IBM Cloud Docs
更改配置

更改配置

在 UI 中更改配置

要在 UI 中更改 Transit Gateway 配置,请执行以下步骤:

  1. 从浏览器打开 IBM Cloud 控制台并登录账户。

  2. 从左上角选择导航菜单图标 导航菜单图标,然后单击基础架构 > 网络 > Transit Gateway

  3. 单击要编辑的中转网关名称。

    如果您位于展开的视图中,请单击 查看详细信息

  4. 从“连接”页面中,单击右上角的 操作,然后选择 编辑

    从此处,您可以更改网关的名称及其路由类型 (本地或全局)。

    要将 Transit Gateway 的路由类型从全局更改为本地,必须删除并非本地到 Transit Gateway 位置的任何连接。

    当您从特定 Transit Gateway 的“本地”路由更改为“全局”路由时,将向您收取所有关联连接流量的费用。

从 CLI 更改配置

要从 CLI 更新现有网关上的属性,请运行以下命令:

ibmcloud tg gateway-update|gwu GATEWAY_ID [--name NAME] [--routing ROUTING] [--output json] [-h, --help]

其中:

  • GATEWAY_ID: 要更新的网关的标识。

  • -- name: 可选: 网关的新名称。

    • -路由:可选:资源的网关路由(全局 | 本地)。 选择全局可跨区域连接资源。 将路由从全局路由更改为本地路由需要所有现有连接都是本地连接。
  • -- output JSON: 可选: 指定是否需要以 JSON 格式显示的输出。

  • --help |-h:可选:获取该命令的帮助。

示例

此示例说明如何使用路由值 global 更新网关:

ibmcloud tg gwu $gateway --routing global

使用 API 更改配置

您可以使用 API 更新 Transit Gateway 的名称和/或全局参数。

请求示例

此示例说明如何使用 API 更改配置:

PATCH /transit_gateways/{id}
"{base_url}/transit_gateways/{id}?version={version}"
{
  "global": true,
  "name": "my-transit-gateway"
}

响应示例

此响应指示已成功更新 Transit Gateway:

{
  "created_at": "2020-03-31T12:08:05Z",
  "crn": "crn:[...]",
  "global": false,
  "id": "ef4dcb1a-fee4-41c7-9e11-9cd99e65c1f4",
  "location": "us-south",
  "name": "example-gateway-new-name",
  "resource_group": {
    "id": "56969d6043e9465c883cb9f7363e78e8"
  },
  "status": "available",
  "updated_at": "2020-03-31T12:08:05Z"
}

有关更多信息,请参阅 Transit Gateway API 参考中的 Update specified Transit Gateway

使用 Terraform 更改配置

使用 Terraform 更改 Transit Gateway 的配置时,可以为资源指定以下参数引用:

用于更改配置的 Terraform 参数引用
参数 详细信息
name
Required
Boolean
网关的唯一用户定义的名称。 例如,myGateway
global
必需
布尔值
具有全局路由 (true) 的网关,用于连接到其关联区域外部的网络。

示例

此示例说明如何更改 Transit Gateway 的配置:

resource "ibm_tg_gateway" "new_tg_gw"{
name="transit-gateway-1"
location="us-south"
global=true
resource_group="30951d2dff914dafb26455a88c0c0092"
}