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

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

Viewing docs for AWS Cloud Control v1.68.0
published on Monday, Jun 1, 2026 by Pulumi
aws-native logo

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

Viewing docs for AWS Cloud Control v1.68.0
published on Monday, Jun 1, 2026 by Pulumi

    Definition of AWS::BedrockAgentCore::Harness resource type - a managed agentic loop service that provides a turnkey solution for running stateful, tool-equipped AI agents.

    Using getHarness

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getHarness(args: GetHarnessArgs, opts?: InvokeOptions): Promise<GetHarnessResult>
    function getHarnessOutput(args: GetHarnessOutputArgs, opts?: InvokeOptions): Output<GetHarnessResult>
    def get_harness(arn: Optional[str] = None,
                    opts: Optional[InvokeOptions] = None) -> GetHarnessResult
    def get_harness_output(arn: pulumi.Input[Optional[str]] = None,
                    opts: Optional[InvokeOptions] = None) -> Output[GetHarnessResult]
    func LookupHarness(ctx *Context, args *LookupHarnessArgs, opts ...InvokeOption) (*LookupHarnessResult, error)
    func LookupHarnessOutput(ctx *Context, args *LookupHarnessOutputArgs, opts ...InvokeOption) LookupHarnessResultOutput

    > Note: This function is named LookupHarness in the Go SDK.

    public static class GetHarness 
    {
        public static Task<GetHarnessResult> InvokeAsync(GetHarnessArgs args, InvokeOptions? opts = null)
        public static Output<GetHarnessResult> Invoke(GetHarnessInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetHarnessResult> getHarness(GetHarnessArgs args, InvokeOptions options)
    public static Output<GetHarnessResult> getHarness(GetHarnessArgs args, InvokeOptions options)
    
    fn::invoke:
      function: aws-native:bedrockagentcore:getHarness
      arguments:
        # arguments dictionary
    data "aws-native_bedrockagentcore_getharness" "name" {
        # arguments
    }

    The following arguments are supported:

    Arn string
    The Amazon Resource Name (ARN) of the harness.
    Arn string
    The Amazon Resource Name (ARN) of the harness.
    arn string
    The Amazon Resource Name (ARN) of the harness.
    arn String
    The Amazon Resource Name (ARN) of the harness.
    arn string
    The Amazon Resource Name (ARN) of the harness.
    arn str
    The Amazon Resource Name (ARN) of the harness.
    arn String
    The Amazon Resource Name (ARN) of the harness.

    getHarness Result

    The following output properties are available:

    AllowedTools List<string>
    The tools that the agent is allowed to use.
    Arn string
    The Amazon Resource Name (ARN) of the harness.
    AuthorizerConfiguration Pulumi.AwsNative.BedrockAgentCore.Outputs.HarnessAuthorizerConfiguration
    The inbound authorization configuration for authenticating incoming requests.
    CreatedAt string
    The timestamp when the harness was created.
    Environment Pulumi.AwsNative.BedrockAgentCore.Outputs.HarnessEnvironmentProvider
    The compute environment configuration for the harness, including underlying runtime information.
    EnvironmentArtifact Pulumi.AwsNative.BedrockAgentCore.Outputs.HarnessEnvironmentArtifact
    The environment artifact for the harness, such as a custom container image.
    EnvironmentVariables Dictionary<string, string>
    Environment variables to set in the harness runtime environment.
    ExecutionRoleArn string
    The ARN of the IAM role that the harness assumes when running.
    HarnessId string
    The unique identifier of the harness.
    MaxIterations int
    The maximum number of iterations the agent loop can execute per invocation.
    MaxTokens int
    The maximum number of tokens the agent can generate per iteration.
    Memory Pulumi.AwsNative.BedrockAgentCore.Outputs.HarnessMemoryConfiguration
    The AgentCore Memory configuration for persisting conversation context.
    Model Pulumi.AwsNative.BedrockAgentCore.Outputs.HarnessModelConfiguration
    The model configuration for the harness.
    Skills List<Pulumi.AwsNative.BedrockAgentCore.Outputs.HarnessSkill>
    The skills available to the agent.
    Status Pulumi.AwsNative.BedrockAgentCore.HarnessStatus
    The current status of the harness.
    SystemPrompt List<Pulumi.AwsNative.BedrockAgentCore.Outputs.HarnessSystemContentBlock>
    The system prompt that defines the agent's behavior.
    Tags List<Pulumi.AwsNative.Outputs.Tag>
    Tags to apply to the harness resource.
    TimeoutSeconds int
    The maximum duration in seconds for the agent loop execution per invocation.
    Tools List<Pulumi.AwsNative.BedrockAgentCore.Outputs.HarnessTool>
    The tools available to the agent.
    Truncation Pulumi.AwsNative.BedrockAgentCore.Outputs.HarnessTruncationConfiguration
    The truncation configuration for managing conversation context.
    UpdatedAt string
    The timestamp when the harness was last updated.
    AllowedTools []string
    The tools that the agent is allowed to use.
    Arn string
    The Amazon Resource Name (ARN) of the harness.
    AuthorizerConfiguration HarnessAuthorizerConfiguration
    The inbound authorization configuration for authenticating incoming requests.
    CreatedAt string
    The timestamp when the harness was created.
    Environment HarnessEnvironmentProvider
    The compute environment configuration for the harness, including underlying runtime information.
    EnvironmentArtifact HarnessEnvironmentArtifact
    The environment artifact for the harness, such as a custom container image.
    EnvironmentVariables map[string]string
    Environment variables to set in the harness runtime environment.
    ExecutionRoleArn string
    The ARN of the IAM role that the harness assumes when running.
    HarnessId string
    The unique identifier of the harness.
    MaxIterations int
    The maximum number of iterations the agent loop can execute per invocation.
    MaxTokens int
    The maximum number of tokens the agent can generate per iteration.
    Memory HarnessMemoryConfiguration
    The AgentCore Memory configuration for persisting conversation context.
    Model HarnessModelConfiguration
    The model configuration for the harness.
    Skills []HarnessSkill
    The skills available to the agent.
    Status HarnessStatus
    The current status of the harness.
    SystemPrompt []HarnessSystemContentBlock
    The system prompt that defines the agent's behavior.
    Tags Tag
    Tags to apply to the harness resource.
    TimeoutSeconds int
    The maximum duration in seconds for the agent loop execution per invocation.
    Tools []HarnessTool
    The tools available to the agent.
    Truncation HarnessTruncationConfiguration
    The truncation configuration for managing conversation context.
    UpdatedAt string
    The timestamp when the harness was last updated.
    allowed_tools list(string)
    The tools that the agent is allowed to use.
    arn string
    The Amazon Resource Name (ARN) of the harness.
    authorizer_configuration object
    The inbound authorization configuration for authenticating incoming requests.
    created_at string
    The timestamp when the harness was created.
    environment object
    The compute environment configuration for the harness, including underlying runtime information.
    environment_artifact object
    The environment artifact for the harness, such as a custom container image.
    environment_variables map(string)
    Environment variables to set in the harness runtime environment.
    execution_role_arn string
    The ARN of the IAM role that the harness assumes when running.
    harness_id string
    The unique identifier of the harness.
    max_iterations number
    The maximum number of iterations the agent loop can execute per invocation.
    max_tokens number
    The maximum number of tokens the agent can generate per iteration.
    memory object
    The AgentCore Memory configuration for persisting conversation context.
    model object
    The model configuration for the harness.
    skills list(object)
    The skills available to the agent.
    status "CREATING" | "CREATE_FAILED" | "UPDATING" | "UPDATE_FAILED" | "READY" | "DELETING" | "DELETE_FAILED"
    The current status of the harness.
    system_prompt list(object)
    The system prompt that defines the agent's behavior.
    tags list(object)
    Tags to apply to the harness resource.
    timeout_seconds number
    The maximum duration in seconds for the agent loop execution per invocation.
    tools list(object)
    The tools available to the agent.
    truncation object
    The truncation configuration for managing conversation context.
    updated_at string
    The timestamp when the harness was last updated.
    allowedTools List<String>
    The tools that the agent is allowed to use.
    arn String
    The Amazon Resource Name (ARN) of the harness.
    authorizerConfiguration HarnessAuthorizerConfiguration
    The inbound authorization configuration for authenticating incoming requests.
    createdAt String
    The timestamp when the harness was created.
    environment HarnessEnvironmentProvider
    The compute environment configuration for the harness, including underlying runtime information.
    environmentArtifact HarnessEnvironmentArtifact
    The environment artifact for the harness, such as a custom container image.
    environmentVariables Map<String,String>
    Environment variables to set in the harness runtime environment.
    executionRoleArn String
    The ARN of the IAM role that the harness assumes when running.
    harnessId String
    The unique identifier of the harness.
    maxIterations Integer
    The maximum number of iterations the agent loop can execute per invocation.
    maxTokens Integer
    The maximum number of tokens the agent can generate per iteration.
    memory HarnessMemoryConfiguration
    The AgentCore Memory configuration for persisting conversation context.
    model HarnessModelConfiguration
    The model configuration for the harness.
    skills List<HarnessSkill>
    The skills available to the agent.
    status HarnessStatus
    The current status of the harness.
    systemPrompt List<HarnessSystemContentBlock>
    The system prompt that defines the agent's behavior.
    tags List<Tag>
    Tags to apply to the harness resource.
    timeoutSeconds Integer
    The maximum duration in seconds for the agent loop execution per invocation.
    tools List<HarnessTool>
    The tools available to the agent.
    truncation HarnessTruncationConfiguration
    The truncation configuration for managing conversation context.
    updatedAt String
    The timestamp when the harness was last updated.
    allowedTools string[]
    The tools that the agent is allowed to use.
    arn string
    The Amazon Resource Name (ARN) of the harness.
    authorizerConfiguration HarnessAuthorizerConfiguration
    The inbound authorization configuration for authenticating incoming requests.
    createdAt string
    The timestamp when the harness was created.
    environment HarnessEnvironmentProvider
    The compute environment configuration for the harness, including underlying runtime information.
    environmentArtifact HarnessEnvironmentArtifact
    The environment artifact for the harness, such as a custom container image.
    environmentVariables {[key: string]: string}
    Environment variables to set in the harness runtime environment.
    executionRoleArn string
    The ARN of the IAM role that the harness assumes when running.
    harnessId string
    The unique identifier of the harness.
    maxIterations number
    The maximum number of iterations the agent loop can execute per invocation.
    maxTokens number
    The maximum number of tokens the agent can generate per iteration.
    memory HarnessMemoryConfiguration
    The AgentCore Memory configuration for persisting conversation context.
    model HarnessModelConfiguration
    The model configuration for the harness.
    skills HarnessSkill[]
    The skills available to the agent.
    status HarnessStatus
    The current status of the harness.
    systemPrompt HarnessSystemContentBlock[]
    The system prompt that defines the agent's behavior.
    tags Tag[]
    Tags to apply to the harness resource.
    timeoutSeconds number
    The maximum duration in seconds for the agent loop execution per invocation.
    tools HarnessTool[]
    The tools available to the agent.
    truncation HarnessTruncationConfiguration
    The truncation configuration for managing conversation context.
    updatedAt string
    The timestamp when the harness was last updated.
    allowed_tools Sequence[str]
    The tools that the agent is allowed to use.
    arn str
    The Amazon Resource Name (ARN) of the harness.
    authorizer_configuration HarnessAuthorizerConfiguration
    The inbound authorization configuration for authenticating incoming requests.
    created_at str
    The timestamp when the harness was created.
    environment HarnessEnvironmentProvider
    The compute environment configuration for the harness, including underlying runtime information.
    environment_artifact HarnessEnvironmentArtifact
    The environment artifact for the harness, such as a custom container image.
    environment_variables Mapping[str, str]
    Environment variables to set in the harness runtime environment.
    execution_role_arn str
    The ARN of the IAM role that the harness assumes when running.
    harness_id str
    The unique identifier of the harness.
    max_iterations int
    The maximum number of iterations the agent loop can execute per invocation.
    max_tokens int
    The maximum number of tokens the agent can generate per iteration.
    memory HarnessMemoryConfiguration
    The AgentCore Memory configuration for persisting conversation context.
    model HarnessModelConfiguration
    The model configuration for the harness.
    skills Sequence[HarnessSkill]
    The skills available to the agent.
    status HarnessStatus
    The current status of the harness.
    system_prompt Sequence[HarnessSystemContentBlock]
    The system prompt that defines the agent's behavior.
    tags Sequence[root_Tag]
    Tags to apply to the harness resource.
    timeout_seconds int
    The maximum duration in seconds for the agent loop execution per invocation.
    tools Sequence[HarnessTool]
    The tools available to the agent.
    truncation HarnessTruncationConfiguration
    The truncation configuration for managing conversation context.
    updated_at str
    The timestamp when the harness was last updated.
    allowedTools List<String>
    The tools that the agent is allowed to use.
    arn String
    The Amazon Resource Name (ARN) of the harness.
    authorizerConfiguration Property Map
    The inbound authorization configuration for authenticating incoming requests.
    createdAt String
    The timestamp when the harness was created.
    environment Property Map
    The compute environment configuration for the harness, including underlying runtime information.
    environmentArtifact Property Map
    The environment artifact for the harness, such as a custom container image.
    environmentVariables Map<String>
    Environment variables to set in the harness runtime environment.
    executionRoleArn String
    The ARN of the IAM role that the harness assumes when running.
    harnessId String
    The unique identifier of the harness.
    maxIterations Number
    The maximum number of iterations the agent loop can execute per invocation.
    maxTokens Number
    The maximum number of tokens the agent can generate per iteration.
    memory Property Map
    The AgentCore Memory configuration for persisting conversation context.
    model Property Map
    The model configuration for the harness.
    skills List<Property Map>
    The skills available to the agent.
    status "CREATING" | "CREATE_FAILED" | "UPDATING" | "UPDATE_FAILED" | "READY" | "DELETING" | "DELETE_FAILED"
    The current status of the harness.
    systemPrompt List<Property Map>
    The system prompt that defines the agent's behavior.
    tags List<Property Map>
    Tags to apply to the harness resource.
    timeoutSeconds Number
    The maximum duration in seconds for the agent loop execution per invocation.
    tools List<Property Map>
    The tools available to the agent.
    truncation Property Map
    The truncation configuration for managing conversation context.
    updatedAt String
    The timestamp when the harness was last updated.

    Supporting Types

    HarnessAgentCoreBrowserConfig

    BrowserArn string
    BrowserArn string
    browserArn String
    browserArn string
    browserArn String

    HarnessAgentCoreCodeInterpreterConfig

    HarnessAgentCoreGatewayConfig

    HarnessAgentCoreMemoryConfiguration

    Arn string
    ActorId string
    MessagesCount int
    RetrievalConfig Dictionary<string, Pulumi.AwsNative.BedrockAgentCore.Inputs.HarnessAgentCoreMemoryRetrievalConfig>
    Arn string
    ActorId string
    MessagesCount int
    RetrievalConfig map[string]HarnessAgentCoreMemoryRetrievalConfig
    arn string
    actor_id string
    messages_count number
    retrieval_config map(object)
    arn String
    actorId String
    messagesCount Integer
    retrievalConfig Map<String,HarnessAgentCoreMemoryRetrievalConfig>
    arn string
    actorId string
    messagesCount number
    retrievalConfig {[key: string]: HarnessAgentCoreMemoryRetrievalConfig}
    arn str
    actor_id str
    messages_count int
    retrieval_config Mapping[str, HarnessAgentCoreMemoryRetrievalConfig]
    arn String
    actorId String
    messagesCount Number
    retrievalConfig Map<Property Map>

    HarnessAgentCoreMemoryRetrievalConfig

    RelevanceScore float64
    StrategyId string
    TopK int
    relevance_score number
    strategy_id string
    top_k number
    relevanceScore Double
    strategyId String
    topK Integer
    relevanceScore number
    strategyId string
    topK number
    relevanceScore Number
    strategyId String
    topK Number

    HarnessAgentCoreRuntimeEnvironment

    AgentRuntimeArn string
    The ARN of the underlying AgentCore Runtime.
    AgentRuntimeId string
    The ID of the underlying AgentCore Runtime.
    AgentRuntimeName string
    The name of the underlying AgentCore Runtime.
    FilesystemConfigurations []HarnessFilesystemConfiguration
    LifecycleConfiguration HarnessLifecycleConfiguration
    NetworkConfiguration HarnessNetworkConfiguration
    agent_runtime_arn string
    The ARN of the underlying AgentCore Runtime.
    agent_runtime_id string
    The ID of the underlying AgentCore Runtime.
    agent_runtime_name string
    The name of the underlying AgentCore Runtime.
    filesystem_configurations list(object)
    lifecycle_configuration object
    network_configuration object
    agentRuntimeArn String
    The ARN of the underlying AgentCore Runtime.
    agentRuntimeId String
    The ID of the underlying AgentCore Runtime.
    agentRuntimeName String
    The name of the underlying AgentCore Runtime.
    filesystemConfigurations List<HarnessFilesystemConfiguration>
    lifecycleConfiguration HarnessLifecycleConfiguration
    networkConfiguration HarnessNetworkConfiguration
    agentRuntimeArn string
    The ARN of the underlying AgentCore Runtime.
    agentRuntimeId string
    The ID of the underlying AgentCore Runtime.
    agentRuntimeName string
    The name of the underlying AgentCore Runtime.
    filesystemConfigurations HarnessFilesystemConfiguration[]
    lifecycleConfiguration HarnessLifecycleConfiguration
    networkConfiguration HarnessNetworkConfiguration
    agent_runtime_arn str
    The ARN of the underlying AgentCore Runtime.
    agent_runtime_id str
    The ID of the underlying AgentCore Runtime.
    agent_runtime_name str
    The name of the underlying AgentCore Runtime.
    filesystem_configurations Sequence[HarnessFilesystemConfiguration]
    lifecycle_configuration HarnessLifecycleConfiguration
    network_configuration HarnessNetworkConfiguration
    agentRuntimeArn String
    The ARN of the underlying AgentCore Runtime.
    agentRuntimeId String
    The ID of the underlying AgentCore Runtime.
    agentRuntimeName String
    The name of the underlying AgentCore Runtime.
    filesystemConfigurations List<Property Map>
    lifecycleConfiguration Property Map
    networkConfiguration Property Map

    HarnessAuthorizerConfiguration

    HarnessAuthorizingClaimMatchValueType

    HarnessAuthorizingClaimMatchValueTypeClaimMatchOperator

    HarnessBedrockModelConfig

    ModelId string
    MaxTokens int
    Temperature double
    TopP double
    ModelId string
    MaxTokens int
    Temperature float64
    TopP float64
    model_id string
    max_tokens number
    temperature number
    top_p number
    modelId String
    maxTokens Integer
    temperature Double
    topP Double
    modelId string
    maxTokens number
    temperature number
    topP number
    modelId String
    maxTokens Number
    temperature Number
    topP Number

    HarnessClaimMatchValueType

    HarnessContainerConfiguration

    ContainerUri string
    The ECR URI of the container.
    ContainerUri string
    The ECR URI of the container.
    container_uri string
    The ECR URI of the container.
    containerUri String
    The ECR URI of the container.
    containerUri string
    The ECR URI of the container.
    container_uri str
    The ECR URI of the container.
    containerUri String
    The ECR URI of the container.

    HarnessCustomClaimValidationType

    HarnessCustomClaimValidationTypeInboundTokenClaimValueType

    HarnessCustomJwtAuthorizerConfiguration

    HarnessEnvironmentArtifact

    HarnessEnvironmentProvider

    HarnessFilesystemConfiguration

    HarnessGatewayOutboundAuth

    HarnessGeminiModelConfig

    ApiKeyArn string
    ModelId string
    MaxTokens int
    Temperature double
    TopK int
    TopP double
    ApiKeyArn string
    ModelId string
    MaxTokens int
    Temperature float64
    TopK int
    TopP float64
    api_key_arn string
    model_id string
    max_tokens number
    temperature number
    top_k number
    top_p number
    apiKeyArn String
    modelId String
    maxTokens Integer
    temperature Double
    topK Integer
    topP Double
    apiKeyArn string
    modelId string
    maxTokens number
    temperature number
    topK number
    topP number
    apiKeyArn String
    modelId String
    maxTokens Number
    temperature Number
    topK Number
    topP Number

    HarnessInlineFunctionConfig

    Description string
    InputSchema object
    JSON Schema describing the tool's input parameters.
    Description string
    InputSchema interface{}
    JSON Schema describing the tool's input parameters.
    description string
    input_schema any
    JSON Schema describing the tool's input parameters.
    description String
    inputSchema Object
    JSON Schema describing the tool's input parameters.
    description string
    inputSchema any
    JSON Schema describing the tool's input parameters.
    description str
    input_schema Any
    JSON Schema describing the tool's input parameters.
    description String
    inputSchema Any
    JSON Schema describing the tool's input parameters.

    HarnessLifecycleConfiguration

    HarnessMemoryConfiguration

    HarnessModelConfiguration

    HarnessNetworkConfiguration

    HarnessNetworkConfigurationNetworkMode

    HarnessOAuthCredentialProvider

    HarnessOAuthCredentialProviderGrantType

    HarnessOpenAiModelConfig

    ApiKeyArn string
    ModelId string
    MaxTokens int
    Temperature double
    TopP double
    ApiKeyArn string
    ModelId string
    MaxTokens int
    Temperature float64
    TopP float64
    api_key_arn string
    model_id string
    max_tokens number
    temperature number
    top_p number
    apiKeyArn String
    modelId String
    maxTokens Integer
    temperature Double
    topP Double
    apiKeyArn string
    modelId string
    maxTokens number
    temperature number
    topP number
    apiKeyArn String
    modelId String
    maxTokens Number
    temperature Number
    topP Number

    HarnessRemoteMcpConfig

    Url string
    Headers Dictionary<string, string>
    Url string
    Headers map[string]string
    url string
    headers map(string)
    url String
    headers Map<String,String>
    url string
    headers {[key: string]: string}
    url str
    headers Mapping[str, str]
    url String
    headers Map<String>

    HarnessSessionStorageConfiguration

    MountPath string
    MountPath string
    mount_path string
    mountPath String
    mountPath string
    mountPath String

    HarnessSkill

    Path string
    The filesystem path to the skill definition.
    Path string
    The filesystem path to the skill definition.
    path string
    The filesystem path to the skill definition.
    path String
    The filesystem path to the skill definition.
    path string
    The filesystem path to the skill definition.
    path str
    The filesystem path to the skill definition.
    path String
    The filesystem path to the skill definition.

    HarnessSlidingWindowConfiguration

    HarnessStatus

    HarnessSummarizationConfiguration

    HarnessSystemContentBlock

    Text string
    The text content of the system prompt block.
    Text string
    The text content of the system prompt block.
    text string
    The text content of the system prompt block.
    text String
    The text content of the system prompt block.
    text string
    The text content of the system prompt block.
    text str
    The text content of the system prompt block.
    text String
    The text content of the system prompt block.

    HarnessTool

    HarnessToolConfiguration

    HarnessToolType

    HarnessTruncationConfiguration

    HarnessTruncationConfigurationStrategy

    HarnessTruncationStrategyConfiguration

    HarnessVpcConfig

    SecurityGroups List<string>
    Subnets List<string>
    SecurityGroups []string
    Subnets []string
    security_groups list(string)
    subnets list(string)
    securityGroups List<String>
    subnets List<String>
    securityGroups string[]
    subnets string[]
    security_groups Sequence[str]
    subnets Sequence[str]
    securityGroups List<String>
    subnets List<String>

    Tag

    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

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

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

    Viewing docs for AWS Cloud Control v1.68.0
    published on Monday, Jun 1, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial