# Daftar bundel konfigurasi
<a name="configuration-bundles-list"></a>

Buat daftar bundel konfigurasi di akun Anda, atau daftar versi bundel tertentu. Dua operasi tersedia:
+  **ListConfigurationBundles**— Mengembalikan semua bundel di akun Anda dengan informasi ringkasan.
+  **ListConfigurationBundleVersions**— Mengembalikan semua versi bundel tertentu, dengan pemfilteran opsional berdasarkan cabang atau sumber pembuatan.

Kedua operasi mendukung pagination.

## Sampel Kode
<a name="list-bundles-examples"></a>

**Example**  
Daftar versi bundel:  

```
agentcore config-bundle versions --name myAgentConfig
```
Filter berdasarkan cabang:  

```
agentcore config-bundle versions --name myAgentConfig --branch mainline
```
Tampilkan hanya versi terbaru per cabang:  

```
agentcore config-bundle versions --name myAgentConfig --latest-per-branch
```
Filter menurut pembuat (misalnya, versi yang dibuat oleh pekerjaan rekomendasi):  

```
agentcore config-bundle versions --name myAgentConfig --created-by recommendation
```
Daftar semua bundel dengan pagination:  

```
import boto3

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

paginator = client.get_paginator("list_configuration_bundles")
for page in paginator.paginate(maxResults=20):
    for bundle in page["bundles"]:
        print(f"{bundle['bundleId']} - {bundle['bundleName']}")
```
Daftar versi bundel tertentu:  

```
response = client.list_configuration_bundle_versions(
    bundleId="myAgentConfig-a1b2c3d4e5",
    filter={"branchName": "mainline"},
    maxResults=20,
)

for version in response["versions"]:
    lineage = version.get("lineageMetadata", {})
    print(
        f"{version['versionId']}  "
        f"{version['versionCreatedAt']}  "
        f"{lineage.get('commitMessage', '')}"
    )
```

## Permintaan parameter
<a name="list-bundles-params"></a>

### ListConfigurationBundles
<a name="list-bundles-params-bundles"></a>


| Parameter | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
|  `maxResults`  | Bulat | Tidak | Jumlah maksimum hasil yang akan dikembalikan per halaman. Rentang: 1—100. | 
|  `nextToken`  | String | Tidak | Token pagination dari respons sebelumnya. | 

### ListConfigurationBundleVersions
<a name="list-bundles-params-versions"></a>


| Parameter | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
|  `bundleId`  | Tali | Ya | ID dari bundel konfigurasi. Lulus sebagai parameter jalur. | 
|  `filter`  | Objek | Tidak | Filter opsional. Lihat [Filter versi](#list-bundles-filter) di bawah ini. | 
|  `maxResults`  | Bilangan Bulat | Tidak | Jumlah maksimum hasil yang akan dikembalikan per halaman. Rentang: 1—100. | 
|  `nextToken`  | String | Tidak | Token pagination dari respons sebelumnya. | 

### Filter versi
<a name="list-bundles-filter"></a>


| Bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
|  `branchName`  | String | Kembalikan hanya versi di cabang ini. | 
|  `createdByName`  | String | Kembalikan hanya versi yang dibuat oleh nama sumber ini (misalnya, `optimization-job` atau`recommendation`). | 
|  `latestPerBranch`  | Boolean | Kapan`true`, hanya mengembalikan versi terbaru untuk setiap cabang. Dapat dikombinasikan dengan `branchName` untuk mendapatkan yang terbaru untuk cabang tertentu. | 

## Respons
<a name="list-bundles-response"></a>

### ListConfigurationBundles
<a name="list-bundles-response-bundles"></a>


| Bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
|  `bundles`  | Daftar | Daftar ringkasan bundel. Masing-masing berisi`bundleArn`,`bundleId`,`bundleName`, dan`description`. | 
|  `nextToken`  | String | Token pagination untuk halaman berikutnya. Absen ketika tidak ada hasil lagi. | 

### ListConfigurationBundleVersions
<a name="list-bundles-response-versions"></a>


| Bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
|  `versions`  | Daftar | Daftar ringkasan versi. Masing-masing berisi `bundleArn``bundleId`,,`versionId`,`lineageMetadata`, dan`versionCreatedAt`. | 
|  `nextToken`  | String | Token pagination untuk halaman berikutnya. Absen ketika tidak ada hasil lagi. | 

## Kesalahan
<a name="list-bundles-errors"></a>


| Kesalahan | Status HTTP | Deskripsi | 
| --- | --- | --- | 
|  `ValidationException`  | 400 | Parameter permintaan tidak valid. | 
|  `ResourceNotFoundException`  | 404 | Yang ditentukan `bundleId` tidak ada (ListConfigurationBundleVersions hanya). | 
|  `AccessDeniedException`  | 403 | Izin tidak mencukupi. | 
|  `ThrottlingException`  | 429 | Tingkat permintaan terlampaui. Coba lagi dengan backoff eksponensial. | 
|  `InternalServerException`  | 500 | Service-side kesalahan. Coba lagi permintaannya. |