Skip to contents

Welcome to the Amazon Bedrock AgentCore Control plane API reference. Control plane actions configure, create, modify, and monitor Amazon Web Services resources.

Usage

bedrockagentcorecontrol(
  config = list(),
  credentials = list(),
  endpoint = NULL,
  region = NULL
)

Arguments

config

Optional configuration of credentials, endpoint, and/or region.

  • credentials:

    • creds:

      • access_key_id: AWS access key ID

      • secret_access_key: AWS secret access key

      • session_token: AWS temporary session token

    • profile: The name of a profile to use. If not given, then the default profile is used.

    • anonymous: Set anonymous credentials.

  • endpoint: The complete URL to use for the constructed client.

  • region: The AWS Region used in instantiating the client.

  • close_connection: Immediately close all HTTP connections.

  • timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.

  • s3_force_path_style: Set this to true to force the request to use path-style addressing, i.e. http://s3.amazonaws.com/BUCKET/KEY.

  • sts_regional_endpoint: Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html

credentials

Optional credentials shorthand for the config parameter

  • creds:

    • access_key_id: AWS access key ID

    • secret_access_key: AWS secret access key

    • session_token: AWS temporary session token

  • profile: The name of a profile to use. If not given, then the default profile is used.

  • anonymous: Set anonymous credentials.

endpoint

Optional shorthand for complete URL to use for the constructed client.

region

Optional shorthand for AWS Region used in instantiating the client.

Value

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Service syntax

svc <- bedrockagentcorecontrol(
  config = list(
    credentials = list(
      creds = list(
        access_key_id = "string",
        secret_access_key = "string",
        session_token = "string"
      ),
      profile = "string",
      anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
      access_key_id = "string",
      secret_access_key = "string",
      session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

add_dataset_examplesAdds examples to the dataset's DRAFT
create_agent_runtimeCreates an Amazon Bedrock AgentCore Runtime
create_agent_runtime_endpointCreates an AgentCore Runtime endpoint
create_api_key_credential_providerCreates a new API key credential provider
create_browserCreates a custom browser
create_browser_profileCreates a browser profile in Amazon Bedrock AgentCore
create_code_interpreterCreates a custom code interpreter
create_configuration_bundleCreates a new configuration bundle resource
create_datasetCreates a new Dataset resource asynchronously
create_dataset_versionPublishes the current DRAFT as a new numbered version
create_evaluatorCreates a custom evaluator for agent quality assessment
create_gatewayCreates a gateway for Amazon Bedrock Agent
create_gateway_ruleCreates a rule for a gateway
create_gateway_targetCreates a target for a gateway
create_harnessOperation to create a Harness
create_memoryCreates a new Amazon Bedrock AgentCore Memory resource
create_oauth_2_credential_providerCreates a new OAuth2 credential provider
create_online_evaluation_configCreates an online evaluation configuration for continuous monitoring of agent performance
create_payment_connectorCreates a new payment connector for a payment manager
create_payment_credential_providerCreates a new payment credential provider for storing authentication credentials used by payment connectors to communicate with external payment providers
create_payment_managerCreates a new payment manager in your Amazon Web Services account
create_policyCreates a policy within the AgentCore Policy system
create_policy_engineCreates a new policy engine within the AgentCore Policy system
create_registryCreates a new registry in your Amazon Web Services account
create_registry_recordCreates a new registry record within the specified registry
create_workload_identityCreates a new workload identity
delete_agent_runtimeDeletes an Amazon Bedrock AgentCore Runtime
delete_agent_runtime_endpointDeletes an AAgentCore Runtime endpoint
delete_api_key_credential_providerDeletes an API key credential provider
delete_browserDeletes a custom browser
delete_browser_profileDeletes a browser profile
delete_code_interpreterDeletes a custom code interpreter
delete_configuration_bundleDeletes a configuration bundle and all of its versions
delete_datasetDeletes a dataset version or an entire dataset (all versions + name claim)
delete_dataset_examplesDeletes specific examples by ID from DRAFT
delete_evaluatorDeletes a custom evaluator
delete_gatewayDeletes a gateway
delete_gateway_ruleDeletes a gateway rule
delete_gateway_targetDeletes a gateway target
delete_harnessOperation to delete a Harness
delete_memoryDeletes an Amazon Bedrock AgentCore Memory resource
delete_oauth_2_credential_providerDeletes an OAuth2 credential provider
delete_online_evaluation_configDeletes an online evaluation configuration and stops any ongoing evaluation processes associated with it
delete_payment_connectorDeletes a payment connector
delete_payment_credential_providerDeletes a payment credential provider and its associated stored credentials
delete_payment_managerDeletes a payment manager
delete_policyDeletes an existing policy from the AgentCore Policy system
delete_policy_engineDeletes an existing policy engine from the AgentCore Policy system
delete_registryDeletes a registry
delete_registry_recordDeletes a registry record
delete_resource_policyDeletes the resource-based policy for a specified resource
delete_workload_identityDeletes a workload identity
get_agent_runtimeGets an Amazon Bedrock AgentCore Runtime
get_agent_runtime_endpointGets information about an Amazon Secure AgentEndpoint
get_api_key_credential_providerRetrieves information about an API key credential provider
get_browserGets information about a custom browser
get_browser_profileGets information about a browser profile
get_code_interpreterGets information about a custom code interpreter
get_configuration_bundleGets the latest version of a configuration bundle
get_configuration_bundle_versionGets a specific version of a configuration bundle by its version identifier
get_datasetRetrieves dataset metadata only
get_evaluatorRetrieves detailed information about an evaluator, including its configuration, status, and metadata
get_gatewayRetrieves information about a specific Gateway
get_gateway_ruleRetrieves detailed information about a specific gateway rule
get_gateway_targetRetrieves information about a specific gateway target
get_harnessOperation to get a single Harness
get_memoryRetrieve an existing Amazon Bedrock AgentCore Memory resource
get_oauth_2_credential_providerRetrieves information about an OAuth2 credential provider
get_online_evaluation_configRetrieves detailed information about an online evaluation configuration, including its rules, data sources, evaluators, and execution status
get_payment_connectorRetrieves information about a specific payment connector
get_payment_credential_providerRetrieves information about a specific payment credential provider
get_payment_managerRetrieves information about a specific payment manager
get_policyRetrieves detailed information about a specific policy within the AgentCore Policy system
get_policy_engineRetrieves detailed information about a specific policy engine within the AgentCore Policy system
get_policy_engine_summaryRetrieves a metadata-only summary of a specific policy engine without decrypting customer content
get_policy_generationRetrieves information about a policy generation request within the AgentCore Policy system
get_policy_generation_summaryRetrieves a metadata-only summary of a specific policy generation request without decrypting customer content
get_policy_summaryRetrieves a metadata-only summary of a specific policy without decrypting customer content
get_registryRetrieves information about a specific registry
get_registry_recordRetrieves information about a specific registry record
get_resource_policyRetrieves the resource-based policy for a specified resource
get_token_vaultRetrieves information about a token vault
get_workload_identityRetrieves information about a workload identity
list_agent_runtime_endpointsLists all endpoints for a specific Amazon Secure Agent
list_agent_runtimesLists all Amazon Secure Agents in your account
list_agent_runtime_versionsLists all versions of a specific Amazon Secure Agent
list_api_key_credential_providersLists all API key credential providers in your account
list_browser_profilesLists all browser profiles in your account
list_browsersLists all custom browsers in your account
list_code_interpretersLists all custom code interpreters in your account
list_configuration_bundlesLists all configuration bundles in the account
list_configuration_bundle_versionsLists all versions of a configuration bundle, with optional filtering by branch name or creation source
list_dataset_examplesReturns paginated examples from the dataset
list_datasetsLists all datasets in the caller's account, paginated
list_dataset_versionsLists all published versions of a dataset, sorted by version number descending (newest first)
list_evaluatorsLists all available evaluators, including both builtin evaluators provided by the service and custom evaluators created by the user
list_gateway_rulesLists all rules for a gateway
list_gatewaysLists all gateways in the account
list_gateway_targetsLists all targets for a specific gateway
list_harnessesOperation to list Harnesses
list_memoriesLists the available Amazon Bedrock AgentCore Memory resources in the current Amazon Web Services Region
list_oauth_2_credential_providersLists all OAuth2 credential providers in your account
list_online_evaluation_configsLists all online evaluation configurations in the account, providing summary information about each configuration's status and settings
list_payment_connectorsLists all payment connectors for a specified payment manager
list_payment_credential_providersLists all payment credential providers in the account
list_payment_managersLists all payment managers in the account
list_policiesRetrieves a list of policies within the AgentCore Policy engine
list_policy_enginesRetrieves a list of policy engines within the AgentCore Policy system
list_policy_engine_summariesRetrieves a paginated list of metadata-only policy engine summaries without decrypting customer content
list_policy_generation_assetsRetrieves a list of generated policy assets from a policy generation request within the AgentCore Policy system
list_policy_generationsRetrieves a list of policy generation requests within the AgentCore Policy system
list_policy_generation_summariesRetrieves a paginated list of metadata-only policy generation summaries within a policy engine without decrypting customer content
list_policy_summariesRetrieves a paginated list of metadata-only policy summaries within a policy engine without decrypting customer content
list_registriesLists all registries in the account
list_registry_recordsLists registry records within a registry
list_tags_for_resourceLists the tags associated with the specified resource
list_workload_identitiesLists all workload identities in your account
put_resource_policyCreates or updates a resource-based policy for a resource with the specified resourceArn
set_token_vault_cmkSets the customer master key (CMK) for a token vault
start_policy_generationInitiates the AI-powered generation of Cedar policies from natural language descriptions within the AgentCore Policy system
submit_registry_record_for_approvalSubmits a registry record for approval
synchronize_gateway_targetsSynchronizes the gateway targets by fetching the latest tool definitions from the target endpoints
tag_resourceAssociates the specified tags to a resource with the specified resourceArn
untag_resourceRemoves the specified tags from the specified resource
update_agent_runtimeUpdates an existing Amazon Secure Agent
update_agent_runtime_endpointUpdates an existing Amazon Bedrock AgentCore Runtime endpoint
update_api_key_credential_providerUpdates an existing API key credential provider
update_configuration_bundleUpdates a configuration bundle by creating a new version with the specified changes
update_datasetUpdates a dataset's metadata
update_dataset_examplesUpdates multiple existing examples in-place on DRAFT
update_evaluatorUpdates a custom evaluator's configuration, description, or evaluation level
update_gatewayUpdates an existing gateway
update_gateway_ruleUpdates a gateway rule's priority, conditions, actions, or description
update_gateway_targetUpdates an existing gateway target
update_harnessOperation to update a Harness
update_memoryUpdate an Amazon Bedrock AgentCore Memory resource memory
update_oauth_2_credential_providerUpdates an existing OAuth2 credential provider
update_online_evaluation_configUpdates an online evaluation configuration's settings, including rules, data sources, evaluators, and execution status
update_payment_connectorUpdates an existing payment connector
update_payment_credential_providerUpdates an existing payment credential provider with new authentication credentials
update_payment_managerUpdates an existing payment manager
update_policyUpdates an existing policy within the AgentCore Policy system
update_policy_engineUpdates an existing policy engine within the AgentCore Policy system
update_registryUpdates an existing registry
update_registry_recordUpdates an existing registry record
update_registry_record_statusUpdates the status of a registry record
update_workload_identityUpdates an existing workload identity

Examples

if (FALSE) { # \dontrun{
svc <- bedrockagentcorecontrol()
svc$add_dataset_examples(
  Foo = 123
)
} # }