Skip to content

Create Agent Runtime

bedrockagentcorecontrol_create_agent_runtime R Documentation

Creates an Amazon Bedrock AgentCore Runtime

Description

Creates an Amazon Bedrock AgentCore Runtime.

Usage

bedrockagentcorecontrol_create_agent_runtime(agentRuntimeName,
  agentRuntimeArtifact, roleArn, networkConfiguration, clientToken,
  description, authorizerConfiguration, requestHeaderConfiguration,
  protocolConfiguration, lifecycleConfiguration, environmentVariables,
  filesystemConfigurations, tags)

Arguments

agentRuntimeName

[required] The name of the AgentCore Runtime.

agentRuntimeArtifact

[required] The artifact of the AgentCore Runtime.

roleArn

[required] The IAM role ARN that provides permissions for the AgentCore Runtime.

networkConfiguration

[required] The network configuration for the AgentCore Runtime.

clientToken

A unique, case-sensitive identifier to ensure idempotency of the request.

description

The description of the AgentCore Runtime.

authorizerConfiguration

The authorizer configuration for the AgentCore Runtime.

requestHeaderConfiguration

Configuration for HTTP request headers that will be passed through to the runtime.

protocolConfiguration

The protocol configuration for an agent runtime. This structure defines how the agent runtime communicates with clients.

lifecycleConfiguration

The life cycle configuration for the AgentCore Runtime.

environmentVariables

Environment variables to set in the AgentCore Runtime environment.

filesystemConfigurations

The filesystem configurations to mount into the AgentCore Runtime. Use filesystem configurations to provide persistent storage to your AgentCore Runtime sessions.

tags

A map of tag keys and values to assign to the agent runtime. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment.

Value

A list with the following syntax:

list(
  agentRuntimeArn = "string",
  workloadIdentityDetails = list(
    workloadIdentityArn = "string"
  ),
  agentRuntimeId = "string",
  agentRuntimeVersion = "string",
  createdAt = as.POSIXct(
    "2015-01-01"
  ),
  status = "CREATING"|"CREATE_FAILED"|"UPDATING"|"UPDATE_FAILED"|"READY"|"DELETING"
)

Request syntax

svc$create_agent_runtime(
  agentRuntimeName = "string",
  agentRuntimeArtifact = list(
    containerConfiguration = list(
      containerUri = "string"
    ),
    codeConfiguration = list(
      code = list(
        s3 = list(
          bucket = "string",
          prefix = "string",
          versionId = "string"
        )
      ),
      runtime = "PYTHON_3_10"|"PYTHON_3_11"|"PYTHON_3_12"|"PYTHON_3_13"|"PYTHON_3_14"|"NODE_22",
      entryPoint = list(
        "string"
      )
    )
  ),
  roleArn = "string",
  networkConfiguration = list(
    networkMode = "PUBLIC"|"VPC",
    networkModeConfig = list(
      securityGroups = list(
        "string"
      ),
      subnets = list(
        "string"
      ),
      requireServiceS3Endpoint = TRUE|FALSE
    )
  ),
  clientToken = "string",
  description = "string",
  authorizerConfiguration = list(
    customJWTAuthorizer = list(
      discoveryUrl = "string",
      allowedAudience = list(
        "string"
      ),
      allowedClients = list(
        "string"
      ),
      allowedScopes = list(
        "string"
      ),
      customClaims = list(
        list(
          inboundTokenClaimName = "string",
          inboundTokenClaimValueType = "STRING"|"STRING_ARRAY",
          authorizingClaimMatchValue = list(
            claimMatchValue = list(
              matchValueString = "string",
              matchValueStringList = list(
                "string"
              )
            ),
            claimMatchOperator = "EQUALS"|"CONTAINS"|"CONTAINS_ANY"
          )
        )
      ),
      privateEndpoint = list(
        selfManagedLatticeResource = list(
          resourceConfigurationIdentifier = "string"
        ),
        managedVpcResource = list(
          vpcIdentifier = "string",
          subnetIds = list(
            "string"
          ),
          endpointIpAddressType = "IPV4"|"IPV6",
          securityGroupIds = list(
            "string"
          ),
          tags = list(
            "string"
          ),
          routingDomain = "string"
        )
      ),
      privateEndpointOverrides = list(
        list(
          domain = "string",
          privateEndpoint = list(
            selfManagedLatticeResource = list(
              resourceConfigurationIdentifier = "string"
            ),
            managedVpcResource = list(
              vpcIdentifier = "string",
              subnetIds = list(
                "string"
              ),
              endpointIpAddressType = "IPV4"|"IPV6",
              securityGroupIds = list(
                "string"
              ),
              tags = list(
                "string"
              ),
              routingDomain = "string"
            )
          )
        )
      )
    )
  ),
  requestHeaderConfiguration = list(
    requestHeaderAllowlist = list(
      "string"
    )
  ),
  protocolConfiguration = list(
    serverProtocol = "MCP"|"HTTP"|"A2A"|"AGUI"
  ),
  lifecycleConfiguration = list(
    idleRuntimeSessionTimeout = 123,
    maxLifetime = 123
  ),
  environmentVariables = list(
    "string"
  ),
  filesystemConfigurations = list(
    list(
      sessionStorage = list(
        mountPath = "string"
      ),
      s3FilesAccessPoint = list(
        accessPointArn = "string",
        mountPath = "string"
      ),
      efsAccessPoint = list(
        accessPointArn = "string",
        mountPath = "string"
      )
    )
  ),
  tags = list(
    "string"
  )
)