Sebagian atau seluruh informasi di halaman ini mungkin tidak berlaku untuk Cloud de Confiance dari S3NS. Lihat Perbedaan dengan Google Cloud untuk mengetahui detail selengkapnya.

Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Atribut CEL untuk Unified Access Policies IAM

Dokumen ini menjelaskan atribut dan fungsi Common Expression Language (CEL) yang dapat Anda gunakan saat menulis ekspresi bersyarat dalam Kebijakan Akses Terpadu (UAP) IAM untuk Agent Gateway.

Untuk mempelajari lebih lanjut konsep UAP, lihat Ringkasan UAP IAM. Untuk mempelajari cara mengonfigurasi UAP, lihat Membuat UAP IAM.

Atribut CEL yang tersedia

Di UAP, Anda dapat menentukan kondisi dengan ekspresi bersyarat. Ekspresi dapat berisi beberapa sub-ekspresi. Jenis resource tujuan yang Anda gunakan di setiap sub-kondisi relasional menentukan atribut yang dapat Anda gunakan.

Misalnya, dalam kondisi berikut, dalam sub-ekspresi destination.unregistered.path.startsWith('/v1/statements'), jenis resource adalah tujuan yang tidak terdaftar, atributnya adalah destination.unregistered.path, dan startsWith() adalah fungsi CEL.

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

Atribut yang dijelaskan dalam tabel berikut tersedia untuk setiap jenis resource:

Jenis resource tujuan Atribut Detail

Agent Registry

destination.is_registered

Jenis nilai	Boolean
Nilai yang didukung	`true`, `false`
Operasi yang didukung	`==`, `!=`

destination.agent_registry.resource_type

Jenis nilai	String
Nilai yang didukung	`'AGENT'`, `'ENDPOINT'`, `'MCP_SERVER'`, `'SKILL'`
Operasi yang didukung	`==`, `!=`, `in`

destination.agent_registry.location

Jenis nilai	String
Nilai yang didukung	ID lokasi Google Cloud (misalnya, `'global'`, `'us-central1'`)
Operasi yang didukung	`==`, `!=`, `in`

destination.agent_registry.project_id

Jenis nilai	String
Nilai yang didukung	Project ID Google Cloud
Operasi yang didukung	`==`, `!=`, `in`

Agen

destination.agent_registry.agent.name

Jenis nilai	String
Nilai yang didukung	Nama resource agen (`projects/PROJECT_ID/locations/LOCATION/agents/AGENT_NAME`)
Operasi yang didukung	`==`, `!=`, `in`

Server MCP

destination.agent_registry.mcp_server.name

Jenis nilai	String
Nilai yang didukung	Nama resource server MCP (`projects/PROJECT_ID/locations/LOCATION/mcpServers/MCP_SERVER_NAME`)
Operasi yang didukung	`==`, `!=`, `in`

destination.agent_registry.mcp_server.method

Jenis nilai	String
Nilai yang didukung	Nama metode MCP (misalnya, `'tools'`, `'prompts'`, `'resources'`)
Operasi yang didukung	`==`, `!=`, `in`

destination.agent_registry.mcp_server.tool.name

Jenis nilai	String
Nilai yang didukung	Nama alat (misalnya, `'search_code'`, `'execute'`)
Operasi yang didukung	`==`, `!=`, `in`

destination.agent_registry.mcp_server.tool.annotations.read_only_hint

Jenis nilai	Boolean
Nilai yang didukung	`true`, `false`
Operasi yang didukung	`==`, `!=`

destination.agent_registry.mcp_server.tool.annotations.destructive_hint

Jenis nilai	Boolean
Nilai yang didukung	`true`, `false`
Operasi yang didukung	`==`, `!=`

destination.agent_registry.mcp_server.tool.annotations.idempotent_hint

Jenis nilai	Boolean
Nilai yang didukung	`true`, `false`
Operasi yang didukung	`==`, `!=`

destination.agent_registry.mcp_server.tool.annotations.open_world_hint

Jenis nilai	Boolean
Nilai yang didukung	`true`, `false`
Operasi yang didukung	`==`, `!=`

destination.agent_registry.mcp_server.prompt.name

Jenis nilai	String
Nilai yang didukung	Nama perintah
Operasi yang didukung	`==`, `!=`, `in`

destination.agent_registry.mcp_server.resource.name

Jenis nilai	String
Nilai yang didukung	Nama resource
Operasi yang didukung	`==`, `!=`, `in`

Endpoint

destination.agent_registry.endpoint.name

Jenis nilai	String
Nilai yang didukung	Nama resource endpoint (`projects/PROJECT_ID/locations/LOCATION/endpoints/ENDPOINT_NAME`)
Operasi yang didukung	`==`, `!=`, `in`

Tujuan Tidak Terdaftar

destination.unregistered.host

Jenis nilai	String
Nilai yang didukung	Nama host (misalnya, `'google.com'`, `'example.com'`)
Operasi yang didukung	`==`, `!=`, `in`, `.startsWith()`, `.endsWith()`, `.contains()`

destination.unregistered.path

Jenis nilai	String
Nilai yang didukung	Jalur permintaan (misalnya, `'/admin'`, `'/api/v1'`)
Operasi yang didukung	`==`, `!=`, `in`, `.startsWith()`, `.endsWith()`, `.contains()`

destination.unregistered.method

Jenis nilai	String
Nilai yang didukung	Metode HTTP (misalnya, `'get'`, `'post'`, `'put'`, `'delete'`)
Operasi yang didukung	`==`, `!=`, `in`

Langkah berikutnya

Ringkasan