Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141531,219979.8 KB

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

put/configuration-bundles/{bundleId}

Path parameters

bundleIdstring required

The unique identifier of the configuration bundle to update.

Request body

clientTokenstring

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 <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.

bundleNamestring

The updated name for the configuration bundle.

descriptionstring password

The updated description for the configuration bundle.

componentsobject

The updated component configurations. Creates a new version of the bundle.

parentVersionIdsConfigurationBundleVersion[]

A list of parent version identifiers for lineage tracking. Regular commits have a single parent. Merge commits have two parents: the target branch parent and the source branch parent. If the branch already exists, the first parent must be the latest version on that branch.

branchNamestring

The branch name for this version. If not specified, inherits the parent's branch or defaults to <code>mainline</code>.

commitMessagestring

A commit message describing the changes in this version.

kmsKeyArnstring

Optional KMS key ARN for encrypting component configurations. If provided, components will be encrypted with this key. If the bundle already has a KMS key, this rotates to the new key.

Response

Success

bundleArnstring required

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

bundleIdstring required

The unique identifier of the updated configuration bundle.

versionIdstring required

The new version identifier created by this update.

updatedAtstring date-time required

The timestamp when the configuration bundle was updated.