Skip to content

create_configuration_bundle

Operation

create_configuration_bundle

create_configuration_bundle(request: CreateConfigurationBundleInput | CreateConfigurationBundleInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[CreateConfigurationBundleInputDict]) -> CreateConfigurationBundleOutput

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

Parameters:

Name Type Description Default
request CreateConfigurationBundleInput | CreateConfigurationBundleInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[CreateConfigurationBundleInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
CreateConfigurationBundleOutput

An instance of CreateConfigurationBundleOutput.

create_configuration_bundle async

create_configuration_bundle(request: CreateConfigurationBundleInput | CreateConfigurationBundleInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[CreateConfigurationBundleInputDict]) -> CreateConfigurationBundleOutput

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

Parameters:

Name Type Description Default
request CreateConfigurationBundleInput | CreateConfigurationBundleInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[CreateConfigurationBundleInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
CreateConfigurationBundleOutput

An instance of CreateConfigurationBundleOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

CreateConfigurationBundleInputDict

Bases: TypedDict

Dictionary form of CreateConfigurationBundleInput.

Attributes

branch_name instance-attribute
branch_name: str | None

The branch name for version tracking. Defaults to mainline if not specified.

bundle_name instance-attribute
bundle_name: Required[str]

The name for the configuration bundle. Names must be unique within your account.

client_token instance-attribute
client_token: str | None

A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If you don't specify this field, a value is randomly generated for you. If this token matches a previous request, the service ignores the request, but doesn't return an error. For more information, see Ensuring idempotency.

This field is autopopulated if not provided.

commit_message instance-attribute
commit_message: str | None

A commit message describing the initial version of the configuration bundle.

components instance-attribute

A map of component identifiers to their configurations. Each component represents a configurable element within the bundle.

created_by instance-attribute

The source that created this version, including the source name and optional ARN.

description instance-attribute
description: str | None

The description for the configuration bundle.

kms_key_arn instance-attribute
kms_key_arn: str | None

Optional KMS key ARN for encrypting component configurations.

tags instance-attribute
tags: Mapping[str, str] | None

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

CreateConfigurationBundleInput dataclass

Bases: _SerdeShape

Dataclass for CreateConfigurationBundleInput structure.

Attributes

branch_name class-attribute instance-attribute
branch_name: str | None = ...

The branch name for version tracking. Defaults to mainline if not specified.

bundle_name class-attribute instance-attribute
bundle_name: str | None = ...

The name for the configuration bundle. Names must be unique within your account.

client_token class-attribute instance-attribute
client_token: str | None = ...

A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If you don't specify this field, a value is randomly generated for you. If this token matches a previous request, the service ignores the request, but doesn't return an error. For more information, see Ensuring idempotency.

This field is autopopulated if not provided.

commit_message class-attribute instance-attribute
commit_message: str | None = ...

A commit message describing the initial version of the configuration bundle.

components class-attribute instance-attribute
components: dict[str, ComponentConfiguration] | None = ...

A map of component identifiers to their configurations. Each component represents a configurable element within the bundle.

created_by class-attribute instance-attribute
created_by: VersionCreatedBySource | None = ...

The source that created this version, including the source name and optional ARN.

description class-attribute instance-attribute
description: str | None = ...

The description for the configuration bundle.

kms_key_arn class-attribute instance-attribute
kms_key_arn: str | None = ...

Optional KMS key ARN for encrypting component configurations.

tags class-attribute instance-attribute
tags: dict[str, str] | None = ...

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

Output

CreateConfigurationBundleOutput dataclass

Bases: _SerdeShape

Dataclass for CreateConfigurationBundleOutput structure.

Attributes

bundle_arn instance-attribute
bundle_arn: str

The Amazon Resource Name (ARN) of the created configuration bundle.

bundle_id instance-attribute
bundle_id: str

The unique identifier of the created configuration bundle.

created_at instance-attribute
created_at: datetime

The timestamp when the configuration bundle was created.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.

version_id instance-attribute
version_id: str

The initial version identifier of the configuration bundle.