View a markdown version of this page

구성 번들 삭제 - Amazon Bedrock AgentCore
코드 샘플요청 파라미터응답삭제 동작오류

구성 번들 삭제

구성 번들과 모든 버전을 삭제합니다. 삭제는 비동기식입니다. API는 DELETING 즉시 상태와 함께를 반환하고 서비스는 백그라운드에서 번들과 해당 버전 기록을 제거합니다.

활성 A/B 테스트에서 참조하는 번들은 삭제할 수 없습니다. 먼저 A/B 테스트를 중지합니다.

코드 샘플

예
AgentCore CLI

프로젝트 구성에서 번들을 제거한 다음를 배포하여 삭제를 전파합니다.

agentcore remove config-bundle

agentcore deploy

CLI에 제거할 번들을 선택하라는 메시지가 표시됩니다.

특정 번들을 비대화식으로 제거하려면(예: 스크립트에서)를 사용하여 번들 이름을 전달--name하고를 사용하여 확인 프롬프트를 건너뜁니다. -y 

agentcore remove config-bundle --name MyBundle -y

agentcore deploy
AWS SDK (boto3)
import boto3

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

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

print(f"Bundle ID: {response['bundleId']}")
print(f"Status: {response['status']}")  # DELETING

요청 파라미터

파라미터 유형 필수 설명

bundleId

문자열

예

삭제할 구성 번들의 ID입니다. 경로 파라미터로 전달됩니다.

응답

API는 HTTP 202(승인됨)를 반환하여 삭제가 대기열에 있음을 나타냅니다.

Field 유형 설명

bundleId

문자열

삭제 중인 번들의 ID입니다.

status

문자열

번들의 상태입니다. DELETING을 반환합니다.

삭제 동작

  • 작업은 멱등성입니다. 이미 삭제 중인 번들에서 삭제를 호출하면 오류 없이 동일한 응답이 반환됩니다.

  • 모든 브랜치의 모든 버전은 번들과 함께 삭제됩니다.

  • 삭제가 완료되면 번들 ID와 이름을 재사용할 수 있게 됩니다.

  • 번들이 활성 A/B 테스트에서 참조되는 경우에서 삭제가 실패합니다ConflictException. 먼저 A/B 테스트를 중지합니다.

오류

오류 HTTP 상태 설명

ValidationException

400

잘못된 요청 파라미터입니다.

ResourceNotFoundException

404

지정된 bundleId이 존재하지 않습니다.

ConflictException

409

번들이 다른 리소스(예: 활성 A/B 테스트)에서 사용 중이므로 삭제할 수 없습니다.

AccessDeniedException

403

권한이 부족합니다. IAM 정책에가 포함되어 있는지 확인합니다bedrock-agentcore:DeleteConfigurationBundle.

ThrottlingException

429

요청 속도가 초과되었습니다. 지수 백오프를 사용하여 재시도하세요.

InternalServerException

500

서비스 측 오류입니다. 요청을 다시 시도하세요.