View a markdown version of this page

LaunchParameters - Amazon Bedrock AgentCore Control Plane

LaunchParameters

The parameters for launching Amazon EC2 instances in a capacity provider.

Contents

instanceRequirements

The requirements that determine which instance types can be launched.

Type: InstanceRequirements object

Required: Yes

operatingSystem

The operating system and CPU architecture for the instances.

Type: String

Valid Values: LINUX_X86_64 | LINUX_ARM64

Required: Yes

capacityReservationSpecification

The Capacity Reservation targeting option for the instances.

Type: CapacityReservationSpecification object

Required: No

ephemeralVolumes

The block device mappings for instance store (ephemeral) volumes. You can specify up to five mappings.

Type: Array of EphemeralBlockDeviceMapping objects

Array Members: Minimum number of 0 items. Maximum number of 5 items.

Required: No

instanceProfileArn

The Amazon Resource Name (ARN) of the IAM instance profile to associate with launched instances. If provided, this overrides the default instance profile.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

Pattern: arn:aws(-[^:]+)?:iam::[0-9]{12}:instance-profile/([!-~]{1,510}/)?([\w+=,.@-]{1,128})

Required: No

licenseSpecifications

The license configurations to associate with the instances. You can specify up to five configurations.

Type: Array of LicenseSpecification objects

Array Members: Minimum number of 0 items. Maximum number of 5 items.

Required: No

monitoring

The monitoring level for the instances.

Type: String

Valid Values: BASIC | DETAILED

Required: No

propagatedTags

The tags to propagate to all Amazon EC2 resources (instances, volumes, and network interfaces) that the capacity provider creates.

Type: String to string map

Map Entries: Minimum number of 0 items. Maximum number of 50 items.

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Key Pattern: [a-zA-Z0-9\s._:/=+@-]*

Value Length Constraints: Minimum length of 0. Maximum length of 256.

Value Pattern: [a-zA-Z0-9\s._:/=+@-]*

Required: No

sshKeyName

The name of the SSH key pair to configure on the instances for SSH connectivity.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: [!-~][ -~]*[!-~]$|^[!-~]

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: