发布和取消发布“专用路径”服务

验证成功 连接到您的私有路径服务 后,您必须发布您的服务,以便部署给消费者。

如果未发布“专用路径”服务,则无法在账户之外访问该服务。

任何账户都可以通过发布内容来申请使用“私人路径”服务。 如有必要,您也可以取消发布,因为访问权限仅限于创建“专用路径”服务的账户。

你可以使用控制台、CLI、API 或 Terraform 发布或取消发布 IBM Cloud® Private Path 服务。

在控制台中发布“专用路径”服务

要在 IBM Cloud 控制台中发布私有路径服务,请按照以下步骤操作:

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

  2. 选择导航菜单 导航菜单图标,然后单击基础架构 VPC 图标 > 网络 > 专用路径服务。

  3. 在表中找到新“专用路径”服务的名称,然后单击该名称查看“专用路径”服务详细信息页面。

  4. 单击操作菜单中的发布 操作菜单。

    VPC 专用路径服务表中的“发布”列更改为 Published。

“专用路径”服务现在面向其他帐户公开,以通过虚拟专用端点 (VPE) 网关连接到该服务。

发布后,连接到专用路径服务的客户就能看到专用路径服务名称。

在控制台中取消发布“专用路径”服务

要在 IBM Cloud 控制台中取消发布私有路径服务,请按照以下步骤操作:

  1. 从浏览器打开 IBM Cloud 控制台 并登录账户。
  2. 选择导航菜单 菜单图标,然后单击基础设施 > 网络 > 专用路径服务。
  3. 在“VPC 专用路径服务”表中,找到要取消发布的“专用路径”,然后单击该“专用路径”服务的名称。
  4. 在“专用路径”服务详细信息页面,单击“操作”菜单,然后单击“解除发布”。
  5. 确认要取消发布“专用路径”服务。

从 CLI 发布专用路径服务

以下示例显示如何使用 CLI 发布专用路径服务。

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

要从 CLI 发布专用路径服务,请执行以下步骤:

  1. 输入以下命令:
ibmcloud is private-path-service-gateway-publish PRIVATE_PATH_SERVICE_GATEWAY
    [--output JSON]
    [-f, --force]
    [-q, --quiet]

其中:

PRIVATE_PATH_SERVICE_GATEWAY
表示专用路径服务的 ID 或名称。
--output
表示输出格式,仅支持 JSON。 以下项之一:JSON。
-q, --quiet
禁止详细输出。

命令示例

  • 发布私人路径服务: ibmcloud is ppsgp r006-01cd30f7-e6f2-432f-9520-76247b1fbbe1 ibmcloud is private-path-service-gateway-publish cli-ppsg-0

从 CLI 取消发布专用路径服务

下面的示例显示了如何使用 CLI 取消发布“专用路径”服务。

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

要从 CLI 取消发布“专用路径”服务,请按照以下步骤操作:

  1. 输入以下命令:
ibmcloud is private-path-service-gateway-unpublish PRIVATE_PATH_SERVICE_GATEWAY
    [--output JSON]
    [-f, --force]
    [-q, --quiet]

其中:

PRIVATE_PATH_SERVICE_GATEWAY
表示专用路径服务的 ID 或名称。
--output
表示输出格式,仅支持 JSON。 以下项之一:JSON。
-q, --quiet
禁止详细输出。

使用 API 发布专用路径服务

要使用 API 发布专用路径服务,请执行以下步骤:

  1. 设置 API 环境。

  2. 将以下值存储在要在 API 命令中使用的变量中:

    • ppsgId-获取专用路径服务,然后填充变量:

      export ppsgId=<your_ppsg_id>
      
  3. 启动所有变量后,发布“专用路径”服务:

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

使用 API 取消发布“专用路径”服务

要使用 API 取消发布“专用路径”服务,请按照以下步骤操作:

  1. 设置 API 环境。

  2. 将以下值存储在要在 API 命令中使用的变量中:

    • ppsgId-获取专用路径服务,然后填充变量:

      export ppsgId=<your_ppsg_id>
      
  3. 启动所有变量后,取消发布“专用路径”服务:

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

命令示例

  • 发布私人路径服务: ibmcloud is ppsgunp r006-01cd30f7-e6f2-432f-9520-76247b1fbbe1 ibmcloud is private-path-service-gateway-unpublish cli-ppsg-0

使用 Terraform 发布私有路径服务

下面的示例使用 Terraform 发布了专用路径网络:

resource "ibm_is_private_path_service_gateway_operations" "publish" {
  published = true
  private_path_service_gateway = ibm_is_private_path_service_gateway.ppsg.id
}

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

使用 Terraform 解除发布私有路径服务

Terraform 在达到通用可用性(GA)并正式发布后将支持该功能。

下面的示例通过使用 Terraform 解除发布专用路径网络:

resource "ibm_is_private_path_service_gateway_operations" "publish" {
  published = false
  private_path_service_gateway = ibm_is_private_path_service_gateway.ppsg.id
}

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

后续步骤

  1. 向使用者传达连接信息
  2. 查看连接请求 和 创建帐户策略