Tous les produits
Search
Centre de documentation

Alibaba Cloud SDK:Configurer les endpoints

Dernière mise à jour :Sep 21, 2026

Lorsque vous utilisez le SDK V2.0 pour appeler une opération OpenAPI, vous devez configurer l'endpoint du service Alibaba Cloud cible. Lors de la création d'une ressource, sélectionnez l'endpoint de la région physiquement la plus proche de votre activité afin de réduire la latence réseau et d'améliorer les temps de réponse. Pour interroger, mettre à jour ou supprimer une ressource, choisissez l'endpoint de la région où celle-ci se trouve, car le stockage des ressources est spécifique à chaque région ; une opération inter-régions pourrait échouer ou entraîner des risques d'incohérence des données. Cette rubrique explique comment configurer les endpoints dans le SDK V2.0.

Types d'endpoints

Il existe deux catégories d'endpoints : les endpoints publics et les endpoints VPC. Si votre activité est déployée dans un VPC, par exemple sur ECS ou ACK, vous pouvez accéder aux ressources cloud de ce VPC via un endpoint VPC. Les endpoints VPC renforcent la sécurité et réduisent la latence réseau. Pour plus d'informations, consultez la rubrique Endpoints.

Définir un endpoint

Le SDK V2.0 propose deux méthodes pour définir un endpoint : spécifier directement l'endpoint ou indiquer un ID de région pour obtenir l'endpoint automatiquement.

  1. Spécifiez un endpoint (recommandé) : définissez l'endpoint lors de l'initialisation du client. Vous trouverez l'endpoint d'un service sur la page d'accueil du produit dans le portail des développeurs OpenAPI. Pour plus de détails, reportez-vous à la fin de cette rubrique.

    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);
  2. Spécifiez un RegionId : l'endpoint est obtenu grâce à la logique d'adressage.

    image
    • Si le SDK du service demandé contient un objet de mappage RegionId-vers-endpoint et que le RegionId spécifié existe dans cet objet, l'endpoint est extrait du mappage.

    • Si le SDK du service demandé ne contient pas d'objet de mappage RegionId-vers-endpoint, ou si le RegionId spécifié n'existe pas dans l'objet, l'endpoint est construit automatiquement selon la règle suivante : ${Product ID}.${RegionId}.aliyuncs.com.

Annexe : Trouver un endpoint

Vous pouvez trouver l'endpoint d'un service cloud dans le portail OpenAPI :

  1. Dans le menu supérieur du portail, cliquez sur Products et sélectionnez un produit, tel que ECS.

  2. Sur la product homepage, repérez la list of service regions.

  3. Sélectionnez l'endpoint correspondant à votre ID de région, puis copiez-collez-le.

Vous pouvez également consulter les endpoints pris en charge par le service cloud en cliquant sur Regions dans le volet de navigation de gauche de la page de débogage des API.