Cloud Control API:Call the Cloud Control API through PrivateLink

Paso 1: Inicie sesión en la consola

1. Inicie sesión en la consola de VPC.

2. En el panel de navegación izquierdo, haga clic en Endpoints.

3. En la pestaña Interface Endpoint, haga clic en Enable PrivateLink.

Paso 2: Seleccione una región

En la lista desplegable Región, seleccione una región:

• Para acceder al servicio nacional, seleccione China (Zhangjiakou).

• Para acceder al servicio internacional, seleccione Singapore.

Paso 3: Configure la información básica

Paso 4: Seleccione un servicio de endpoint

1. En el cuadro de búsqueda Endpoint Service, introduzca el nombre del servicio según el servicio de destino:

   • Servicio nacional: com.aliyuncs.privatelink.cn-zhangjiakou.cloudcontrol-api

   • Servicio internacional: com.aliyuncs.privatelink.ap-southeast-1.cloudcontrol

2. Seleccione el servicio de endpoint en los resultados de la búsqueda.

Paso 5: Habilite un nombre de dominio personalizado

Seleccione Enable Custom Domain Name. El sistema asigna un nombre de dominio privado automáticamente.

• Nombre de dominio del servicio nacional: cloudcontrol.vpc-proxy.aliyuncs.com

• Nombre de dominio del servicio internacional: cloudcontrol-vpc.ap-southeast-1.aliyuncs.com

Paso 6: Configure los parámetros de red

Ejemplo de configuración de varias zonas:

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

Paso 7: Configure una política de endpoint

Una política de endpoint define qué cuentas de Alibaba Cloud o usuarios de RAM pueden acceder al servicio a través del endpoint.

Política predeterminada (permite todo):

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

Política recomendada (permite solo la cuenta actual):

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

Paso 8: Cree y compruebe

1. Haga clic en OK y cree el endpoint.

2. Espere de 2 a 5 minutos a que el estado del endpoint sea Active.

3. El estado de la conexión cambia a Connected.

Descripciones de estados:

• Creating: El endpoint se está creando.

• Active: El endpoint está listo para su uso.

• Abnormal: La creación terminó con errores o la conexión no funciona. Compruebe su configuración. Después de crear el endpoint, compruebe lo que se indica a continuación en su página de detalles: que en la sección Información básica, el Estado sea Active y el Estado de conexión sea Connected. En la sección Nombre de dominio del servicio de endpoint, confirme que el Nombre de dominio personalizado está habilitado y muestra el dominio esperado.

Paso 1: Cree un endpoint en la región de destino

• Cree un endpoint en cn-zhangjiakou o ap-southeast-1. Para obtener instrucciones, consulte Same-region configuration.

• Registre el ID de la VPC donde se encuentra el endpoint.

Paso 2: Conecte regiones con CEN

Para obtener información sobre cómo configurar 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
...

Ejemplo de 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());
        }
    }
}