Demander un endpoint de répartition lecture/écriture - - Centre de documentation Alibaba Cloud

Si des instances en lecture seule sont associées à une instance principale ApsaraDB RDS for SQL Server, appelez cette opération pour demander un endpoint de routage en lecture seule unifié pour l'instance principale. Une fois l'endpoint de routage en lecture seule demandé pour l'instance principale, les endpoints existants de l'instance principale et de ses instances en lecture seule restent valides. Vous pouvez également demander des endpoints internes et publics.

Avant d'appeler cette opération, vérifiez que les conditions suivantes sont remplies :

Si l'instance exécute MySQL, elle utilise un proxy partagé.
L'instance est dans l'état Running.
Des instances en lecture seule sont associées à l'instance principale.
Aucune tâche de migration Data Transmission Service (DTS) n'est en cours sur l'instance.
L'instance exécute l'une des versions de base de données et éditions RDS suivantes :
- SQL Server (édition cluster)
- MySQL 5.7 sur RDS High-availability Edition avec SSD locaux
- MySQL 5.6

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	AllocateReadWriteSplittingConnection	Opération à effectuer. Définissez la valeur sur AllocateReadWriteSplittingConnection.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxx	ID de l'instance principale. Appelez l'opération DescribeDBInstances pour interroger l'ID de l'instance.
ConnectionStringPrefix	String	No	rr-m5exxxxx-rw.mysql.rds.aliyuncs.com	Préfixe de l'endpoint de routage en lecture seule. Le préfixe doit être unique. Il peut contenir jusqu'à 30 caractères, inclure des lettres minuscules et des traits d'union (-). Il doit commencer par une lettre minuscule. Remarque Le préfixe par défaut se compose du nom de l'instance principale suivi des lettres rw.
Port	String	No	1433	Port associé à l'endpoint de routage en lecture seule. Valeurs valides : 1000 à 5999. Valeur par défaut : 1433.
MaxDelayTime	String	No	30	Seuil de latence autorisé sur les instances en lecture seule. Valeurs valides : 0 à 7200. Valeur par défaut : 30. Unité : secondes. Remarque Si la latence d'une instance en lecture seule dépasse le seuil spécifié, ApsaraDB RDS ne transfère pas les requêtes de lecture vers cette instance.
NetType	String	No	Intranet	Type de réseau de l'endpoint de routage en lecture seule. Valeurs valides : Internet : Internet Intranet : réseau interne Remarque La valeur par défaut est Intranet. Assurez-vous que le type de réseau de l'endpoint de routage en lecture seule est identique à celui de l'instance principale.
DistributionType	String	No	Standard	Méthode utilisée pour attribuer les poids de lecture. Valeurs valides : Standard : ApsaraDB RDS attribue automatiquement les poids de lecture aux instances principales et en lecture seule en fonction des spécifications de ces instances. Custom : Vous devez attribuer manuellement un poids de lecture à chaque instance.
Weight	String	No	{"rm-bp1**********":800,"master":400,"slave":400}	Poids de lecture de l'instance principale et de ses instances en lecture seule. Le poids de lecture augmente par incréments de 100. La valeur maximale est 10000. Pour les instances ApsaraDB RDS, la valeur de ce paramètre est au format suivant : `{"<ID of the read-only instance >":<Weight>,"master":<Weight>,"slave":<Weight>}`. Pour les instances ApsaraDB MyBase, la valeur de ce paramètre est au format suivant : `[{"instanceName":"<ID of the primary instance>","weight":<Weight>,"role":"master"},{"instanceName":"<ID of the primary instance>","weight":<Weight>,"role":"slave"},{"instanceName":"<ID of the read-only instance>","weight":<Weight>,"role":"master"}]` Remarque Si vous définissez le paramètre DistributionType sur Custom, vous devez également spécifier ce paramètre. Si vous définissez le paramètre DistributionType sur Standard, ce paramètre est invalide.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	4C467B38-3910-447D-87BC-AC049166F216	ID de la requête.

Exemples

Exemples de requêtes

http(s)://rds.aliyuncs.com/?Action=AllocateReadWriteSplittingConnection
&DBInstanceId=rm-uf6wjk5xxxxxxx
&ConnectionStringPrefix=rr-m5exxxxx-rw.mysql.rds.aliyuncs.com
&Port=1433
&MaxDelayTime=30
&NetType=Intranet
&DistributionType=Standard
&Weight={"rm-bp1**********":800,"master":400,"slave":400}
&Common request parameters

Exemples de réponses réussies

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<AllocateReadWriteSplittingConnectionResponse>
    <RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId>
</AllocateReadWriteSplittingConnectionResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "4C467B38-3910-447D-87BC-AC049166F216"
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs.