1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. bedrockagentcore
  6. Policy

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.86.0
published on Wednesday, Nov 18, 2026 by Pulumi
aws-native logo aws-native logo AWS Cloud Control

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.86.0
published on Wednesday, Nov 18, 2026 by Pulumi

    Resource Type definition for AWS::BedrockAgentCore::Policy

    Create Policy Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Policy(name: string, args: PolicyArgs, opts?: CustomResourceOptions);
    @overload
    def Policy(resource_name: str,
               args: PolicyArgs,
               opts: Optional[ResourceOptions] = None)
    
    @overload
    def Policy(resource_name: str,
               opts: Optional[ResourceOptions] = None,
               definition: Optional[PolicyDefinitionArgs] = None,
               policy_engine_id: Optional[str] = None,
               description: Optional[str] = None,
               enforcement_mode: Optional[PolicyEnforcementMode] = None,
               name: Optional[str] = None,
               validation_mode: Optional[PolicyValidationMode] = None)
    func NewPolicy(ctx *Context, name string, args PolicyArgs, opts ...ResourceOption) (*Policy, error)
    public Policy(string name, PolicyArgs args, CustomResourceOptions? opts = null)
    public Policy(String name, PolicyArgs args)
    public Policy(String name, PolicyArgs args, CustomResourceOptions options)
    
    type: aws-native:bedrockagentcore:Policy
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws-native_bedrockagentcore_policy" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args PolicyArgs
    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 PolicyArgs
    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 PolicyArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args PolicyArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args PolicyArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Policy 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 Policy resource accepts the following input properties:

    Definition Pulumi.AwsNative.BedrockAgentCore.Inputs.PolicyDefinition
    PolicyEngineId string
    The identifier of the policy engine which contains this policy.
    Description string
    A human-readable description of the policy's purpose and functionality.
    EnforcementMode Pulumi.AwsNative.BedrockAgentCore.PolicyEnforcementMode
    Name string
    The customer-assigned immutable name for the policy. Must be unique within the policy engine.
    ValidationMode Pulumi.AwsNative.BedrockAgentCore.PolicyValidationMode
    Definition PolicyDefinitionArgs
    PolicyEngineId string
    The identifier of the policy engine which contains this policy.
    Description string
    A human-readable description of the policy's purpose and functionality.
    EnforcementMode PolicyEnforcementMode
    Name string
    The customer-assigned immutable name for the policy. Must be unique within the policy engine.
    ValidationMode PolicyValidationMode
    definition object
    policy_engine_id string
    The identifier of the policy engine which contains this policy.
    description string
    A human-readable description of the policy's purpose and functionality.
    enforcement_mode "ACTIVE" | "LOG_ONLY"
    name string
    The customer-assigned immutable name for the policy. Must be unique within the policy engine.
    validation_mode "FAIL_ON_ANY_FINDINGS" | "IGNORE_ALL_FINDINGS"
    definition PolicyDefinition
    policyEngineId String
    The identifier of the policy engine which contains this policy.
    description String
    A human-readable description of the policy's purpose and functionality.
    enforcementMode PolicyEnforcementMode
    name String
    The customer-assigned immutable name for the policy. Must be unique within the policy engine.
    validationMode PolicyValidationMode
    definition PolicyDefinition
    policyEngineId string
    The identifier of the policy engine which contains this policy.
    description string
    A human-readable description of the policy's purpose and functionality.
    enforcementMode PolicyEnforcementMode
    name string
    The customer-assigned immutable name for the policy. Must be unique within the policy engine.
    validationMode PolicyValidationMode
    definition PolicyDefinitionArgs
    policy_engine_id str
    The identifier of the policy engine which contains this policy.
    description str
    A human-readable description of the policy's purpose and functionality.
    enforcement_mode PolicyEnforcementMode
    name str
    The customer-assigned immutable name for the policy. Must be unique within the policy engine.
    validation_mode PolicyValidationMode
    definition Property Map
    policyEngineId String
    The identifier of the policy engine which contains this policy.
    description String
    A human-readable description of the policy's purpose and functionality.
    enforcementMode "ACTIVE" | "LOG_ONLY"
    name String
    The customer-assigned immutable name for the policy. Must be unique within the policy engine.
    validationMode "FAIL_ON_ANY_FINDINGS" | "IGNORE_ALL_FINDINGS"

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Policy resource produces the following output properties:

    CreatedAt string
    The timestamp when the policy was created.
    Id string
    The provider-assigned unique ID for this managed resource.
    PolicyArn string
    The Amazon Resource Name (ARN) of the policy.
    PolicyId string
    The unique identifier for the policy.
    Status Pulumi.AwsNative.BedrockAgentCore.PolicyStatus
    The current status of the policy.
    StatusReasons List<string>
    Additional information about the policy status.
    UpdatedAt string
    The timestamp when the policy was last updated.
    CreatedAt string
    The timestamp when the policy was created.
    Id string
    The provider-assigned unique ID for this managed resource.
    PolicyArn string
    The Amazon Resource Name (ARN) of the policy.
    PolicyId string
    The unique identifier for the policy.
    Status PolicyStatus
    The current status of the policy.
    StatusReasons []string
    Additional information about the policy status.
    UpdatedAt string
    The timestamp when the policy was last updated.
    created_at string
    The timestamp when the policy was created.
    id string
    The provider-assigned unique ID for this managed resource.
    policy_arn string
    The Amazon Resource Name (ARN) of the policy.
    policy_id string
    The unique identifier for the policy.
    status "CREATING" | "ACTIVE" | "UPDATING" | "DELETING" | "CREATE_FAILED" | "UPDATE_FAILED" | "DELETE_FAILED"
    The current status of the policy.
    status_reasons list(string)
    Additional information about the policy status.
    updated_at string
    The timestamp when the policy was last updated.
    createdAt String
    The timestamp when the policy was created.
    id String
    The provider-assigned unique ID for this managed resource.
    policyArn String
    The Amazon Resource Name (ARN) of the policy.
    policyId String
    The unique identifier for the policy.
    status PolicyStatus
    The current status of the policy.
    statusReasons List<String>
    Additional information about the policy status.
    updatedAt String
    The timestamp when the policy was last updated.
    createdAt string
    The timestamp when the policy was created.
    id string
    The provider-assigned unique ID for this managed resource.
    policyArn string
    The Amazon Resource Name (ARN) of the policy.
    policyId string
    The unique identifier for the policy.
    status PolicyStatus
    The current status of the policy.
    statusReasons string[]
    Additional information about the policy status.
    updatedAt string
    The timestamp when the policy was last updated.
    created_at str
    The timestamp when the policy was created.
    id str
    The provider-assigned unique ID for this managed resource.
    policy_arn str
    The Amazon Resource Name (ARN) of the policy.
    policy_id str
    The unique identifier for the policy.
    status PolicyStatus
    The current status of the policy.
    status_reasons Sequence[str]
    Additional information about the policy status.
    updated_at str
    The timestamp when the policy was last updated.
    createdAt String
    The timestamp when the policy was created.
    id String
    The provider-assigned unique ID for this managed resource.
    policyArn String
    The Amazon Resource Name (ARN) of the policy.
    policyId String
    The unique identifier for the policy.
    status "CREATING" | "ACTIVE" | "UPDATING" | "DELETING" | "CREATE_FAILED" | "UPDATE_FAILED" | "DELETE_FAILED"
    The current status of the policy.
    statusReasons List<String>
    Additional information about the policy status.
    updatedAt String
    The timestamp when the policy was last updated.

    Look up Existing Policy Resource

    Get an existing Policy 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>, opts?: CustomResourceOptions): Policy
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None) -> Policy
    func GetPolicy(ctx *Context, name string, id IDInput, state *PolicyState, opts ...ResourceOption) (*Policy, error)
    public static Policy Get(string name, Input<string> id, CustomResourceOptions? opts = null)
    public static Policy get(String name, Output<String> id, CustomResourceOptions options)
    resources:  existingPolicy:    type: aws-native:bedrockagentcore:Policy    get:      id: ${id}
    import {
      to = aws-native_bedrockagentcore_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.
    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 PolicyState
    Pass nil. This resource has no state arguments.
    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.
    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.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Supporting Types

    PolicyCedarPolicy, PolicyCedarPolicyArgs

    A Cedar policy statement within the AgentCore Policy system.

    Statement string
    The Cedar policy statement that defines the authorization logic.
    Statement string
    The Cedar policy statement that defines the authorization logic.
    statement string
    The Cedar policy statement that defines the authorization logic.
    statement String
    The Cedar policy statement that defines the authorization logic.
    statement string
    The Cedar policy statement that defines the authorization logic.
    statement str
    The Cedar policy statement that defines the authorization logic.
    statement String
    The Cedar policy statement that defines the authorization logic.

    PolicyDefinition, PolicyDefinitionArgs

    The definition structure for policies. Encapsulates different policy formats.

    PolicyEnforcementMode

    Whether the policy contributes to the enforce decision returned to Gateway. LOG_ONLY policies are still evaluated but their decisions are observed only, allowing customers to validate a policy against real traffic before promoting it.

    NameValue
    ActiveACTIVE
    LogOnlyLOG_ONLY
    NameValue
    PolicyEnforcementModeActiveACTIVE
    PolicyEnforcementModeLogOnlyLOG_ONLY
    Value
    ACTIVE
    LOG_ONLY
    NameValue
    ActiveACTIVE
    LogOnlyLOG_ONLY
    NameValue
    ActiveACTIVE
    LogOnlyLOG_ONLY
    NameValue
    ACTIVEACTIVE
    LOG_ONLYLOG_ONLY
    Value
    ACTIVE
    LOG_ONLY

    PolicyStatement, PolicyStatementArgs

    A policy statement within the AgentCore Policy system.

    Statement string
    The policy statement.
    Statement string
    The policy statement.
    statement string
    The policy statement.
    statement String
    The policy statement.
    statement string
    The policy statement.
    statement str
    The policy statement.
    statement String
    The policy statement.

    PolicyStatus

    NameValue
    CreatingCREATING
    ActiveACTIVE
    UpdatingUPDATING
    DeletingDELETING
    CreateFailedCREATE_FAILED
    UpdateFailedUPDATE_FAILED
    DeleteFailedDELETE_FAILED
    NameValue
    PolicyStatusCreatingCREATING
    PolicyStatusActiveACTIVE
    PolicyStatusUpdatingUPDATING
    PolicyStatusDeletingDELETING
    PolicyStatusCreateFailedCREATE_FAILED
    PolicyStatusUpdateFailedUPDATE_FAILED
    PolicyStatusDeleteFailedDELETE_FAILED
    Value
    CREATING
    ACTIVE
    UPDATING
    DELETING
    CREATE_FAILED
    UPDATE_FAILED
    DELETE_FAILED
    NameValue
    CreatingCREATING
    ActiveACTIVE
    UpdatingUPDATING
    DeletingDELETING
    CreateFailedCREATE_FAILED
    UpdateFailedUPDATE_FAILED
    DeleteFailedDELETE_FAILED
    NameValue
    CreatingCREATING
    ActiveACTIVE
    UpdatingUPDATING
    DeletingDELETING
    CreateFailedCREATE_FAILED
    UpdateFailedUPDATE_FAILED
    DeleteFailedDELETE_FAILED
    NameValue
    CREATINGCREATING
    ACTIVEACTIVE
    UPDATINGUPDATING
    DELETINGDELETING
    CREATE_FAILEDCREATE_FAILED
    UPDATE_FAILEDUPDATE_FAILED
    DELETE_FAILEDDELETE_FAILED
    Value
    CREATING
    ACTIVE
    UPDATING
    DELETING
    CREATE_FAILED
    UPDATE_FAILED
    DELETE_FAILED

    PolicyValidationMode

    The validation mode for the policy. Determines how Cedar analyzer validation results are handled.

    NameValue
    FailOnAnyFindingsFAIL_ON_ANY_FINDINGS
    IgnoreAllFindingsIGNORE_ALL_FINDINGS
    NameValue
    PolicyValidationModeFailOnAnyFindingsFAIL_ON_ANY_FINDINGS
    PolicyValidationModeIgnoreAllFindingsIGNORE_ALL_FINDINGS
    Value
    FAIL_ON_ANY_FINDINGS
    IGNORE_ALL_FINDINGS
    NameValue
    FailOnAnyFindingsFAIL_ON_ANY_FINDINGS
    IgnoreAllFindingsIGNORE_ALL_FINDINGS
    NameValue
    FailOnAnyFindingsFAIL_ON_ANY_FINDINGS
    IgnoreAllFindingsIGNORE_ALL_FINDINGS
    NameValue
    FAIL_ON_ANY_FINDINGSFAIL_ON_ANY_FINDINGS
    IGNORE_ALL_FINDINGSIGNORE_ALL_FINDINGS
    Value
    FAIL_ON_ANY_FINDINGS
    IGNORE_ALL_FINDINGS

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo AWS Cloud Control

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.86.0
    published on Wednesday, Nov 18, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial