기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 구성 번들 나열
<a name="configuration-bundles-list"></a>

계정의 구성 번들을 나열하거나 특정 번들의 버전을 나열합니다. 두 가지 작업을 사용할 수 있습니다.
+  **ListConfigurationBundles** - 요약 정보와 함께 계정의 모든 번들을 반환합니다.
+  **ListConfigurationBundleVersions** - 브랜치 또는 생성 소스별 선택적 필터링과 함께 특정 번들의 모든 버전을 반환합니다.

두 작업 모두 페이지 매김을 지원합니다.

## 코드 샘플
<a name="list-bundles-examples"></a>

**Example**  
번들의 버전을 나열합니다.  

```
agentcore config-bundle versions --name myAgentConfig
```
브랜치를 기준으로 필터링:  

```
agentcore config-bundle versions --name myAgentConfig --branch mainline
```
브랜치당 최신 버전만 표시:  

```
agentcore config-bundle versions --name myAgentConfig --latest-per-branch
```
생성자를 기준으로 필터링(예: 권장 작업으로 생성된 버전):  

```
agentcore config-bundle versions --name myAgentConfig --created-by recommendation
```
페이지 매김이 있는 모든 번들 나열:  

```
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']}")
```
특정 번들의 버전을 나열합니다.  

```
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', '')}"
    )
```

## 요청 파라미터
<a name="list-bundles-params"></a>

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


| 파라미터 | 유형 | 필수 | 설명 | 
| --- | --- | --- | --- | 
|  `maxResults`  | Integer | 아니요 | 페이지당 반환할 최대 결과 수입니다. 범위: 1\~100. | 
|  `nextToken`  | 문자열 | No | 이전 응답의 페이지 매김 토큰입니다. | 

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


| 파라미터 | 유형 | 필수 | 설명 | 
| --- | --- | --- | --- | 
|  `bundleId`  | 문자열 | 예 | 구성 번들의 ID입니다. 경로 파라미터로 전달됩니다. | 
|  `filter`  | 객체 | 아니요 | 선택적 필터. 자세한 내용은 아래 [버전 필터](#list-bundles-filter) 섹션을 참조하세요. | 
|  `maxResults`  | Integer | 아니요 | 페이지당 반환할 최대 결과 수입니다. 범위: 1\~100. | 
|  `nextToken`  | 문자열 | No | 이전 응답의 페이지 매김 토큰입니다. | 

### 버전 필터
<a name="list-bundles-filter"></a>


| Field | 유형 | 설명 | 
| --- | --- | --- | 
|  `branchName`  | 문자열 | 이 브랜치의 버전만 반환합니다. | 
|  `createdByName`  | 문자열 | 이 소스 이름으로 생성된 버전만 반환합니다(예: `optimization-job` 또는 `recommendation`). | 
|  `latestPerBranch`  | 부울 | `true`인 경우는 각 브랜치에 대해 최신 버전만 반환합니다. 와 결합하여 특정 브랜치에 대한 최신를 `branchName` 가져올 수 있습니다. | 

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

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


| Field | 유형 | 설명 | 
| --- | --- | --- | 
|  `bundles`  | 목록 | 번들 요약 목록입니다. 각 에는 `bundleArn`, `bundleName`, `bundleId`및가 포함되어 있습니다`description`. | 
|  `nextToken`  | 문자열 | 다음 페이지의 페이지 매김 토큰입니다. 더 이상 결과가 없으면 없습니다. | 

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


| Field | 유형 | 설명 | 
| --- | --- | --- | 
|  `versions`  | 목록 | 버전 요약 목록입니다. 각 에는 `bundleArn`, `bundleId`, `lineageMetadata`, `versionId`및가 포함되어 있습니다`versionCreatedAt`. | 
|  `nextToken`  | 문자열 | 다음 페이지의 페이지 매김 토큰입니다. 더 이상 결과가 없으면 없습니다. | 

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


| 오류 | HTTP 상태 | 설명 | 
| --- | --- | --- | 
|  `ValidationException`  | 400 | 잘못된 요청 파라미터입니다. | 
|  `ResourceNotFoundException`  | 404 | 지정된 `bundleId`이 존재하지 않습니다(ListConfigurationBundleVersions만 해당). | 
|  `AccessDeniedException`  | 403 | 권한이 부족합니다. | 
|  `ThrottlingException`  | 429 | 요청 속도가 초과되었습니다. 지수 백오프를 사용하여 재시도하세요. | 
|  `InternalServerException`  | 500 | 서비스 측 오류입니다. 요청을 다시 시도하세요. |