ApsaraDB for MongoDB vous permet de modifier l'endpoint interne ou public ainsi que le port d'une instance.
Limites
Le tableau suivant présente les limites relatives à la modification de l'endpoint et du port d'une instance ApsaraDB for MongoDB, ainsi que les scénarios de basculement vers une nouvelle instance.
| Type d'instance | Endpoint | Port | Scénario de basculement vers une nouvelle instance |
| Instance autonome | Une instance autonome ne dispose que d'un seul nœud principal. Vous pouvez modifier l'endpoint du nœud principal. | Vous ne pouvez pas modifier le port d'une instance autonome. | Vous pouvez aligner l'endpoint et le port de la nouvelle instance sur ceux de l'instance d'origine. Dans ce cas, vous n'avez pas besoin de modifier l'endpoint et le port dans votre application. |
| Instance de type Replica Set | Vous pouvez modifier les endpoints des nœuds principaux, secondaires et en lecture seule, tant pour les instances SSD locales que pour les instances ESSD. | Vous pouvez modifier le port des instances ESSD exécutant MongoDB 4.2 ou une version ultérieure. | La chaîne de connexion de l'endpoint haute disponibilité du Replica Set contient des informations replicaSet qui ne peuvent pas être modifiées. Par conséquent, après le basculement vers une nouvelle instance, vous devez modifier l'endpoint et le port dans votre application. |
| Instance de type Sharded Cluster | Si l'instance utilise le protocole MongoDB, vous pouvez uniquement modifier les endpoints des nœuds mongos. Si l'instance utilise le protocole compatible DynamoDB, vous pouvez modifier l'endpoint du nœud config server. | Vous pouvez modifier le port des instances ESSD exécutant MongoDB 4.2 ou une version ultérieure. | Vous pouvez aligner l'endpoint et le port de la nouvelle instance sur ceux de l'instance d'origine. Dans ce cas, vous n'avez pas besoin de modifier l'endpoint et le port dans votre application. |
Prérequis
(Requis uniquement pour modifier un endpoint public) Un endpoint public a été demandé pour l'instance. La section Public Connections n'affiche le bouton Update Connection String qu'après la demande d'un endpoint public. Pour plus d'informations, consultez la rubrique Demander un endpoint public.
Procédure
Accédez à la page Replica Set Instances ou Sharded Cluster Instances. Dans la barre de navigation supérieure, sélectionnez le groupe de ressources et la région auxquels appartient l'instance souhaitée. Localisez ensuite l'instance et cliquez sur son ID.
Dans le volet de navigation de gauche de la page des détails de l'instance, cliquez sur Database Connections.
Dans la section Internal Connections - VPC ou la section Public Connections, cliquez sur Update Connection String. Sélectionnez la section appropriée selon que vous souhaitez modifier l'endpoint interne ou l'endpoint public de l'instance.
-
Dans le panneau Update Connection String, configurez les paramètres suivants.
Paramètre Description Node Sélectionnez dans la liste déroulante le nœud dont vous souhaitez modifier l'endpoint.
RemarquePour les instances de type Sharded Cluster, vous pouvez uniquement modifier les endpoints des nœuds mongos.
Current Connection String Chaîne de connexion actuelle du nœud dont vous souhaitez modifier l'endpoint. Ce paramètre est en lecture seule. New Connection String Saisissez le préfixe du nouvel endpoint en respectant les règles suivantes : le préfixe doit commencer par une lettre minuscule ; il doit se terminer par une lettre minuscule ou un chiffre ; il peut contenir des lettres minuscules, des chiffres et des traits d'union (-), et sa longueur doit être comprise entre 8 et 64 caractères. Port Number Numéro de port du nouvel endpoint. Valeurs valides : 1 000 à 65 535. Cliquez sur OK.
Étapes suivantes
Après avoir modifié l'endpoint, mettez à jour l'endpoint et le port dans votre application avec les nouvelles valeurs.