published on Wednesday, Nov 18, 2026 by Pulumi
published on Wednesday, Nov 18, 2026 by Pulumi
A Semantic Governance Policy governs an AI agent’s actions and tool execution
using natural language constraints. A policy requires an active
SemanticGovernancePolicyEngine (gcp.vertex.AiSemanticGovernancePolicyEngine)
in the same project and region.
To get more information about SemanticGovernancePolicy, see:
- API documentation
- How-to Guides
Example Usage
Vertex Ai Semantic Governance Policy Basic
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
import * as time from "@pulumiverse/time";
const sgpe = new gcp.vertex.AiSemanticGovernancePolicyEngine("sgpe", {region: "us-central1"});
const agentAiReasoningEngine = new gcp.vertex.AiReasoningEngine("agent", {
displayName: "example-agent",
region: "us-central1",
spec: {
identityType: "AGENT_IDENTITY",
},
});
const waitForIngestion = new time.Sleep("wait_for_ingestion", {createDuration: "120s"}, {
dependsOn: [agentAiReasoningEngine],
});
const agent = gcp.agentregistry.getAgentOutput({
location: "us-central1",
filter: pulumi.interpolate`displayName="${agentAiReasoningEngine.displayName}"`,
});
const policy = new gcp.vertex.AiSemanticGovernancePolicy("policy", {
semanticGovernancePolicyId: "example-policy",
region: "us-central1",
naturalLanguageConstraint: "Do not access internal developer endpoints",
agent: agent.id,
}, {
dependsOn: [sgpe],
});
import pulumi
import pulumi_gcp as gcp
import pulumiverse_time as time
sgpe = gcp.vertex.AiSemanticGovernancePolicyEngine("sgpe", region="us-central1")
agent_ai_reasoning_engine = gcp.vertex.AiReasoningEngine("agent",
display_name="example-agent",
region="us-central1",
spec={
"identity_type": "AGENT_IDENTITY",
})
wait_for_ingestion = time.Sleep("wait_for_ingestion", create_duration="120s",
opts = pulumi.ResourceOptions(depends_on=[agent_ai_reasoning_engine]))
agent = gcp.agentregistry.get_agent_output(location="us-central1",
filter=agent_ai_reasoning_engine.display_name.apply(lambda display_name: f"displayName=\"{display_name}\""))
policy = gcp.vertex.AiSemanticGovernancePolicy("policy",
semantic_governance_policy_id="example-policy",
region="us-central1",
natural_language_constraint="Do not access internal developer endpoints",
agent=agent.id,
opts = pulumi.ResourceOptions(depends_on=[sgpe]))
package main
import (
"fmt"
"github.com/pulumi/pulumi-gcp/sdk/v10/go/gcp/agentregistry"
"github.com/pulumi/pulumi-gcp/sdk/v10/go/gcp/vertex"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/pulumiverse/pulumi-time/sdk/go/time"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
sgpe, err := vertex.NewAiSemanticGovernancePolicyEngine(ctx, "sgpe", &vertex.AiSemanticGovernancePolicyEngineArgs{
Region: pulumi.String("us-central1"),
})
if err != nil {
return err
}
agentAiReasoningEngine, err := vertex.NewAiReasoningEngine(ctx, "agent", &vertex.AiReasoningEngineArgs{
DisplayName: pulumi.String("example-agent"),
Region: pulumi.String("us-central1"),
Spec: &vertex.AiReasoningEngineSpecArgs{
IdentityType: pulumi.String("AGENT_IDENTITY"),
},
})
if err != nil {
return err
}
_, err = time.NewSleep(ctx, "wait_for_ingestion", &time.SleepArgs{
CreateDuration: pulumi.String("120s"),
}, pulumi.DependsOn([]pulumi.Resource{
agentAiReasoningEngine,
}))
if err != nil {
return err
}
agent := agentregistry.GetAgentOutput(ctx, agentregistry.GetAgentOutputArgs{
Location: pulumi.String("us-central1"),
Filter: agentAiReasoningEngine.DisplayName.ApplyT(func(displayName string) (string, error) {
return fmt.Sprintf("displayName=\"%v\"", displayName), nil
}).(pulumi.StringOutput),
}, nil)
_, err = vertex.NewAiSemanticGovernancePolicy(ctx, "policy", &vertex.AiSemanticGovernancePolicyArgs{
SemanticGovernancePolicyId: pulumi.String("example-policy"),
Region: pulumi.String("us-central1"),
NaturalLanguageConstraint: pulumi.String("Do not access internal developer endpoints"),
Agent: agent.Id(),
}, pulumi.DependsOn([]pulumi.Resource{
sgpe,
}))
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
using Time = Pulumiverse.Time;
return await Deployment.RunAsync(() =>
{
var sgpe = new Gcp.Vertex.AiSemanticGovernancePolicyEngine("sgpe", new()
{
Region = "us-central1",
});
var agentAiReasoningEngine = new Gcp.Vertex.AiReasoningEngine("agent", new()
{
DisplayName = "example-agent",
Region = "us-central1",
Spec = new Gcp.Vertex.Inputs.AiReasoningEngineSpecArgs
{
IdentityType = "AGENT_IDENTITY",
},
});
var waitForIngestion = new Time.Sleep("wait_for_ingestion", new()
{
CreateDuration = "120s",
}, new CustomResourceOptions
{
DependsOn =
{
agentAiReasoningEngine,
},
});
var agent = Gcp.AgentRegistry.GetAgent.Invoke(new()
{
Location = "us-central1",
Filter = $"displayName=\"{agentAiReasoningEngine.DisplayName}\"",
});
var policy = new Gcp.Vertex.AiSemanticGovernancePolicy("policy", new()
{
SemanticGovernancePolicyId = "example-policy",
Region = "us-central1",
NaturalLanguageConstraint = "Do not access internal developer endpoints",
Agent = agent.Apply(getAgentResult => getAgentResult.Id),
}, new CustomResourceOptions
{
DependsOn =
{
sgpe,
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.vertex.AiSemanticGovernancePolicyEngine;
import com.pulumi.gcp.vertex.AiSemanticGovernancePolicyEngineArgs;
import com.pulumi.gcp.vertex.AiReasoningEngine;
import com.pulumi.gcp.vertex.AiReasoningEngineArgs;
import com.pulumi.gcp.vertex.inputs.AiReasoningEngineSpecArgs;
import com.pulumiverse.time.Sleep;
import com.pulumiverse.time.SleepArgs;
import com.pulumi.gcp.agentregistry.AgentregistryFunctions;
import com.pulumi.gcp.agentregistry.inputs.GetAgentArgs;
import com.pulumi.gcp.vertex.AiSemanticGovernancePolicy;
import com.pulumi.gcp.vertex.AiSemanticGovernancePolicyArgs;
import com.pulumi.resources.CustomResourceOptions;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var sgpe = new AiSemanticGovernancePolicyEngine("sgpe", AiSemanticGovernancePolicyEngineArgs.builder()
.region("us-central1")
.build());
var agentAiReasoningEngine = new AiReasoningEngine("agentAiReasoningEngine", AiReasoningEngineArgs.builder()
.displayName("example-agent")
.region("us-central1")
.spec(AiReasoningEngineSpecArgs.builder()
.identityType("AGENT_IDENTITY")
.build())
.build());
var waitForIngestion = new Sleep("waitForIngestion", SleepArgs.builder()
.createDuration("120s")
.build(), CustomResourceOptions.builder()
.dependsOn(agentAiReasoningEngine)
.build());
final var agent = AgentregistryFunctions.getAgent(GetAgentArgs.builder()
.location("us-central1")
.filter(agentAiReasoningEngine.displayName().applyValue(_displayName -> String.format("displayName=\"%s\"", _displayName)))
.build());
var policy = new AiSemanticGovernancePolicy("policy", AiSemanticGovernancePolicyArgs.builder()
.semanticGovernancePolicyId("example-policy")
.region("us-central1")
.naturalLanguageConstraint("Do not access internal developer endpoints")
.agent(agent.applyValue(_agent -> _agent.id()))
.build(), CustomResourceOptions.builder()
.dependsOn(sgpe)
.build());
}
}
resources:
sgpe:
type: gcp:vertex:AiSemanticGovernancePolicyEngine
properties:
region: us-central1
agentAiReasoningEngine:
type: gcp:vertex:AiReasoningEngine
name: agent
properties:
displayName: example-agent
region: us-central1
spec:
identityType: AGENT_IDENTITY
waitForIngestion:
type: time:Sleep
name: wait_for_ingestion
properties:
createDuration: 120s
options:
dependsOn:
- ${agentAiReasoningEngine}
policy:
type: gcp:vertex:AiSemanticGovernancePolicy
properties:
semanticGovernancePolicyId: example-policy
region: us-central1
naturalLanguageConstraint: Do not access internal developer endpoints
agent: ${agent.id}
options:
dependsOn:
- ${sgpe}
variables:
agent:
fn::invoke:
function: gcp:agentregistry:getAgent
arguments:
location: us-central1
filter: displayName="${agentAiReasoningEngine.displayName}"
terraform {
required_providers {
gcp = {
source = "pulumi/gcp"
}
time = {
source = "pulumi/time"
}
}
}
data "gcp_agentregistry_agent" "agent" {
location = "us-central1"
filter ="displayName="${gcp_vertex_ai_reasoning_engine.agent.display_name}""
}
resource "gcp_vertex_ai_semantic_governance_policy_engine" "sgpe" {
lifecycle {
create_before_destroy = true
}
region = "us-central1"
}
resource "gcp_vertex_ai_reasoning_engine" "agent" {
lifecycle {
create_before_destroy = true
}
display_name = "example-agent"
region = "us-central1"
spec = {
identity_type = "AGENT_IDENTITY"
}
}
resource "time_sleep" "wait_for_ingestion" {
depends_on = [gcp_vertex_ai_reasoning_engine.agent]
lifecycle {
create_before_destroy = true
}
create_duration = "120s"
}
resource "gcp_vertex_ai_semantic_governance_policy" "policy" {
depends_on = [gcp_vertex_ai_semantic_governance_policy_engine.sgpe]
lifecycle {
create_before_destroy = true
}
semantic_governance_policy_id = "example-policy"
region = "us-central1"
natural_language_constraint = "Do not access internal developer endpoints"
agent = data.gcp_agentregistry_agent.agent.id
}
Create AiSemanticGovernancePolicy Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new AiSemanticGovernancePolicy(name: string, args: AiSemanticGovernancePolicyArgs, opts?: CustomResourceOptions);@overload
def AiSemanticGovernancePolicy(resource_name: str,
args: AiSemanticGovernancePolicyArgs,
opts: Optional[ResourceOptions] = None)
@overload
def AiSemanticGovernancePolicy(resource_name: str,
opts: Optional[ResourceOptions] = None,
agent: Optional[str] = None,
natural_language_constraint: Optional[str] = None,
semantic_governance_policy_id: Optional[str] = None,
agent_response_customization: Optional[AiSemanticGovernancePolicyAgentResponseCustomizationArgs] = None,
deletion_policy: Optional[str] = None,
description: Optional[str] = None,
display_name: Optional[str] = None,
mcp_tools: Optional[AiSemanticGovernancePolicyMcpToolsArgs] = None,
project: Optional[str] = None,
region: Optional[str] = None)func NewAiSemanticGovernancePolicy(ctx *Context, name string, args AiSemanticGovernancePolicyArgs, opts ...ResourceOption) (*AiSemanticGovernancePolicy, error)public AiSemanticGovernancePolicy(string name, AiSemanticGovernancePolicyArgs args, CustomResourceOptions? opts = null)
public AiSemanticGovernancePolicy(String name, AiSemanticGovernancePolicyArgs args)
public AiSemanticGovernancePolicy(String name, AiSemanticGovernancePolicyArgs args, CustomResourceOptions options)
type: gcp:vertex:AiSemanticGovernancePolicy
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "gcp_vertex_ai_semantic_governance_policy" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args AiSemanticGovernancePolicyArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args AiSemanticGovernancePolicyArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args AiSemanticGovernancePolicyArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args AiSemanticGovernancePolicyArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args AiSemanticGovernancePolicyArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var aiSemanticGovernancePolicyResource = new Gcp.Vertex.AiSemanticGovernancePolicy("aiSemanticGovernancePolicyResource", new()
{
Agent = "string",
NaturalLanguageConstraint = "string",
SemanticGovernancePolicyId = "string",
AgentResponseCustomization = new Gcp.Vertex.Inputs.AiSemanticGovernancePolicyAgentResponseCustomizationArgs
{
DenialMessage = "string",
},
DeletionPolicy = "string",
Description = "string",
DisplayName = "string",
McpTools = new Gcp.Vertex.Inputs.AiSemanticGovernancePolicyMcpToolsArgs
{
McpServer = "string",
Tools = new[]
{
"string",
},
},
Project = "string",
Region = "string",
});
example, err := vertex.NewAiSemanticGovernancePolicy(ctx, "aiSemanticGovernancePolicyResource", &vertex.AiSemanticGovernancePolicyArgs{
Agent: pulumi.String("string"),
NaturalLanguageConstraint: pulumi.String("string"),
SemanticGovernancePolicyId: pulumi.String("string"),
AgentResponseCustomization: &vertex.AiSemanticGovernancePolicyAgentResponseCustomizationArgs{
DenialMessage: pulumi.String("string"),
},
DeletionPolicy: pulumi.String("string"),
Description: pulumi.String("string"),
DisplayName: pulumi.String("string"),
McpTools: &vertex.AiSemanticGovernancePolicyMcpToolsArgs{
McpServer: pulumi.String("string"),
Tools: pulumi.StringArray{
pulumi.String("string"),
},
},
Project: pulumi.String("string"),
Region: pulumi.String("string"),
})
resource "gcp_vertex_ai_semantic_governance_policy" "aiSemanticGovernancePolicyResource" {
lifecycle {
create_before_destroy = true
}
agent = "string"
natural_language_constraint = "string"
semantic_governance_policy_id = "string"
agent_response_customization = {
denial_message = "string"
}
deletion_policy = "string"
description = "string"
display_name = "string"
mcp_tools = {
mcp_server = "string"
tools = ["string"]
}
project = "string"
region = "string"
}
var aiSemanticGovernancePolicyResource = new AiSemanticGovernancePolicy("aiSemanticGovernancePolicyResource", AiSemanticGovernancePolicyArgs.builder()
.agent("string")
.naturalLanguageConstraint("string")
.semanticGovernancePolicyId("string")
.agentResponseCustomization(AiSemanticGovernancePolicyAgentResponseCustomizationArgs.builder()
.denialMessage("string")
.build())
.deletionPolicy("string")
.description("string")
.displayName("string")
.mcpTools(AiSemanticGovernancePolicyMcpToolsArgs.builder()
.mcpServer("string")
.tools("string")
.build())
.project("string")
.region("string")
.build());
ai_semantic_governance_policy_resource = gcp.vertex.AiSemanticGovernancePolicy("aiSemanticGovernancePolicyResource",
agent="string",
natural_language_constraint="string",
semantic_governance_policy_id="string",
agent_response_customization={
"denial_message": "string",
},
deletion_policy="string",
description="string",
display_name="string",
mcp_tools={
"mcp_server": "string",
"tools": ["string"],
},
project="string",
region="string")
const aiSemanticGovernancePolicyResource = new gcp.vertex.AiSemanticGovernancePolicy("aiSemanticGovernancePolicyResource", {
agent: "string",
naturalLanguageConstraint: "string",
semanticGovernancePolicyId: "string",
agentResponseCustomization: {
denialMessage: "string",
},
deletionPolicy: "string",
description: "string",
displayName: "string",
mcpTools: {
mcpServer: "string",
tools: ["string"],
},
project: "string",
region: "string",
});
type: gcp:vertex:AiSemanticGovernancePolicy
properties:
agent: string
agentResponseCustomization:
denialMessage: string
deletionPolicy: string
description: string
displayName: string
mcpTools:
mcpServer: string
tools:
- string
naturalLanguageConstraint: string
project: string
region: string
semanticGovernancePolicyId: string
AiSemanticGovernancePolicy Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The AiSemanticGovernancePolicy resource accepts the following input properties:
- Agent string
- The name of the agent in Agent Registry that is affected by this policy.
- Natural
Language stringConstraint - The natural language constraint of the SemanticGovernancePolicy.
- Semantic
Governance stringPolicy Id - The ID of the SemanticGovernancePolicy, which will become the final component of the resource name. This value may be up to 63 characters, and valid characters are [a-z0-9-]. The first character cannot be a number or hyphen. The last character must be a letter or a number.
- Agent
Response AiCustomization Semantic Governance Policy Agent Response Customization - Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
- Deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- Description string
- The description of the SemanticGovernancePolicy.
- Display
Name string - The user-defined name of the SemanticGovernancePolicy.
- Mcp
Tools AiSemantic Governance Policy Mcp Tools - The McpTools that are affected by this policy. Structure is documented below.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
- The region of the SemanticGovernancePolicy, e.g. 'us-central1'.
- Agent string
- The name of the agent in Agent Registry that is affected by this policy.
- Natural
Language stringConstraint - The natural language constraint of the SemanticGovernancePolicy.
- Semantic
Governance stringPolicy Id - The ID of the SemanticGovernancePolicy, which will become the final component of the resource name. This value may be up to 63 characters, and valid characters are [a-z0-9-]. The first character cannot be a number or hyphen. The last character must be a letter or a number.
- Agent
Response AiCustomization Semantic Governance Policy Agent Response Customization Args - Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
- Deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- Description string
- The description of the SemanticGovernancePolicy.
- Display
Name string - The user-defined name of the SemanticGovernancePolicy.
- Mcp
Tools AiSemantic Governance Policy Mcp Tools Args - The McpTools that are affected by this policy. Structure is documented below.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
- The region of the SemanticGovernancePolicy, e.g. 'us-central1'.
- agent string
- The name of the agent in Agent Registry that is affected by this policy.
- natural_
language_ stringconstraint - The natural language constraint of the SemanticGovernancePolicy.
- semantic_
governance_ stringpolicy_ id - The ID of the SemanticGovernancePolicy, which will become the final component of the resource name. This value may be up to 63 characters, and valid characters are [a-z0-9-]. The first character cannot be a number or hyphen. The last character must be a letter or a number.
- agent_
response_ objectcustomization - Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
- deletion_
policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- description string
- The description of the SemanticGovernancePolicy.
- display_
name string - The user-defined name of the SemanticGovernancePolicy.
- mcp_
tools object - The McpTools that are affected by this policy. Structure is documented below.
- project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region string
- The region of the SemanticGovernancePolicy, e.g. 'us-central1'.
- agent String
- The name of the agent in Agent Registry that is affected by this policy.
- natural
Language StringConstraint - The natural language constraint of the SemanticGovernancePolicy.
- semantic
Governance StringPolicy Id - The ID of the SemanticGovernancePolicy, which will become the final component of the resource name. This value may be up to 63 characters, and valid characters are [a-z0-9-]. The first character cannot be a number or hyphen. The last character must be a letter or a number.
- agent
Response AiCustomization Semantic Governance Policy Agent Response Customization - Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
- deletion
Policy String - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- description String
- The description of the SemanticGovernancePolicy.
- display
Name String - The user-defined name of the SemanticGovernancePolicy.
- mcp
Tools AiSemantic Governance Policy Mcp Tools - The McpTools that are affected by this policy. Structure is documented below.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region String
- The region of the SemanticGovernancePolicy, e.g. 'us-central1'.
- agent string
- The name of the agent in Agent Registry that is affected by this policy.
- natural
Language stringConstraint - The natural language constraint of the SemanticGovernancePolicy.
- semantic
Governance stringPolicy Id - The ID of the SemanticGovernancePolicy, which will become the final component of the resource name. This value may be up to 63 characters, and valid characters are [a-z0-9-]. The first character cannot be a number or hyphen. The last character must be a letter or a number.
- agent
Response AiCustomization Semantic Governance Policy Agent Response Customization - Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
- deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- description string
- The description of the SemanticGovernancePolicy.
- display
Name string - The user-defined name of the SemanticGovernancePolicy.
- mcp
Tools AiSemantic Governance Policy Mcp Tools - The McpTools that are affected by this policy. Structure is documented below.
- project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region string
- The region of the SemanticGovernancePolicy, e.g. 'us-central1'.
- agent str
- The name of the agent in Agent Registry that is affected by this policy.
- natural_
language_ strconstraint - The natural language constraint of the SemanticGovernancePolicy.
- semantic_
governance_ strpolicy_ id - The ID of the SemanticGovernancePolicy, which will become the final component of the resource name. This value may be up to 63 characters, and valid characters are [a-z0-9-]. The first character cannot be a number or hyphen. The last character must be a letter or a number.
- agent_
response_ Aicustomization Semantic Governance Policy Agent Response Customization Args - Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
- deletion_
policy str - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- description str
- The description of the SemanticGovernancePolicy.
- display_
name str - The user-defined name of the SemanticGovernancePolicy.
- mcp_
tools AiSemantic Governance Policy Mcp Tools Args - The McpTools that are affected by this policy. Structure is documented below.
- project str
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region str
- The region of the SemanticGovernancePolicy, e.g. 'us-central1'.
- agent String
- The name of the agent in Agent Registry that is affected by this policy.
- natural
Language StringConstraint - The natural language constraint of the SemanticGovernancePolicy.
- semantic
Governance StringPolicy Id - The ID of the SemanticGovernancePolicy, which will become the final component of the resource name. This value may be up to 63 characters, and valid characters are [a-z0-9-]. The first character cannot be a number or hyphen. The last character must be a letter or a number.
- agent
Response Property MapCustomization - Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
- deletion
Policy String - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- description String
- The description of the SemanticGovernancePolicy.
- display
Name String - The user-defined name of the SemanticGovernancePolicy.
- mcp
Tools Property Map - The McpTools that are affected by this policy. Structure is documented below.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region String
- The region of the SemanticGovernancePolicy, e.g. 'us-central1'.
Outputs
All input properties are implicitly available as output properties. Additionally, the AiSemanticGovernancePolicy resource produces the following output properties:
- Agent
Identity string - Represents the principal of the agent, used by the Policy Decision Point (PDP) for governance checks.
For more information, see https://docs.cloud.google.com/agent-builder/agent-engine/agent-identity.
Format:
principal://TRUST_DOMAIN/NAMESPACE/AGENT_NAME - Create
Time string - The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
- Etag string
- Used to perform consistent read-modify-write transactions.
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- The resource name of the SemanticGovernancePolicy, in the form 'projects/{project}/locations/{location}/semanticGovernancePolicies/{semantic_governance_policy}'.
- Update
Time string - The time the SemanticGovernancePolicy was last updated, in RFC3339 UTC "Zulu" format.
- Agent
Identity string - Represents the principal of the agent, used by the Policy Decision Point (PDP) for governance checks.
For more information, see https://docs.cloud.google.com/agent-builder/agent-engine/agent-identity.
Format:
principal://TRUST_DOMAIN/NAMESPACE/AGENT_NAME - Create
Time string - The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
- Etag string
- Used to perform consistent read-modify-write transactions.
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- The resource name of the SemanticGovernancePolicy, in the form 'projects/{project}/locations/{location}/semanticGovernancePolicies/{semantic_governance_policy}'.
- Update
Time string - The time the SemanticGovernancePolicy was last updated, in RFC3339 UTC "Zulu" format.
- agent_
identity string - Represents the principal of the agent, used by the Policy Decision Point (PDP) for governance checks.
For more information, see https://docs.cloud.google.com/agent-builder/agent-engine/agent-identity.
Format:
principal://TRUST_DOMAIN/NAMESPACE/AGENT_NAME - create_
time string - The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
- etag string
- Used to perform consistent read-modify-write transactions.
- id string
- The provider-assigned unique ID for this managed resource.
- name string
- The resource name of the SemanticGovernancePolicy, in the form 'projects/{project}/locations/{location}/semanticGovernancePolicies/{semantic_governance_policy}'.
- update_
time string - The time the SemanticGovernancePolicy was last updated, in RFC3339 UTC "Zulu" format.
- agent
Identity String - Represents the principal of the agent, used by the Policy Decision Point (PDP) for governance checks.
For more information, see https://docs.cloud.google.com/agent-builder/agent-engine/agent-identity.
Format:
principal://TRUST_DOMAIN/NAMESPACE/AGENT_NAME - create
Time String - The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
- etag String
- Used to perform consistent read-modify-write transactions.
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- The resource name of the SemanticGovernancePolicy, in the form 'projects/{project}/locations/{location}/semanticGovernancePolicies/{semantic_governance_policy}'.
- update
Time String - The time the SemanticGovernancePolicy was last updated, in RFC3339 UTC "Zulu" format.
- agent
Identity string - Represents the principal of the agent, used by the Policy Decision Point (PDP) for governance checks.
For more information, see https://docs.cloud.google.com/agent-builder/agent-engine/agent-identity.
Format:
principal://TRUST_DOMAIN/NAMESPACE/AGENT_NAME - create
Time string - The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
- etag string
- Used to perform consistent read-modify-write transactions.
- id string
- The provider-assigned unique ID for this managed resource.
- name string
- The resource name of the SemanticGovernancePolicy, in the form 'projects/{project}/locations/{location}/semanticGovernancePolicies/{semantic_governance_policy}'.
- update
Time string - The time the SemanticGovernancePolicy was last updated, in RFC3339 UTC "Zulu" format.
- agent_
identity str - Represents the principal of the agent, used by the Policy Decision Point (PDP) for governance checks.
For more information, see https://docs.cloud.google.com/agent-builder/agent-engine/agent-identity.
Format:
principal://TRUST_DOMAIN/NAMESPACE/AGENT_NAME - create_
time str - The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
- etag str
- Used to perform consistent read-modify-write transactions.
- id str
- The provider-assigned unique ID for this managed resource.
- name str
- The resource name of the SemanticGovernancePolicy, in the form 'projects/{project}/locations/{location}/semanticGovernancePolicies/{semantic_governance_policy}'.
- update_
time str - The time the SemanticGovernancePolicy was last updated, in RFC3339 UTC "Zulu" format.
- agent
Identity String - Represents the principal of the agent, used by the Policy Decision Point (PDP) for governance checks.
For more information, see https://docs.cloud.google.com/agent-builder/agent-engine/agent-identity.
Format:
principal://TRUST_DOMAIN/NAMESPACE/AGENT_NAME - create
Time String - The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
- etag String
- Used to perform consistent read-modify-write transactions.
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- The resource name of the SemanticGovernancePolicy, in the form 'projects/{project}/locations/{location}/semanticGovernancePolicies/{semantic_governance_policy}'.
- update
Time String - The time the SemanticGovernancePolicy was last updated, in RFC3339 UTC "Zulu" format.
Look up Existing AiSemanticGovernancePolicy Resource
Get an existing AiSemanticGovernancePolicy resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: AiSemanticGovernancePolicyState, opts?: CustomResourceOptions): AiSemanticGovernancePolicy@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
agent: Optional[str] = None,
agent_identity: Optional[str] = None,
agent_response_customization: Optional[AiSemanticGovernancePolicyAgentResponseCustomizationArgs] = None,
create_time: Optional[str] = None,
deletion_policy: Optional[str] = None,
description: Optional[str] = None,
display_name: Optional[str] = None,
etag: Optional[str] = None,
mcp_tools: Optional[AiSemanticGovernancePolicyMcpToolsArgs] = None,
name: Optional[str] = None,
natural_language_constraint: Optional[str] = None,
project: Optional[str] = None,
region: Optional[str] = None,
semantic_governance_policy_id: Optional[str] = None,
update_time: Optional[str] = None) -> AiSemanticGovernancePolicyfunc GetAiSemanticGovernancePolicy(ctx *Context, name string, id IDInput, state *AiSemanticGovernancePolicyState, opts ...ResourceOption) (*AiSemanticGovernancePolicy, error)public static AiSemanticGovernancePolicy Get(string name, Input<string> id, AiSemanticGovernancePolicyState? state, CustomResourceOptions? opts = null)public static AiSemanticGovernancePolicy get(String name, Output<String> id, AiSemanticGovernancePolicyState state, CustomResourceOptions options)resources: existingAiSemanticGovernancePolicy: type: gcp:vertex:AiSemanticGovernancePolicy get: id: ${id}import {
to = gcp_vertex_ai_semantic_governance_policy.example
id = "${id}"
}
- name string
- The unique name of the resulting resource.
- id Input<ID>
- The unique provider ID of the resource to look up.
- state AiSemanticGovernancePolicyState
- Known property values the provider needs, along with the ID, to find the resource. Usually not required.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resulting resource.
- id str
- The unique provider ID of the resource to look up.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resulting resource.
- id IDInput
- The unique provider ID of the resource to look up.
- state AiSemanticGovernancePolicyState
- Known property values the provider needs, along with the ID, to find the resource. Usually not required.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resulting resource.
- id Input<string>
- The unique provider ID of the resource to look up.
- state AiSemanticGovernancePolicyState
- Known property values the provider needs, along with the ID, to find the resource. Usually not required.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resulting resource.
- id Output<String>
- The unique provider ID of the resource to look up.
- state AiSemanticGovernancePolicyState
- Known property values the provider needs, along with the ID, to find the resource. Usually not required.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
- Agent string
- The name of the agent in Agent Registry that is affected by this policy.
- Agent
Identity string - Represents the principal of the agent, used by the Policy Decision Point (PDP) for governance checks.
For more information, see https://docs.cloud.google.com/agent-builder/agent-engine/agent-identity.
Format:
principal://TRUST_DOMAIN/NAMESPACE/AGENT_NAME - Agent
Response AiCustomization Semantic Governance Policy Agent Response Customization - Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
- Create
Time string - The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
- Deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- Description string
- The description of the SemanticGovernancePolicy.
- Display
Name string - The user-defined name of the SemanticGovernancePolicy.
- Etag string
- Used to perform consistent read-modify-write transactions.
- Mcp
Tools AiSemantic Governance Policy Mcp Tools - The McpTools that are affected by this policy. Structure is documented below.
- Name string
- The resource name of the SemanticGovernancePolicy, in the form 'projects/{project}/locations/{location}/semanticGovernancePolicies/{semantic_governance_policy}'.
- Natural
Language stringConstraint - The natural language constraint of the SemanticGovernancePolicy.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
- The region of the SemanticGovernancePolicy, e.g. 'us-central1'.
- Semantic
Governance stringPolicy Id - The ID of the SemanticGovernancePolicy, which will become the final component of the resource name. This value may be up to 63 characters, and valid characters are [a-z0-9-]. The first character cannot be a number or hyphen. The last character must be a letter or a number.
- Update
Time string - The time the SemanticGovernancePolicy was last updated, in RFC3339 UTC "Zulu" format.
- Agent string
- The name of the agent in Agent Registry that is affected by this policy.
- Agent
Identity string - Represents the principal of the agent, used by the Policy Decision Point (PDP) for governance checks.
For more information, see https://docs.cloud.google.com/agent-builder/agent-engine/agent-identity.
Format:
principal://TRUST_DOMAIN/NAMESPACE/AGENT_NAME - Agent
Response AiCustomization Semantic Governance Policy Agent Response Customization Args - Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
- Create
Time string - The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
- Deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- Description string
- The description of the SemanticGovernancePolicy.
- Display
Name string - The user-defined name of the SemanticGovernancePolicy.
- Etag string
- Used to perform consistent read-modify-write transactions.
- Mcp
Tools AiSemantic Governance Policy Mcp Tools Args - The McpTools that are affected by this policy. Structure is documented below.
- Name string
- The resource name of the SemanticGovernancePolicy, in the form 'projects/{project}/locations/{location}/semanticGovernancePolicies/{semantic_governance_policy}'.
- Natural
Language stringConstraint - The natural language constraint of the SemanticGovernancePolicy.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Region string
- The region of the SemanticGovernancePolicy, e.g. 'us-central1'.
- Semantic
Governance stringPolicy Id - The ID of the SemanticGovernancePolicy, which will become the final component of the resource name. This value may be up to 63 characters, and valid characters are [a-z0-9-]. The first character cannot be a number or hyphen. The last character must be a letter or a number.
- Update
Time string - The time the SemanticGovernancePolicy was last updated, in RFC3339 UTC "Zulu" format.
- agent string
- The name of the agent in Agent Registry that is affected by this policy.
- agent_
identity string - Represents the principal of the agent, used by the Policy Decision Point (PDP) for governance checks.
For more information, see https://docs.cloud.google.com/agent-builder/agent-engine/agent-identity.
Format:
principal://TRUST_DOMAIN/NAMESPACE/AGENT_NAME - agent_
response_ objectcustomization - Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
- create_
time string - The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
- deletion_
policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- description string
- The description of the SemanticGovernancePolicy.
- display_
name string - The user-defined name of the SemanticGovernancePolicy.
- etag string
- Used to perform consistent read-modify-write transactions.
- mcp_
tools object - The McpTools that are affected by this policy. Structure is documented below.
- name string
- The resource name of the SemanticGovernancePolicy, in the form 'projects/{project}/locations/{location}/semanticGovernancePolicies/{semantic_governance_policy}'.
- natural_
language_ stringconstraint - The natural language constraint of the SemanticGovernancePolicy.
- project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region string
- The region of the SemanticGovernancePolicy, e.g. 'us-central1'.
- semantic_
governance_ stringpolicy_ id - The ID of the SemanticGovernancePolicy, which will become the final component of the resource name. This value may be up to 63 characters, and valid characters are [a-z0-9-]. The first character cannot be a number or hyphen. The last character must be a letter or a number.
- update_
time string - The time the SemanticGovernancePolicy was last updated, in RFC3339 UTC "Zulu" format.
- agent String
- The name of the agent in Agent Registry that is affected by this policy.
- agent
Identity String - Represents the principal of the agent, used by the Policy Decision Point (PDP) for governance checks.
For more information, see https://docs.cloud.google.com/agent-builder/agent-engine/agent-identity.
Format:
principal://TRUST_DOMAIN/NAMESPACE/AGENT_NAME - agent
Response AiCustomization Semantic Governance Policy Agent Response Customization - Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
- create
Time String - The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
- deletion
Policy String - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- description String
- The description of the SemanticGovernancePolicy.
- display
Name String - The user-defined name of the SemanticGovernancePolicy.
- etag String
- Used to perform consistent read-modify-write transactions.
- mcp
Tools AiSemantic Governance Policy Mcp Tools - The McpTools that are affected by this policy. Structure is documented below.
- name String
- The resource name of the SemanticGovernancePolicy, in the form 'projects/{project}/locations/{location}/semanticGovernancePolicies/{semantic_governance_policy}'.
- natural
Language StringConstraint - The natural language constraint of the SemanticGovernancePolicy.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region String
- The region of the SemanticGovernancePolicy, e.g. 'us-central1'.
- semantic
Governance StringPolicy Id - The ID of the SemanticGovernancePolicy, which will become the final component of the resource name. This value may be up to 63 characters, and valid characters are [a-z0-9-]. The first character cannot be a number or hyphen. The last character must be a letter or a number.
- update
Time String - The time the SemanticGovernancePolicy was last updated, in RFC3339 UTC "Zulu" format.
- agent string
- The name of the agent in Agent Registry that is affected by this policy.
- agent
Identity string - Represents the principal of the agent, used by the Policy Decision Point (PDP) for governance checks.
For more information, see https://docs.cloud.google.com/agent-builder/agent-engine/agent-identity.
Format:
principal://TRUST_DOMAIN/NAMESPACE/AGENT_NAME - agent
Response AiCustomization Semantic Governance Policy Agent Response Customization - Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
- create
Time string - The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
- deletion
Policy string - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- description string
- The description of the SemanticGovernancePolicy.
- display
Name string - The user-defined name of the SemanticGovernancePolicy.
- etag string
- Used to perform consistent read-modify-write transactions.
- mcp
Tools AiSemantic Governance Policy Mcp Tools - The McpTools that are affected by this policy. Structure is documented below.
- name string
- The resource name of the SemanticGovernancePolicy, in the form 'projects/{project}/locations/{location}/semanticGovernancePolicies/{semantic_governance_policy}'.
- natural
Language stringConstraint - The natural language constraint of the SemanticGovernancePolicy.
- project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region string
- The region of the SemanticGovernancePolicy, e.g. 'us-central1'.
- semantic
Governance stringPolicy Id - The ID of the SemanticGovernancePolicy, which will become the final component of the resource name. This value may be up to 63 characters, and valid characters are [a-z0-9-]. The first character cannot be a number or hyphen. The last character must be a letter or a number.
- update
Time string - The time the SemanticGovernancePolicy was last updated, in RFC3339 UTC "Zulu" format.
- agent str
- The name of the agent in Agent Registry that is affected by this policy.
- agent_
identity str - Represents the principal of the agent, used by the Policy Decision Point (PDP) for governance checks.
For more information, see https://docs.cloud.google.com/agent-builder/agent-engine/agent-identity.
Format:
principal://TRUST_DOMAIN/NAMESPACE/AGENT_NAME - agent_
response_ Aicustomization Semantic Governance Policy Agent Response Customization Args - Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
- create_
time str - The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
- deletion_
policy str - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- description str
- The description of the SemanticGovernancePolicy.
- display_
name str - The user-defined name of the SemanticGovernancePolicy.
- etag str
- Used to perform consistent read-modify-write transactions.
- mcp_
tools AiSemantic Governance Policy Mcp Tools Args - The McpTools that are affected by this policy. Structure is documented below.
- name str
- The resource name of the SemanticGovernancePolicy, in the form 'projects/{project}/locations/{location}/semanticGovernancePolicies/{semantic_governance_policy}'.
- natural_
language_ strconstraint - The natural language constraint of the SemanticGovernancePolicy.
- project str
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region str
- The region of the SemanticGovernancePolicy, e.g. 'us-central1'.
- semantic_
governance_ strpolicy_ id - The ID of the SemanticGovernancePolicy, which will become the final component of the resource name. This value may be up to 63 characters, and valid characters are [a-z0-9-]. The first character cannot be a number or hyphen. The last character must be a letter or a number.
- update_
time str - The time the SemanticGovernancePolicy was last updated, in RFC3339 UTC "Zulu" format.
- agent String
- The name of the agent in Agent Registry that is affected by this policy.
- agent
Identity String - Represents the principal of the agent, used by the Policy Decision Point (PDP) for governance checks.
For more information, see https://docs.cloud.google.com/agent-builder/agent-engine/agent-identity.
Format:
principal://TRUST_DOMAIN/NAMESPACE/AGENT_NAME - agent
Response Property MapCustomization - Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
- create
Time String - The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
- deletion
Policy String - Whether Terraform will be prevented from destroying the resource. Defaults to DELETE. When a 'terraform destroy' or 'pulumi up' would delete the resource, the command will fail if this field is set to "PREVENT" in Terraform state. When set to "ABANDON", the command will remove the resource from Terraform management without updating or deleting the resource in the API. When set to "DELETE", deleting the resource is allowed.
- description String
- The description of the SemanticGovernancePolicy.
- display
Name String - The user-defined name of the SemanticGovernancePolicy.
- etag String
- Used to perform consistent read-modify-write transactions.
- mcp
Tools Property Map - The McpTools that are affected by this policy. Structure is documented below.
- name String
- The resource name of the SemanticGovernancePolicy, in the form 'projects/{project}/locations/{location}/semanticGovernancePolicies/{semantic_governance_policy}'.
- natural
Language StringConstraint - The natural language constraint of the SemanticGovernancePolicy.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- region String
- The region of the SemanticGovernancePolicy, e.g. 'us-central1'.
- semantic
Governance StringPolicy Id - The ID of the SemanticGovernancePolicy, which will become the final component of the resource name. This value may be up to 63 characters, and valid characters are [a-z0-9-]. The first character cannot be a number or hyphen. The last character must be a letter or a number.
- update
Time String - The time the SemanticGovernancePolicy was last updated, in RFC3339 UTC "Zulu" format.
Supporting Types
AiSemanticGovernancePolicyAgentResponseCustomization, AiSemanticGovernancePolicyAgentResponseCustomizationArgs
- Denial
Message string - Custom message shown to the end user when the policy check results in a denial. Use this to explain the rationale to the user. Max 1000 characters.
- Denial
Message string - Custom message shown to the end user when the policy check results in a denial. Use this to explain the rationale to the user. Max 1000 characters.
- denial_
message string - Custom message shown to the end user when the policy check results in a denial. Use this to explain the rationale to the user. Max 1000 characters.
- denial
Message String - Custom message shown to the end user when the policy check results in a denial. Use this to explain the rationale to the user. Max 1000 characters.
- denial
Message string - Custom message shown to the end user when the policy check results in a denial. Use this to explain the rationale to the user. Max 1000 characters.
- denial_
message str - Custom message shown to the end user when the policy check results in a denial. Use this to explain the rationale to the user. Max 1000 characters.
- denial
Message String - Custom message shown to the end user when the policy check results in a denial. Use this to explain the rationale to the user. Max 1000 characters.
AiSemanticGovernancePolicyMcpTools, AiSemanticGovernancePolicyMcpToolsArgs
- Mcp
Server string - The resource name of the McpServer in Agent Registry that is affected by this policy.
Format:
projects/{project}/locations/{location}/mcpServers/{mcpServer} - Tools List<string>
- The resource names of the McpTools used by the Agent that is affected by this policy. At least one tool must be listed.
- Mcp
Server string - The resource name of the McpServer in Agent Registry that is affected by this policy.
Format:
projects/{project}/locations/{location}/mcpServers/{mcpServer} - Tools []string
- The resource names of the McpTools used by the Agent that is affected by this policy. At least one tool must be listed.
- mcp_
server string - The resource name of the McpServer in Agent Registry that is affected by this policy.
Format:
projects/{project}/locations/{location}/mcpServers/{mcpServer} - tools list(string)
- The resource names of the McpTools used by the Agent that is affected by this policy. At least one tool must be listed.
- mcp
Server String - The resource name of the McpServer in Agent Registry that is affected by this policy.
Format:
projects/{project}/locations/{location}/mcpServers/{mcpServer} - tools List<String>
- The resource names of the McpTools used by the Agent that is affected by this policy. At least one tool must be listed.
- mcp
Server string - The resource name of the McpServer in Agent Registry that is affected by this policy.
Format:
projects/{project}/locations/{location}/mcpServers/{mcpServer} - tools string[]
- The resource names of the McpTools used by the Agent that is affected by this policy. At least one tool must be listed.
- mcp_
server str - The resource name of the McpServer in Agent Registry that is affected by this policy.
Format:
projects/{project}/locations/{location}/mcpServers/{mcpServer} - tools Sequence[str]
- The resource names of the McpTools used by the Agent that is affected by this policy. At least one tool must be listed.
- mcp
Server String - The resource name of the McpServer in Agent Registry that is affected by this policy.
Format:
projects/{project}/locations/{location}/mcpServers/{mcpServer} - tools List<String>
- The resource names of the McpTools used by the Agent that is affected by this policy. At least one tool must be listed.
Import
SemanticGovernancePolicy can be imported using any of these accepted formats:
projects/{{project}}/locations/{{region}}/semanticGovernancePolicies/{{semantic_governance_policy_id}}{{project}}/{{region}}/{{semantic_governance_policy_id}}{{region}}/{{semantic_governance_policy_id}}{{semantic_governance_policy_id}}
When using the pulumi import command, SemanticGovernancePolicy can be imported using one of the formats above. For example:
$ pulumi import gcp:vertex/aiSemanticGovernancePolicy:AiSemanticGovernancePolicy default projects/{{project}}/locations/{{region}}/semanticGovernancePolicies/{{semantic_governance_policy_id}}
$ pulumi import gcp:vertex/aiSemanticGovernancePolicy:AiSemanticGovernancePolicy default {{project}}/{{region}}/{{semantic_governance_policy_id}}
$ pulumi import gcp:vertex/aiSemanticGovernancePolicy:AiSemanticGovernancePolicy default {{region}}/{{semantic_governance_policy_id}}
$ pulumi import gcp:vertex/aiSemanticGovernancePolicy:AiSemanticGovernancePolicy default {{semantic_governance_policy_id}}
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Google Cloud (GCP) pulumi/pulumi-gcp
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
google-betaTerraform Provider.
published on Wednesday, Nov 18, 2026 by Pulumi