Todos los productos
Search
Centro de documentos

:Modificación de la configuración de cifrado SSL de una instancia de ApsaraDB RDS

Última actualización: Sep 03, 2026

Puede llamar a la operación ModifyDBInstanceSSL para modificar la configuración de cifrado SSL de una instancia de ApsaraDB RDS.

Esta operación configura el cifrado SSL en una instancia. Para obtener más información, consulte Secure Sockets Layer.

Nota
  • Antes de llamar a esta operación, asegúrese de que su instancia sea uno de los siguientes tipos:

    • Instancias de ApsaraDB RDS for MySQL que no ejecutan RDS Basic Edition

    • Instancias de ApsaraDB RDS for SQL Server

    • Instancias de ApsaraDB RDS for PostgreSQL que usan discos SSD estándar o discos SSD mejorados (ESSD)

  • El cifrado SSL no es compatible con las conexiones al endpoint de división de lectura/escritura de una instancia.

Depuración

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

Parámetros de solicitud

ParámetroTipoObligatorioEjemploDescripción
ActionStringSíModifyDBInstanceSSL

La operación que desea ejecutar. Establezca el valor en ModifyDBInstanceSSL.

DBInstanceIdStringSírm-uf6wjk5xxxxxxx

El ID de la instancia.

ConnectionStringStringSírm-uf6wjk5xxxxx.mysql.rds.aliyuncs.com

El endpoint interno o público para el cual se debe crear o actualizar el certificado del servidor.

SSLEnabledIntegerNo1

Especifica si se habilita o deshabilita el cifrado SSL. Valores válidos:

  • 1: habilita el cifrado SSL
  • 0: deshabilita el cifrado SSL
CATypeStringNoaliyun

El tipo de certificado del servidor. Este parámetro solo es compatible cuando la instancia ejecuta PostgreSQL con discos SSD estándar o ESSD. Si establece el parámetro SSLEnabled en 1, el valor predeterminado de este parámetro es aliyun.

Valores válidos:

  • aliyun: un certificado de nube
  • custom: un certificado personalizado
ServerCertStringNo-----BEGIN CERTIFICATE-----MIID*****QqEP-----END CERTIFICATE-----

El contenido del certificado del servidor. Este parámetro solo es compatible cuando la instancia ejecuta PostgreSQL con discos SSD estándar o ESSD. Si establece el parámetro CAType en custom, también debe especificar este parámetro.

ServerKeyStringNo-----BEGIN PRIVATE KEY-----MIIE****ihfg==-----END PRIVATE KEY-----

La clave privada del certificado del servidor. Este parámetro solo es compatible cuando la instancia ejecuta PostgreSQL con discos SSD estándar o ESSD. Si establece el parámetro CAType en custom, también debe especificar este parámetro.

ClientCAEnabledIntegerNo1

Especifica si se habilita la clave pública de la CA que emite los certificados de cliente. Este parámetro solo es compatible cuando la instancia ejecuta PostgreSQL con discos SSD estándar o ESSD. Valores válidos:

  • 1: habilita la clave pública
  • 0: deshabilita la clave pública
ClientCACertStringNo-----BEGIN CERTIFICATE-----MIID*****viXk=-----END CERTIFICATE-----

La clave pública de la CA que emite los certificados de cliente. Este parámetro solo es compatible cuando la instancia ejecuta PostgreSQL con discos SSD estándar o ESSD. Si establece el parámetro ClientCAEbabled en 1, también debe especificar este parámetro.

ClientCrlEnabledIntegerNo1

Especifica si se habilita una lista de revocación de certificados (CRL) que contiene certificados de cliente revocados. Este parámetro solo es compatible cuando la instancia ejecuta PostgreSQL con discos SSD estándar o mejorados. Además, este parámetro solo está disponible cuando la clave pública de la CA que emite los certificados de cliente está habilitada. Valores válidos:

  • 1: habilita la CRL
  • 0: deshabilita la CRL
ClientCertRevocationListStringNo-----BEGIN X509 CRL-----MIIB****19mg==-----END X509 CRL-----

La CRL que contiene los certificados de cliente revocados. Este parámetro solo es compatible cuando la instancia ejecuta PostgreSQL con discos SSD estándar o ESSD. Si establece el parámetro ClientCrlEnabled en 1, también debe especificar este parámetro.

ACLStringNocert

El método para verificar las identidades de los clientes. Este parámetro solo es compatible cuando la instancia ejecuta PostgreSQL con discos SSD estándar o ESSD. Además, este parámetro solo está disponible cuando la clave pública de la CA que emite los certificados de cliente está habilitada. Valores válidos:

  • cert
  • perfer
  • verify-ca
  • verify-full (compatible solo cuando la instancia ejecuta PostgreSQL 12 o posterior)
ReplicationACLStringNocert

El método para verificar el permiso de replicación. Este parámetro solo es compatible cuando la instancia ejecuta PostgreSQL con discos SSD estándar o ESSD. Además, este parámetro solo está disponible cuando la clave pública de la CA que emite los certificados de cliente está habilitada. Valores válidos:

  • cert
  • perfer
  • verify-ca
  • verify-full (compatible solo cuando la instancia ejecuta PostgreSQL 12 o posterior)

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

RequestId

String

777C4593-8053-427B-99E2-105593277CAB

El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

http(s)://rds.aliyuncs.com/?Action=ModifyDBInstanceSSL
&ConnectionString=rm-uf6wjk5xxxxx.mysql.rds.aliyuncs.com
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<RequestId>777C4593-8053-427B-99E2-105593277CAB</RequestId>

Formato JSON

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

{
  "RequestId" : "777C4593-8053-427B-99E2-105593277CAB"
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400

InvalidServerCertOrPrivateKey

Specify server certificate or private key is invalid.

El mensaje de error devuelto porque el certificado del servidor o la clave privada especificados no son válidos.

400

InvalidClientCACert

Specify client ca certificate is invalid.

El mensaje de error devuelto porque el valor del parámetro ClientCACert no es válido.

400

InvalidClientCrl

Specify client certificate revocation list is invalid.

El mensaje de error devuelto porque la CRL especificada no es válida.

400

InvalidCAType.NotFound

Specify ca type is not found.

El mensaje de error devuelto porque el tipo de certificado del servidor especificado no es válido.

400

InvalidACL.NotFound

Specify acl is not found.

El mensaje de error devuelto porque el valor del parámetro ACL no es válido.

400

InvalidSSLStatus

Specify ssl status is invalid.

El mensaje de error devuelto porque el valor del parámetro SSLEnabled no es válido.

403

InvalidClientCrl.Permission

Client ca certificate is set first if need to set client certificate revocation list.

El mensaje de error devuelto porque no tiene autorización para realizar esta operación. Debe configurar un certificado de CA de cliente antes de realizar esta operación.

403

InvalidACL.Permission

Client ca certificate is set first if need to set acl.

El mensaje de error devuelto porque no se especificó el certificado de CA de cliente.

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