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

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

リファレンス:

• このサービスを設定する方法について説明します。

• このサービスで使用可能な API オペレーションのリストを表示します。

• IAM アクセス許可ポリシーを使用して、このサービスとそのリソースを保護する方法を学びます。

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

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

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

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

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

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

注記

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

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

アクション	説明	アクセスレベル	リソースタイプ (* 必須)	条件キー	依存アクション
AllowVendedLogDeliveryForResource [アクセス許可のみ]	リソースに提供されたテレメトリを設定するアクセス許可を付与します	権限の管理	memory*
ConnectBrowserAutomationStream	ブラウザ自動化ストリームに接続するアクセス許可を付与します	読み取り
ConnectBrowserLiveViewStream	ブラウザライブビューストリームに接続するアクセス許可を付与します	読み取り
CreateAgentRuntime	新しいエージェントランタイムを作成するアクセス許可を付与します	書き込み			iam:PassRole
CreateAgentRuntimeEndpoint	新しいエージェントランタイムエンドポイントを作成するアクセス許可を付与します	書き込み
CreateApiKeyCredentialProvider	新しい API キー認証情報プロバイダーを作成するアクセス許可を付与します	書き込み	apikeycredentialprovider*
			token-vault*
CreateBrowser	新しいカスタムブラウザを作成するアクセス許可を付与します	書き込み
CreateCodeInterpreter	新しいカスタムコードインタプリタを作成するアクセス許可を付与します	書き込み
CreateEvent	イベントを作成するアクセス許可を付与します	書き込み	memory*
				bedrock-agentcore:sessionId bedrock-agentcore:actorId
CreateGateway	新しいゲートウェイを作成するアクセス許可を付与します	書き込み			iam:PassRole
CreateGatewayTarget	既存のゲートウェイに新しいターゲットを作成するアクセス許可を付与します	書き込み	gateway*
CreateMemory	メモリリソースを作成するアクセス許可を付与します	書き込み			iam:PassRole
CreateOauth2CredentialProvider	OAuth2 プロトコルを使用して外部リソースにアクセスするための新しい認証情報プロバイダーを作成するアクセス許可を付与します	書き込み	oauth2credentialprovider*
			token-vault*
CreateWorkloadIdentity	新しいワークロード ID を作成するアクセス許可を付与します	書き込み	workload-identity*
			workload-identity-directory*
DeleteAgentRuntime	エージェントランタイムを削除するアクセス許可を付与します	書き込み	runtime*
DeleteAgentRuntimeEndpoint	エージェントランタイムエンドポイントを削除するアクセス許可を付与します	書き込み	runtime*
			runtime-endpoint*
DeleteApiKeyCredentialProvider	登録された API キー認証情報プロバイダーを削除するアクセス許可を付与します	書き込み	apikeycredentialprovider*
			token-vault*
DeleteBrowser	カスタムブラウザを削除するアクセス許可を付与します	書き込み	browser-custom*
DeleteCodeInterpreter	カスタムコードインタプリタを削除するアクセス許可を付与します	書き込み	code-interpreter-custom*
DeleteEvent	イベントを削除するアクセス許可を付与します	書き込み	memory*
				bedrock-agentcore:sessionId bedrock-agentcore:actorId
DeleteGateway	既存のゲートウェイを削除するアクセス許可を付与します	書き込み	gateway*
DeleteGatewayTarget	既存のゲートウェイターゲットを削除するアクセス許可を付与します	書き込み	gateway*
DeleteMemory	メモリリソースを削除するアクセス許可を付与します	書き込み	memory*
DeleteMemoryRecord	メモリレコードを削除するアクセス許可を付与します	書き込み	memory*
DeleteOauth2CredentialProvider	登録された OAuth2 認証情報プロバイダーを削除するアクセス許可を付与します	書き込み	oauth2credentialprovider*
			token-vault*
DeleteWorkloadIdentity	登録されたワークロード ID を削除するアクセス許可を付与します	書き込み	workload-identity*
			workload-identity-directory*
GetAgentRuntime	エージェントランタイムの詳細を取得するアクセス許可を付与します	読み取り	runtime*
GetAgentRuntimeEndpoint	エージェントランタイムエンドポイントの詳細を取得するアクセス許可を付与します	読み取り	runtime*
			runtime-endpoint*
GetApiKeyCredentialProvider	登録された API キー認証情報プロバイダーを名前で取得するアクセス許可を付与します	読み取り	apikeycredentialprovider*
			token-vault*
GetBrowser	ブラウザの詳細を取得するアクセス許可を付与します	読み取り	browser-custom*
GetBrowserSession	ブラウザセッションの詳細を取得するアクセス許可を付与します	読み取り	browser*
			browser-custom*
GetCodeInterpreter	コードインタープリタの詳細を取得するアクセス許可を付与します	読み取り	code-interpreter-custom*
GetCodeInterpreterSession	コードインタープリタセッションの詳細を取得するアクセス許可を付与します	読み取り	code-interpreter*
			code-interpreter-custom*
GetEvent	イベントを取得するアクセス許可を付与します	読み取り	memory*
				bedrock-agentcore:sessionId bedrock-agentcore:actorId
GetGateway	既存のゲートウェイを取得するアクセス許可を付与します	読み取り	gateway*
GetGatewayTarget	既存のゲートウェイターゲットを取得するアクセス許可を付与します	読み取り	gateway*
GetMemory	メモリリソースの詳細を取得するアクセス許可を付与します	読み取り	memory*
GetMemoryRecord	メモリレコードを取得するアクセス許可を付与します	読み取り	memory*
GetOauth2CredentialProvider	登録された OAuth2 認証情報プロバイダーを名前で取得するアクセス許可を付与します	読み取り	oauth2credentialprovider*
			token-vault*
GetResourceApiKey	Api キー認証情報プロバイダーに関連付けられた API キーを取得する許可を付与	読み取り	apikeycredentialprovider*
			token-vault*
			workload-identity*
			workload-identity-directory*
GetResourceOauth2Token	OAuth2 2LO または 3LO フローでアクセストークンを取得して外部リソースにアクセスする許可を付与	読み取り	oauth2credentialprovider*
			token-vault*
			workload-identity*
			workload-identity-directory*
GetTokenVault	暗号化設定など、TokenVault の現在の設定を取得する許可を付与	読み取り	token-vault*
GetWorkloadAccessToken	ユーザーに代わって動作しないエージェントワークロードのワークロードアクセストークンを取得する許可を付与	書き込み	workload-identity*
			workload-identity-directory*
GetWorkloadAccessTokenForJWT	JWT トークンを持つユーザーに代わって動作するエージェントワークロードのワークロードアクセストークンを取得する許可を付与	書き込み	workload-identity*
			workload-identity-directory*
GetWorkloadAccessTokenForUserId	ユーザー ID を持つユーザーに代わって動作するエージェントワークロードのワークロードアクセストークンを取得する許可を付与	書き込み	workload-identity*
			workload-identity-directory*
GetWorkloadIdentity	名前や許可された OAuth2 リターン URLs	読み取り	workload-identity*
			workload-identity-directory*
InvokeAgentRuntime	エージェントランタイムエンドポイントを呼び出すアクセス許可を付与します	書き込み	runtime*
			runtime-endpoint*
InvokeCodeInterpreter	コードインタープリタセッションを呼び出すアクセス許可を付与します	書き込み	code-interpreter*
			code-interpreter-custom*
ListActors	アクターを一覧表示するアクセス許可を付与します	リスト	memory*
ListAgentRuntimeEndpoints	エージェントランタイムエンドポイントを一覧表示するアクセス許可を付与します	リスト
ListAgentRuntimeVersions	エージェントランタイムバージョンを一覧表示するアクセス許可を付与します	リスト
ListAgentRuntimes	エージェントランタイムを一覧表示する許可を付与	リスト
ListApiKeyCredentialProviders	トークンボールト内のすべての API キー認証情報プロバイダーを一覧表示するアクセス許可を付与します	読み取り	apikeycredentialprovider*
			token-vault*
ListBrowserSessions	ブラウザセッションを一覧表示するアクセス許可を付与します	リスト
ListBrowsers	ブラウザを一覧表示するアクセス許可を付与します	リスト
ListCodeInterpreterSessions	コードインタープリタセッションを一覧表示するアクセス許可を付与します	リスト	code-interpreter*
			code-interpreter-custom*
ListCodeInterpreters	コードインタプリタを一覧表示するアクセス許可を付与します	リスト
ListEvents	イベントを一覧表示するアクセス許可を付与します	リスト	memory*
				bedrock-agentcore:sessionId bedrock-agentcore:actorId
ListGatewayTargets	既存のゲートウェイターゲットを一覧表示するアクセス許可を付与します	リスト	gateway*
ListGateways	既存のゲートウェイを一覧表示するアクセス許可を付与します	リスト
ListMemories	メモリリソースを一覧表示するアクセス許可を付与します	リスト
ListMemoryRecords	メモリレコードを一覧表示するアクセス許可を付与します	リスト	memory*
				bedrock-agentcore:namespace bedrock-agentcore:strategyId
ListOauth2CredentialProviders	トークンボールト内のすべての OAuth2 認証情報プロバイダーを一覧表示するアクセス許可を付与します	読み取り	oauth2credentialprovider*
			token-vault*
ListSessions	セッションを一覧表示するアクセス許可を付与します	リスト	memory*
				bedrock-agentcore:actorId
ListWorkloadIdentities	発信者のすべてのワークロード ID を一覧表示するアクセス許可を付与します AWS アカウント	読み取り	workload-identity*
			workload-identity-directory*
RetrieveMemoryRecords	セマティッククエリを使用してメモリレコードを取得するアクセス許可を付与します	リスト	memory*
				bedrock-agentcore:namespace bedrock-agentcore:strategyId
SetTokenVaultCMK	カスタマーマネージドキー (CMK) またはサービスマネージドキーを特定の TokenVault に関連付けるアクセス許可を付与します	読み取り	token-vault*
StartBrowserSession	新しいブラウザセッションを開始するアクセス許可を付与します	書き込み	browser*
			browser-custom*
StartCodeInterpreterSession	新しいコードインタプリタセッションを開始するアクセス許可を付与します	書き込み	code-interpreter*
			code-interpreter-custom*
StopBrowserSession	ブラウザセッションを停止するアクセス許可を付与します	書き込み	browser*
			browser-custom*
StopCodeInterpreterSession	コードインタープリタセッションを停止するアクセス許可を付与します	書き込み	code-interpreter*
			code-interpreter-custom*
SynchronizeGatewayTargets [アクセス許可のみ]	ゲートウェイで検索を有効にするアクセス許可を付与します	権限の管理	gateway*
UpdateAgentRuntime	エージェントランタイムを更新するアクセス許可を付与します	書き込み	runtime*		iam:PassRole
UpdateAgentRuntimeEndpoint	エージェントランタイムエンドポイントを更新するアクセス許可を付与します	書き込み	runtime*
			runtime-endpoint*
UpdateApiKeyCredentialProvider	既存の API キー認証情報プロバイダーを更新する許可を付与	書き込み	apikeycredentialprovider*
			token-vault*
UpdateBrowserStream	ブラウザセッションストリームのステータスを更新するアクセス許可を付与します	書き込み	browser*
			browser-custom*
UpdateGateway	既存のゲートウェイを更新するアクセス許可を付与します	書き込み	gateway*		iam:PassRole
UpdateGatewayTarget	既存のゲートウェイターゲットを更新するアクセス許可を付与します	書き込み	gateway*
UpdateMemory	メモリリソースを更新するアクセス許可を付与します	書き込み	memory*		iam:PassRole
UpdateOauth2CredentialProvider	既存の OAuth2 認証情報プロバイダーを更新する許可を付与	書き込み	oauth2credentialprovider*
			token-vault*
UpdateWorkloadIdentity	既存のワークロード ID のメタデータを更新する許可を付与	書き込み	workload-identity*
			workload-identity-directory*

Amazon Bedrock Agentcore で定義されるリソースタイプ

以下のリソースタイプは、このサービスによって定義され、IAM アクセス許可ポリシーステートメントの Resource エレメントで使用できます。アクションテーブルの各アクションは、そのアクションで指定できるリソースタイプを示しています。リソースタイプは、ポリシーに含めることができる条件キーを定義することもできます。これらのキーは、[リソースタイプ] テーブルの最後の列に表示されます。以下の表の列の詳細については、「リソースタイプテーブル」を参照してください。

リソースタイプ	ARN	条件キー
memory	arn:${Partition}:bedrock-agentcore:${Region}:${Account}:memory/${MemoryId}
gateway	arn:${Partition}:bedrock-agentcore:${Region}:${Account}:gateway/${GatewayId}
workload-identity	arn:${Partition}:bedrock-agentcore:${Region}:${Account}:workload-identity-directory/${DirectoryId}/workload-identity/${WorkloadIdentityName}
oauth2credentialprovider	arn:${Partition}:bedrock-agentcore:${Region}:${Account}:token-vault/${TokenVaultId}/oauth2credentialprovider/${Name}
apikeycredentialprovider	arn:${Partition}:bedrock-agentcore:${Region}:${Account}:token-vault/${TokenVaultId}/apikeycredentialprovider/${Name}
runtime	arn:${Partition}:bedrock-agentcore:${Region}:${Account}:runtime/${RuntimeId}
runtime-endpoint	arn:${Partition}:bedrock-agentcore:${Region}:${Account}:runtime/${RuntimeId}/runtime-endpoint/${Name}
code-interpreter-custom	arn:${Partition}:bedrock-agentcore:${Region}:${Account}:code-interpreter-custom/${CodeInterpreterId}
code-interpreter	arn:${Partition}:bedrock-agentcore:${Region}:aws:code-interpreter/${CodeInterpreterId}
browser-custom	arn:${Partition}:bedrock-agentcore:${Region}:${Account}:browser-custom/${BrowserId}
browser	arn:${Partition}:bedrock-agentcore:${Region}:aws:browser/${BrowserId}
workload-identity-directory	arn:${Partition}:bedrock-agentcore:${Region}:${Account}:workload-identity-directory/${DirectoryId}
token-vault	arn:${Partition}:bedrock-agentcore:${Region}:${Account}:token-vault/${TokenVaultId}

Amazon Bedrock Agentcore の条件キー

Amazon Bedrock エージェントコアは、IAM ポリシーの Condition要素で使用できる以下の条件キーを定義します。これらのキーを使用して、ポリシーステートメントが適用される条件をさらに絞り込むことができます。以下の表の列の詳細については、「条件キーテーブル」を参照してください。

すべてのサービスで使用できるグローバル条件キーを表示するには、AWS 「グローバル条件コンテキストキー」を参照してください。

条件キー	説明	[Type] (タイプ)
bedrock-agentcore:actorId	アクター ID でアクセスをフィルタリングします	文字列
bedrock-agentcore:namespace	名前空間でアクセスをフィルタリングします	文字列
bedrock-agentcore:sessionId	セッション ID でアクセスをフィルタリングします	文字列
bedrock-agentcore:strategyId	メモリ戦略 ID でアクセスをフィルタリングします	文字列