通过PrivateLink调用云控制API

步骤1：登录控制台

1. 登录阿里云VPC控制台。

2. 在左侧导航栏中，单击进入终端节点页面。

3. 在接口终端节点中，单击创建终端节点 。

步骤2：选择地域

在“所属地域”下拉框中选择：

• 访问国内服务 → 选择华北3（张家口）。

• 访问国际服务 → 选择新加坡。

步骤3：配置基本信息

步骤4：选择终端节点服务

1. 在搜索终端节点服务输入框中，根据目标服务输入：

   • 国内服务：com.aliyuncs.privatelink.cn-zhangjiakou.cloudcontrol-api

   • 国际服务：com.aliyuncs.privatelink.ap-southeast-1.cloudcontrol

2. 搜索后会显示唯一的终端节点服务，选中即可。

步骤5：启用自定义域名

勾选开启自定义服务域名，系统会自动分配私网访问域名，无需手动填写。

• 国内服务域名：cloudcontrol.vpc-proxy.aliyuncs.com

• 国际服务域名：cloudcontrol-vpc.ap-southeast-1.aliyuncs.com

选择终端节点服务名称为 com.aliyuncs.privatelink.cn-zhangjiakou.cloudcontrol-api 的服务。

步骤6：网络配置

多可用区配置示例：

可用区A：vsw-xxxxx 
可用区B：vsw-yyyyy 

步骤7：配置访问策略

终端节点策略用于控制哪些主账号/RAM用户可以通过该终端节点访问服务。

默认策略（允许所有）：

{
  "Version"："1"，
  "Statement"：[
    {
      "Effect"："Allow"，
      "Principal"："*"，
      "Action"："*"，
      "Resource"："*"
    }
  ]
}

推荐策略（仅允许本账号）：

{
  "Version"："1"，
  "Statement"：[
    {
      "Effect"："Allow"，
      "Principal"：{
        "Aliyun"：[
          "acs：ram：YOUR_ACCOUNT_ID：root"
        ]
      }，
      "Action"："*"，
      "Resource"："*"
    }
  ]
}

步骤8：创建并验证

1. 单击确定创建，创建终端节点。

2. 等待2-5分钟，终端节点状态变为可用。

3. 连接状态显示为已连接。

状态说明：

• 创建中：终端节点正在创建。

• 可用：终端节点已就绪，可以使用。

• 异常 ：创建失败或连接异常，需要检查配置。
  终端节点创建完成后，在终端节点详情页的基本信息区域，确认状态为可用、连接状态为已连接。在终端节点服务域名区域，可查看默认服务域名，并确认自定义服务域名已启用，域名为 cloudcontrol.vpc-proxy.aliyuncs.com。
  

步骤1：在目标地域创建终端节点

• 在cn-zhangjiakou或ap-southeast-1创建终端节点。具体操作，请参见同地域配置。

• 记录终端节点所在的VPC ID。

步骤2：创建CEN实例打通region

CEN配置说明请参考跨地域VPC互通。

Java示例

import com.aliyun.cloudcontrol20220830.Client;
import com.aliyun.teaopenapi.models.Config;
public class PrivateLinkExample {
    public static void main(String[] args) throws Exception {
        // 配置客户端
        Config config = new Config()
            .setAccessKeyId("<YOUR-ACCESS-KEY-ID>")
            .setAccessKeySecret("<YOUR-ACCESS-KEY-SECRET>")
            // 使用私网域名
            .setEndpoint("cloudcontrol.vpc-proxy.aliyuncs.com")  // 国内服务
            .setHost("cloudcontrol.aliyuncs.com")  // 国内服务
            // .setEndpoint("cloudcontrol-vpc.ap-southeast-1.aliyuncs.com")  // 国际服务
            .setProtocol("https");
        Client client = new Client(config);
        // 后续使用client进行API调用
        try {
            var response = client.listResources(...);
            System.out.println("Request successful: " + response.getBody().getRequestId());
        } catch (Exception e) {
            System.err.println("Request failed: " + e.getMessage());
        }
    }
}