Amazon Kendra のアクション、リソース、および条件キー

Amazon Kendra（サービスプレフィックス: kendra）では、IAM アクセス許可ポリシーで使用できるように、以下のサービス固有のリソースやアクション、条件コンテキストキーが用意されています。

参照:

このサービスを設定する方法について説明します。
このサービスで使用可能な API オペレーションのリストを表示します。
IAM アクセス許可ポリシーを使用して、このサービスとそのリソースを保護する方法を学びます。

トピック

Amazon Kendra で定義されるアクション
Amazon Kendra で定義されるリソースタイプ
Amazon Kendra の条件キー

Amazon Kendra で定義されるアクション

IAM ポリシーステートメントの Action エレメントでは、以下のアクションを指定できます。ポリシーを使用して、 AWSでオペレーションを実行するアクセス許可を付与します。ポリシーでアクションを使用する場合は、通常、同じ名前の API オペレーションまたは CLI コマンドへのアクセスを許可または拒否します。ただし、場合によっては、1 つのアクションによって複数のオペレーションへのアクセスが制御されます。あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

Actions テーブルのアクセスレベル列は、アクションの分類方法 (List、Read、Permissions Management、Tagging) を示しています。このように分類することで、ポリシーで使用する際にアクションで付与するアクセスレベルを理解しやすくなります。アクセスレベルの詳細については、ポリシー概要の「アクセスレベル」を参照してください。

[アクション] テーブルの [リソースタイプ] 列は、各アクションがリソースレベルの許可をサポートしているかどうかを示します。この列に値がない場合は、ポリシーステートメントの Resource 要素で、ポリシーが適用されるすべてのリソース (「*」) を指定する必要があります。列にリソースタイプが含まれる場合、そのアクションを含むステートメントでそのタイプの ARN を指定できます。アクションで 1 つ以上のリソースが必須となっている場合、呼び出し元には、それらのリソースを伴うアクションを使用するための許可が付与されている必要があります。必須リソースは、アスタリスク (*) でテーブルに示されています。IAM ポリシーの Resource 要素でリソースアクセスを制限する場合は、必要なリソースタイプごとに ARN またはパターンを含める必要があります。一部のアクションでは、複数のリソースタイプがサポートされています。リソースタイプがオプション (必須として示されていない) の場合、オプションのリソースタイプのいずれかを使用することを選択できます。

[アクション] テーブルの [条件キー] 列には、ポリシーステートメントの Condition 要素で指定できるキーが含まれます。サービスのリソースに関連付けられている条件キーの詳細については、[リソースタイプ] テーブルの [条件キー] 列を参照してください。

Actions テーブルの Dependent actions 列には、アクションを正常に呼び出すために必要な追加のアクセス許可が表示されます。これらのアクセス許可は、アクション自体のアクセス許可に加えて必要になる場合があります。アクションが依存アクションを指定すると、それらの依存関係は、テーブルにリストされている最初のリソースだけでなく、そのアクションに定義された追加のリソースに適用される場合があります。

注記

リソース条件キーは、リソースタイプテーブルに一覧表示されています。アクションに適用されるリソースタイプへのリンクは、[アクション] テーブルの [リソースタイプ (* 必須)] 列にあります。[リソースタイプ] テーブルのリソースタイプには、[アクション] テーブルのアクションに適用されるリソース条件キーである、[条件キー] 列が含まれています。

以下の表の列の詳細については、「アクションテーブル」を参照してください。

アクション	説明	アクセスレベル	リソースタイプ (* 必須)	条件キー
AssociateEntitiesToExperience	インデックスにプリンシパルマッピングを配置する許可を付与	書き込み	experience*
AssociateEntitiesToExperience	インデックスにプリンシパルマッピングを配置する許可を付与	書き込み	index*
AssociatePersonasToEntities	Amazon Kendra エクスペリエンスにアクセスできる AWS SSO ID ソース内のユーザーまたはグループの特定のアクセス許可を定義します。	書き込み	experience*
AssociatePersonasToEntities		書き込み	index*
BatchDeleteDocument	ドキュメントを一括で削除する許可を付与	書き込み	index*
BatchDeleteFeaturedResultsSet	主要な結果セットを削除する許可を付与	書き込み	featured-results-set*
BatchDeleteFeaturedResultsSet	主要な結果セットを削除する許可を付与	書き込み	index*
BatchGetDocumentStatus	ドキュメントのステータスをバッチ取得する許可を付与	読み込み	index*
BatchPutDocument	ドキュメントを一括で配置する許可を付与	書き込み	index*
ClearQuerySuggestions	これまでに生成されたインデックスの候補をクリアする許可を付与	書き込み	index*
CreateAccessControlConfiguration	アクセスコントロール設定を作成する許可を付与	書き込み	index*
CreateDataSource	データソースを作成するアクセス許可を付与	書き込み	index*
CreateDataSource	データソースを作成するアクセス許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
CreateExperience	検索アプリケーションなどの Amazon Kendra エクスペリエンスを作成します	書き込み	index*
CreateFaq	よくある質問を作成する許可を付与	書き込み	index*
CreateFaq	よくある質問を作成する許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
CreateFeaturedResultsSet	主要な結果セットを作成する許可を付与	書き込み	index*
CreateFeaturedResultsSet	主要な結果セットを作成する許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
CreateIndex	インデックスを作成する許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
CreateQuerySuggestionsBlockList	QuerySuggestions ブロックリストを作成する許可を付与	書き込み	index*
CreateQuerySuggestionsBlockList	QuerySuggestions ブロックリストを作成する許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
CreateThesaurus	類語辞典を作成する許可を付与	書き込み	index*
CreateThesaurus	類語辞典を作成する許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
DeleteAccessControlConfiguration	アクセスコントロール設定を削除する許可を付与	書き込み	access-control-configuration*
DeleteAccessControlConfiguration	アクセスコントロール設定を削除する許可を付与	書き込み	index*
DeleteDataSource	データソースを削除するアクセス許可を付与	書き込み	data-source*
DeleteDataSource	データソースを削除するアクセス許可を付与	書き込み	index*
DeleteExperience	検索アプリケーションなどの Amazon Kendra エクスペリエンスを削除します	書き込み	experience*
DeleteExperience	検索アプリケーションなどの Amazon Kendra エクスペリエンスを削除します	書き込み	index*
DeleteFaq	よくある質問を削除する許可を付与	書き込み	faq*
DeleteFaq	よくある質問を削除する許可を付与	書き込み	index*
DeleteIndex	インデックスを削除する許可を付与	書き込み	index*
DeletePrincipalMapping	インデックスからプリンシパルマッピングを削除する許可を付与	書き込み	index*
DeletePrincipalMapping	インデックスからプリンシパルマッピングを削除する許可を付与	書き込み	data-source
DeleteQuerySuggestionsBlockList	QuerySuggestions ブロックリストを削除する許可を付与	書き込み	index*
DeleteQuerySuggestionsBlockList	QuerySuggestions ブロックリストを削除する許可を付与	書き込み	query-suggestions-block-list*
DeleteThesaurus	類語辞典を削除する許可を付与	書き込み	index*
DeleteThesaurus	類語辞典を削除する許可を付与	書き込み	thesaurus*
DescribeAccessControlConfiguration	アクセスコントロール設定を記述する許可を付与	読み取り	access-control-configuration*
DescribeAccessControlConfiguration	アクセスコントロール設定を記述する許可を付与	読み取り	index*
DescribeDataSource	データソースを記述するアクセス許可を付与	読み込み	data-source*
DescribeDataSource	データソースを記述するアクセス許可を付与	読み込み	index*
DescribeExperience	検索アプリケーションなどの Amazon Kendra エクスペリエンスに関する情報を取得します	読み込み	experience*
DescribeExperience	検索アプリケーションなどの Amazon Kendra エクスペリエンスに関する情報を取得します	読み込み	index*
DescribeFaq	よくある質問を記述する許可を付与	読み取り	faq*
DescribeFaq	よくある質問を記述する許可を付与	読み取り	index*
DescribeFeaturedResultsSet	主要な結果セットを記述する許可を付与	読み取り	featured-results-set*
DescribeFeaturedResultsSet	主要な結果セットを記述する許可を付与	読み取り	index*
DescribeIndex	インデックスを記述する許可を付与	読み込み	index*
DescribePrincipalMapping	インデックスからプリンシパルマッピングを記述する許可を付与	読み込み	index*
DescribePrincipalMapping	インデックスからプリンシパルマッピングを記述する許可を付与	読み込み	data-source
DescribeQuerySuggestionsBlockList	QuerySuggestions ブロックリストを記述する許可を付与	読み込み	index*
DescribeQuerySuggestionsBlockList	QuerySuggestions ブロックリストを記述する許可を付与	読み込み	query-suggestions-block-list*
DescribeQuerySuggestionsConfig	インデックスのクエリ候補設定を記述する許可を付与	読み込み	index*
DescribeThesaurus	類語辞典を記述する許可を付与	読み取り	index*
DescribeThesaurus	類語辞典を記述する許可を付与	読み取り	thesaurus*
DisassociateEntitiesFromExperience	SSO ID AWS ソースのユーザーまたはグループが Amazon Kendra エクスペリエンスにアクセスできないようにします	書き込み	experience*
DisassociateEntitiesFromExperience		書き込み	index*
DisassociatePersonasFromEntities	Amazon Kendra エクスペリエンスにアクセスできる AWS SSO ID ソース内のユーザーまたはグループの特定のアクセス許可を削除します。	書き込み	experience*
DisassociatePersonasFromEntities		書き込み	index*
GetQuerySuggestions	クエリプレフィックスの候補を取得する許可を付与	読み込み	index*
GetSnapshots	検索メトリクスデータを取得します	読み取り	index*
ListAccessControlConfigurations	オリジンアクセスコントロール設定を一覧表示する許可を付与	リスト	index*
ListDataSourceSyncJobs	データソース同期ジョブの履歴を取得する許可を付与	リスト	data-source*
ListDataSourceSyncJobs	データソース同期ジョブの履歴を取得する許可を付与	リスト	index*
ListDataSources	データソースを一覧表示する許可を付与	リスト	index*
ListEntityPersonas	Amazon Kendra エクスペリエンスへのアクセス権のあるユーザーおよびグループの特定の許可を一覧表示します	リスト	experience*
ListEntityPersonas	Amazon Kendra エクスペリエンスへのアクセス権のあるユーザーおよびグループの特定の許可を一覧表示します	リスト	index*
ListExperienceEntities	Amazon Kendra エクスペリエンスへのアクセスが許可されている AWS SSO ID ソースのユーザーまたはグループを一覧表示します。	リスト	experience*
ListExperienceEntities		リスト	index*
ListExperiences	1 つ以上の Amazon Kendra エクスペリエンスを一覧表示します。検索アプリケーションなどの Amazon Kendra エクスペリエンスを作成できます	リスト	index*
ListFaqs	よくある質問を一覧表示する許可を付与	リスト	index*
ListFeaturedResultsSets	主要な結果セットを一覧表示する許可を付与	リスト	index*
ListGroupsOlderThanOrderingId	注文 ID よりも古いグループを一覧表示する許可を付与	リスト	index*
ListGroupsOlderThanOrderingId	注文 ID よりも古いグループを一覧表示する許可を付与	リスト	data-source
ListIndices	インデックスを一覧表示する許可を付与	リスト
ListQuerySuggestionsBlockLists	QuerySuggestions ブロックリストを一覧表示する許可を付与	リスト	index*
ListTagsForResource	リソースのタグを一覧表示する許可を付与	読み込み	data-source
			faq
			featured-results-set
			index
			query-suggestions-block-list
			thesaurus
ListThesauri	類語辞典を一覧表示する許可を付与	リスト	index*
PutPrincipalMapping	インデックスにプリンシパルマッピングを配置する許可を付与	書き込み	index*
PutPrincipalMapping	インデックスにプリンシパルマッピングを配置する許可を付与	書き込み	data-source
Query	ドキュメントとよくある質問をクエリする許可を付与	読み取り	index*
Retrieve	インデックスから関連コンテンツを取得するアクセス許可を付与します	読み取り	index*
StartDataSourceSyncJob	データソース同期ジョブを開始する許可を付与	書き込み	data-source*
StartDataSourceSyncJob	データソース同期ジョブを開始する許可を付与	書き込み	index*
StopDataSourceSyncJob	データソース同期ジョブを停止する許可を付与	書き込み	data-source*
StopDataSourceSyncJob	データソース同期ジョブを停止する許可を付与	書き込み	index*
SubmitFeedback	クエリ結果に関するフィードバックを送信する許可を付与	書き込み	index*
TagResource	指定されたキーと値のペアでリソースにタグを付けるアクセス許可を付与	Tagging	data-source
			faq
			featured-results-set
			index
			query-suggestions-block-list
			thesaurus
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	所与のキーを持つタグをリソースから削除する許可を付与	Tagging	data-source
			faq
			featured-results-set
			index
			query-suggestions-block-list
			thesaurus
				aws:TagKeys
UpdateAccessControlConfiguration	アクセスコントロール設定を更新する許可を付与	書き込み	access-control-configuration*
UpdateAccessControlConfiguration	アクセスコントロール設定を更新する許可を付与	書き込み	index*
UpdateDataSource	データソースを更新する権限を付与	書き込み	data-source*
UpdateDataSource	データソースを更新する権限を付与	書き込み	index*
UpdateExperience	検索アプリケーションなどの Amazon Kendra エクスペリエンスを更新します	書き込み	index*
UpdateFeaturedResultsSet	主要な結果セットを更新する許可を付与	書き込み	featured-results-set*
UpdateFeaturedResultsSet	主要な結果セットを更新する許可を付与	書き込み	index*
UpdateIndex	インデックスを更新する許可を付与	書き込み	index*
UpdateQuerySuggestionsBlockList	QuerySuggestions ブロックリストを更新する許可を付与	書き込み	index*
UpdateQuerySuggestionsBlockList	QuerySuggestions ブロックリストを更新する許可を付与	書き込み	query-suggestions-block-list*
UpdateQuerySuggestionsConfig	インデックスのクエリ候補設定を更新する許可を付与	書き込み	index*
UpdateThesaurus	類語辞典を更新する許可を付与	書き込み	index*
UpdateThesaurus	類語辞典を更新する許可を付与	書き込み	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 「グローバル条件コンテキストキー」を参照してください。

条件キー	説明	タイプ
aws:RequestTag/${TagKey}	リクエストで渡されたタグでアクセスをフィルタリングします	文字列
aws:ResourceTag/${TagKey}	リソースに関連付けられたタグでアクセスをフィルタリングします	文字列
aws:TagKeys	リクエストで渡されたタグキーでアクセスをフィルタリングします	ArrayOfString

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

AWS IQ アクセス許可

Amazon Kendra インテリジェントランキング