BedrockAgentCoreControl / Client / list_configuration_bundle_versions

list_configuration_bundle_versions

BedrockAgentCoreControl.Client.list_configuration_bundle_versions(**kwargs)

Lists all versions of a configuration bundle, with optional filtering by branch name or creation source.

See also: AWS API Documentation

Request Syntax

response = client.list_configuration_bundle_versions(
    bundleId='string',
    nextToken='string',
    maxResults=123,
    filter={
        'branchName': 'string',
        'createdByName': 'string',
        'latestPerBranch': True|False
    }
)
Parameters:

  • bundleId (string) –

    [REQUIRED]

    The unique identifier of the configuration bundle to list versions for.

  • 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.

  • 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.

  • filter (dict) –

    An optional filter for listing versions, including branch name, creation source, and whether to return only the latest version per branch.

    • branchName (string) –

      Filter by branch name.

    • createdByName (string) –

      Filter by creation source name.

    • latestPerBranch (boolean) –

      When true, returns only the latest version for each branch. When false or not specified, returns all versions. Can be combined with branchName to get the latest version for a specific branch.

Return type:

dict

Returns:

Response Syntax

{
    'versions': [
        {
            'bundleArn': 'string',
            'bundleId': 'string',
            'versionId': 'string',
            'lineageMetadata': {
                'parentVersionIds': [
                    'string',
                ],
                'branchName': 'string',
                'createdBy': {
                    'name': 'string',
                    'arn': 'string'
                },
                'commitMessage': 'string'
            },
            'versionCreatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • versions (list) –

      The list of configuration bundle version summaries.

      • (dict) –

        Summary information about a configuration bundle version.

        • bundleArn (string) –

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

        • bundleId (string) –

          The unique identifier of the configuration bundle.

        • versionId (string) –

          The version identifier of this configuration bundle version.

        • lineageMetadata (dict) –

          The version lineage metadata, including parent versions, branch name, and creation source.

          • parentVersionIds (list) –

            A list of parent version identifiers. Regular commits have 0-1 parents. Merge commits have 2 parents: the target branch parent and the source branch parent. The first parent represents the primary lineage.

            • (string) –

          • branchName (string) –

            The branch name for this version. If not specified, inherits the parent’s branch or defaults to mainline.

          • createdBy (dict) –

            The source that created this version.

            • name (string) –

              The name of the source (for example, user, optimization-job, or system).

            • arn (string) –

              The Amazon Resource Name (ARN) of the source, if applicable (for example, a user ARN or optimization job ARN).

          • commitMessage (string) –

            A commit message describing the changes in this version.

        • versionCreatedAt (datetime) –

          The timestamp when this version was created.

    • nextToken (string) –

      If the total number of results is greater than the maxResults value provided in the request, use this token when making another request in the nextToken field to return the next batch of results.

Exceptions