Ao usar o SDK V2.0 para chamar uma operação OpenAPI, configure o endpoint do service da Alibaba Cloud de destino. Crie um recurso e selecione o endpoint da região fisicamente mais próxima do seu negócio para reduzir a latência de rede e melhorar a velocidade de resposta. Consulte, atualize ou exclua um recurso selecionando o endpoint da região onde o recurso está alojado, pois o armazenamento de recursos é específico por região e uma operação entre regiões pode falhar ou gerar riscos à consistência dos dados. Este tópico descreve como configurar endpoints no SDK V2.0.
Tipos de endpoint
Os endpoints se dividem em duas categorias: endpoints públicos e endpoints de VPC. Se o seu negócio estiver implantado em uma VPC, como no ECS ou ACK, você pode acessar os recursos da cloud nessa VPC por meio de um endpoint de VPC. Os endpoints de VPC melhoram 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 definir um endpoint: especifique um endpoint diretamente ou especifique um ID de região para obter o endpoint automaticamente.
-
Especifique um endpoint (recomendado): especifique o endpoint durante a inicialização do cliente. Você encontra o endpoint de um service na home do product no Portal do Desenvolvedor OpenAPI. Para mais informações, consulte o final deste tópico.
AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config { // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is set. AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"), // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is set. AccessKeySecret = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"), }; // Specify a custom endpoint. config.Endpoint = "dysmsapi.aliyuncs.com"; AlibabaCloud.SDK.Dysmsapi20170525.Client client = new AlibabaCloud.SDK.Dysmsapi20170525.Client(config); -
Especifique um RegionId: o endpoint é obtido por meio da lógica de endereçamento.
Se o SDK do service solicitado contiver um objeto de mapeamento de RegionId para endpoint e o RegionId especificado existir nesse objeto, o endpoint será obtido a partir do objeto de mapeamento.
Caso o SDK do service solicitado não contenha um objeto de mapeamento de RegionId para endpoint, ou se o RegionId especificado não existir no objeto, o endpoint é construído automaticamente com base na seguinte regra de construção:
${Product ID}.${RegionId}.aliyuncs.com.
Apêndice: Encontre um endpoint
É possível encontrar o endpoint de um cloud service no portal OpenAPI:
No menu superior do portal, escolha Products e selecione um product, como o ECS.
Na product homepage, encontre a list of service regions.
Selecione o endpoint correspondente ao seu ID de região e, em seguida, copie e cole-o.
Como alternativa, na página de depuração de API, clique em Regions no painel de navegação à esquerda para visualize os endpoints compatíveis com o cloud service.