Todos os produtos
Search

Este produto

    Alibaba Cloud SDK:Configure endpoints

    Central de documentação

    Alibaba Cloud SDK:Configure endpoints

    Última atualização: Sep 21, 2026

    Ao utilizar o SDK V2.0 para chamar uma operação openapi, você precisa configure o endpoint do service da Alibaba Cloud de destino. Para crie um recurso, selecione o endpoint da região fisicamente mais próxima do seu negócio, reduzindo a latência de rede e melhorando a velocidade de resposta. Para consultar, atualize ou exclua um recurso, selecione o endpoint da região onde o recurso se encontra, pois o armazenamento de recursos é específico por região — operações entre regiões podem falhar ou introduzir riscos de consistência de dados. Este tópico descreve como configure endpoints no SDK V2.0.

    Tipos de endpoint

    Os endpoints se dividem em duas categorias: endpoints públicos e endpoints VPC. Se o seu negócio está implantado em uma VPC — por exemplo, em ECS ou ACK —, você pode acessar os recursos cloud dessa VPC por meio de um endpoint VPC. Endpoints VPC aumentam a segurança e reduzem a latência de rede. Para mais informações, consulte Endpoints.

    defina um endpoint

    O SDK V2.0 oferece duas formas de defina um endpoint: especifique o endpoint diretamente ou informar um ID de região para que o SDK obtenha o endpoint automaticamente.

    Método 1: especifique um endpoint (recomendado)

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

    O exemplo a seguir 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: especifique um ID de região

    Caso não especifique um endpoint, informe um ID de região ao inicializar o objeto client de um service cloud. O SDK resolve automaticamente o endpoint correspondente.

    A lógica de resolução de endereço funciona da seguinte forma:

    A maioria dos SDK de service cloud defina um endpointMap que mapeia IDs de região para endpoints. Por exemplo, o endpointMap no SDK do ECS é o seguinte:

    {
    "ap-northeast-2-pop": "ecs.aliyuncs.com",
    "cn-beijing-finance-pop": "ecs.aliyuncs.com",
    "cn-beijing-gov-1": "ecs.aliyuncs.com",
    "cn-beijing-nu16-b01": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-edge-1": "ecs.cn-qingdao-nebula.aliyuncs.com",
    "cn-fujian": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-haidian-cm12-c01": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-hangzhou": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-hangzhou-bj-b01": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-hangzhou-finance": "ecs.aliyuncs.com",
    "cn-hangzhou-internal-prod-1": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-hangzhou-internal-test-1": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-hangzhou-internal-test-2": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-hangzhou-internal-test-3": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-hangzhou-test-306": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-hongkong-finance-pop": "ecs.aliyuncs.com",
    "cn-huhehaote-nebula-1": "ecs.cn-qingdao-nebula.aliyuncs.com",
    "cn-north-2-gov-1": "ecs.aliyuncs.com",
    "cn-shanghai-et15-b01": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-shanghai-et2-b01": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-shanghai-finance-1": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-shanghai-inner": "ecs.aliyuncs.com",
    "cn-shanghai-internal-test-1": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-shenzhen-finance-1": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-shenzhen-inner": "ecs.aliyuncs.com",
    "cn-shenzhen-st4-d01": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-shenzhen-su18-b01": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-wuhan": "ecs.aliyuncs.com",
    "cn-yushanfang": "ecs.aliyuncs.com",
    "cn-zhangbei": "ecs.aliyuncs.com",
    "cn-zhangbei-na61-b01": "ecs-cn-hangzhou.aliyuncs.com",
    "cn-zhangjiakou-na62-a01": "ecs.cn-zhangjiakou.aliyuncs.com",
    "cn-zhengzhou-nebula-1": "ecs.cn-qingdao-nebula.aliyuncs.com",
    "eu-west-1-oxs": "ecs.cn-shenzhen-cloudstone.aliyuncs.com",
    "rus-west-1-pop": "ecs.aliyuncs.com"
}

    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 de região especificado, o endpoint corresponde ao valor mapeado para esse ID de região.

    3. Caso o endpointMap não contenha o ID de região especificado, o SDK constrói o endpoint com base nas regras de construção.

    As regras de construção são as seguintes:

    • 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. especifique os outros três parâmetros de acordo com o seu cenário:

    • <SUFFIX>: sufixo presente em um endpoint VPC. defina esse parâmetro com base no sufixo do endpoint VPC do service cloud. Não adicione hífen (-).

    • <NET_WORK>: tipo de endpoint. Por padrão, um endpoint público é utilizado. Valores válidos:

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

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

      • accelerate: ao utilizar 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 se encontra.

    Nota

    Os formatos de endpoints VPC variam bastante. Para configure um endpoint VPC, especifique o endpoint diretamente com o Método 1 em vez de construí-lo a partir de um ID de região.

    O exemplo a seguir 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 (-).

    Apêndice: Encontrar um endpoint

    Você pode encontrar o endpoint de um service cloud no portal openapi:

    1. No menu superior do portal, escolha Products e selecione um product, como ECS.

    2. Na product homepage, localize a list of service regions.

    3. selecione o endpoint correspondente ao seu ID de região e copie-o.

    Outra opção é acessar a página de depuração de API e clique em Regions no painel de navegação à esquerda para visualize os endpoints aceitos pelo service cloud.