Alibaba Cloud SDK:Configurar endpoints

Método 1: Especificar um endpoint (recomendado)

Especifique o endpoint ao inicializar o objeto client de um service cloud. Tanto endpoints públicos quanto de VPC são suportados.

O exemplo abaixo mostra apenas a configuração relacionada ao endpoint:

com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config();
// Set the endpoint.
config.setEndpoint("<ENDPOINT>");

Método 2: Especificar um ID da região

Caso não especifique um endpoint, informe um ID da região ao inicializar o objeto client de um service cloud. O SDK resolverá automaticamente o endpoint correspondente. Para configurar um endpoint de VPC, utilize o Método 1.

A maioria dos SDKs de services cloud define um endpointMap que mapeia IDs de região para endpoints. Por exemplo, o endpointMap no SDK do ECS contém entradas como as seguintes:

{
    "cn-zhangjiakou-na62-a01": "ecs.cn-zhangjiakou.aliyuncs.com",
    "cn-huhehaote-nebula-1": "ecs.cn-qingdao-nebula.aliyuncs.com",
    "rus-west-1-pop": "ecs.aliyuncs.com",
    ...
}

O SDK resolve o endpoint na seguinte ordem:

1. Se não existir um endpointMap, o SDK constrói o endpoint com base nas regras de construção.

2. Quando o endpointMap existe e contém o ID da região especificado, o endpoint corresponde ao valor mapeado para esse ID da região.

3. Se o endpointMap não contiver o ID da região informado, o SDK constrói o endpoint seguindo as regras de construção. As regras são:

• Serviços regionalizados: <PRODUCT_CODE><SUFFIX><NET_WORK>.<REGION_ID>.aliyuncs.com

• Serviços centralizados: <PRODUCT_CODE><SUFFIX><NET_WORK>.aliyuncs.com O tipo de implantação e o <PRODUCT_CODE> são determinados pelo SDK do service cloud utilizado. Defina os outros três parâmetros conforme o seu cenário:

• <SUFFIX>: sufixo do endpoint de VPC. Defina este parâmetro com base no sufixo do endpoint de VPC do service cloud. Não adicione hífen (-).

• <NET_WORK>: tipo de endpoint. Por padrão, utiliza-se o endpoint público. Valores válidos:

  • vpc: obtém o endpoint de VPC do service.

  • intranet: ao usar o SDK do Simple Log Service (sls20201230), obtém o endpoint de VPC do Simple Log Service.

  • accelerate: ao usar o SDK do Simple Log Service (sls20201230), obtém o endpoint de aceleração de transferência do Simple Log Service.

• <REGION_ID>: região onde o recurso reside. O exemplo abaixo mostra apenas a configuração relacionada ao endpoint:

com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config();
// Specify the region ID.
config.setRegionId("<REGION_ID>");
config.setNetwork("<NET_WORK>"); // You do not need to set this parameter for a public endpoint. For a VPC endpoint, set it to vpc.
config.setSuffix("<SUFFIX>"); // You do not need to set this parameter for a public endpoint. For a VPC endpoint, specify it based on the suffix in the VPC endpoint of the cloud service and do not add a hyphen (-).