Activer TDE - - Centre de documentation Alibaba Cloud

Le service TDE effectue un chiffrement et un déchiffrement en temps réel des fichiers de données lors des opérations d'E/S. Les données sont chiffrées avant leur écriture sur le disque, puis déchiffrées avant leur lecture depuis le disque et leur chargement en mémoire. Pour plus d'informations, consultez la rubrique Configurer TDE pour une instance ApsaraDB RDS for MySQL.

Avant d'appeler cette opération, assurez-vous que les conditions suivantes sont remplies :

Le service Key Management Service (KMS) est activé. Si ce n'est pas le cas, vous pouvez l'activer directement lors de l'activation du service TDE.
L'instance doit exécuter l'une des versions de moteur de base de données et éditions RDS suivantes :
- MySQL 8.0 (version mineure du moteur 20191015 ou ultérieure) sur l'édition RDS High-availability avec SSD locaux
- MySQL 5.7 (version mineure du moteur 20191015 ou ultérieure) sur l'édition RDS High-availability avec SSD locaux
- MySQL 5.6
- SQL Server 2019 SE ou une édition Enterprise de SQL Server
- PostgreSQL 10, PostgreSQL 11, PostgreSQL 12, PostgreSQL 13, PostgreSQL 14 ou PostgreSQL 15 (version mineure du moteur 20221030 ou ultérieure)

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. 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	ModifyDBInstanceTDE	Opération à effectuer. Définissez la valeur sur ModifyDBInstanceTDE.
DBInstanceId	String	Oui	rm-uf6wjk5****	ID de l'instance. Vous pouvez appeler l'opération DescribeDBInstances pour interroger l'ID de l'instance.
TDEStatus	String	Oui	Enabled	Indique s'il faut activer le service TDE. Valeurs possibles : Enabled Disabled
DBName	String	Non	testDB	Nom de la base de données pour laquelle vous souhaitez activer le service TDE. Vous pouvez spécifier jusqu'à 50 noms de bases de données dans une seule requête. Si vous spécifiez plusieurs noms, séparez-les par des virgules (,). Remarque Ce paramètre est disponible et doit être spécifié lorsque l'instance exécute SQL Server 2019 SE ou une édition Enterprise de SQL Server.
EncryptionKey	String	Non	749c1df7-**---**	ID de la clé personnalisée. Remarque Ce paramètre est disponible lorsque l'instance exécute MySQL ou PostgreSQL.
RoleArn	String	Non	acs:ram::1406926****:role/aliyunrdsinstanceencryptiondefaultrole	Alibaba Cloud Resource Name (ARN) du rôle RAM. Un rôle RAM est une identité virtuelle que vous pouvez créer au sein de votre compte Alibaba Cloud. Pour plus d'informations, consultez la rubrique Présentation des rôles RAM. Remarque Ce paramètre est disponible lorsque l'instance exécute MySQL ou PostgreSQL.
Certificate	String	Non	oss-ap-southeast-1.aliyuncs.com:****:key.cer	Fichier contenant le certificat. Format : Endpoint public : `oss-<ID de la région>.aliyuncs.com:<nom du bucket>:<nom du fichier de certificat>` (le nom de fichier inclut l'extension) Endpoint interne : `oss-<ID de la région>-internal.aliyuncs.com:<nom du bucket>:<nom du fichier de certificat>` (le nom de fichier inclut l'extension) Remarque Ce paramètre est disponible lorsque l'instance exécute SQL Server 2019 SE ou une édition Enterprise de SQL Server. Vous pouvez appeler l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
PrivateKey	String	Non	oss-ap-southeast-1.aliyuncs.com:****:key.pvk	Fichier contenant la clé privée du certificat. Format : Endpoint public : `oss-<ID de la région>.aliyuncs.com:<nom du bucket>:<nom du fichier contenant la clé privée>` (le nom de fichier inclut l'extension) Endpoint interne : `oss-<ID de la région>-internal.aliyuncs.com:<nom du bucket>:<nom du fichier contenant la clé privée>` (le nom de fichier inclut l'extension) Remarque Ce paramètre est disponible lorsque l'instance exécute SQL Server 2019 SE ou une édition Enterprise de SQL Server. Vous pouvez appeler l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
PassWord	String	Non	1qaz@WSX	Mot de passe du certificat. Remarque Ce paramètre est disponible lorsque l'instance exécute SQL Server 2019 SE ou une édition Enterprise de SQL Server.
IsRotate	Boolean	Non	false	Indique s'il faut remplacer la clé. Valeurs possibles : true : remplace la clé. false : ne remplace pas la clé. Valeur par défaut : false. Remarque Ce paramètre est disponible uniquement lorsque l'instance exécute PostgreSQL.

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=ModifyDBInstanceTDE
&DBInstanceId=rm-uf6wjk5****
&TDEStatus=Enabled
&<Common request parameters>

Exemple de réponse réussie

XML format

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

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

JSON format

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

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

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidTDEstatus.Format	The Specified TDEStatus is not valid.	La valeur du paramètre TDEStatus n'est pas valide.
400	Invalid.PrivateKey	The requested privateKey parameter is invalid.	La valeur du paramètre PrivateKey n'est pas valide.
400	Invalid.Certificate	The requested certificate parameter is invalid.	La valeur du paramètre Certificate n'est pas valide.
400	CertOrPrivateKeyOrPasswordNotMatched	The public certificate, private key, and password do not match.	Le certificat, la clé privée et le mot de passe ne correspondent pas.
403	IncorrectDBInstanceType	Current DB instance type does not support this operation.	Cette opération n'est pas prise en charge dans l'état actuel de l'instance.
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	IncorrectDBInstanceLockMode	Current DB instance lock mode does not support this operation.	L'instance est verrouillée.
403	IncorrectDBInstanceState	Current DB instance state does not support this operation.	Cette opération n'est pas prise en charge dans l'état actuel de l'instance.
403	DBSizeExceeded	Exceeding the allowed DB size of DB instance.	La taille de la base de données spécifiée dépasse la limite autorisée.
403	IncorrectMinorVersion	Current engine minor version does not support operations.	Cette opération n'est pas prise en charge pour la version mineure actuelle du moteur.
404	InvalidDBName.NotFound	Specified one or more DB name does not exist or DB status does not support.	Le nom de l'instance est introuvable.

Pour obtenir la liste des codes d'erreur, consultez la rubrique Codes d'erreur de service.