Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-132661,4471.5 MB
projects

Creates a SemanticGovernancePolicy.

post/v1/{+parent}/semanticGovernancePolicies

Path parameters

parentstring required

Required. The resource name of the Location into which to create the SemanticGovernancePolicy. Format: projects/{project}/locations/{location}

Query parameters

semanticGovernancePolicyIdstring

Required. The ID to use for the SemanticGovernancePolicy, which will become the final component of the SemanticGovernancePolicy's 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.

Request body

agentstring

Required. The name of the agent in Agent Registry that is affected by this policy.

namestring

Identifier. Resource name of the SemanticGovernancePolicy.

descriptionstring

Optional. The description of the SemanticGovernancePolicy.

displayNamestring

Optional. The user-defined name of the SemanticGovernancePolicy.

createTimestring google-datetime

Output only. Timestamp when this SemanticGovernancePolicy was created.

naturalLanguageConstraintstring

Required. The natural language constraint of the SemanticGovernancePolicy.

agentIdentitystring

Output only. 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 Example: principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/LOCATION/reasoningEngines/AGENT_ENGINE_ID

etagstring

Optional. Used to perform consistent read-modify-write transactions. If provided, the request will only succeed if the etag matches the current value. Otherwise, an ABORTED error will be returned.

updateTimestring google-datetime

Output only. Timestamp when this SemanticGovernancePolicy was last updated.

Response

Successful response