aws Verified current stable Not installed? Cloud Infrastructure

Aws / List Indexes

List Indexes

Lists existing Kendra indexes.

$
Terminal
aws kendra list-indexes

When To Use

During a system audit to inventory deployed Kendra indexes within an AWS account.

Pro Tip

Using `--max-results` can help paginate results for accounts with numerous indexes, mitigating timeouts.

Terminal Output

Expected runtime feedback

Simulated preview
>
Output
┌────────────┬───────────────────────────────────────────────┐
│ IndexId    │ Name                                          │
├────────────┼───────────────────────────────────────────────┤
│ 1234567890 │ MyFirstIndex                                 │
│ 0987654321 │ AnotherIndex                                  │
└────────────┴───────────────────────────────────────────────┘

Anatomy of Output

Understanding the result

IndexSummaryList: [] Index Summary List

An empty list indicates no indexes are currently deployed.

IndexId: 67890-abcde-12345-fghij Example Index ID

Identifier for an existing Kendra index.

Status: ACTIVE Status of the Index

Current operational status of the listed indexes.

Power User Variants

Optimized versions

aws kendra list-indexes --max-results 10

List a maximum of 10 indexes to prevent timeout errors.

Troubleshooting

Common pitfalls

An error occurred (ResourceNotFound) when calling the ListIndexes operation: No indexes found.

Solution: Confirm that at least one Kendra index has been created in your account.

An error occurred (AccessDenied) when calling the ListIndexes operation: User does not have permissions to list indexes.

Solution: Validate IAM permissions related to Kendra service for the executing user.

An error occurred (ThrottlingException) when calling the ListIndexes operation: Rate limit exceeded.

Solution: Implement exponential backoff in your code to handle API rate limiting.

Command Breakdown

What each part is doing

aws
Base Command
The executable that performs this operation. Here it runs Aws before the shell applies any redirect operators.

How To Run

Execution path

  1. Step 1

    Run the command: aws kendra list-indexes

  2. Step 2

    Review the output to find your Kendra indexes

  3. Step 3

    Ensure the indexes match expected configurations for effective document indexing

Alternative Approaches

Comparable commands in other tools

Alternative cloud infrastructure tools for the same job.