Appelez l'opération DescribeDBInstanceSSL pour interroger les paramètres de chiffrement SSL d'une instance ApsaraDB RDS.
Avant d'appeler cette opération, assurez-vous que votre instance correspond à l'un des types suivants :
Instances ApsaraDB RDS for MySQL autres que l'édition RDS Basic Edition
Instances ApsaraDB RDS for SQL Server
Instances ApsaraDB RDS for PostgreSQL utilisant des disques SSD standard ou des disques ESSD (Enhanced SSD)
Débogage
Paramètres de requête
|
Paramètre |
Type |
Obligatoire |
Exemple |
Description |
|
Action |
String |
Oui |
DescribeDBInstanceSSL |
Opération à effectuer. Définissez la valeur sur DescribeDBInstanceSSL. |
|
DBInstanceId |
String |
Oui |
rm-bp162dfr55g47**** |
ID de l'instance. |
Paramètres de réponse
| Paramètre | Type | Exemple | Description |
| ServerCert | String | -----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 des disques ESSD. |
| ClientCACertExpireTime | String | - | Date d'expiration de 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 des disques ESSD. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ et s'affiche en UTC. Ce paramètre n'est pas encore pris en charge. |
| RequireUpdateItem | String | - | Certificat serveur à mettre à jour. Ce paramètre est pris en charge uniquement lorsque l'instance exécute PostgreSQL avec des disques SSD standard ou des disques ESSD. |
| ServerCAUrl | String | - | URL du certificat utilisé pour émettre le certificat serveur. Ce paramètre est pris en charge uniquement lorsque l'instance exécute PostgreSQL avec des disques SSD standard ou des disques ESSD. |
| RequireUpdate | String | Yes | Indique si le certificat serveur doit être mis à jour.
|
| ClientCertRevocationList | String | -----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 des disques ESSD. |
| SSLExpireTime | String | 2022-10-11T08:16:43Z | Date d'expiration du certificat serveur. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ et s'affiche en UTC. |
| CAType | String | aliyun | Type de certificat serveur. Ce paramètre est pris en charge uniquement lorsque l'instance exécute PostgreSQL avec des disques SSD standard ou des disques ESSD. Valeurs valides :
|
| SSLCreateTime | String | - | Date de création du certificat serveur. Ce paramètre est pris en charge uniquement lorsque l'instance exécute PostgreSQL avec des disques SSD standard ou des disques ESSD. De plus, ce paramètre n'est valide que lorsque le paramètre CAType est défini sur aliyun. |
| ReplicationACL | String | 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 des disques ESSD. Valeurs valides :
|
| ACL | String | 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 des disques ESSD. Valeurs valides :
|
| RequestId | String | 7705151C-E242-55AF-9929-2A3C39D979D2 | ID de la requête. |
| LastModifyStatus | String | setting | État du lien SSL. Ce paramètre est pris en charge uniquement lorsque l'instance exécute PostgreSQL avec des disques SSD standard ou des disques ESSD. Valeurs valides :
|
| SSLEnabled | String | Yes | Indique si le chiffrement SSL est activé.
|
| ConnectionString | String | rm-bp162dfr55g47****.mysql.rds.aliyuncs.com | Endpoint protégé par le chiffrement SSL. |
| RequireUpdateReason | String | - | Raison de la mise à jour requise du certificat serveur. Ce paramètre est pris en charge uniquement lorsque l'instance exécute PostgreSQL avec des disques SSD standard ou des disques ESSD. |
| ClientCACert | String | -----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 des disques ESSD. |
| ServerKey | String | -----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 des disques ESSD. |
| ModifyStatusReason | String | Modify DB Instance SSL Config. | Raison pour laquelle le lien SSL reste dans l'état actuel. Ce paramètre est pris en charge uniquement lorsque l'instance exécute PostgreSQL avec des disques SSD standard ou des disques ESSD. |
Exemples
Exemples de requêtes
http(s)://rds.aliyuncs.com/?Action=DescribeDBInstanceSSL
&DBInstanceId=rm-bp162dfr55g47****
&<Common request parameters>
Exemples de réponses réussies
Format XML
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeDBInstanceSSL>
<RequestId>7705151C-E242-55AF-9929-2A3C39D979D2</RequestId>
<RequireUpdate>Yes</RequireUpdate>
<SSLExpireTime>2022-10-11T08:16:43Z</SSLExpireTime>
<SSLEnabled>Yes</SSLEnabled>
<RequireUpdateReason/>
<ConnectionString>rm-bp162dfr55g47****.mysql.rds.aliyuncs.com</ConnectionString>
</DescribeDBInstanceSSL>
Format JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "7705151C-E242-55AF-9929-2A3C39D979D2",
"RequireUpdate" : "Yes",
"SSLExpireTime" : "2022-10-11T08:16:43Z",
"SSLEnabled" : "Yes",
"RequireUpdateReason" : "",
"ConnectionString" : "rm-bp162dfr55g47****.mysql.rds.aliyuncs.com"
}
Codes d'erreur
|
Code d'état HTTP |
Code d'erreur |
Message d'erreur |
Description |
|
400 |
InvaildEngineInRegion.ValueNotSupported |
The engine is not supported in the region. |
Le moteur de base de données exécuté sur l'instance n'est pas pris en charge dans la région spécifiée. |
|
403 |
OperationDenied.DBInstanceType |
The operation is not permitted due to type of the instance. |
L'opération n'est pas autorisée en raison du type de l'instance. Vérifiez si l'instance est une instance en lecture seule. Une instance en lecture seule ne peut pas être clonée. |
|
403 |
InstanceEngineType.NotSupport |
The instance engine and type does not support operations |
L'opération n'est pas prise en charge pour le moteur de base de données et le type d'instance spécifiés. |
|
403 |
IncorrectEngineVersion |
Current engine version does not support operations. |
Cette opération n'est pas prise en charge pour la version du moteur de base de données exécutée sur l'instance. |
|
403 |
IncorrectDBInstanceState |
Current DB instance state does not support this operation. |
Cette opération n'est pas prise en charge lorsque l'instance se trouve dans l'état actuel. |
|
403 |
IncorrectDBInstanceType |
Current DB instance type does not support this operation. |
Cette opération n'est pas prise en charge lorsque l'instance se trouve dans l'état actuel. |
|
403 |
IncorrectDBInstanceLockMode |
Current DB instance lock mode does not support this operation. |
L'instance est verrouillée. |
|
403 |
ConnectionStringLengthExceeded |
Connection String is too long. |
La longueur de l'endpoint spécifié dépasse la limite supérieure. Saisissez un endpoint valide. |
|
404 |
InvalidDBInstanceId.NotFound |
The specified instance is not found. |
L'instance n'existe pas. Vérifiez si l'instance existe dans le compte actuel. |
|
404 |
EnabledSSLNotSupport |
Specified region does not support enable ssl. |
La fonctionnalité de chiffrement SSL n'est pas prise en charge dans la région spécifiée. |
|
404 |
InvalidConnectionString.NotFound |
Specified connection string or net type is not found. |
L'endpoint que vous avez spécifié est introuvable. Vérifiez si l'endpoint spécifié est valide. |
Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs.