Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Erstellen eines -Index Sie können einen Index mit der Konsole oder durch Aufrufen der [CreateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateIndex.html)API erstellen. Sie können das AWS Command Line Interface (AWS CLI) oder das SDK mit der API verwenden. Nachdem Sie Ihren Index erstellt haben, können Sie ihm Dokumente direkt oder aus einer Datenquelle hinzufügen. Um einen Index zu erstellen, müssen Sie den Amazon-Ressourcennamen (ARN) einer AWS Identity and Access Management (IAM) -Rolle angeben, auf die Indizes zugreifen CloudWatch können. Weitere Informationen finden Sie unter [IAM Rollen für Indizes](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-index). Die folgenden Registerkarten enthalten ein Verfahren zum Erstellen eines Indexes mithilfe von AWS-Managementkonsole, sowie Codebeispiele für die Verwendung von AWS CLI, und Python und Java SDKs. ------ #### [ Console ] **So erstellen Sie einen -Index** 1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon Kendra Konsole unter [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/). 1. Wählen Sie im Bereich **Indizes** die Option **Index erstellen** aus. 1. **Geben Sie im Feld Indexdetails** angeben Ihrem Index einen Namen und eine Beschreibung. 1. Geben Sie im Feld **IAM Rolle** eine IAM Rolle an. Um eine Rolle zu finden, wählen Sie eine der Rollen in Ihrem Konto aus, die das Wort „Kendra“ enthalten, oder geben Sie den Namen einer anderen Rolle ein. Weitere Informationen zu den Berechtigungen, die für die Rolle erforderlich sind, finden Sie unter [IAM Rollen für Indizes](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-index). 1. Wählen Sie **Weiter** aus. 1. Wählen Sie auf der Seite **Benutzerzugriffskontrolle konfigurieren** die Option **Weiter** aus. Sie können Ihren Index aktualisieren, um Token für die Zugriffskontrolle zu verwenden, nachdem Sie einen Index erstellt haben. Weitere Informationen finden Sie unter [Steuern des Zugriffs auf Dokumente](https://docs.aws.amazon.com/kendra/latest/dg/create-index-access-control.html). 1. Wählen Sie auf der Seite mit den **Bereitstellungsdetails** die Option **Erstellen** aus. 1. Es kann einige Zeit dauern, bis der Index erstellt ist. Sehen Sie sich die Liste der Indizes an, um den Fortschritt der Indexerstellung zu verfolgen. Wenn der Status des Indexes lautet`ACTIVE`, ist Ihr Index einsatzbereit. ------ #### [ AWS CLI ] **So erstellen Sie einen -Index** 1. Verwenden Sie den folgenden Befehl, um einen Index zu erstellen. Das `role-arn` muss der Amazon-Ressourcenname (ARN) einer IAM Rolle sein, die Amazon Kendra Aktionen ausführen kann. Weitere Informationen finden Sie unter [IAM Rollen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html). Der Befehl ist für Linux und macOS formatiert. Wenn Sie Windows verwenden, ersetzen Sie das Unix-Zeilenfortsetzungszeichen (\\) durch ein Caret (^). ``` aws kendra create-index \ --name {{index name}} \ --description "{{index description}}" \ --role-arn arn:aws:iam::{{account ID}}:role/{{role name}} ``` 1. Es kann einige Zeit dauern, bis der Index erstellt ist. Um den Status Ihres Indexes zu überprüfen, verwenden Sie die Index-ID, die `create-index` mit dem folgenden Befehl zurückgegeben wurde. Wenn der Status des Indexes lautet`ACTIVE`, ist Ihr Index einsatzbereit. ``` aws kendra describe-index \ --index-id {{index ID}} ``` ------ #### [ Python ] **So erstellen Sie einen -Index** + Geben Sie im folgenden Codebeispiel Werte für die folgenden Variablen an: + `description`—Eine Beschreibung des Indexes, den Sie erstellen. Das ist optional. + `index_name`— Der Name des Indexes, den Sie erstellen. + `role_arn`— Der Amazon-Ressourcenname (ARN) einer Rolle, die ausgeführt werden kann Amazon Kendra APIs. Weitere Informationen finden Sie unter [IAM Rollen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html). ``` import boto3 from botocore.exceptions import ClientError import pprint import time kendra = boto3.client("kendra") print("Create an index.") # Provide a name for the index index_name = "index-name" # Provide an optional description for the index description = "index description" # Provide the IAM role ARN required for indexes role_arn = "arn:aws:iam::${account id}:role/${role name}" try: index_response = kendra.create_index( Name = index_name, Description = description, RoleArn = role_arn ) pprint.pprint(index_response) index_id = index_response["Id"] print("Wait for Amazon Kendra to create the index.") while True: # Get the details of the index, such as the status index_description = kendra.describe_index( Id = index_id ) # If status is not CREATING, then quit status = index_description["Status"] print(" Creating index. Status: "+status) if status != "CREATING": break time.sleep(60) except ClientError as e: print("%s" % e) print("Program ends.") ``` ------ #### [ Java ] **So erstellen Sie einen -Index** + Geben Sie im folgenden Codebeispiel Werte für die folgenden Variablen an: + `description`—Eine Beschreibung des Indexes, den Sie erstellen. Das ist optional. + `index_name`— Der Name des Indexes, den Sie erstellen. + `role_arn`— Der Amazon-Ressourcenname (ARN) einer Rolle, die ausgeführt werden kann Amazon Kendra APIs. Weitere Informationen finden Sie unter [IAM Rollen](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html). ``` package com.amazonaws.kendra; import java.util.concurrent.TimeUnit; import software.amazon.awssdk.services.kendra.KendraClient; import software.amazon.awssdk.services.kendra.model.CreateIndexRequest; import software.amazon.awssdk.services.kendra.model.CreateIndexResponse; import software.amazon.awssdk.services.kendra.model.DescribeIndexRequest; import software.amazon.awssdk.services.kendra.model.DescribeIndexResponse; import software.amazon.awssdk.services.kendra.model.IndexStatus; public class CreateIndexExample { public static void main(String[] args) throws InterruptedException { String indexDescription = "Getting started index for Kendra"; String indexName = "java-getting-started-index"; String indexRoleArn = "arn:aws:iam:::role/KendraRoleForGettingStartedIndex"; System.out.println(String.format("Creating an index named %s", indexName)); CreateIndexRequest createIndexRequest = CreateIndexRequest .builder() .description(indexDescription) .name(indexName) .roleArn(indexRoleArn) .build(); KendraClient kendra = KendraClient.builder().build(); CreateIndexResponse createIndexResponse = kendra.createIndex(createIndexRequest); System.out.println(String.format("Index response %s", createIndexResponse)); String indexId = createIndexResponse.id(); System.out.println(String.format("Waiting until the index with ID %s is created.", indexId)); while (true) { DescribeIndexRequest describeIndexRequest = DescribeIndexRequest.builder().id(indexId).build(); DescribeIndexResponse describeIndexResponse = kendra.describeIndex(describeIndexRequest); IndexStatus status = describeIndexResponse.status(); if (status != IndexStatus.CREATING) { break; } TimeUnit.SECONDS.sleep(60); } System.out.println("Index creation is complete."); } } ``` ------ Nachdem Sie Ihren Index erstellt haben, fügen Sie ihm Dokumente hinzu. Sie können sie direkt hinzufügen oder eine Datenquelle erstellen, die Ihren Index regelmäßig aktualisiert. **Topics** + [Direktes Hinzufügen von Dokumenten zu einem Index mit Batch-Upload](in-adding-documents.md) + [Häufig gestellte Fragen (FAQs) zu einem Index hinzufügen](in-creating-faq.md) + [Benutzerdefinierte Dokumentfelder erstellen](custom-attributes.md) + [Steuern des Benutzerzugriffs auf Dokumente mit Tokens](create-index-access-control.md)