# 获取配置包
<a name="configuration-bundles-get"></a>

检索配置包以检查其元数据或读取特定版本的完整配置内容。有两种操作可供选择：
+  **GetConfigurationBundle**— 返回最新版本的捆绑包。如果指定，`branchName`则返回该分支上的最新版本。如果省略，则返回所有分支的最新版本。使用它来读取当前的活动配置。
+  **GetConfigurationBundleVersion**— 按版本 ID 返回特定的历史版本。使用它来检查过去的配置或比较版本。

## 捆绑包元数据与版本内容
<a name="get-bundle-metadata-vs-content"></a>

 `GetConfigurationBundle`返回捆绑包级别的元数据（名称、描述、ARN）和完整版本内容（带有配置键值对的组件）。如果您只需要知道存在哪些版本而不获取其全部内容，请`ListConfigurationBundleVersions`改用。

 `GetConfigurationBundleVersion`返回相同的字段 plus`versionCreatedAt`，它会准确地告诉你该特定版本的创建时间（而不是最初创建捆绑包本身的时间）。`createdAt`

## 代码示例
<a name="get-bundle-examples"></a>

**Example**  
查看捆绑包的版本历史记录：  

```
agentcore config-bundle versions --name myAgentConfig
```
并排比较两个版本：  

```
agentcore config-bundle diff --name myAgentConfig \
  --from <version-1> \
  --to <version-2>
```
没有直接的 “获取捆绑包内容” CLI 命令—— `config-bundle` 子命令是`versions``diff`、和`create-branch`。要枚举版本并捕获其 ID，请使用`agentcore config-bundle versions --name myAgentConfig --json`（可选择使用`--branch <name>``--latest-per-branch`、或`--created-by <name>`），然后将版本 ID 输入到`config-bundle diff`。要获取捆绑包版本的完整配置内容，请使用如下所示的 SDK/REST `GetConfigurationBundleVersion`操作。
获取捆绑包元数据和最新版本内容：  

```
import boto3

client = boto3.client("bedrock-agentcore-control", region_name="us-west-2")

response = client.get_configuration_bundle(
    bundleId="myAgentConfig-a1b2c3d4e5"
)

print(f"Bundle: {response['bundleName']}")
print(f"Version: {response['versionId']}")
print(f"Branch: {response.get('lineageMetadata', {}).get('branchName', 'N/A')}")
print(f"Components: {response['components']}")
```
获取特定的历史版本：  

```
response = client.get_configuration_bundle_version(
    bundleId="myAgentConfig-a1b2c3d4e5",
    versionId="12345678-1234-1234-1234-123456789012"
)

print(f"Version: {response['versionId']}")
print(f"Version created at: {response['versionCreatedAt']}")
print(f"Commit message: {response.get('lineageMetadata', {}).get('commitMessage', '')}")
print(f"Components: {response['components']}")
```

## 请求参数
<a name="get-bundle-params"></a>

### GetConfigurationBundle
<a name="get-bundle-params-latest"></a>


| 参数 | Type | 必需 | 描述 | 
| --- | --- | --- | --- | 
|  `bundleId`  | 字符串 | 是 | 配置包的 ID。作为路径参数传递。 | 
|  `branchName`  | 字符串 | 否 | 要从中获取最新版本的分支名称。如果省略，则返回所有分支的最新版本。 | 

### GetConfigurationBundleVersion
<a name="get-bundle-params-version"></a>


| 参数 | Type | 必需 | 描述 | 
| --- | --- | --- | --- | 
|  `bundleId`  | 字符串 | 是 | 配置包的 ID。作为路径参数传递。 | 
|  `versionId`  | 字符串 | 是 | 要检索的特定版本的 UUID。作为路径参数传递。 | 

## 响应
<a name="get-bundle-response"></a>

这两个操作都返回相同的字段。 `GetConfigurationBundleVersion`另外还会返回`versionCreatedAt`。


| 字段 | Type | 说明 | 
| --- | --- | --- | 
|  `bundleArn`  | 字符串 | 配置包的 ARN。 | 
|  `bundleId`  | 字符串 | 配置包的 ID。 | 
|  `bundleName`  | 字符串 | 捆绑包的名称。 | 
|  `description`  | 字符串 | 捆绑包的描述（如果已设置）。 | 
|  `versionId`  | 字符串 | 返回的版本的 UUID。 | 
|  `components`  | Map | 组件标识符到组件配置的映射。每个值都包含一个`configuration`对象，其键值对存储在此版本中。 | 
|  `lineageMetadata`  | 对象 | 版本谱系元数据包括`parentVersionIds`、`branchName``createdBy`、和。`commitMessage` | 
|  `createdAt`  | Timestamp | 最初创建捆绑包的时间。 | 
|  `updatedAt`  | Timestamp | 捆绑包上次更新时间（GetConfigurationBundle 仅限）。 | 
|  `versionCreatedAt`  | Timestamp | 此特定版本的创建时间（GetConfigurationBundleVersion 仅限）。 | 

## 错误
<a name="get-bundle-errors"></a>


| 错误 | HTTP 状态 | 说明 | 
| --- | --- | --- | 
|  `ValidationException`  | 400 | 请求参数无效。 | 
|  `ResourceNotFoundException`  | 404 | 指定的`bundleId`或`versionId`不存在。 | 
|  `AccessDeniedException`  | 403 | 权限不足。验证 IAM 策略是否包含`bedrock-agentcore:GetConfigurationBundle`或`bedrock-agentcore:GetConfigurationBundleVersion`。 | 
|  `ThrottlingException`  | 429 | 超出请求速率。使用指数回退进行重试。 | 
|  `InternalServerException`  | 500 | Service-side 错误。重试请求。 |