Cloud Control API:Call the Cloud Control API through PrivateLink

Etapa 1: Faça login no console

1. Faça login no console da VPC.

2. No painel de navegação à esquerda, clique em Endpoints.

3. Na aba Interface Endpoint, clique em Enable PrivateLink.

Etapa 2: Selecione uma região

Na lista suspensa Region, selecione uma região:

• Para acessar o service doméstico, selecione China (Zhangjiakou).

• Para acessar o service internacional, selecione Singapore.

Etapa 3: Configure as informações básicas

Etapa 4: Selecione um endpoint service

1. Na caixa de pesquisa Endpoint Service, insira o nome do service conforme o seu service de destino:

   • Serviço doméstico: com.aliyuncs.privatelink.cn-zhangjiakou.cloudcontrol-api

   • Serviço internacional: com.aliyuncs.privatelink.ap-southeast-1.cloudcontrol

2. Selecione o endpoint service nos resultados da pesquisa.

Etapa 5: Ative um nome de domínio personalizado

Selecione Enable Custom Domain Name. O sistema atribui automaticamente um nome de domínio privado.

• Nome de domínio do service doméstico: cloudcontrol.vpc-proxy.aliyuncs.com

• Nome de domínio do service internacional: cloudcontrol-vpc.ap-southeast-1.aliyuncs.com

Etapa 6: Configure as definições de rede

Exemplo de configuração multizona:

Zone A: vsw-xxxxx 
Zone B: vsw-yyyyy 

Etapa 7: Configure uma política de endpoint

Uma política de endpoint define quais contas da Alibaba Cloud ou usuários RAM podem acessar o service por meio do endpoint.

Política padrão (permite todos):

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": "*",
      "Action": "*",
      "Resource": "*"
    }
  ]
}

Política recomendada (permite apenas a conta atual):

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

Etapa 8: Crie e verifique

1. Clique em OK para criar o endpoint.

2. Aguarde de 2 a 5 minutos até que o status do endpoint se torne Active.

3. O status da conexão mudará para Connected.

Descrições de status:

• Creating: O endpoint está sendo criado.

• Active: O endpoint está pronto para uso.

• Abnormal : A criação falhou ou a conexão não está funcionando. Verifique sua configuração. Após a criação do endpoint, confirme o seguinte na página de detalhes: na seção Basic Information, o Status deve ser Active e o Connection Status deve ser Connected. Na seção Endpoint Service Domain Name, verifique se o Custom Domain Name está ativado e exibe o domínio esperado.

Etapa 1: Crie o endpoint na região de destino

• Crie um endpoint em cn-zhangjiakou ou ap-southeast-1. Para obter instruções, consulte Same-region configuration.

• Anote o ID da VPC onde o endpoint está localizado.

Etapa 2: Conecte as regiões com o CEN

Para obter informações sobre como configure o CEN, consulte Connect VPCs across regions.

curl -v cloudcontrol.vpc-proxy.aliyuncs.com

curl -v cloudcontrol-vpc.ap-southeast-1.aliyuncs.com

< HTTP/1.1 401 Unauthorized
< date: Thu, 09 Oct 2025 10:30:00 GMT
< content-type: application/json
< x-acs-request-id: 23C12345-1234-1234-1234-123456789ABC
< x-acs-trace-id: 0b12345678901234567890123456789a
...

Exemplo em Java

import com.aliyun.cloudcontrol20220830.Client;
import com.aliyun.teaopenapi.models.Config;
public class PrivateLinkExample {
    public static void main(String[] args) throws Exception {
        // Configure the client.
        Config config = new Config()
            .setAccessKeyId("<YOUR-ACCESS-KEY-ID>")
            .setAccessKeySecret("<YOUR-ACCESS-KEY-SECRET>")
            // Use the private endpoint.
            // For the domestic service
            .setEndpoint("cloudcontrol.vpc-proxy.aliyuncs.com")
            .setHost("cloudcontrol.aliyuncs.com")
            // For the international service
            // .setEndpoint("cloudcontrol-vpc.ap-southeast-1.aliyuncs.com")
            .setProtocol("https");
        Client client = new Client(config);
        // Use the client object for subsequent API calls.
        try {
            var response = client.listResources(...);
            System.out.println("Request successful: " + response.getBody().getRequestId());
        } catch (Exception e) {
            System.err.println("Request failed: " + e.getMessage());
        }
    }
}