Crear un endpoint de proxy - - Centro de documentación de Alibaba Cloud

Puede llamar a la operación CreateDBProxyEndpointAddress para crear un endpoint de proxy que se utiliza para conectarse al proxy de base de datos de una instancia de ApsaraDB RDS.

Al habilitar la función de proxy dedicado en una instancia de ApsaraDB RDS for MySQL o la función de proxy de base de datos en una instancia de ApsaraDB RDS for PostgreSQL, se crea un endpoint de proxy predeterminado. Llame a esta operación para crear endpoints de proxy de diferentes tipos de red. Para obtener más información, consulte ¿Qué son los proxies de base de datos? y Activar y configurar la función de proxy de base de datos para una instancia de ApsaraDB RDS for PostgreSQL.

Nota

Las instancias con discos SSD locales admiten los siguientes tipos de red: VPC, Classic y Public.
Las instancias con discos SSD estándar o discos SSD mejorados (ESSD) admiten los tipos de red VPC y Public. Si desea crear un endpoint de proxy de tipo red pública, configure listas blancas de direcciones IP tanto para la instancia como para sus instancias de solo lectura a fin de garantizar la conectividad entre el cliente y la instancia. Llame a la operación ModifySecurityIps para configurar una lista blanca de direcciones IP en una instancia.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer, ya que genera dinámicamente código de ejemplo para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateDBProxyEndpointAddress	La operación que desea ejecutar. Establezca el valor en CreateDBProxyEndpointAddress.
RegionId	String	Sí	cn-hangzhou	El ID de la región donde reside la instancia. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.
DBInstanceId	String	Sí	rm-t4n3axxxxx	El ID de la instancia. Llame a la operación DescribeDBInstances para consultar el ID de la instancia.
DBProxyEndpointId	String	Sí	ta9um4xxxxx	El ID del endpoint de proxy. Llame a la operación DescribeDBProxyEndpoint para consultar el ID del endpoint de proxy.
ConnectionStringPrefix	String	Sí	test1234	El prefijo del endpoint de proxy. Introduzca un prefijo personalizado.
DBProxyNewConnectStringPort	String	No	3306	El número de puerto asociado con el endpoint de proxy. Si la instancia ejecuta MySQL, el valor predeterminado es 3306. Si la instancia ejecuta PostgreSQL, el valor predeterminado es 5432.
DBProxyConnectStringNetType	String	Sí	Public	El tipo de red del endpoint de proxy. Valores válidos: Public VPC Classic Valor predeterminado: Classic.
VPCId	String	No	vpc-bpxxxxxx	El ID de la nube privada virtual (VPC) a la que pertenece el endpoint de proxy. Llame a la operación DescribeDBInstanceAttribute para consultar el ID de la VPC. Nota Si establece el parámetro DBProxyConnectStringNetType en VPC, también debe especificar el parámetro VPCId.
VSwitchId	String	No	vsw-bpxxxxxx	El ID del vSwitch asociado con la VPC especificada. Llame a la operación DescribeDBInstanceAttribute para consultar el ID del vSwitch. Nota Si establece el parámetro DBProxyConnectStringNetType en VPC, también debe especificar el parámetro VSwitchId.
DBProxyEngineType	String	No	normal	Un parámetro interno. No necesita especificar este parámetro.
ResourceGroupId	String	No	rg-acfmy*****	El ID del resource group.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	F2911788-25E8-42E5-A3A3-1B38D263F01E	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

Formato XML

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

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

Formato JSON

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

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidPort.Malformed	Specified port is not valid.	El mensaje de error devuelto porque el número de puerto especificado no es válido.
400	NetTypeExists	Specified net type already existed.	El mensaje de error devuelto porque ya existe un endpoint de proxy del tipo de red especificado.
400	IncorrectDBInstanceNetType	Current DB instance net type does not support this operation.	El mensaje de error devuelto porque el tipo de red de la instancia no admite esta operación.
400	InvalidConnectionString.Duplicate	Specified connection string already exists in the Aliyun RDS.	El mensaje de error devuelto porque el endpoint de proxy especificado ya existe. Especifique un endpoint diferente.
400	InvalidVpcInstanceId	Specified vpc instance id is not valid.	El mensaje de error devuelto porque el ID de VPC especificado no es válido.
400	InvalidDBInstanceName	Specified parameter DBInstanceName is not valid.	El mensaje de error devuelto porque el valor del parámetro DBInstanceName no es válido. Compruebe si el valor es nulo o una cadena vacía.
403	IncorrectDBInstanceType	Current DB instance type does not support this operation.	El mensaje de error devuelto porque esta operación no es compatible cuando la instancia se encuentra en su estado actual.
403	IncorrectDBInstanceState	Current DB instance state does not support this operation.	El mensaje de error devuelto porque esta operación no es compatible cuando la instancia se encuentra en su estado actual.
404	Endpoint.NotFound	Specified endpoint is not found.	El mensaje de error devuelto porque no se encuentra el puerto utilizado para conectarse al endpoint de proxy dedicado.
404	InvalidVSwitchId.NotFound	The specified VSwitch is invalid.	El mensaje de error devuelto porque el ID de vSwitch especificado no es válido.
404	Maxscale.NotFound	The related maxscale instance is not found.	El mensaje de error devuelto porque no se encuentran las instancias de MaxScale asociadas.

Para obtener una lista de códigos de error, visite el Centro de errores de API.