API Gateway:Clusters d'instances dédiées

API Gateway vous permet de regrouper des instances dédiées en cluster afin de tirer parti de leurs performances cumulées.

Présentation

Les instances dédiées individuelles offrent des performances limitées. Si vos besoins métier ne peuvent pas être satisfaits, même par une instance dédiée de la plus haute spécification, vous pouvez regrouper plusieurs instances dédiées en cluster pour partager la charge de travail. Vous ne pouvez regrouper que des instances du même type et de la même spécification au sein d'une même région, via la résolution DNS. Pour connaître les limites de spécification des instances dédiées, consultez la rubrique Instances dédiées.

Opérations de base sur les clusters d'instances dédiées

Créer un cluster d'instances dédiées

1. Connectez-vous à la console API Gateway. Dans le volet de navigation de gauche, sélectionnez Dedicated Instance Cluster.

2. Sur la page qui s'affiche, cliquez sur Create Cluster. Dans la boîte de dialogue Create Cluster, spécifiez les paramètres Name et Description, puis cliquez sur Confirm.

3. Le statut du cluster créé est Ready.

Ajouter des instances à un cluster

1. Localisez le cluster que vous avez créé et cliquez sur Manage Instances dans la colonne Actions.

2. Sur la page qui s'affiche, cliquez sur Add Instance et spécifiez l'instance à ajouter.

   Remarque

   1. Lorsque le cluster est à l'état Ready, vous ne pouvez spécifier qu'une seule instance dédiée à ajouter. Le cluster utilise les configurations de cette instance comme ses propres configurations, y compris la spécification, la version et le type de l'instance.

   2. La première instance ajoutée peut contenir des groupes d'API. Une fois l'instance ajoutée au cluster, les groupes d'API appartiennent au cluster.

3. Cliquez sur Add. Le système crée les ressources et utilise les configurations de l'instance ajoutée pour initialiser le cluster. Une fois le cluster initialisé, il passe à l'état Running.

4. (Facultatif) Ajoutez d'autres instances au cluster. Vous pouvez ajouter plusieurs instances simultanément.

   Remarque

   Les instances que vous souhaitez ajouter doivent utiliser les mêmes configurations que le cluster. Sinon, les erreurs suivantes peuvent se produire :

   1. Les instances serverless ne peuvent pas être ajoutées au cluster.

   2. L'instance que vous souhaitez ajouter utilise une version différente. Dans ce cas, soumettez un ticket pour mettre à jour votre instance.

   3. L'instance que vous souhaitez ajouter possède une spécification différente et ne peut pas être ajoutée.

   4. L'instance que vous souhaitez ajouter est d'un type différent et ne peut pas être ajoutée.

   5. L'instance que vous souhaitez ajouter contient des groupes d'API et ne peut pas être ajoutée.

   6. L'instance que vous souhaitez ajouter présente des configurations différentes pour Inbound IPv6 Traffic, Outbound IPv6 Traffic ou Calls from API Gateway et ne peut pas être ajoutée.

   7. L'instance que vous souhaitez ajouter présente des configurations différentes pour HTTPS Security Policy, VPC for Access to Dedicated Instance, IPv6 Access Control, IPv4 Access Control ou Custom Private CIDR Block. Ces configurations seront écrasées par les configurations correspondantes du cluster après l'ajout.

Modifier les configurations du cluster

1. Dans la liste Dedicated Instance Cluster, localisez le cluster souhaité et accédez à la page Instance Management.

2. Sur la page qui s'affiche, cliquez sur Modify dans le coin supérieur droit pour modifier les informations de base du cluster, notamment le nom et la description.

3. Modifiez d'autres configurations, telles que HTTPS Security Policy et VPC for Access to Dedicated Instance. La modification s'applique à toutes les instances dédiées du cluster.

4. La modification de la configuration du cluster est terminée une fois que toutes les instances dédiées du cluster sont mises à jour.

Supprimer des instances d'un cluster

1. Localisez le cluster à gérer dans la liste des clusters et cliquez sur Manage Instances dans la colonne Actions.

2. Sélectionnez les instances à supprimer dans la liste Dedicated Instances, puis cliquez sur Remove Instance dans le coin supérieur droit.

   Remarque

   1. Pendant le processus de suppression, vous ne pouvez pas modifier les configurations du cluster, ni ajouter ou supprimer d'autres instances du cluster.

   2. Si le cluster contient un groupe d'API, vous ne pouvez pas supprimer toutes les instances dédiées du cluster.

Remarques d'utilisation

1. Vous pouvez ajouter des instances dédiées de spécification api.s2.large.x4 ou supérieure.

2. Vous pouvez ajouter jusqu'à 20 instances dédiées à un seul cluster. Si vous souhaitez ajouter davantage d'instances, soumettez un ticket pour demander une augmentation du quota.

3. Lors de la création d'un groupe d'API, vous pouvez spécifier un cluster d'instances dédiées comme instance à laquelle le groupe d'API appartient. Vous ne pouvez pas créer de groupes d'API dans un cluster où les opérations suivantes sont en cours : modification de la configuration, ajout d'instance et suppression d'instance.

4. Vous pouvez migrer des groupes d'API depuis d'autres instances API Gateway vers un cluster d'instances dédiées.

5. Si une nouvelle adresse IP de sortie est également ajoutée après l'ajout d'une instance dédiée à un cluster, vous devez ajouter cette nouvelle adresse IP de sortie à la liste d'autorisation de votre service backend pour éviter les problèmes de connectivité.

6. Lorsque vous ajoutez ou supprimez une instance dédiée, des enregistrements de résolution DNS sont ajoutés ou supprimés des noms de domaine des groupes d'API du cluster. La durée de vie (TTL) des enregistrements de résolution DNS est de 60 secondes.