Deletes a custom engine version. To run this command, make sure you meet the following prerequisites:
-
The CEV must not be the default for RDS Custom. If it is, change the default before running this command.
-
The CEV must not be associated with an RDS Custom DB instance, RDS Custom instance snapshot, or automated backup of your RDS Custom instance.
Typically, deletion takes a few minutes.
The MediaImport service that imports files from Amazon S3 to create CEVs isn't integrated with Amazon Web Services CloudTrail. If you turn on data logging for Amazon RDS in CloudTrail, calls to the DeleteCustomDbEngineVersion event aren't logged. However, you might see calls from the API gateway that accesses your Amazon S3 bucket. These calls originate from the MediaImport service for the DeleteCustomDbEngineVersion event.
For more information, see Deleting a CEV in the Amazon RDS User Guide.
Parameters:
-
engine
(Optional[CustomEngineName], default:
None
)
–
The database engine.
RDS Custom for Oracle supports the following values:
-
custom-oracle-ee
-
custom-oracle-ee-cdb
-
custom-oracle-se2
-
custom-oracle-se2-cdb
RDS Custom for SQL Server supports the following values:
-
custom-sqlserver-ee
-
custom-sqlserver-se
-
custom-sqlserver-web
-
custom-sqlserver-dev
RDS for SQL Server supports the following values:
-
engine_version
(Optional[CustomEngineVersion], default:
None
)
–
The custom engine version (CEV) for your DB instance. This option is required for RDS Custom, but optional for Amazon RDS. The combination of Engine and EngineVersion is unique per customer per Amazon Web Services Region.
Raises:
Source code in docs_src/capo_rds/_services/async_rds.py
| async def delete_custom_db_engine_version(
self,
*,
config_overrides: Optional[AsyncRDSClientConfig] = None,
engine: Optional["capo_rds.types.custom_engine_name.CustomEngineName"] = None,
engine_version: Optional[
"capo_rds.types.custom_engine_version.CustomEngineVersion"
] = None,
) -> "capo_rds.types.db_engine_version.DBEngineVersion":
"""<p>Deletes a custom engine version. To run this command, make sure you meet the following prerequisites:</p> <ul> <li> <p>The CEV must not be the default for RDS Custom. If it is, change the default before running this command.</p> </li> <li> <p>The CEV must not be associated with an RDS Custom DB instance, RDS Custom instance snapshot, or automated backup of your RDS Custom instance.</p> </li> </ul> <p>Typically, deletion takes a few minutes.</p> <note> <p>The MediaImport service that imports files from Amazon S3 to create CEVs isn't integrated with Amazon Web Services CloudTrail. If you turn on data logging for Amazon RDS in CloudTrail, calls to the <code>DeleteCustomDbEngineVersion</code> event aren't logged. However, you might see calls from the API gateway that accesses your Amazon S3 bucket. These calls originate from the MediaImport service for the <code>DeleteCustomDbEngineVersion</code> event.</p> </note> <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.delete">Deleting a CEV</a> in the <i>Amazon RDS User Guide</i>.</p>
Args:
engine: <p>The database engine.</p> <p>RDS Custom for Oracle supports the following values:</p> <ul> <li> <p> <code>custom-oracle-ee</code> </p> </li> <li> <p> <code>custom-oracle-ee-cdb</code> </p> </li> <li> <p> <code>custom-oracle-se2</code> </p> </li> <li> <p> <code>custom-oracle-se2-cdb</code> </p> </li> </ul> <p>RDS Custom for SQL Server supports the following values:</p> <ul> <li> <p> <code>custom-sqlserver-ee</code> </p> </li> <li> <p> <code>custom-sqlserver-se</code> </p> </li> <li> <p> <code>custom-sqlserver-web</code> </p> </li> <li> <p> <code>custom-sqlserver-dev</code> </p> </li> </ul> <p>RDS for SQL Server supports the following values:</p> <ul> <li> <p> <code>sqlserver-ee</code> (Bring Your Own Media)</p> </li> <li> <p> <code>sqlserver-se</code> (Bring Your Own Media)</p> </li> <li> <p> <code>sqlserver-dev-ee</code> </p> </li> </ul>
engine_version: <p>The custom engine version (CEV) for your DB instance. This option is required for RDS Custom, but optional for Amazon RDS. The combination of <code>Engine</code> and <code>EngineVersion</code> is unique per customer per Amazon Web Services Region.</p>
Raises:
capo_rds.errors.custom_db_engine_version_not_found_fault.CustomDBEngineVersionNotFoundFault: <p>The specified CEV was not found.</p>
capo_rds.errors.invalid_custom_db_engine_version_state_fault.InvalidCustomDBEngineVersionStateFault: <p>You can't delete the CEV.</p>
capo_rds.errors.UnknownServiceError: The service returned an error code this client does not model.
"""
async def _handler(
req: "AsyncOperationRequest[capo_rds.types.delete_custom_db_engine_version_message.DeleteCustomDBEngineVersionMessage]",
) -> AsyncOperationResponse["capo_rds.types.db_engine_version.DBEngineVersion"]:
import capo_rds._operations.amazon_rd_sv19.delete_custom_db_engine_version
(
output,
http_response,
) = await capo_rds._operations.amazon_rd_sv19.delete_custom_db_engine_version.async_delete_custom_db_engine_version(
req.options, req.input
)
return AsyncOperationResponse(output=output, response=http_response)
interceptors_, options_ = self.operation_options(
config_overrides, OperationLogging("DeleteCustomDBEngineVersion")
)
input_: capo_rds.types.delete_custom_db_engine_version_message.DeleteCustomDBEngineVersionMessage = {}
if engine is not None:
input_["engine"] = engine
if engine_version is not None:
input_["engine_version"] = engine_version
response = await aexecute_pipeline(
AsyncOperationRequest(input=input_, options=options_),
handler=_handler,
interceptors=list(interceptors_),
)
await response.response.aclose()
return response.output
|