IBM Cloud Docs
更改配置

更改配置

在 UI 中更改配置

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

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

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

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

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

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

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

    路由类型的更改可能需要几分钟才能应用,具体取决于现有连接的数量。

    重要路由类型注意事项

    • 要切换到不同的路由类型,必须删除任何不在中转网关本地的连接。
    • 当您从特定 Transit Gateway 的“本地”路由更改为“全局”路由时,将向您收取所有关联连接流量的费用。
    • 中转网关必须有少于 30 个连接才能更改路由类型。

从 CLI 更改配置

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

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

其中:

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

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

    • -路由:可选:资源的网关路由 (global | local)。选择 global 可跨区域连接资源。 将路由从 global 改为 local 时,要求所有现有连接都是本地连接。
  • -- 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
** global**
Required
boolean

示例

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

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