configuration_bundles

Creates, updates, deletes, gets or lists a configuration_bundles resource.

Overview

Name	configuration_bundles
Type	Resource
Id	aws.bedrock_agentcore_control.configuration_bundles

Fields

The following fields are returned by SELECT queries:

get_configuration_bundle

Name	Datatype	Description
bundle_arn	string	The Amazon Resource Name (ARN) of the configuration bundle. (pattern: <code>arn:aws[a-zA-Z-]*:bedrock-agentcore:[a-z0-9-]+:[0-9]{12}:configuration-bundle/[a-zA-Z][a-zA-Z0-9-_]{0,99}-[a-zA-Z0-9]{10}</code>)
bundle_id	string	The unique identifier of the configuration bundle. (pattern: <code>[a-zA-Z][a-zA-Z0-9-_]{0,99}-[a-zA-Z0-9]{10}</code>)
bundle_name	string	The name of the configuration bundle. (pattern: <code>[a-zA-Z][a-zA-Z0-9_]{0,99}</code>)
components	object	A map of component identifiers to their configurations for this version.
created_at	string (date-time)	The timestamp when the configuration bundle was created.
description	string	The description of the configuration bundle. (pattern: <code>.+</code>)
kms_key_arn	string	KMS key ARN used to encrypt component configurations, if CMK was provided. (pattern: <code>arn:aws(|-cn|-us-gov):kms:[a-zA-Z0-9-]*:[0-9]{12}:key/[a-zA-Z0-9-]{36}</code>)
lineage_metadata	object	The version lineage metadata, including parent versions, branch name, and creation source.
updated_at	string (date-time)	The timestamp when the configuration bundle was last updated.
version_id	string	The version identifier of this configuration bundle. (pattern: <code>[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}</code>)

list_configuration_bundles

Name	Datatype	Description
bundle_arn	string	The Amazon Resource Name (ARN) of the configuration bundle. (pattern: <code>arn:aws[a-zA-Z-]*:bedrock-agentcore:[a-z0-9-]+:[0-9]{12}:configuration-bundle/[a-zA-Z][a-zA-Z0-9-_]{0,99}-[a-zA-Z0-9]{10}</code>)
bundle_id	string	The unique identifier of the configuration bundle. (pattern: <code>[a-zA-Z][a-zA-Z0-9-_]{0,99}-[a-zA-Z0-9]{10}</code>)
bundle_name	string	The name of the configuration bundle. (pattern: <code>[a-zA-Z][a-zA-Z0-9_]{0,99}</code>)
created_at	string (date-time)	The timestamp when the configuration bundle was created.
description	string	The description of the configuration bundle. (pattern: <code>.+</code>)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_configuration_bundle	select	bundle_id, region	branchName	Gets the latest version of a configuration bundle. By default, returns the latest version on the mainline branch. Use GetConfigurationBundleVersion to retrieve a specific historical version.
list_configuration_bundles	select	region	nextToken, maxResults	Lists all configuration bundles in the account.
create_configuration_bundle	insert	region, bundleName, components		Creates a new configuration bundle resource. A configuration bundle stores versioned component configurations for agent evaluation workflows.
update_configuration_bundle	update	bundle_id, region		Updates a configuration bundle by creating a new version with the specified changes. Each update creates a new version in the version history.
delete_configuration_bundle	delete	bundle_id, region		Deletes a configuration bundle and all of its versions.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
bundle_id	string	The unique identifier of the configuration bundle to delete.
region	string	AWS region (default: us-east-1)
branchName	string	The branch name to get the latest version from. If not specified, returns the latest version on the mainline branch.
maxResults	integer	The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the nextToken field when making another request to return the next batch of results.
nextToken	string	If the total number of results is greater than the maxResults value provided in the request, enter the token returned in the nextToken field in the response in this field to return the next batch of results.

SELECT examples

get_configuration_bundle

Gets the latest version of a configuration bundle. By default, returns the latest version on the mainline branch. Use GetConfigurationBundleVersion to retrieve a specific historical version.

SELECT
bundle_arn,
bundle_id,
bundle_name,
components,
created_at,
description,
kms_key_arn,
lineage_metadata,
updated_at,
version_id
FROM aws.bedrock_agentcore_control.configuration_bundles
WHERE bundle_id = '{{ bundle_id }}' -- required
AND region = '{{ region }}' -- required
AND branchName = '{{ branchName }}'
;

list_configuration_bundles

Lists all configuration bundles in the account.

SELECT
bundle_arn,
bundle_id,
bundle_name,
created_at,
description
FROM aws.bedrock_agentcore_control.configuration_bundles
WHERE region = '{{ region }}' -- required
AND nextToken = '{{ nextToken }}'
AND maxResults = '{{ maxResults }}'
;

INSERT examples

create_configuration_bundle

Creates a new configuration bundle resource. A configuration bundle stores versioned component configurations for agent evaluation workflows.

INSERT INTO aws.bedrock_agentcore_control.configuration_bundles (
clientToken,
bundleName,
description,
components,
branchName,
commitMessage,
createdBy,
kmsKeyArn,
tags,
region
)
SELECT 
'{{ clientToken }}',
'{{ bundleName }}' /* required */,
'{{ description }}',
'{{ components }}' /* required */,
'{{ branchName }}',
'{{ commitMessage }}',
'{{ createdBy }}',
'{{ kmsKeyArn }}',
'{{ tags }}',
'{{ region }}'
RETURNING
bundle_arn,
bundle_id,
created_at,
version_id
;

Manifest

# Description fields are for documentation purposes
- name: configuration_bundles
props:
  - name: region
    value: "{{ region }}"
    description: Required parameter for the configuration_bundles resource.
  - name: clientToken
    value: "{{ clientToken }}"
  - name: bundleName
    value: "{{ bundleName }}"
  - name: description
    value: "{{ description }}"
  - name: components
    value: "{{ components }}"
  - name: branchName
    value: "{{ branchName }}"
  - name: commitMessage
    value: "{{ commitMessage }}"
  - name: createdBy
    description: |
      The source that created a configuration bundle version.
    value:
      name: "{{ name }}"
      arn: "{{ arn }}"
  - name: kmsKeyArn
    value: "{{ kmsKeyArn }}"
  - name: tags
    value: "{{ tags }}"

UPDATE examples

update_configuration_bundle

Updates a configuration bundle by creating a new version with the specified changes. Each update creates a new version in the version history.

UPDATE aws.bedrock_agentcore_control.configuration_bundles
SET 
clientToken = '{{ clientToken }}',
bundleName = '{{ bundleName }}',
description = '{{ description }}',
components = '{{ components }}',
parentVersionIds = '{{ parentVersionIds }}',
branchName = '{{ branchName }}',
commitMessage = '{{ commitMessage }}',
createdBy = '{{ createdBy }}',
kmsKeyArn = '{{ kmsKeyArn }}'
WHERE 
bundle_id = '{{ bundle_id }}' --required
AND region = '{{ region }}' --required
RETURNING
bundle_arn,
bundle_id,
updated_at,
version_id;

DELETE examples

delete_configuration_bundle

Deletes a configuration bundle and all of its versions.

DELETE FROM aws.bedrock_agentcore_control.configuration_bundles
WHERE bundle_id = '{{ bundle_id }}' --required
AND region = '{{ region }}' --required
;