Einige oder alle Informationen auf dieser Seite gelten möglicherweise nicht für Cloud de Confiance von S3NS. Weitere Informationen finden Sie unter Unterschiede zu Google Cloud.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

CEL-Attribute für Unified Access Policies für IAM

In diesem Dokument werden die CEL-Attribute (Common Expression Language) und -Funktionen beschrieben, die Sie beim Schreiben von bedingten Ausdrücken in IAM Unified Access Policies (UAPs) für Agent Gateway verwenden können.

Weitere Informationen zu UAP-Konzepten finden Sie unter IAM-UAPs. Informationen zum Konfigurieren von UAPs finden Sie unter IAM-UAPs erstellen.

Verfügbare CEL-Attribute

In Ihren UAPs können Sie Bedingungen mit bedingten Ausdrücken definieren. Die Ausdrücke können mehrere untergeordnete Ausdrücke enthalten. Der Zielressourcentyp, den Sie in jeder relationalen Unterbedingung verwenden, bestimmt, welche Attribute Sie verwenden können.

Im folgenden Beispiel ist im Teilausdruck destination.unregistered.path.startsWith('/v1/statements') der Ressourcentyp ein nicht registriertes Ziel, das Attribut ist destination.unregistered.path und startsWith() ist die CEL-Funktion.

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

Die in der folgenden Tabelle beschriebenen Attribute sind für jeden Ressourcentyp verfügbar:

Typ der Zielressource Attribut Details

Agent Registry

destination.is_registered

Werttyp	Boolesch
Unterstützte Werte	`true`, `false`
Unterstützte Vorgänge	`==`, `!=`

destination.agent_registry.resource_type

Werttyp	String
Unterstützte Werte	`'AGENT'`, `'ENDPOINT'`, `'MCP_SERVER'`, `'SKILL'`
Unterstützte Vorgänge	`==`, `!=`, `in`

destination.agent_registry.location

Werttyp	String
Unterstützte Werte	Google Cloud-Standort-ID (z. B. `'global'`, `'us-central1'`)
Unterstützte Vorgänge	`==`, `!=`, `in`

destination.agent_registry.project_id

Werttyp	String
Unterstützte Werte	Google Cloud-Projekt-ID
Unterstützte Vorgänge	`==`, `!=`, `in`

Agent

destination.agent_registry.agent.name

Werttyp	String
Unterstützte Werte	Ressourcenname des KI-Agenten (`projects/PROJECT_ID/locations/LOCATION/agents/AGENT_NAME`)
Unterstützte Vorgänge	`==`, `!=`, `in`

MCP-Server

destination.agent_registry.mcp_server.name

Werttyp	String
Unterstützte Werte	Ressourcenname des MCP-Servers (`projects/PROJECT_ID/locations/LOCATION/mcpServers/MCP_SERVER_NAME`)
Unterstützte Vorgänge	`==`, `!=`, `in`

destination.agent_registry.mcp_server.method

Werttyp	String
Unterstützte Werte	Name der MCP-Methode (z. B. `'tools'`, `'prompts'` oder `'resources'`)
Unterstützte Vorgänge	`==`, `!=`, `in`

destination.agent_registry.mcp_server.tool.name

Werttyp	String
Unterstützte Werte	Toolname (z. B. `'search_code'`, `'execute'`)
Unterstützte Vorgänge	`==`, `!=`, `in`

destination.agent_registry.mcp_server.tool.annotations.read_only_hint

Werttyp	Boolesch
Unterstützte Werte	`true`, `false`
Unterstützte Vorgänge	`==`, `!=`

destination.agent_registry.mcp_server.tool.annotations.destructive_hint

Werttyp	Boolesch
Unterstützte Werte	`true`, `false`
Unterstützte Vorgänge	`==`, `!=`

destination.agent_registry.mcp_server.tool.annotations.idempotent_hint

Werttyp	Boolesch
Unterstützte Werte	`true`, `false`
Unterstützte Vorgänge	`==`, `!=`

destination.agent_registry.mcp_server.tool.annotations.open_world_hint

Werttyp	Boolesch
Unterstützte Werte	`true`, `false`
Unterstützte Vorgänge	`==`, `!=`

destination.agent_registry.mcp_server.prompt.name

Werttyp	String
Unterstützte Werte	Name der Aufforderung
Unterstützte Vorgänge	`==`, `!=`, `in`

destination.agent_registry.mcp_server.resource.name

Werttyp	String
Unterstützte Werte	Ressourcenname
Unterstützte Vorgänge	`==`, `!=`, `in`

Endpunkt

destination.agent_registry.endpoint.name

Werttyp	String
Unterstützte Werte	Ressourcenname des Endpunkts (`projects/PROJECT_ID/locations/LOCATION/endpoints/ENDPOINT_NAME`)
Unterstützte Vorgänge	`==`, `!=`, `in`

Nicht registriertes Ziel

destination.unregistered.host

Werttyp	String
Unterstützte Werte	Hostname (z. B. `'google.com'`, `'example.com'`)
Unterstützte Vorgänge	`==`, `!=`, `in`, `.startsWith()`, `.endsWith()`, `.contains()`

destination.unregistered.path

Werttyp	String
Unterstützte Werte	Anfragepfad (z. B. `'/admin'`, `'/api/v1'`)
Unterstützte Vorgänge	`==`, `!=`, `in`, `.startsWith()`, `.endsWith()`, `.contains()`

destination.unregistered.method

Werttyp	String
Unterstützte Werte	HTTP-Methode (z. B. `'get'`, `'post'`, `'put'`, `'delete'`)
Unterstützte Vorgänge	`==`, `!=`, `in`

Nächste Schritte

Übersicht