How to resolve the 'Failed to delete DataIntegration' error when deleting Amazon Q for Connect data integrations ?

Root Causes

The "Failed to delete DataIntegration" error typically occurs due to two main reasons:

1. The data integration is actively associated with an Amazon Q domain in your Connect instance.
2. There are underlying or hidden association records that must be removed first.

Prerequisites

• AWS CLI version 2.3 (or higher) installed locally, or access to AWS CloudShell.
• AWS credentials and the region configured in your environment.
• Appropriate IAM permissions to manage Connect and Q in Connect (Wisdom) resources.

Resolution Steps

1. List Existing Data Integrations

To view all the existing data integrations , run the following command :

aws appintegrations list-data-integrations

2. Check Data Integration Associations

To view asociations for the target data integration , run :

aws appintegrations list-data-integration-associations --data-integration-identifier <DATA_INTEGRATION_NAME>

If you cannot find any data integration associations with your data integration, move to the next step in order to ensure there are no other associations existing with the Connect instance or in Q for Connect.

3. Review Connect Instance Integrations

To list all the integrations associated with your Connect instance , run :

aws connect list-integration-associations --instance-id <CONNECT_INSTANCE_ID>

Note down:

• IntegrationAssociationId for "WISDOM_KNOWLEDGE_BASE" type
• IntegrationArn for "WISDOM_ASSISTANT" type

4. Delete Knowledge Base Integration

If WISDOM_KNOWLEDGE_BASE exists, run :

aws connect delete-integration-association --instance-id <CONNECT_INSTANCE_ID> --integration-association-id <WISDOM_KNOWLEDGE_BASE_IntegrationAssociationId>

5. Manage QConnect Assistant Associations

List the assistant associations for the "WISDOM_ASSISTANT" :

aws qconnect list-assistant-associations --assistant-id <WISDOM_ASSISTANT_ID>

Note: Only input the id from the IntegrationARN value retrieved in step 3.

6. Clean Up any existing Assistant Associations

Delete any found associations :

aws qconnect delete-assistant-association --assistant-id <assistantId> --assistant-association-id <assistantAssociationId>

7. Handle Knowledge Base Resources

List existing qconnect knowledge bases :

 aws qconnect list-knowledge-bases

8. Delete Related Knowledge Base

Remove any knowledge base associated with your data integration :

aws qconnect delete-knowledge-base --knowledge-base-id <KNOWLEDGE_BASE_ID>

9. Verify Association Removal

Confirm data integration associations are removed :

aws appintegrations list-data-integration-associations --data-integration-identifier <DATA_INTEGRATION_NAME>

10. Delete Data Integration

Finally, delete the data integration :

aws appintegrations delete-data-integration --data-integration-identifier  <DATA_INTEGRATION_NAME>

Verification

After completing these steps, verify in the Amazon Connect console that the data integration has been successfully removed.

Important Notes

• Amazon Q in Connect Knowledge bases have a hard limit of 10 per region.
• 'Data integrations per region' quota can be increased from the default value of 10 through Service Quotas console. It is possible to receive auto-approval for an increase request of upto 25.
• As a best practice, ensure to back up or document the configurations and settings before deletion.
• The provided CLI commands can also be run directly in AWS CloudShell within the AWS Management Console, provided the IAM role/user has the necessary permissions required to access it.

Related Documentation

• AWS CLI Installation Guide : https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-install.html
• Amazon Connect AppIntegrations service quotas : https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-service-limits.html#app-integration-quotas
• Amazon Q in Connect Service Quotas : https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-service-limits.html#q-in-connect-quotas
• Amazon Connect CLI reference : https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/index.html
• Amazon Connect Appintegrations CLI reference : https://awscli.amazonaws.com/v2/documentation/api/latest/reference/appintegrations/index.html
• Amazon Q in Connect CLI reference : https://awscli.amazonaws.com/v2/documentation/api/latest/reference/qconnect/index.html
• AWS CloudShell reference : https://docs.aws.amazon.com/cloudshell/latest/userguide/getting-started.html