更改配置
在 UI 中更改配置
要在 UI 中更改 Transit Gateway 配置,请执行以下步骤:
-
从浏览器打开 IBM Cloud 控制台并登录账户。
-
从左上角选择导航菜单图标 导航
,然后单击基础架构 > 网络 > Transit Gateway。
-
单击要编辑的中转网关名称。
如果您位于展开的视图中,请单击 查看详细信息。
-
从“连接”页面中,单击右上角的 操作,然后选择 编辑。
从此处,您可以更改网关的名称及其路由类型 (本地或全局)。
要将 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 的配置时,可以为资源指定以下参数引用:
参数 | 详细信息 |
---|---|
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"
}