Queues the installation of the extension pack on your target database. If other requests created by Start* operations are already in the migration project's queue, the installation begins after they complete.
This operation requires a non-virtual target data provider.
If the extension pack already exists, the operation reinstalls it. To ensure compatibility, reconvert your database objects if the version has changed since your last conversion. For more information, see Using extension packs in DMS Schema Conversion.
To check the status of the request, call DescribeExtensionPackAssociations using the returned RequestIdentifier as a filter.
Required permissions: dms:AssociateExtensionPack. For more information, see Actions, resources, and condition keys for Database Migration Service.
Parameters:
Raises:
Examples:
Install the extension pack on the target database
The following example queues the installation of the extension pack on the target database.
>>> await client.start_extension_pack_association(migration_project_identifier='arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS')
Source code in docs_src/capo_database_migration_service/_services/async_database_migration_service.py
| async def start_extension_pack_association(
self,
migration_project_identifier: "capo_database_migration_service.types.migration_project_identifier.MigrationProjectIdentifier",
*,
config_overrides: Optional[AsyncDatabaseMigrationServiceClientConfig] = None,
) -> "capo_database_migration_service.types.start_extension_pack_association_response.StartExtensionPackAssociationResponse":
"""<p>Queues the installation of the extension pack on your target database. If other requests created by <code>Start*</code> operations are already in the migration project's queue, the installation begins after they complete.</p> <p>This operation requires a non-virtual target data provider.</p> <p>If the extension pack already exists, the operation reinstalls it. To ensure compatibility, reconvert your database objects if the version has changed since your last conversion. For more information, see <a href="https://docs.aws.amazon.com/dms/latest/userguide/extension-pack.html">Using extension packs in DMS Schema Conversion</a>.</p> <p>To check the status of the request, call <a href="https://docs.aws.amazon.com/dms/latest/APIReference/API_DescribeExtensionPackAssociations.html">DescribeExtensionPackAssociations</a> using the returned <code>RequestIdentifier</code> as a filter.</p> <p> <b>Required permissions:</b> <code>dms:AssociateExtensionPack</code>. For more information, see <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsdatabasemigrationservice.html">Actions, resources, and condition keys for Database Migration Service</a>.</p>
Args:
migration_project_identifier: <p>The migration project name or Amazon Resource Name (ARN).</p>
Raises:
capo_database_migration_service.errors.access_denied_fault.AccessDeniedFault: <p>DMS was denied access to the endpoint. Check that the role is correctly configured.</p>
capo_database_migration_service.errors.invalid_resource_state_fault.InvalidResourceStateFault: <p>The resource is in a state that prevents it from being used for database migration.</p>
capo_database_migration_service.errors.kms_key_not_accessible_fault.KMSKeyNotAccessibleFault: <p>DMS cannot access the KMS key.</p>
capo_database_migration_service.errors.resource_already_exists_fault.ResourceAlreadyExistsFault: <p>The resource you are attempting to create already exists.</p>
capo_database_migration_service.errors.resource_not_found_fault.ResourceNotFoundFault: <p>The resource could not be found.</p>
capo_database_migration_service.errors.resource_quota_exceeded_fault.ResourceQuotaExceededFault: <p>The quota for this resource quota has been exceeded.</p>
capo_database_migration_service.errors.s3_access_denied_fault.S3AccessDeniedFault: <p>Insufficient privileges are preventing access to an Amazon S3 object.</p>
capo_database_migration_service.errors.s3_resource_not_found_fault.S3ResourceNotFoundFault: <p>A specified Amazon S3 bucket, bucket folder, or other object can't be found.</p>
capo_database_migration_service.errors.UnknownServiceError: The service returned an error code this client does not model.
Examples:
Install the extension pack on the target database
The following example queues the installation of the extension pack on the target database.
>>> await client.start_extension_pack_association(migration_project_identifier='arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS')
"""
async def _handler(
req: "AsyncOperationRequest[capo_database_migration_service.types.start_extension_pack_association_message.StartExtensionPackAssociationMessage]",
) -> AsyncOperationResponse[
"capo_database_migration_service.types.start_extension_pack_association_response.StartExtensionPackAssociationResponse"
]:
import capo_database_migration_service._operations.amazon_dm_sv20160101.start_extension_pack_association
(
output,
http_response,
) = await capo_database_migration_service._operations.amazon_dm_sv20160101.start_extension_pack_association.async_start_extension_pack_association(
req.options, req.input
)
return AsyncOperationResponse(output=output, response=http_response)
interceptors_, options_ = self.operation_options(
config_overrides, OperationLogging("StartExtensionPackAssociation")
)
input_: capo_database_migration_service.types.start_extension_pack_association_message.StartExtensionPackAssociationMessage = {
"migration_project_identifier": migration_project_identifier
}
response = await aexecute_pipeline(
AsyncOperationRequest(input=input_, options=options_),
handler=_handler,
interceptors=list(interceptors_),
)
await response.response.aclose()
return response.output
|