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.
-
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
Parámetros de solicitud
| Parámetro | Tipo | Obligatorio | Ejemplo | Descripción |
| Action | String | Sí | ModifyDBInstanceSSL | La operación que desea ejecutar. Establezca el valor en ModifyDBInstanceSSL. |
| DBInstanceId | String | Sí | rm-uf6wjk5xxxxxxx | El ID de la instancia. |
| ConnectionString | String | Sí | rm-uf6wjk5xxxxx.mysql.rds.aliyuncs.com | El endpoint interno o público para el cual se debe crear o actualizar el certificado del servidor. |
| SSLEnabled | Integer | No | 1 | Especifica si se habilita o deshabilita el cifrado SSL. Valores válidos:
|
| CAType | String | No | aliyun | 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:
|
| ServerCert | String | No | -----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. |
| ServerKey | String | No | -----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. |
| ClientCAEnabled | Integer | No | 1 | 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:
|
| ClientCACert | String | No | -----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. |
| ClientCrlEnabled | Integer | No | 1 | 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:
|
| ClientCertRevocationList | String | No | -----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. |
| ACL | String | No | cert | 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:
|
| ReplicationACL | String | No | cert | 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:
|
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.