Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Managing Amazon Q Business indices

Focus mode
Managing Amazon Q Business indices - Amazon Q Business

To manage Amazon Q Business indexes, you can take the following actions:

Deleting an Amazon Q Business index

To delete a Amazon Q Business index, you can use the console or the DeleteIndex API operation.

If you use the console, deleting an index automatically deletes the retriever attached to it. If you use the API, you must also use the DeleteRetriever API operation to delete the Amazon Q Business retriever attached to your index.

The following tabs provide a procedure for the AWS Management Console and code examples for the AWS CLI.

Console

To delete an Amazon Q Business index

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. Complete the steps to create your Amazon Q Business application.

  3. In Applications, select the name of your application from the list of applications.

  4. From the left navigation menu, choose Data sources.

  5. From the Data sources page, from Index, select Delete.

  6. In the dialog box that opens, type Confirm to confirm deletion, and then choose Delete.

    You are returned to the service console while your application environment is deleted. When the deletion process is complete, the console displays a message confirming successful deletion.

AWS CLI

To delete an Amazon Q Business index

aws qbusiness delete-index \ --application-id application-id \ --retriever-id index-id

To delete an Amazon Q Business retriever

aws qbusiness delete-retriever \ --application-id application-id \ --retriever-id retriever-id

To delete an Amazon Q Business index

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. Complete the steps to create your Amazon Q Business application.

  3. In Applications, select the name of your application from the list of applications.

  4. From the left navigation menu, choose Data sources.

  5. From the Data sources page, from Index, select Delete.

  6. In the dialog box that opens, type Confirm to confirm deletion, and then choose Delete.

    You are returned to the service console while your application environment is deleted. When the deletion process is complete, the console displays a message confirming successful deletion.

Getting properties of an Amazon Q Business index

To get the properties of an Amazon Q Business index and retriever, you can use the console or the GetIndex and GetRetriever API operation.

The following tabs provide a procedure for the AWS Management Console and code examples for the AWS CLI.

Console

To get properties of an Amazon Q Business index and retriever

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. In Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Data sources.

  4. On the Data sources page, under Index the following settings are available:

    • Index name – The name of the index.

    • Index status – The status of your index.

    • Index provisioning – The number of index units provisioned for your index.

    • Document count – The number of documents that are attached to your index.

    • Storage used – The amount of storage that your index is using.

    • Index ID – The ID of the index attached to your retriever.

    • Retriever ID – The ID of the retriever that you're using.

    • Retriever – The retriever type that you're using.

    • Last modified – The time that your index was last modified.

AWS CLI

To get properties of an Amazon Q Business index and retriever

aws qbusiness get-index \ --application-id application-id \ --index-id index-id
aws qbusiness get-retriever \ --application-id application-id \ --retriever-id retriever-id

To get properties of an Amazon Q Business index and retriever

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. In Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Data sources.

  4. On the Data sources page, under Index the following settings are available:

    • Index name – The name of the index.

    • Index status – The status of your index.

    • Index provisioning – The number of index units provisioned for your index.

    • Document count – The number of documents that are attached to your index.

    • Storage used – The amount of storage that your index is using.

    • Index ID – The ID of the index attached to your retriever.

    • Retriever ID – The ID of the retriever that you're using.

    • Retriever – The retriever type that you're using.

    • Last modified – The time that your index was last modified.

Listing Amazon Q Business indices and retrievers

To list your native Amazon Q Business indices and retrievers, you can use the console or the ListIndices API operation and the ListRetrievers API operation.

If you use the console, the list of Amazon Q Business indices and retrievers can be found within the list of data sources that you have created.

The following tabs provide a procedure for the AWS Management Console and code examples for the AWS CLI.

Console

To list your Amazon Q Business indices and retrievers

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. In Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Data sources.

  4. On the Data sources page, a list of all indices that you have created is available.

AWS CLI

To list your Amazon Q Business indices and retrievers

aws qbusiness list-indices \ --application-id application-id \ --max-results maximum-result-to-display
aws qbusiness list-retrievers \ --application-id application-id \ --max-results maximum-result-to-display

To list your Amazon Q Business indices and retrievers

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. In Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Data sources.

  4. On the Data sources page, a list of all indices that you have created is available.

Editing Amazon Q Business indices

To edit your Amazon Q Business index, you can use the console or the UpdateIndices API operation.

Note

When you update a native index, you can only update the number of storage units you provisioned for it. You can't change any other settings.

The following tab provides code examples for the AWS Management Console and AWS CLI.

Console

To update your Amazon Q Business retriever

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. In Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Data sources.

  4. In the Data sources page, from Index, select Edit.

  5. In Edit index, choose to update index units provisioned from Number of units.

  6. Select Update to save your changes.

AWS CLI

To update your Amazon Q Business index

aws qbusiness update-index \ --application-id application-id \ --index-id index-id \ --display-name display-name \ --role-arn roleArn \ --capacity-configuration IndexCapacityConfiguration="{indexId=<index-id>}"

To update your Amazon Q Business retriever

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. In Applications, select the name of your application from the list of applications.

  3. From the left navigation menu, choose Data sources.

  4. In the Data sources page, from Index, select Edit.

  5. In Edit index, choose to update index units provisioned from Number of units.

  6. Select Update to save your changes.

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.