# PolicyProps

Properties for creating a Policy resource.

Extends: PolicyProps
Used as props by: Policy

- Source: [`aws-bedrockagentcore/lib/policy/policy.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/aws-cdk-lib/aws-bedrockagentcore/lib/policy/policy.ts#L21)
- Type last changed: v2.269.0 · 10 Sep 2026

## Example

```ts
declare const policyEngine: agentcore.PolicyEngine;

const advancedPolicy = new agentcore.Policy(this, "AdvancedPolicy", {
  policyEngine: policyEngine,
  statement: agentcore.PolicyStatement.fromCedar(
    'permit(principal, action, resource) when { context.custom > 10 };'
  ),
  description: "Advanced policy with custom Cedar logic",
});

policyEngine.addPolicy("CustomPolicy", {
  statement: agentcore.PolicyStatement.fromCedar(
    'forbid(principal, action, resource) when { resource.confidential == true };'
  ),
  description: "Custom policy from Cedar string",
});
```

## Properties

- `description`: string — Optional description for the policy.

  **Default:** No description

  Maximum length of 4096.

- `policyEngine`: [IPolicyEngine](/cdk/api/v2/docs/aws-cdk-lib.aws_bedrockagentcore.IPolicyEngine.html) (required) — The policy engine this policy belongs to.

  [disable-awslint:prefer-ref-interface]

- `policyName`: string — The name of the policy.

  **Default:** Auto-generated unique name

  Valid characters: a-z, A-Z, 0-9, _ (underscore)
  Must start with a letter, 1-48 characters
  Pattern: ^[A-Za-z][A-Za-z0-9_]*$

- `statement`: [PolicyStatement](/cdk/api/v2/docs/aws-cdk-lib.aws_bedrockagentcore.PolicyStatement.html) (required) — The Cedar policy statement for this policy.

  Build a type-safe statement with the `PolicyStatement` factories, which validate
  at synthesis time and reject values that cannot be represented safely in Cedar.

  For raw Cedar (features this API does not model, or migrating an existing policy),
  use `PolicyStatement.fromCedar('...')`. That string is used exactly as given: the
  module does not escape, quote, or validate it, so it is treated as trusted input
  and you own its correctness and safety. Do not assemble it from values that come
  from outside your application, such as a request body or a database record.

- `validationMode`: [PolicyValidationMode](/cdk/api/v2/docs/aws-cdk-lib.aws_bedrockagentcore.PolicyValidationMode.html) — Validation mode for the policy.

  **Default:** PolicyValidationMode.FAIL_ON_ANY_FINDINGS

  Controls how Cedar analyzer validation findings are handled.
