Créer un endpoint de proxy - - Centre de documentation Alibaba Cloud

Lorsque vous activez la fonctionnalité de proxy dédié pour une instance ApsaraDB RDS for MySQL ou le proxy de base de données pour une instance ApsaraDB RDS for PostgreSQL, un endpoint de proxy par défaut est créé. Appelez cette opération pour créer des endpoints de proxy de différents types de réseau. Pour plus d'informations, consultez les rubriques Présentation des proxys de base de données et Activer et configurer la fonctionnalité de proxy de base de données pour une instance ApsaraDB RDS for PostgreSQL.

Remarque

Les instances utilisant des SSD locaux prennent en charge les types de réseau suivants : VPC, Classic et Public.
Les instances utilisant des SSD standard ou des disques ESSD (Enhanced SSD) prennent en charge les types de réseau suivants : VPC et Public. Pour créer un endpoint de proxy de type Public, configurez des listes d'autorisation d'adresses IP pour l'instance et ses instances en lecture seule afin de garantir la connectivité entre le client et l'instance. Appelez l'opération ModifySecurityIps pour configurer la liste d'autorisation d'adresses IP d'une instance.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. L'outil génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	CreateDBProxyEndpointAddress	Opération à effectuer. Définissez la valeur sur CreateDBProxyEndpointAddress.
RegionId	String	Oui	cn-hangzhou	ID de la région où réside l'instance. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
DBInstanceId	String	Oui	rm-t4n3axxxxx	ID de l'instance. Appelez l'opération DescribeDBInstances pour obtenir l'ID de l'instance.
DBProxyEndpointId	String	Oui	ta9um4xxxxx	ID de l'endpoint de proxy. Appelez l'opération DescribeDBProxyEndpoint pour obtenir l'ID de l'endpoint de proxy.
ConnectionStringPrefix	String	Oui	test1234	Préfixe de l'endpoint de proxy. Saisissez un préfixe personnalisé.
DBProxyNewConnectStringPort	String	Non	3306	Numéro de port associé à l'endpoint de proxy. Si l'instance exécute MySQL, la valeur par défaut est 3306. Si l'instance exécute PostgreSQL, la valeur par défaut est 5432.
DBProxyConnectStringNetType	String	Oui	Public	Type de réseau de l'endpoint de proxy. Valeurs valides : Public VPC Classic Valeur par défaut : Classic.
VPCId	String	Non	vpc-bpxxxxxx	ID du Virtual Private Cloud (VPC) auquel appartient l'endpoint de proxy. Appelez l'opération DescribeDBInstanceAttribute pour obtenir l'ID du VPC. Remarque Si vous définissez le paramètre DBProxyConnectStringNetType sur VPC, vous devez également spécifier le paramètre VPCId.
VSwitchId	String	Non	vsw-bpxxxxxx	ID du vSwitch associé au VPC spécifié. Appelez l'opération DescribeDBInstanceAttribute pour obtenir l'ID du vSwitch. Remarque Si vous définissez le paramètre DBProxyConnectStringNetType sur VPC, vous devez également spécifier le paramètre VSwitchId.
DBProxyEngineType	String	Non	normal	Paramètre interne. Ne spécifiez pas ce paramètre.
ResourceGroupId	String	Non	rg-acfmy*****	ID du groupe de ressources.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	F2911788-25E8-42E5-A3A3-1B38D263F01E	ID de la requête.

Exemples

Exemples de requêtes

http(s)://rds.aliyuncs.com/?Action=CreateDBProxyEndpointAddress
&RegionId=cn-hangzhou
&DBInstanceId=m-t4n3axxxxx
&DBProxyEndpointId=ta9um4xxxxx
&DBProxyConnectStringNetType=Public
&ConnectionStringPrefix=test1234
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<CreateDBProxyEndpointAddressResponse>
<RequestId>F2911788-25E8-42E5-A3A3-1B38D263F01E</RequestId>
</CreateDBProxyEndpointAddressResponse>

JSON format

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

{
  "RequestId" : "F2911788-25E8-42E5-A3A3-1B38D263F01E"
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidPort.Malformed	Specified port is not valid.	Le numéro de port spécifié n'est pas valide.
400	NetTypeExists	Specified net type already existed.	Un endpoint de proxy du type de réseau spécifié existe déjà.
400	IncorrectDBInstanceNetType	Current DB instance net type does not support this operation.	Le type de réseau de l'instance ne prend pas en charge cette opération.
400	InvalidConnectionString.Duplicate	Specified connection string already exists in the Aliyun RDS.	L'endpoint de proxy spécifié existe déjà. Spécifiez un autre endpoint.
400	InvalidVpcInstanceId	Specified vpc instance id is not valid.	L'ID VPC spécifié n'est pas valide.
400	InvalidDBInstanceName	Specified parameter DBInstanceName is not valid.	La valeur du paramètre DBInstanceName n'est pas valide. Vérifiez si la valeur est nulle ou une chaîne vide.
403	IncorrectDBInstanceType	Current DB instance type does not support this operation.	Cette opération n'est pas prise en charge dans l'état actuel de l'instance.
403	IncorrectDBInstanceState	Current DB instance state does not support this operation.	Cette opération n'est pas prise en charge dans l'état actuel de l'instance.
404	Endpoint.NotFound	Specified endpoint is not found.	Le port utilisé pour se connecter à l'endpoint de proxy dédié est introuvable.
404	InvalidVSwitchId.NotFound	The specified VSwitch is invalid.	L'ID vSwitch spécifié n'est pas valide.
404	Maxscale.NotFound	The related maxscale instance is not found.	Les instances MaxScale associées sont introuvables.

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