Modifier les paramètres de chiffrement SSL d'une instance ApsaraDB RDS -

Cette opération configure le chiffrement SSL d'une instance. Pour plus d'informations, consultez la rubrique Secure Sockets Layer.

Remarque

Avant d'appeler cette opération, vérifiez que votre instance correspond à l'un des types suivants :
- Instances ApsaraDB RDS for MySQL autres que l'édition Basic
- Instances ApsaraDB RDS for SQL Server
- Instances ApsaraDB RDS for PostgreSQL utilisant des disques SSD standard ou ESSD (Enhanced SSD)
Le chiffrement SSL n'est pas pris en charge pour les connexions à l'endpoint de répartition lecture/écriture d'une instance.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer 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	ModifyDBInstanceSSL	Opération à effectuer. Définissez la valeur sur ModifyDBInstanceSSL.
DBInstanceId	String	Oui	rm-uf6wjk5xxxxxxx	ID de l'instance.
ConnectionString	String	Oui	rm-uf6wjk5xxxxx.mysql.rds.aliyuncs.com	Endpoint interne ou public pour lequel créer ou mettre à jour le certificat serveur.
SSLEnabled	Integer	Non	1	Indique s'il faut activer ou désactiver le chiffrement SSL. Valeurs possibles : 1 : active le chiffrement SSL 0 : désactive le chiffrement SSL
CAType	String	Non	aliyun	Type du certificat serveur. Ce paramètre est pris en charge uniquement lorsque l'instance exécute PostgreSQL avec des disques SSD standard ou ESSD. Si vous définissez le paramètre SSLEnabled sur 1, la valeur par défaut de ce paramètre est aliyun. Valeurs possibles : aliyun : certificat cloud custom : certificat personnalisé
ServerCert	String	Non	-----BEGIN CERTIFICATE-----MIID*****QqEP-----END CERTIFICATE-----	Contenu du certificat serveur. Ce paramètre est pris en charge uniquement lorsque l'instance exécute PostgreSQL avec des disques SSD standard ou ESSD. Si vous définissez le paramètre CAType sur custom, vous devez également spécifier ce paramètre.
ServerKey	String	Non	-----BEGIN PRIVATE KEY-----MIIE****ihfg==-----END PRIVATE KEY-----	Clé privée du certificat serveur. Ce paramètre est pris en charge uniquement lorsque l'instance exécute PostgreSQL avec des disques SSD standard ou ESSD. Si vous définissez le paramètre CAType sur custom, vous devez également spécifier ce paramètre.
ClientCAEnabled	Integer	Non	1	Indique s'il faut activer la clé publique de l'autorité de certification (CA) émettant les certificats clients. Ce paramètre est pris en charge uniquement lorsque l'instance exécute PostgreSQL avec des disques SSD standard ou ESSD. Valeurs possibles : 1 : active la clé publique 0 : désactive la clé publique
ClientCACert	String	Non	-----BEGIN CERTIFICATE-----MIID*****viXk=-----END CERTIFICATE-----	Clé publique de l'autorité de certification (CA) émettant les certificats clients. Ce paramètre est pris en charge uniquement lorsque l'instance exécute PostgreSQL avec des disques SSD standard ou ESSD. Si vous définissez le paramètre ClientCAEbabled sur 1, vous devez également spécifier ce paramètre.
ClientCrlEnabled	Integer	Non	1	Indique s'il faut activer une liste de révocation de certificats (CRL) contenant les certificats clients révoqués. Ce paramètre est pris en charge uniquement lorsque l'instance exécute PostgreSQL avec des disques SSD standard ou ESSD. De plus, ce paramètre est disponible uniquement si la clé publique de l'autorité de certification (CA) émettant les certificats clients est activée. Valeurs possibles : 1 : active la CRL 0 : désactive la CRL
ClientCertRevocationList	String	Non	-----BEGIN X509 CRL-----MIIB****19mg==-----END X509 CRL-----	Liste de révocation de certificats (CRL) contenant les certificats clients révoqués. Ce paramètre est pris en charge uniquement lorsque l'instance exécute PostgreSQL avec des disques SSD standard ou ESSD. Si vous définissez le paramètre ClientCrlEnabled sur 1, vous devez également spécifier ce paramètre.
ACL	String	Non	cert	Méthode utilisée pour vérifier l'identité des clients. Ce paramètre est pris en charge uniquement lorsque l'instance exécute PostgreSQL avec des disques SSD standard ou ESSD. De plus, ce paramètre est disponible uniquement si la clé publique de l'autorité de certification (CA) émettant les certificats clients est activée. Valeurs possibles : cert perfer verify-ca verify-full (pris en charge uniquement lorsque l'instance exécute PostgreSQL 12 ou version ultérieure)
ReplicationACL	String	Non	cert	Méthode utilisée pour vérifier l'autorisation de réplication. Ce paramètre est pris en charge uniquement lorsque l'instance exécute PostgreSQL avec des disques SSD standard ou ESSD. De plus, ce paramètre est disponible uniquement si la clé publique de l'autorité de certification (CA) émettant les certificats clients est activée. Valeurs possibles : cert perfer verify-ca verify-full (pris en charge uniquement lorsque l'instance exécute PostgreSQL 12 ou version ultérieure)

Paramètres de réponse

Paramètre

Type

Exemple

Description

RequestId

String

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

ID de la requête.

Exemples

Exemple de requête

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

Exemple de réponse réussie

Format XML

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

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

Format JSON

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

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

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidServerCertOrPrivateKey	Specify server certificate or private key is invalid.	Le message d'erreur indique que le certificat serveur ou la clé privée spécifiée n'est pas valide.
400	InvalidClientCACert	Specify client ca certificate is invalid.	Le message d'erreur indique que la valeur du paramètre ClientCACert n'est pas valide.
400	InvalidClientCrl	Specify client certificate revocation list is invalid.	Le message d'erreur indique que la liste de révocation de certificats (CRL) spécifiée n'est pas valide.
400	InvalidCAType.NotFound	Specify ca type is not found.	Le message d'erreur indique que le type de certificat serveur spécifié n'est pas valide.
400	InvalidACL.NotFound	Specify acl is not found.	Le message d'erreur indique que la valeur du paramètre ACL n'est pas valide.
400	InvalidSSLStatus	Specify ssl status is invalid.	Le message d'erreur indique que la valeur du paramètre SSLEnabled n'est pas valide.
403	InvalidClientCrl.Permission	Client ca certificate is set first if need to set client certificate revocation list.	Le message d'erreur indique que vous n'êtes pas autorisé à effectuer cette opération. Vous devez configurer un certificat CA client avant d'effectuer cette opération.
403	InvalidACL.Permission	Client ca certificate is set first if need to set acl.	Le message d'erreur indique que le certificat CA client n'est pas spécifié.

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