Endpoints de gateways de API - OpenAPI Explorer: Central de Documentação do Alibaba Cloud

Um endpoint é o ponto de entrada para acessar um serviço da Alibaba Cloud. Ele define o endereço de rede, incluindo protocolo, nome do host e porta, usados para fazer requisições de API a serviços como Alibaba Cloud Model Studio, Elastic Compute Service (ECS) e Object Storage Service (OSS).

Classificação de endpoints

Tipos de endpoint por ambiente de rede

Os endpoints classificam-se conforme o ambiente de rede de acesso.

Ambiente de rede	Descrição	Características
Endpoint público	Endereço acessível pela Internet.	Permite acesso de qualquer local, incluindo data centers on-premises, outros provedores de nuvem ou dispositivos pessoais. A transferência de dados ocorre pela Internet. Ideal para cenários que exigem acesso entre regiões ou externo.
Endpoint de VPC	Endereço acessível apenas dentro de uma VPC da Alibaba Cloud.	Os dados trafegam inteiramente pela rede interna da Alibaba Cloud, o que oferece maior segurança e privacidade. O tráfego na rede interna da VPC geralmente apresenta latência menor que o tráfego da Internet. Reduz os custos com tráfego de Internet.

Tipos de endpoint por modelo de implantação

Os endpoints também se categorizam conforme o modelo de implantação do serviço subjacente.

Modelo de implantação	Descrição	Características
Endpoint central	O serviço é implantado em uma ou poucas regiões principais, e todas as requisições dos usuários são processadas nessas regiões.	Os usuários acessam o serviço pelo mesmo endpoint em qualquer região suportada. Pode resultar em maior latência para usuários geograficamente distantes da região principal.
Endpoint regional	O serviço é implantado em várias regiões, e as requisições dos usuários são processadas na região específica de destino.	Os recursos ficam isolados entre as regiões. Diminui a latência de rede e melhora a velocidade de acesso. Aumenta a disponibilidade do serviço e a capacidade de recuperação de desastres.

Formatos de endpoint

Endpoints centrais

Endpoints centrais: O formato é [product_code].aliyuncs.com para implantações em região única e [product_code].[region_id].aliyuncs.com para implantações em múltiplas regiões.

Endpoints de VPC: O formato é [product_code].vpc-proxy.aliyuncs.com. Como esse formato pode variar conforme o serviço, verifique sempre o endpoint correto para o seu serviço de nuvem específico. Para mais informações, consulte a seção "Visualizar os endpoints de um serviço de nuvem" neste tópico.

Endpoints regionais

Endpoints públicos: O formato é [product_code].[region_id].aliyuncs.com. Por exemplo, o endpoint do ECS na região China (Hangzhou) é ecs.cn-hangzhou.aliyuncs.com.

Endpoints de VPC: O formato é [product_code]-vpc.[region_id].aliyuncs.com. Por exemplo, o endpoint do ECS na região China (Hangzhou) é ecs-vpc.cn-hangzhou.aliyuncs.com.

Como escolher um endpoint

Caso de uso	Endpoint recomendado
Acesso a serviços pela Internet ou entre diferentes regiões.	Use um endpoint público. Nota Não é possível conectar-se a um endpoint de VPC em outra região, mesmo com conexões de peering de VPC ou uso da Cloud Enterprise Network (CEN) para comunicação entre VPCs. Por exemplo, não é possível conectar-se a ecs-vpc.cn-hangzhou.aliyuncs.com a partir de uma instância ECS na região cn-chengdu.
Comunicação entre recursos na mesma região, como uma instância ECS acessando uma instância do ApsaraDB RDS.	Use um endpoint de VPC.
Testes rápidos ou desenvolvimento a partir de um ambiente local.	Use um endpoint público.
Uma aplicação em uma instância ECS sem endereço IP público precisa chamar outros serviços de nuvem na mesma região.	Use um endpoint de VPC.

Visualize os endpoints de um serviço de nuvem

Consulte o tópico Endpoints na seção API Reference da documentação do serviço no Help Center.
Acesse o OpenAPI Explorer, acesse o cloud service desejado e localize os endpoints suportados na página principal.