Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar. 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. # Amazon Kendra Beispiele mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Amazon Kendra Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-data-source` Das folgende Codebeispiel zeigt, wie Sie`create-data-source`. **AWS CLI** **So erstellen Sie einen Datenquellen-Konnektor für Amazon Kendra** Mit dem folgenden `create-data-source` wird ein Datenquellen-Konnektor für Amazon Kendra erstellt und konfiguriert. Mit `describe-data-source` können Sie den Status eines Datenquellen-Konnektors anzeigen und alle Fehlermeldungen lesen, wenn der Status anzeigt, dass ein Datenquellen-Konnektor nicht vollständig erstellt werden konnte („FAILED“). ``` aws kendra create-data-source \ --name "example data source 1" \ --description "Example data source 1 for example index 1 contains the first set of example documents" \ --tags '{"Key": "test resources", "Value": "kendra"}, {"Key": "test resources", "Value": "aws"}' \ --role-arn "arn:aws:iam::my-account-id:role/KendraRoleForS3TemplateConfigDataSource" \ --index-id exampleindex1 \ --language-code "es" \ --schedule "0 0 18 ? * TUE,MON,WED,THU,FRI,SAT *" \ --configuration '{"TemplateConfiguration": {"Template": file://s3schemaconfig.json}}' \ --type "TEMPLATE" \ --custom-document-enrichment-configuration '{"PostExtractionHookConfiguration": {"LambdaArn": "arn:aws:iam::my-account-id:function/my-function-ocr-docs", "S3Bucket": "s3://amzn-s3-demo-bucket/scanned-image-text-example-docs"}, "RoleArn": "arn:aws:iam:my-account-id:role/KendraRoleForCDE"}' \ --vpc-configuration '{"SecurityGroupIds": ["sg-1234567890abcdef0"], "SubnetIds": ["subnet-1c234","subnet-2b134"]}' ``` Ausgabe: ``` { "Id": "exampledatasource1" } ``` Weitere Informationen finden Sie unter [Erste Schritte mit einem Index und Datenquellen-Konnektor für Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html) im *Entwicklerhandbuch für Amazon Kendra*. + Einzelheiten zur API finden Sie [CreateDataSource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/create-data-source.html)in der *AWS CLI Befehlsreferenz*. ### `create-index` Das folgende Codebeispiel zeigt die Verwendung`create-index`. **AWS CLI** **So erstellen Sie einen Amazon-Kendra-Index** Mit dem folgenden `create-index` wird ein Amazon-Kendra-Index konfiguriert. Mit `describe-index` können Sie den Status eines Indexes anzeigen und alle Fehlermeldungen lesen, wenn der Status anzeigt, dass ein Index nicht vollständig erstellt werden konnte („FAILED“). ``` aws kendra create-index \ --name "example index 1" \ --description "Example index 1 contains the first set of example documents" \ --tags '{"Key": "test resources", "Value": "kendra"}, {"Key": "test resources", "Value": "aws"}' \ --role-arn "arn:aws:iam::my-account-id:role/KendraRoleForExampleIndex" \ --edition "DEVELOPER_EDITION" \ --server-side-encryption-configuration '{"KmsKeyId": "my-kms-key-id"}' \ --user-context-policy "USER_TOKEN" \ --user-token-configurations '{"JsonTokenTypeConfiguration": {"GroupAttributeField": "groupNameField", "UserNameAttributeField": "userNameField"}}' ``` Ausgabe: ``` { "Id": index1 } ``` Weitere Informationen finden Sie unter [Erste Schritte mit einem Index und Datenquellen-Konnektor für Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html) im *Entwicklerhandbuch für Amazon Kendra*. + Einzelheiten zur API finden Sie [CreateIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/create-index.html)in der *AWS CLI Befehlsreferenz*. ### `describe-data-source` Das folgende Codebeispiel zeigt die Verwendung`describe-data-source`. **AWS CLI** **So rufen Sie Informationen über einen Datenquellen-Konnektor für Amazon Kendra ab** Im Folgenden finden Sie `describe-data-source` Informationen zu einem Amazon Kendra Kendra-Datenquellen-Connector. Sie können die Konfiguration eines Datenquellen-Konnektors anzeigen und alle Fehlermeldungen lesen, wenn der Status anzeigt, dass ein Datenquellen-Konnektor nicht vollständig erstellt werden konnte („FAILED“). ``` aws kendra describe-data-source \ --id exampledatasource1 \ --index-id exampleindex1 ``` Ausgabe: ``` { "Configuration": { "TemplateConfiguration": { "Template": { "connectionConfiguration": { "repositoryEndpointMetadata": { "BucketName": "amzn-s3-demo-bucket" } }, "repositoryConfigurations": { "document":{ "fieldMappings": [ { "indexFieldName":"_document_title", "indexFieldType":"STRING", "dataSourceFieldName": "title" }, { "indexFieldName":"_last_updated_at", "indexFieldType":"DATE", "dataSourceFieldName": "modified_date" } ] } }, "additionalProperties": { "inclusionPatterns": [ "*.txt", "*.doc", "*.docx" ], "exclusionPatterns": [ "*.json" ], "inclusionPrefixes": [ "PublicExampleDocsFolder" ], "exclusionPrefixes": [ "PrivateDocsFolder/private" ], "aclConfigurationFilePath": "ExampleDocsFolder/AclConfig.json", "metadataFilesPrefix": "metadata" }, "syncMode": "FULL_CRAWL", "type" : "S3", "version": "1.0.0" } } }, "CreatedAt": 2024-02-25T13:30:10+00:00, "CustomDocumentEnrichmentConfiguration": { "PostExtractionHookConfiguration": { "LambdaArn": "arn:aws:iam::my-account-id:function/my-function-ocr-docs", "S3Bucket": "s3://amzn-s3-demo-bucket/scanned-image-text-example-docs/function" }, "RoleArn": "arn:aws:iam:my-account-id:role/KendraRoleForCDE" } "Description": "Example data source 1 for example index 1 contains the first set of example documents", "Id": exampledatasource1, "IndexId": exampleindex1, "LanguageCode": "en", "Name": "example data source 1", "RoleArn": "arn:aws:iam::my-account-id:role/KendraRoleForS3TemplateConfigDataSource", "Schedule": "0 0 18 ? * TUE,MON,WED,THU,FRI,SAT *", "Status": "ACTIVE", "Type": "TEMPLATE", "UpdatedAt": 1709163615, "VpcConfiguration": { "SecurityGroupIds": ["sg-1234567890abcdef0"], "SubnetIds": ["subnet-1c234","subnet-2b134"] } } ``` Weitere Informationen finden Sie unter [Erste Schritte mit einem Index und Datenquellen-Konnektor für Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html) im *Entwicklerhandbuch für Amazon Kendra*. + Einzelheiten zur API finden Sie [DescribeDataSource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/describe-data-source.html)in der *AWS CLI Befehlsreferenz.* ### `describe-index` Das folgende Codebeispiel zeigt die Verwendung`describe-index`. **AWS CLI** **So rufen Sie Informationen zu einem Amazon-Kendra-Index ab** Mit dem folgenden `describe-index`-Befehl werden Informationen zu einem Amazon-Kendra-Index abgerufen. Sie können die Konfiguration eines Indexes anzeigen und alle Fehlermeldungen lesen, wenn der Status anzeigt, dass ein Index nicht vollständig erstellt werden konnte („FAILED“). ``` aws kendra describe-index \ --id exampleindex1 ``` Ausgabe: ``` { "CapacityUnits": { "QueryCapacityUnits": 0, "StorageCapacityUnits": 0 }, "CreatedAt": 2024-02-25T12:30:10+00:00, "Description": "Example index 1 contains the first set of example documents", "DocumentMetadataConfigurations": [ { "Name": "_document_title", "Relevance": { "Importance": 8 }, "Search": { "Displayable": true, "Facetable": false, "Searchable": true, "Sortable": false }, "Type": "STRING_VALUE" }, { "Name": "_document_body", "Relevance": { "Importance": 5 }, "Search": { "Displayable": true, "Facetable": false, "Searchable": true, "Sortable": false }, "Type": "STRING_VALUE" }, { "Name": "_last_updated_at", "Relevance": { "Importance": 6, "Duration": "2628000s", "Freshness": true }, "Search": { "Displayable": true, "Facetable": false, "Searchable": true, "Sortable": true }, "Type": "DATE_VALUE" }, { "Name": "department_custom_field", "Relevance": { "Importance": 7, "ValueImportanceMap": { "Human Resources" : 4, "Marketing and Sales" : 2, "Research and innvoation" : 3, "Admin" : 1 } }, "Search": { "Displayable": true, "Facetable": true, "Searchable": true, "Sortable": true }, "Type": "STRING_VALUE" } ], "Edition": "DEVELOPER_EDITION", "Id": "index1", "IndexStatistics": { "FaqStatistics": { "IndexedQuestionAnswersCount": 10 }, "TextDocumentStatistics": { "IndexedTextBytes": 1073741824, "IndexedTextDocumentsCount": 1200 } }, "Name": "example index 1", "RoleArn": "arn:aws:iam::my-account-id:role/KendraRoleForExampleIndex", "ServerSideEncryptionConfiguration": { "KmsKeyId": "my-kms-key-id" }, "Status": "ACTIVE", "UpdatedAt": 1709163615, "UserContextPolicy": "USER_TOKEN", "UserTokenConfigurations": [ { "JsonTokenTypeConfiguration": { "GroupAttributeField": "groupNameField", "UserNameAttributeField": "userNameField" } } ] } ``` Weitere Informationen finden Sie unter [Erste Schritte mit einem Index und Datenquellen-Konnektor für Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html) im *Entwicklerhandbuch für Amazon Kendra*. + Einzelheiten zur API finden Sie [DescribeIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/describe-index.html)in der *AWS CLI Befehlsreferenz*. ### `update-data-source` Das folgende Codebeispiel zeigt die Verwendung`update-data-source`. **AWS CLI** **So aktualisieren Sie einen Datenquellen-Konnektor für Amazon Kendra** Mit dem folgenden `update-data-source` wird die Konfiguration eines Datenquellen-Konnektors für Amazon Kendra aktualisiert. Wenn die Aktion erfolgreich ist, sendet der Dienst entweder keine Ausgabe, den HTTP-Statuscode 200 oder den AWS CLI-Rückgabecode 0 zurück. Mit `describe-data-source` können Sie die Konfiguration und den Status eines Datenquellen-Konnektors anzeigen. ``` aws kendra update-data-source \ --id exampledatasource1 \ --index-id exampleindex1 \ --name "new name for example data source 1" \ --description "new description for example data source 1" \ --role-arn arn:aws:iam::my-account-id:role/KendraNewRoleForExampleDataSource \ --configuration '{"TemplateConfiguration": {"Template": file://s3schemanewconfig.json}}' \ --custom-document-enrichment-configuration '{"PostExtractionHookConfiguration": {"LambdaArn": "arn:aws:iam::my-account-id:function/my-function-ocr-docs", "S3Bucket": "s3://amzn-s3-demo-bucket/scanned-image-text-example-docs"}, "RoleArn": "arn:aws:iam:my-account-id:role/KendraNewRoleForCDE"}' \ --language-code "es" \ --schedule "0 0 18 ? * MON,WED,FRI *" \ --vpc-configuration '{"SecurityGroupIds": ["sg-1234567890abcdef0"], "SubnetIds": ["subnet-1c234","subnet-2b134"]}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erste Schritte mit einem Index und Datenquellen-Konnektor für Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html) im *Entwicklerhandbuch für Amazon Kendra*. + Einzelheiten zur API finden Sie [UpdateDataSource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/update-data-source.html)in der *AWS CLI Befehlsreferenz*. ### `update-index` Das folgende Codebeispiel zeigt die Verwendung`update-index`. **AWS CLI** **So aktualisieren Sie einen Amazon-Kendra-Index** Mit dem folgenden `update-index` wird die Konfiguration eines Amazon-Kendra-Index aktualisiert. Wenn die Aktion erfolgreich ist, sendet der Dienst entweder keine Ausgabe, den HTTP-Statuscode 200 oder den AWS CLI-Rückgabecode 0 zurück. Mit `describe-index` können Sie die Konfiguration und den Status eines Indexes anzeigen. ``` aws kendra update-index \ --id enterpriseindex1 \ --name "new name for Enterprise Edition index 1" \ --description "new description for Enterprise Edition index 1" \ --role-arn arn:aws:iam::my-account-id:role/KendraNewRoleForEnterpriseIndex \ --capacity-units '{"QueryCapacityUnits": 2, "StorageCapacityUnits": 1}' \ --document-metadata-configuration-updates '{"Name": "_document_title", "Relevance": {"Importance": 6}}, {"Name": "_last_updated_at", "Relevance": {"Importance": 8}}' \ --user-context-policy "USER_TOKEN" \ --user-token-configurations '{"JsonTokenTypeConfiguration": {"GroupAttributeField": "groupNameField", "UserNameAttributeField": "userNameField"}}' ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [Erste Schritte mit einem Index und Datenquellen-Konnektor für Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html) im *Entwicklerhandbuch für Amazon Kendra*. + Einzelheiten zur API finden Sie [UpdateIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/update-index.html)in der *AWS CLI Befehlsreferenz*.