IBM Cloud Docs

在控制台中更新“专用路径”服务

要更新 IBM Cloud 控制台的专用路径提供程序服务，请执行以下步骤:

从浏览器打开 IBM Cloud 控制台并登录账户。
选择导航菜单 ，然后单击基础架构 > 网络 > 专用路径服务。
在“VPC 的专用路径服务”表中，找到并单击要更新的专用路径服务的名称。
在“专用路径详细信息”页面上，单击要更新的详细信息旁边的“编辑”图标。

您也可以在您的“私人路径”服务中更新“私人路径”NLB的成员。有关详细信息，请参阅更新控制台中的网络负载平衡器。

在控制台中更新“专用路径”服务的目标服务

如果要在不更改负载均衡器的情况下更新实际目标服务，那么无需在“专用路径”服务中执行任何操作。而是需要更新专用路径网络负载均衡器。更多信息，请参阅审核连接请求。

要在 IBM Cloud 控制台中更新专用路径提供程序服务的目标服务，请执行以下步骤:

从浏览器打开 IBM Cloud 控制台并登录账户。
选择导航菜单 ，然后单击基础设施 > 网络 > 负载平衡器。
选择负载均衡器的区域。
选择要更新的负载平衡器。
选择后端池>创建池，为更新的服务创建新的服务器池。
选择池的新选项。可以选择以下选项：
- 池名称: 池的名称。理想情况下，描述此池所执行的功能的名称。
- 协议: 流量的网络流量协议。
- 方法: 池的负载均衡算法。
- 会话粘性：用户会话期间的所有请求是否都发送到同一个实例。
- 运行状况检查: 有关配置运行状况检查的更多信息，请参阅使用运行状况检查。
通过将方法设置为旧池和新池的加权循环法，确保为新提供程序服务配置这些服务器。将新池的权重设置为非零值，将旧池的权重设置为零值。这会将流量从旧服务器池重定向到新服务器池。
更新现有前端侦听器以完成将负载均衡器连接到此新池。在负载均衡器详细信息页面上，单击 前端侦听器 选项卡。在表格中，单击现有监听器行尾的导航，然后单击编辑。
在出现的菜单中，点击编辑。在“缺省后端池”下，输入新池的标识。单击保存。

在控制台中删除专用路径服务

要在 IBM Cloud 控制台中删除专用路径服务，请执行以下步骤:

撤销与任何活动 VPE 网关关联的帐户。有关更多信息，请参阅更新和删除帐户策略。

消费者会收到账户被拒绝的通知，VPE 网关也会变为 "failed 状态。
从浏览器打开 IBM Cloud 控制台并登录账户。
选择导航菜单 ，然后单击基础设施 > 网络 > 专用路径服务。
在 VPC 专用路径服务表中，找到要删除的专用路径服务，然后单击操作菜单中的删除。

从 CLI 更新提供者服务

以下示例显示如何从 CLI 更新专用路径提供程序服务。

要从 CLI 更新专用路径服务，请执行以下步骤:

输入以下命令：

ibmcloud is private-path-service-gateway-update PRIVATE_PATH_SERVICE_GATEWAY --name NEW_NAME [--default-access-policy deny | permit | review] [--load-balancer LOAD_BALANCER] [--published] [--zonal-affinity false | true] [--output JSON] [-q, --quiet]

其中：

PRIVATE_PATH_SERVICE_GATEWAY: 表示专用路径服务的 ID 或名称。
--default-access-policy: 表示对没有明确账户策略的账户绑定使用的策略。 deny，permit 和 review 之一。缺省值: deny。
--load-balancer: 表示此“专用路径”服务负载平衡器的 ID 或名称。
--published: 表示该专用路径服务的可用性。如果传递，那么值将设置为 true。 true 值表示帐户可以请求对此专用路径服务的访问权。
--zonal-affinity: 表示此专用路径服务是否具有区域亲和性。其中一个: false，true。
--name: 指示专用路径服务的新名称。
--output: 指定输出格式，仅支持 JSON。以下项之一：JSON。
-q, --quiet: 禁止详细输出。

用于更新专用路径服务的命令示例

更新专用路径服务： ibmcloud is private-path-service-gateway-update r006-2e671f14-19fc-4089-9ad3-973176711259 --name cli-ppsg-2 --default-access-policy deny --load-balancer r006-d-740be75d-be41-48bd-b6e4-89946ddcac4a --zonal-affinity false --published
更新专用路径服务： ibmcloud is private-path-service-gateway-update cli-ppsg-2 --name cli-ppsg-0 --default-access-policy review --load-balancer my-cli-nlb-1 --zonal-affinity false --published

从 CLI 删除专用路径服务

以下示例显示如何使用 CLI 来删除专用路径服务。

开始之前，请确保设置 CLI 环境。

要从 CLI 中删除专用路径服务，请执行以下步骤:

输入以下命令：

ibmcloud is private-path-service-gateway-delete (PRIVATE_PATH_SERVICE_GATEWAY1 PRIVATE_PATH_SERVICE_GATEWAY2 ...)
    [--output JSON] [-f, --force] [-q, --quiet]

其中：

PRIVATE_PATH_SERVICE_GATEWAY1: 表示专用路径服务的 ID 或名称。
PRIVATE_PATH_SERVICE_GATEWAY2: 表示专用路径服务的 ID 或名称。
--output: 指定输出格式，仅支持 JSON。以下项之一：JSON。
force, -f: 不经确认强制执行操作。
-q, --quiet: 禁止详细输出。

用于删除专用路径网关的命令示例

删除多个专用路径服务: ibmcloud is ppsgd r006-01cd30f7-e6f2-432f-9520-76247b1fbbe1 r006-72940467-a4db-487f-b57e-b7141ac40e32
删除多个专用路径服务: ibmcloud is private-path-service-gateway-delete cli-ppsg-0 cli-ppsg-1

使用应用程序接口更新专用路径服务

要使用 API 更新专用路径提供程序服务，请执行以下步骤:

设置 API 环境。
将以下值存储在要在 API 命令中使用的变量中:
- ppsgId-获取专用路径服务，然后填充变量:
```
export ppsgId=<your_ppsg_id>
```

启动所有变量时，请执行下列其中一项操作:

要更新专用路径服务，请执行以下操作:

curl -X PATCH -sH "Authorization:${iam_token}" \
"$vpc_api_endpoint/v1/private_path_service_gateways/$ppsgId?version=$api_version&generation=2" \
-d {
   "zonal_affinity": true
 }'

以上示例将专用路径服务区域亲缘关系更新为 true。

使用 API 删除专用路径服务

要使用 API 删除专用路径服务，请执行以下步骤:

设置 API 环境。
将以下值存储在要在 API 命令中使用的变量中:
- ppsgId-获取专用路径服务，然后填充变量:
```
export ppsgId=<your_ppsg_id>
```

启动所有变量时，请执行下列其中一项操作:

要删除专用路径服务:

curl -X DELETE -sH "Authorization:${iam_token}" \
"$vpc_api_endpoint/v1/private_path_service_gateways/$ppsgId?version=$api_version&generation=2"

使用 Terraform 更新和删除专用路径服务

使用 Terraform 更新和删除专用路径服务时使用的是相同的资源。

下面的示例通过使用 Terraform 更新和删除与专用路径网络绑定的端点网关：

resource "ibm_is_private_path_service_gateway" "ppsg" {
    default_access_policy = "deny"
    load_balancer = ibm_is_lb.ppnlb.id
    service_endpoints = ["my-service.example.com"]
    zonal_affinity = false
    name = "my-example-ppsg"
}

有关 Terraform 资源的文档，请参阅 Terraform 注册表。