本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
Amazon Kendra 的動作、資源和條件索引鍵
Amazon Kendra （服務字首：kendra） 提供下列服務特定的資源、動作和條件內容索引鍵，可用於 IAM 許可政策。
參考資料：
-
了解如何設定此服務。
-
檢視API此服務可用的操作清單 。
-
了解如何使用IAM許可政策來保護此服務及其資源。
Amazon Kendra 定義的動作
您可以在IAM政策陳述式的 Action元素中指定下列動作。使用政策來授予在 AWS中執行操作的許可。當您在政策中使用 動作時，通常會允許或拒絕存取具有相同名稱API的操作或CLI命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作ARN的陳述式中指定該類型的 。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您在IAM政策中使用 Resource元素限制資源存取，則必須為每個所需資源類型包含 ARN或 模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊，請參閱動作資料表。
| 動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
|---|---|---|---|---|---|
| AssociateEntitiesToExperience | 准許在索引中放置委託人映射 | 寫入 | |||
| AssociatePersonasToEntities | 定義身分 AWS SSO來源中使用者或群組的特定許可，並可存取您的 Amazon Kendra 體驗 | 寫入 | |||
| BatchDeleteDocument | 准許批次刪除文件 | 寫入 | |||
| BatchDeleteFeaturedResultsSet | 准許刪除特色結果集 | 寫入 | |||
| BatchGetDocumentStatus | 准許以批次處理的方式取得文件狀態 | 讀取 | |||
| BatchPutDocument | 准許批次放置文件 | 寫入 | |||
| ClearQuerySuggestions | 准許清除指定索引截至目前產生之建議 | 寫入 | |||
| CreateAccessControlConfiguration | 准許建立存取控制組態 | 寫入 | |||
| CreateDataSource | 准許建立資料來源 | 寫入 | |||
| CreateExperience | 建立 Amazon Kendra 體驗，例如搜尋應用程式 | 寫入 | |||
| CreateFaq | 准許建立常見問題 | 寫入 | |||
| CreateFeaturedResultsSet | 准許建立特色結果集 | 寫入 | |||
| CreateIndex | 准許建立索引 | 寫入 | |||
| CreateQuerySuggestionsBlockList | 准許建立 QuerySuggestions BlockList | 寫入 | |||
| CreateThesaurus | 准許建立同義字 | 寫入 | |||
| DeleteAccessControlConfiguration | 准許刪除存取控制組態 | 寫入 | |||
| DeleteDataSource | 准許刪除資料來源 | 寫入 | |||
| DeleteExperience | 刪除您的 Amazon Kendra 體驗，例如搜尋應用程式 | 寫入 | |||
| DeleteFaq | 准許刪除常見問題 | 寫入 | |||
| DeleteIndex | 准許刪除索引 | 寫入 | |||
| DeletePrincipalMapping | 准許從索引刪除委託人映射 | 寫入 | |||
| DeleteQuerySuggestionsBlockList | 准許刪除 QuerySuggestions BlockList | 寫入 | |||
| DeleteThesaurus | 准許刪除同義字 | 寫入 | |||
| DescribeAccessControlConfiguration | 准許描述存取控制組態 | 讀取 | |||
| DescribeDataSource | 准許描述資料來源 | 讀取 | |||
| DescribeExperience | 取得您的 Amazon Kendra 體驗 (例如搜尋應用程式) 的相關資訊 | 讀取 | |||
| DescribeFaq | 准許描述常見問題 | 讀取 | |||
| DescribeFeaturedResultsSet | 准許描述特色結果集 | 讀取 | |||
| DescribeIndex | 准許描述索引 | 讀取 | |||
| DescribePrincipalMapping | 准許描述來自索引的委託人映射 | 讀取 | |||
| DescribeQuerySuggestionsBlockList | 准許描述 QuerySuggestions BlockList | 讀取 | |||
| DescribeQuerySuggestionsConfig | 准許描述索引之查詢建議組態 | 讀取 | |||
| DescribeThesaurus | 准許描述同義字 | 讀取 | |||
| DisassociateEntitiesFromExperience | 防止身分 AWS SSO來源中的使用者或群組存取您的 Amazon Kendra 體驗 | 寫入 | |||
| DisassociatePersonasFromEntities | 移除身分 AWS SSO來源中使用者或群組的特定許可，並可存取您的 Amazon Kendra 體驗 | 寫入 | |||
| GetQuerySuggestions | 准許取得查詢字首建議 | 讀取 | |||
| GetSnapshots | 擷取搜尋指標資料 | 讀取 | |||
| ListAccessControlConfigurations | 准許列出存取控制組態 | 清單 | |||
| ListDataSourceSyncJobs | 准許取得資料來源同步任務歷史記錄 | 列出 | |||
| ListDataSources | 准許列出資料來源 | 清單 | |||
| ListEntityPersonas | 列出可存取您的 Amazon Kendra 體驗的使用者和群組的特定許可 | 清單 | |||
| ListExperienceEntities | 列出您 AWS SSO身分來源中有權存取 Amazon Kendra 體驗的使用者或群組 | 清單 | |||
| ListExperiences | 列出一個或多個 Amazon Kendra 體驗。您可以建立 Amazon Kendra 體驗，例如搜尋應用程式 | 清單 | |||
| ListFaqs | 准許列出常見問答集 | 清單 | |||
| ListFeaturedResultsSets | 准許列出特色結果集 | 清單 | |||
| ListGroupsOlderThanOrderingId | 准許列出比排序 ID 更早的群組 | 列出 | |||
| ListIndices | 准許列出索引 | 清單 | |||
| ListQuerySuggestionsBlockLists | 准許列出 QuerySuggestions BlockLists | 清單 | |||
| ListTagsForResource | 准許列出資源的標籤 | 讀取 | |||
| ListThesauri | 准許列出同義字 | 列出 | |||
| PutPrincipalMapping | 准許在索引中放置委託人映射 | 寫入 | |||
| Query | 准許查詢文件和常見問題 | 讀取 | |||
| Retrieve | 准許從索引擷取相關內容 | 讀取 | |||
| StartDataSourceSyncJob | 准許啟動資料來源同步任務 | 寫入 | |||
| StopDataSourceSyncJob | 准許停止資料來源同步任務 | 寫入 | |||
| SubmitFeedback | 准許傳送查詢結果的意見回饋 | 寫入 | |||
| TagResource | 准許使用指定金鑰值配對來標記資源 | 標記 | |||
| UntagResource | 准許從資源中刪除具有給定索引鍵的標籤 | 標記 | |||
| UpdateAccessControlConfiguration | 准許更新存取控制組態 | 寫入 | |||
| UpdateDataSource | 准許更新資料來源 | 寫入 | |||
| UpdateExperience | 更新您的 Amazon Kendra 體驗，例如搜尋應用程式 | 寫入 | |||
| UpdateFeaturedResultsSet | 准許更新特色結果集 | 寫入 | |||
| UpdateIndex | 准許更新索引 | 寫入 | |||
| UpdateQuerySuggestionsBlockList | 准許更新 QuerySuggestions BlockList | 寫入 | |||
| UpdateQuerySuggestionsConfig | 准許更新索引的查詢建議組態 | 寫入 | |||
| UpdateThesaurus | 准許更新同義字 | 寫入 | |||
Amazon Kendra 定義的資源類型
下列資源類型由此服務定義，可用於IAM許可政策陳述式的 Resource元素。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型資料表。
| 資源類型 | ARN | 條件索引鍵 |
|---|---|---|
| index |
arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}
|
|
| data-source |
arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/data-source/${DataSourceId}
|
|
| faq |
arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/faq/${FaqId}
|
|
| experience |
arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/experience/${ExperienceId}
|
|
| thesaurus |
arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/thesaurus/${ThesaurusId}
|
|
| query-suggestions-block-list |
arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/query-suggestions-block-list/${QuerySuggestionsBlockListId}
|
|
| featured-results-set |
arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/featured-results-set/${FeaturedResultsSetId}
|
|
| access-control-configuration |
arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/access-control-configuration/${AccessControlConfigurationId}
|
Amazon Kendra 的條件索引鍵
Amazon Kendra 定義下列條件索引鍵，可用於IAM政策的 Condition元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。
若要檢視所有服務都可使用的全域條件鍵，請參閱可用全域條件鍵。
| 條件索引鍵 | 描述 | 類型 |
|---|---|---|
| aws:RequestTag/${TagKey} | 依要求中傳遞的標籤來篩選存取權 | 字串 |
| aws:ResourceTag/${TagKey} | 依與資源關聯的標籤來篩選存取權 | 字串 |
| aws:TagKeys | 依要求中傳遞的標籤索引鍵來篩選存取權 | ArrayOfString |
