Skip to main content

Accéder aux API Model Studio via un réseau privé à l'aide d'un endpoint

Pour appeler les API Model Studio depuis un VPC sans exposer le trafic sur Internet public, ajoutez une connexion PrivateLink dans la console Model Studio et associez-la à votre espace de travail.

Fonctionnement

La passerelle Model Studio prend en charge les deux méthodes d'accès suivantes :
  • Accès par réseau public : appelez les API Model Studio via le nom de domaine public MaaS {WorkspaceId}.{RegionId}.maas.aliyuncs.com. Le trafic transite par Internet public.
  • Connexion privée PrivateLink : ajoutez une connexion PrivateLink pour votre VPC dans la console Model Studio, puis appelez les API Model Studio via le nom de domaine privé. Le trafic reste dans le réseau Alibaba Cloud et ne traverse pas Internet public.
Une fois une connexion PrivateLink ajoutée dans la console Model Studio, PrivateLink établit une connexion privée (connexion d'endpoint) entre votre VPC et Model Studio. Cette connexion est unidirectionnelle : elle permet aux ressources de votre VPC d'accéder à Model Studio, mais Model Studio ne peut pas l'utiliser pour accéder aux ressources de votre VPC. Lorsque des ressources de calcul de votre VPC accèdent au nom de domaine privé, PrivateLink achemine le trafic vers le service Model Studio en contournant Internet public.
image
Model Studio est disponible dans les régions suivantes :
  • Cloud public : Chine (Pékin) et Chine (Hong Kong).
    L'accès par réseau privé n'est actuellement pas pris en charge dans les autres régions.
  1. Connectez-vous à la console Model Studio. Dans le volet de navigation de gauche, choisissez Settings > Network configuration.
  2. Lors de la première utilisation, terminez les préparations suivantes dans le panneau Add PrivateLink :
    • Authorize service-linked role for PrivateLink : cliquez sur Authorize Now, puis sur Confirm Authorization pour créer le rôle lié au service AliyunServiceRoleForBackrouterAccessNet.
    • Activate PrivateLink : cliquez sur Enable Now pour activer le service PrivateLink.
  3. Dans la section VPC private network access, cliquez sur Add et configurez les paramètres suivants. Conservez les valeurs par défaut pour les autres paramètres.
    • Region : sélectionnez la région de votre service Model Studio, par exemple Chine (Hong Kong).
    • VPC : sélectionnez le VPC utilisé pour accéder au service Model Studio. La connexion PrivateLink est créée dans ce VPC, ce qui permet aux ressources de ce VPC, telles que les instances ECS et les conteneurs, d'accéder au service Model Studio via le nom de domaine privé. Si aucun VPC n'est disponible, cliquez sur Create VPC pour en créer un dans la console VPC. Pour utiliser un VPC partagé par un autre compte, sélectionnez ce VPC partagé. Pour plus d'informations, consultez Accès inter-comptes.
    • Zones and Switches : sélectionnez une zone prise en charge par Model Studio et contenant un vSwitch, puis sélectionnez ce vSwitch. La connexion PrivateLink occupe une adresse IP interne du vSwitch sélectionné dans chaque zone, laquelle sert d'adresse de résolution DNS interne au nom de domaine privé. Vous pouvez ajouter jusqu'à deux combinaisons zone et vSwitch. Ajoutez-en deux pour assurer une haute disponibilité afin que le trafic puisse basculer si une zone devient indisponible. Si aucun vSwitch n'est disponible, cliquez sur Create Switch pour en créer un dans la console VPC.
    • Security Group : sélectionnez le groupe de sécurité à associer à la connexion PrivateLink. Le groupe de sécurité contrôle les ressources autorisées à accéder à la connexion. Vérifiez qu'il autorise le trafic entrant sur le port 443 (HTTPS). Si aucun groupe de sécurité n'est disponible, cliquez sur Create Security Group pour en créer un dans la console ECS.
  4. Cliquez sur Confirm et attendez que le Status de la connexion passe à Created. La connexion prend effet en 1 à 3 minutes environ. Une fois effective, n'importe quel serveur cloud du VPC peut utiliser le nom de domaine privé pour accéder au service Model Studio.
Un espace de travail qui doit accéder à Model Studio via le réseau privé doit être associé à une connexion PrivateLink.
  1. Dans le volet de navigation de gauche de la console Model Studio, choisissez Workspaces, puis créez un espace de travail ou modifiez l'espace de travail cible.
  2. Dans Advanced Configuration, définissez PrivateLink sur la connexion PrivateLink cible. Chaque option affiche l'ID de l'endpoint avec sa région et son VPC. Si la connexion cible n'est pas répertoriée, cliquez sur Create PrivateLink dans la liste déroulante pour en créer une. Après l'association, l'espace de travail peut accéder à Model Studio via la connexion privée du VPC correspondant.
  3. Pour supprimer l'association, modifiez l'espace de travail, effacez le champ PrivateLink et enregistrez. Vous pouvez également, sur la page Network configuration, développer la ligne de la connexion PrivateLink cible et cliquer sur Unbind dans la colonne Associated workspace pour poursuivre dans l'espace de travail correspondant. Une connexion PrivateLink associée à des espaces de travail ne peut pas être supprimée tant qu'elle n'est pas désassociée.

Étape 3 : Obtenir le nom de domaine privé

Une fois l'étape 2 terminée, un nom de domaine privé est généré pour chaque espace de travail associé. Sur la page Network configuration, développez la ligne de la connexion PrivateLink cible dans la liste VPC private network access et copiez le nom de domaine privé dans la colonne Endpoint. La colonne Associated workspace affiche l'ID de l'espace de travail auquel appartient le nom de domaine. Le nom de domaine privé suit le format {WorkspaceId}-{VpcId}.{region-id}.maas.aliyuncs.com, où WorkspaceId est l'ID de l'espace de travail et VpcId l'ID du VPC auquel appartient la connexion PrivateLink. Vous pouvez également retrouver le nom de domaine privé dans la colonne API Host de l'espace de travail cible, sur la page Workspaces. Après l'association, cette colonne affiche à la fois le nom de domaine public et le nom de domaine privé. Le nom de domaine privé ne peut être résolu et accessible qu'au sein du VPC sélectionné. Utilisez HTTPS (port 443) pour appeler les API Model Studio. Si aucun espace de travail n'est associé, la colonne Endpoint de la ligne développée est vide.

Étape 4 : Vérifier la connexion

Remplacez le nom de domaine dans le paramètre base_url de votre requête API par le nom de domaine privé obtenu à l'étape précédente. Appelez ensuite l'API depuis le VPC correspondant. Par exemple, pour appeler le modèle de texte Qwen en mode compatible OpenAI :
  • Avant remplacement : https://{WorkspaceId}.{RegionId}.maas.aliyuncs.com/compatible-mode/v1/chat/completions
  • Après remplacement : https://{WorkspaceId}-{VpcId}.{RegionId}.maas.aliyuncs.com/compatible-mode/v1/chat/completions
Exemple d'appel :
HTTP
# Replace the original domain name with the private domain name obtained in the previous step.
curl -X POST https://{WorkspaceId}-{VpcId}.{RegionId}.maas.aliyuncs.com/compatible-mode/v1/chat/completions \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen-flash",
    "messages": [
        {
            "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "Who are you?"
        }
    ]
}'
Avant d'effectuer l'appel, vous devez obtenir une clé API . Si vous souhaitez transmettre la clé API directement dans votre code, remplacez $DASHSCOPE_API_KEY par votre clé API.

Accès inter-comptes

Par défaut, une connexion PrivateLink ne peut être créée que dans un VPC appartenant au compte actuel, et seules les ressources de ce VPC peuvent accéder à Model Studio via le nom de domaine privé. Si le VPC qui contient vos ressources appelantes appartient à un autre compte Alibaba Cloud, vous pouvez utiliser l'une des méthodes suivantes :
  • Méthode 1 : partage de VPC : partagez le vSwitch du VPC appelant avec le compte Model Studio, et créez la connexion PrivateLink directement dans le VPC appelant.
  • Méthode 2 : interconnexion de VPC : créez la connexion PrivateLink dans le VPC du compte Model Studio, puis interconnectez le VPC appelant avec ce VPC via une connexion d'appairage VPC ou Cloud Enterprise Network (CEN) pour accéder à la connexion PrivateLink.
Aucune des deux méthodes ne nécessite de partager la connexion PrivateLink elle-même entre les comptes. Si l'appelant n'est pas le compte Model Studio, le compte Model Studio fournit le nom de domaine privé et la clé API de l'espace de travail à l'appelant.

Méthode 1 : partage de VPC

Le partage de VPC implique deux comptes :
  • Compte propriétaire du VPC : possède le VPC et le vSwitch, et partage le vSwitch.
  • Compte Model Studio : accepte le partage, ajoute la connexion PrivateLink dans la console Model Studio et associe l'espace de travail.
La connexion PrivateLink est créée dans le VPC partagé, et les ressources de ce VPC appartenant à n'importe quel compte peuvent utiliser la connexion. Le compte propriétaire du VPC peut également créer lui-même une connexion PrivateLink dans ce VPC, afin que les autres comptes du VPC partagé l'utilisent. Dans tous les cas, les frais PrivateLink sont facturés au compte qui crée la connexion PrivateLink. Les étapes suivantes prennent comme exemple la création de la connexion PrivateLink par le compte Model Studio.

Étape 1 : le compte propriétaire du VPC partage le vSwitch

Dans la console Resource Sharing, cliquez sur Create Sharing Unit et renseignez Configure Basic Information and Add Resources (ajoutez le vSwitch à partager), Associate Permissions (sélectionnez AliyunRSDefaultPermissionVSwitch), Associate Resource Users (saisissez l'UID du compte Model Studio) et Confirm and Submit. Le partage de VPC partage un vSwitch, et non l'ensemble du VPC. Pour plus d'informations, consultez Partager un VPC.

Étape 2 : le compte Model Studio accepte le partage

Connectez-vous à la console Resource Sharing avec le compte Model Studio et acceptez le partage sur la page Shared with Me. Si l'unité de partage est déjà associée, ignorez cette étape. Connectez-vous à la console Model Studio et ajoutez une connexion PrivateLink comme décrit à l'Étape 1 de cette rubrique. Tenez compte des paramètres suivants :
  • Region : sélectionnez la région dans laquelle se trouve le VPC partagé. Cette région doit prendre en charge l'accès réseau privé à Model Studio, par exemple China (Beijing) ou China (Hong Kong).
  • VPC : sélectionnez le VPC partagé.
  • Zones and Switches : sélectionnez le vSwitch partagé dans le VPC partagé.
  • Security Group : sélectionnez un groupe de sécurité disponible dans le VPC partagé et vérifiez que ses règles entrantes autorisent les ressources appelantes à accéder au port 443.
Les autres paramètres sont identiques à ceux du flux pour un même compte.

Étape 4 : terminez la configuration restante et effectuez les appels

Une fois la connexion PrivateLink créée, associez l'espace de travail et obtenez le nom de domaine privé comme décrit aux Étape 2, Étape 3 et Étape 4 de cette rubrique. L'appelant utilise ce nom de domaine privé et la clé API de l'espace de travail pour effectuer les appels depuis le VPC partagé.

Méthode 2 : interconnexion de VPC

L'interconnexion de VPC implique deux comptes :
  • Compte Model Studio : crée la connexion PrivateLink dans son propre VPC (ci-après le VPC Model Studio) et associe l'espace de travail.
  • Compte appelant : possède le VPC qui contient les ressources appelantes (ci-après le VPC appelant).
Une fois les VPC interconnectés, le réseau entre les deux VPC est bidirectionnel. L'un ou l'autre compte peut créer une connexion PrivateLink dans son propre VPC pour que l'autre compte l'appelle. Autrement dit, les deux comptes peuvent jouer le rôle de compte Model Studio.

Étape 1 : connecter les réseaux

Connectez le VPC Model Studio et le VPC appelant à l'aide de l'une des méthodes suivantes. Les blocs CIDR des deux VPC ne doivent pas se chevaucher. Pour comparer le choix et la facturation des deux méthodes, consultez Présentation de l'interconnexion de VPC.
  • Connexion d'appairage VPC
    1. L'un des comptes crée une connexion d'appairage dans la console VPC, sélectionne Cross-account pour Acceptor Account Type, puis saisit l'UID du compte homologue et l'ID du VPC homologue.
    2. Le compte homologue accepte la connexion sur la page des connexions d'appairage VPC de la console VPC.
    3. Chaque compte ajoute une route dans la table de routage de son VPC, avec le bloc CIDR du VPC homologue comme destination et la connexion d'appairage comme tronçon suivant.
    Pour plus d'informations, consultez Connexions d'appairage VPC.
  • Cloud Enterprise Network (CEN)
    1. L'un des comptes crée une instance CEN et crée un routeur de transit dans la région où se trouvent les VPC.
    2. Le compte homologue autorise son VPC sur cette instance CEN.
    3. Dans le routeur de transit, créez une connexion VPC pour chacun des deux VPC afin de les connecter au même routeur de transit.
    Pour plus d'informations, consultez Utiliser des routeurs de transit Enterprise Edition pour connecter des VPC entre régions et comptes.
Une fois les réseaux connectés, le trafic de l'appelant doit encore être autorisé par le groupe de sécurité de la connexion PrivateLink. Le compte Model Studio ajoute la règle entrante suivante au groupe de sécurité associé à la connexion PrivateLink :
ParamètreValeur
Politique d'autorisationAutoriser
Type de protocoleTCP personnalisé
Plage de ports443
Objet d'autorisationBloc CIDR du VPC appelant, par exemple 192.168.0.0/16. Vous pouvez le consulter sur la page de détails du VPC dans la console VPC
Si ce trafic n'est pas autorisé, les appels expirent même si les réseaux sont connectés.

Étape 3 : effectuer les appels

Le compte Model Studio fournit le nom de domaine privé et la clé API de l'espace de travail au compte appelant. Les ressources du VPC appelant effectuent les appels comme décrit à l'Étape 4 de cette rubrique. Si une erreur d'expiration de connexion telle que Failed to connect to <private domain name> port 443 est renvoyée, vérifiez la configuration réseau de l'étape 1 et les règles du groupe de sécurité de l'étape 2.

Facturation

L'utilisation de PrivateLink entraîne des coûts supplémentaires. Pour estimer vos coûts, consultez la rubrique Facturation de PrivateLink. Les frais PrivateLink et les frais d'appel de modèles sont facturés au compte qui crée la connexion PrivateLink, quel que soit le compte propriétaire du VPC. Pour la facturation des connexions d'appairage VPC et de CEN, consultez Connexions d'appairage VPC et Règles de facturation de CEN.

FAQ

  1. Pourquoi mon instance ECS ne peut-elle pas accéder aux API Model Studio via un réseau privé ? Vérifiez les éléments suivants :
    1. Confirmez que l'instance ECS et la connexion PrivateLink se trouvent dans le même VPC. Si l'instance ECS se trouve dans un VPC différent, elle ne peut pas accéder à Model Studio via le réseau privé. Dans ce cas, configurez d'abord la connectivité VPC, par exemple une connexion d'appairage VPC ou CEN, et autorisez le trafic dans le groupe de sécurité de la connexion PrivateLink. Pour plus d'informations, consultez Méthode 2 : interconnexion de VPC.
    2. Vérifiez le groupe de sécurité associé à la connexion PrivateLink. Confirmez qu'une règle entrante autorise le trafic provenant du bloc CIDR de l'instance ECS source sur le port 443 (HTTPS).
    3. Confirmez le statut de la connexion PrivateLink. Le nom de domaine privé ne peut être utilisé qu'une fois le statut de la connexion passé à Created et la connexion effective (environ 1 à 3 minutes après la création).
    4. Confirmez que l'espace de travail est associé. Un nom de domaine privé n'est généré qu'après l'association d'un espace de travail à la connexion PrivateLink. Si la colonne Endpoint de la ligne développée est vide, associez l'espace de travail comme décrit à l'étape 2.
  2. Un endpoint est-il accessible depuis Internet public ? Non. PrivateLink établit uniquement des connexions privées au sein du réseau interne d'Alibaba Cloud. Les endpoints ne sont pas accessibles depuis Internet public, et vous ne pouvez pas associer d'adresse IP élastique à une ENI d'endpoint.
  3. Une connexion PrivateLink existante doit-elle être associée à un espace de travail ? Non. Une connexion PrivateLink existante, créée en tant qu'endpoint d'interface dans la console PrivateLink (VPC), est associée par défaut à tous les espaces de travail. Vous pouvez l'utiliser pour accéder aux API Model Studio via le réseau privé sans effectuer l'étape 2. Lorsque vous développez une connexion existante sur la page Network configuration, la colonne Endpoint affiche vpc-{region-id}.dashscope.aliyuncs.com (par exemple, vpc-ap-southeast-1.dashscope.aliyuncs.com) et la colonne Associated workspace indique que la connexion est associée à tous les espaces de travail. Cela diffère du flux actuel, qui affiche {WorkspaceId}-{VpcId}.{region-id}.maas.aliyuncs.com pour chaque espace de travail associé. Il n'est plus possible de créer une connexion PrivateLink de cette manière. Pour en ajouter une, suivez l'étape 1 pour la créer dans la console Model Studio, puis l'étape 2 pour associer les espaces de travail nécessitant un accès via le réseau privé.