ModifyDBInstanceTDE - - Centro de documentación de Alibaba Cloud

Esta operación permite modificar el estado del cifrado de datos transparente (TDE) de una instancia de ApsaraDB for MongoDB.

El TDE cifra y descifra E/S en tiempo real los archivos de datos. Los datos se cifran antes de escribirse en disco y se descifran al leerlos del disco a la memoria. Para obtener más información, consulte Configurar TDE.

Nota

Una vez habilitado el TDE, no es posible deshabilitarlo.

Antes de ejecutar esta operación, asegúrese de cumplir con los siguientes requisitos:

La instancia debe ser un conjunto de réplicas o un clúster fragmentado.
El motor de almacenamiento de la instancia debe ser WiredTiger.
La versión del motor de base de datos de la instancia debe ser 4.0 o 4.2. Si la versión es anterior a la 4.0, ejecute la operación UpgradeDBInstanceEngineVersion para actualizar el motor de base de datos.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda ejecutar esta operación en OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ModifyDBInstanceTDE	Operación que desea ejecutar. Establezca el valor en ModifyDBInstanceTDE.
DBInstanceId	String	Sí	dds-bpxxxxxxxx	ID de la instancia.
TDEStatus	String	Sí	enabled	Estado del TDE. Establezca el valor en Enabled. Nota Tenga precaución al habilitar el TDE. Una vez habilitado, no es posible deshabilitarlo.
RegionId	String	No	cn-hangzhou	ID de región de la instancia. Ejecute la operación DescribeDBInstanceAttribute para consultar el ID de región de la instancia.
EncryptorName	String	No	aes-256-cbc	Método de cifrado. Establezca el valor en AES-256-CBC. Nota Este parámetro solo es válido cuando se establece el parámetro TEDStatus en enabled.
EncryptionKey	String	No	749c1df7-xxxx-xxxx-xxxx-xxxxxxxxxxxx	Clave personalizada.
RoleARN	String	No	acs:ram::123456789012****:role/adminrole	ARN del rol. Sigue el formato `acs:ram::$accountID:role/$roleName`. Nota `$accountID`: indica el ID de la cuenta de Alibaba Cloud propietaria del rol de RAM. Para ver el ID de la cuenta, inicie sesión en la consola de administración de Alibaba Cloud, pase el puntero sobre su foto de perfil en la esquina superior derecha y haga clic en Security Settings. `$roleName`: indica el nombre del rol de RAM. Para ver el nombre del rol de RAM, siga estos pasos: Inicie sesión en la consola de RAM. En el panel de navegación izquierdo, haga clic en RAM Roles. En la columna RAM Role Name de la página mostrada, podrá consultar el nombre del rol de RAM.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	434D7127-6229-4355-BA50-7A3685A725DF	ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

http(s)://mongodb.aliyuncs.com/? Action=ModifyDBInstanceTDE
&DBInstanceId=dds-bpxxxxxxxx
&TDEStatus=enabled
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<ModifyDBInstanceTDEResponse>
	  <RequestId>434D7127-6229-4355-BA50-7A3685A725DF</RequestId>
</ModifyDBInstanceTDEResponse>

Formato JSON

{
	"RequestId": "434D7127-6229-4355-BA50-7A3685A725DF"
}

Código de error

HttpCode	Código de error	Mensaje de error	Descripción
403	IncorrectDBInstanceState	Current DB instance state does not support this operation.	Mensaje de error devuelto porque la operación no es compatible con el estado actual de la instancia. Compruebe si los parámetros especificados son correctos.
403	IncorrectDBInstanceLockMode	Current DB instance lock mode does not support this operation.	Mensaje de error devuelto porque la instancia está bloqueada.

Para obtener más información sobre los códigos de error, visite el Centro de errores de API.