1. Registry
  2. Packages
  3. Google Cloud (GCP)
  4. API Docs
  5. vertex
  6. AiSemanticGovernancePolicy
Viewing docs for Google Cloud v10.5.0
published on Wednesday, Nov 18, 2026 by Pulumi
gcp logo
Viewing docs for Google Cloud v10.5.0
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:

    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.
    NaturalLanguageConstraint string
    The natural language constraint of the SemanticGovernancePolicy.
    SemanticGovernancePolicyId string
    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.
    AgentResponseCustomization AiSemanticGovernancePolicyAgentResponseCustomization
    Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
    DeletionPolicy 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.
    DisplayName string
    The user-defined name of the SemanticGovernancePolicy.
    McpTools AiSemanticGovernancePolicyMcpTools
    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.
    NaturalLanguageConstraint string
    The natural language constraint of the SemanticGovernancePolicy.
    SemanticGovernancePolicyId string
    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.
    AgentResponseCustomization AiSemanticGovernancePolicyAgentResponseCustomizationArgs
    Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
    DeletionPolicy 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.
    DisplayName string
    The user-defined name of the SemanticGovernancePolicy.
    McpTools AiSemanticGovernancePolicyMcpToolsArgs
    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_constraint string
    The natural language constraint of the SemanticGovernancePolicy.
    semantic_governance_policy_id string
    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_customization object
    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.
    naturalLanguageConstraint String
    The natural language constraint of the SemanticGovernancePolicy.
    semanticGovernancePolicyId String
    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.
    agentResponseCustomization AiSemanticGovernancePolicyAgentResponseCustomization
    Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
    deletionPolicy 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.
    displayName String
    The user-defined name of the SemanticGovernancePolicy.
    mcpTools AiSemanticGovernancePolicyMcpTools
    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.
    naturalLanguageConstraint string
    The natural language constraint of the SemanticGovernancePolicy.
    semanticGovernancePolicyId string
    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.
    agentResponseCustomization AiSemanticGovernancePolicyAgentResponseCustomization
    Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
    deletionPolicy 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.
    displayName string
    The user-defined name of the SemanticGovernancePolicy.
    mcpTools AiSemanticGovernancePolicyMcpTools
    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_constraint str
    The natural language constraint of the SemanticGovernancePolicy.
    semantic_governance_policy_id str
    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_customization AiSemanticGovernancePolicyAgentResponseCustomizationArgs
    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 AiSemanticGovernancePolicyMcpToolsArgs
    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.
    naturalLanguageConstraint String
    The natural language constraint of the SemanticGovernancePolicy.
    semanticGovernancePolicyId String
    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.
    agentResponseCustomization Property Map
    Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
    deletionPolicy 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.
    displayName String
    The user-defined name of the SemanticGovernancePolicy.
    mcpTools 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:

    AgentIdentity 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
    CreateTime 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}'.
    UpdateTime string
    The time the SemanticGovernancePolicy was last updated, in RFC3339 UTC "Zulu" format.
    AgentIdentity 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
    CreateTime 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}'.
    UpdateTime 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.
    agentIdentity 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
    createTime 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}'.
    updateTime String
    The time the SemanticGovernancePolicy was last updated, in RFC3339 UTC "Zulu" format.
    agentIdentity 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
    createTime 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}'.
    updateTime 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.
    agentIdentity 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
    createTime 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}'.
    updateTime 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) -> AiSemanticGovernancePolicy
    func 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.
    The following state arguments are supported:
    Agent string
    The name of the agent in Agent Registry that is affected by this policy.
    AgentIdentity 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
    AgentResponseCustomization AiSemanticGovernancePolicyAgentResponseCustomization
    Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
    CreateTime string
    The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
    DeletionPolicy 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.
    DisplayName string
    The user-defined name of the SemanticGovernancePolicy.
    Etag string
    Used to perform consistent read-modify-write transactions.
    McpTools AiSemanticGovernancePolicyMcpTools
    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}'.
    NaturalLanguageConstraint string
    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'.
    SemanticGovernancePolicyId string
    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.
    UpdateTime 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.
    AgentIdentity 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
    AgentResponseCustomization AiSemanticGovernancePolicyAgentResponseCustomizationArgs
    Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
    CreateTime string
    The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
    DeletionPolicy 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.
    DisplayName string
    The user-defined name of the SemanticGovernancePolicy.
    Etag string
    Used to perform consistent read-modify-write transactions.
    McpTools AiSemanticGovernancePolicyMcpToolsArgs
    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}'.
    NaturalLanguageConstraint string
    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'.
    SemanticGovernancePolicyId string
    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.
    UpdateTime 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_customization object
    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_constraint string
    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_policy_id string
    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.
    agentIdentity 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
    agentResponseCustomization AiSemanticGovernancePolicyAgentResponseCustomization
    Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
    createTime String
    The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
    deletionPolicy 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.
    displayName String
    The user-defined name of the SemanticGovernancePolicy.
    etag String
    Used to perform consistent read-modify-write transactions.
    mcpTools AiSemanticGovernancePolicyMcpTools
    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}'.
    naturalLanguageConstraint String
    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'.
    semanticGovernancePolicyId String
    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.
    updateTime 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.
    agentIdentity 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
    agentResponseCustomization AiSemanticGovernancePolicyAgentResponseCustomization
    Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
    createTime string
    The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
    deletionPolicy 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.
    displayName string
    The user-defined name of the SemanticGovernancePolicy.
    etag string
    Used to perform consistent read-modify-write transactions.
    mcpTools AiSemanticGovernancePolicyMcpTools
    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}'.
    naturalLanguageConstraint string
    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'.
    semanticGovernancePolicyId string
    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.
    updateTime 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_customization AiSemanticGovernancePolicyAgentResponseCustomizationArgs
    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 AiSemanticGovernancePolicyMcpToolsArgs
    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_constraint str
    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_policy_id str
    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.
    agentIdentity 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
    agentResponseCustomization Property Map
    Settings for customizing the agent's response to end users when this policy is evaluated. Structure is documented below.
    createTime String
    The time the SemanticGovernancePolicy was created, in RFC3339 UTC "Zulu" format.
    deletionPolicy 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.
    displayName String
    The user-defined name of the SemanticGovernancePolicy.
    etag String
    Used to perform consistent read-modify-write transactions.
    mcpTools 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}'.
    naturalLanguageConstraint String
    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'.
    semanticGovernancePolicyId String
    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.
    updateTime String
    The time the SemanticGovernancePolicy was last updated, in RFC3339 UTC "Zulu" format.

    Supporting Types

    AiSemanticGovernancePolicyAgentResponseCustomization, AiSemanticGovernancePolicyAgentResponseCustomizationArgs

    DenialMessage 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.
    DenialMessage 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.
    denialMessage 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.
    denialMessage 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.
    denialMessage 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

    McpServer 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.
    McpServer 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.
    mcpServer 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.
    mcpServer 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.
    mcpServer 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-beta Terraform Provider.
    gcp logo
    Viewing docs for Google Cloud v10.5.0
    published on Wednesday, Nov 18, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial