IAM 統合アクセス ポリシーの CEL 属性

このドキュメントでは、Agent Gateway の IAM 統合アクセス ポリシー（UAP）で条件式を作成するときに使用できる Common Expression Language（CEL）の属性と関数について説明します。

UAP のコンセプトの詳細については、IAM UAP の概要をご覧ください。UAP を構成する方法については、IAM UAP を作成するをご覧ください。

使用可能な CEL 属性

UAP では、条件式を使用して条件を定義できます。式には複数のサブ式を含めることができます。各関係サブ条件で使用する宛先リソースタイプによって、使用できる属性が決まります。

たとえば、次の条件では、サブ式 destination.unregistered.path.startsWith('/v1/statements') で、リソースタイプは登録されていない宛先、属性は destination.unregistered.path、startsWith() は CEL 関数です。

destination.unregistered.host == 'finance.example.com' &&
destination.unregistered.path.startsWith('/v1/statements')

次の表に示す属性は、各リソースタイプで使用できます。

移行先リソースタイプ	属性	詳細
Agent Registry	destination.is_registered	値の型 ブール値 サポートされる値 true、false サポートされているオペレーション ==、!=
	destination.agent_registry.resource_type	値の型 文字列 サポートされる値 'AGENT'、'ENDPOINT'、'MCP_SERVER'、'SKILL' サポートされているオペレーション ==、!=、in
	destination.agent_registry.location	値の型 文字列 サポートされる値 Google Cloud 地域 ID（'global'、'us-central1' など） サポートされているオペレーション ==、!=、in
	destination.agent_registry.project_id	値の型 文字列 サポートされる値 Google Cloud プロジェクト ID サポートされているオペレーション ==、!=、in
エージェント	destination.agent_registry.agent.name	値の型 文字列 サポートされる値 エージェント リソース名 （projects/PROJECT_ID/locations/LOCATION/agents/AGENT_NAME） サポートされているオペレーション ==、!=、in
MCP サーバー	destination.agent_registry.mcp_server.name	値の型 文字列 サポートされる値 MCP サーバー リソース名（projects/PROJECT_ID/locations/LOCATION/mcpServers/MCP_SERVER_NAME） サポートされているオペレーション ==、!=、in
	destination.agent_registry.mcp_server.method	値の型 文字列 サポートされる値 MCP メソッド名（'tools'、'prompts'、'resources' など） サポートされているオペレーション ==、!=、in
	destination.agent_registry.mcp_server.tool.name	値の型 文字列 サポートされる値 ツール名（'search_code'、'execute' など） サポートされているオペレーション ==、!=、in
	destination.agent_registry.mcp_server.tool.annotations.read_only_hint	値の型 ブール値 サポートされる値 true、false サポートされているオペレーション ==、!=
	destination.agent_registry.mcp_server.tool.annotations.destructive_hint	値の型 ブール値 サポートされる値 true、false サポートされているオペレーション ==、!=
	destination.agent_registry.mcp_server.tool.annotations.idempotent_hint	値の型 ブール値 サポートされる値 true、false サポートされているオペレーション ==、!=
	destination.agent_registry.mcp_server.tool.annotations.open_world_hint	値の型 ブール値 サポートされる値 true、false サポートされているオペレーション ==、!=
	destination.agent_registry.mcp_server.prompt.name	値の型 文字列 サポートされる値 プロンプト名 サポートされているオペレーション ==、!=、in
	destination.agent_registry.mcp_server.resource.name	値の型 文字列 サポートされる値 リソース名 サポートされているオペレーション ==、!=、in
エンドポイント	destination.agent_registry.endpoint.name	値の型 文字列 サポートされる値 エンドポイント リソース名（projects/PROJECT_ID/locations/LOCATION/endpoints/ENDPOINT_NAME） サポートされているオペレーション ==、!=、in
Unregistered Destination（登録されていない宛先）	destination.unregistered.host	値の型 文字列 サポートされる値 ホスト名（'google.com'、'example.com' など） サポートされているオペレーション ==、!=、in、.startsWith()、.endsWith()、.contains()
	destination.unregistered.path	値の型 文字列 サポートされる値 リクエストパス（'/admin'、'/api/v1' など） サポートされているオペレーション ==、!=、in、.startsWith()、.endsWith()、.contains()
	destination.unregistered.method	値の型 文字列 サポートされる値 HTTP メソッド（'get'、'post'、'put'、'delete' など） サポートされているオペレーション ==、!=、in

次のステップ

• IAM UAP を作成する
• IAM UAP を管理する
• IAM UAP のトラブルシューティング