Amazon Kendra 的動作、資源和條件索引鍵

Amazon Kendra (服務字首：kendra) 提供以下可在 IAM 許可政策中使用的服務特定資源、動作和條件內容金鑰 。

參考資料：

• 了解如何設定此服務。

• 檢視可供此服務使用的 API 操作清單。

• 了解如何使用 IAM 許可政策來保護此服務及其資源。

Amazon Kendra 定義的動作

您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時，通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。

「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取，則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。

「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。

注意

資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。

如需下表各欄的詳細資訊，請參閱動作資料表。

動作	描述	存取層級	資源類型 (*必填項目)	條件索引鍵	相依動作
AssociateEntitiesToExperience	准許在索引中放置委託人映射	寫入	experience*
			index*
AssociatePersonasToEntities	透過存取 Amazon Kendra 體驗，定義 AWS SSO 身分識別來源中使用者或群組的特定許可	寫入	experience*
			index*
BatchDeleteDocument	准許批次刪除文件	寫入	index*
BatchDeleteFeaturedResultsSet	准許刪除特色結果集	寫入	featured-results-set*
			index*
BatchGetDocumentStatus	准許以批次處理的方式取得文件狀態	讀取	index*
BatchPutDocument	准許批次放置文件	寫入	index*
ClearQuerySuggestions	准許清除指定索引截至目前產生之建議	寫入	index*
CreateAccessControlConfiguration	准許建立存取控制組態	寫入	index*
CreateDataSource	准許建立資料來源	寫入	index*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateExperience	建立 Amazon Kendra 體驗，例如搜尋應用程式	寫入	index*
CreateFaq	准許建立常見問題	寫入	index*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateFeaturedResultsSet	准許建立特色結果集	寫入	index*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateIndex	准許建立索引	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateQuerySuggestionsBlockList	授予建立 QuerySuggestions BlockList	寫入	index*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateThesaurus	准許建立同義字	寫入	index*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteAccessControlConfiguration	准許刪除存取控制組態	寫入	access-control-configuration*
			index*
DeleteDataSource	准許刪除資料來源	寫入	data-source*
			index*
DeleteExperience	刪除您的 Amazon Kendra 體驗，例如搜尋應用程式	寫入	experience*
			index*
DeleteFaq	准許刪除常見問題	寫入	faq*
			index*
DeleteIndex	准許刪除索引	寫入	index*
DeletePrincipalMapping	准許從索引刪除委託人映射	寫入	index*
			data-source
DeleteQuerySuggestionsBlockList	授予刪除的權限 QuerySuggestions BlockList	寫入	index*
			query-suggestions-block-list*
DeleteThesaurus	准許刪除同義字	寫入	index*
			thesaurus*
DescribeAccessControlConfiguration	准許描述存取控制組態	讀取	access-control-configuration*
			index*
DescribeDataSource	准許描述資料來源	讀取	data-source*
			index*
DescribeExperience	取得您的 Amazon Kendra 體驗 (例如搜尋應用程式) 的相關資訊	讀取	experience*
			index*
DescribeFaq	准許描述常見問題	讀取	faq*
			index*
DescribeFeaturedResultsSet	准許描述特色結果集	讀取	featured-results-set*
			index*
DescribeIndex	准許描述索引	讀取	index*
DescribePrincipalMapping	准許描述來自索引的委託人映射	讀取	index*
			data-source
DescribeQuerySuggestionsBlockList	授予描述的權限 QuerySuggestions BlockList	讀取	index*
			query-suggestions-block-list*
DescribeQuerySuggestionsConfig	准許描述索引之查詢建議組態	讀取	index*
DescribeThesaurus	准許描述同義字	讀取	index*
			thesaurus*
DisassociateEntitiesFromExperience	防止 AWS SSO 身分識別來源中的使用者或群組存取您的 Amazon Kendra 體驗	寫入	experience*
			index*
DisassociatePersonasFromEntities	透過存取 Amazon Kendra 體驗，移除 AWS SSO 身分識別來源中使用者或群組的特定許可	寫入	experience*
			index*
GetQuerySuggestions	准許取得查詢字首建議	讀取	index*
GetSnapshots	擷取搜尋指標資料	讀取	index*
ListAccessControlConfigurations	准許列出存取控制組態	清單	index*
ListDataSourceSyncJobs	准許取得資料來源同步任務歷史記錄	列出	data-source*
			index*
ListDataSources	准許列出資料來源	清單	index*
ListEntityPersonas	列出可存取您的 Amazon Kendra 體驗的使用者和群組的特定許可	清單	experience*
			index*
ListExperienceEntities	列出 AWS SSO 身分識別來源中被授與 Amazon Kendra 體驗存取權的使用者或群組	清單	experience*
			index*
ListExperiences	列出一個或多個 Amazon Kendra 體驗。您可以建立 Amazon Kendra 體驗，例如搜尋應用程式	清單	index*
ListFaqs	准許列出常見問答集	清單	index*
ListFeaturedResultsSets	准許列出特色結果集	清單	index*
ListGroupsOlderThanOrderingId	准許列出比排序 ID 更早的群組	列出	index*
			data-source
ListIndices	准許列出索引	清單
ListQuerySuggestionsBlockLists	授予列出的權限 QuerySuggestions BlockLists	清單	index*
ListTagsForResource	准許列出資源的標籤	讀取	data-source
			faq
			featured-results-set
			index
			query-suggestions-block-list
			thesaurus
ListThesauri	准許列出同義字	列出	index*
PutPrincipalMapping	准許在索引中放置委託人映射	寫入	index*
			data-source
Query	准許查詢文件和常見問題	讀取	index*
Retrieve	准許從索引擷取相關內容	讀取	index*
StartDataSourceSyncJob	准許啟動資料來源同步任務	寫入	data-source*
			index*
StopDataSourceSyncJob	准許停止資料來源同步任務	寫入	data-source*
			index*
SubmitFeedback	准許傳送查詢結果的意見回饋	寫入	index*
TagResource	准許使用指定金鑰值配對來標記資源	標記	data-source
			faq
			featured-results-set
			index
			query-suggestions-block-list
			thesaurus
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	准許從資源中刪除具有給定索引鍵的標籤	標記	data-source
			faq
			featured-results-set
			index
			query-suggestions-block-list
			thesaurus
				aws:TagKeys
UpdateAccessControlConfiguration	准許更新存取控制組態	寫入	access-control-configuration*
			index*
UpdateDataSource	准許更新資料來源	寫入	data-source*
			index*
UpdateExperience	更新您的 Amazon Kendra 體驗，例如搜尋應用程式	寫入	index*
UpdateFeaturedResultsSet	准許更新特色結果集	寫入	featured-results-set*
			index*
UpdateIndex	准許更新索引	寫入	index*
UpdateQuerySuggestionsBlockList	授予更新的權限 QuerySuggestions BlockList	寫入	index*
			query-suggestions-block-list*
UpdateQuerySuggestionsConfig	准許更新索引的查詢建議組態	寫入	index*
UpdateThesaurus	准許更新同義字	寫入	index*
			thesaurus*

Amazon Kendra 定義的資源類型

此服務會定義下列資源類型，並可用在 IAM 許可政策陳述式的 Resource 元素中。動作資料表中的每個動作都會指明可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型資料表。

資源類型	ARN	條件索引鍵
index	arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}	aws:ResourceTag/${TagKey}
data-source	arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/data-source/${DataSourceId}	aws:ResourceTag/${TagKey}
faq	arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/faq/${FaqId}	aws:ResourceTag/${TagKey}
experience	arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/experience/${ExperienceId}
thesaurus	arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/thesaurus/${ThesaurusId}	aws:ResourceTag/${TagKey}
query-suggestions-block-list	arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/query-suggestions-block-list/${QuerySuggestionsBlockListId}	aws:ResourceTag/${TagKey}
featured-results-set	arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/featured-results-set/${FeaturedResultsSetId}	aws:ResourceTag/${TagKey}
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