런타임 인스턴스에서 데이터 관리

인스턴스 컴퓨팅 유형에서 에이전트를 호스팅하면 데이터가 자체 AWS 계정의 Amazon EBS 볼륨에 저장됩니다.

이 주제에서는 AgentCore에 저장하는 항목과 이를 읽고, 변경하고, 내보내고, 삭제하는 방법을 설명합니다.

모든 Amazon Bedrock AgentCore에 적용되는 공동 책임 모델에 대한 자세한 내용은 Amazon Bedrock AgentCore의 데이터 보호를 참조하세요.

인스턴스가 저장하는 항목 및 위치

인스턴스는 두 가지 범주의 데이터를 저장합니다. 다음 표에는 각 범주의 거주지와 수명 주기를 제어하는 리소스가 나와 있습니다.

카테고리	저장 위치	수명 주기는에 의해 제어됩니다.
볼륨 콘텐츠	AgentCore가 AWS 계정에서 생성하고 에이전트에 탑재하는 Amazon Elastic Block Store(Amazon EBS) 볼륨	볼륨을 탑재하는 세션
리소스 구성	이름, 설명, 허용된 인스턴스 유형, 네트워킹 및 스토리지 정의를 포함한 용량 공급자 및 에이전트 런타임 레코드	용량 공급자 및 에이전트 런타임

볼륨 콘텐츠는 에이전트가 탑재 경로에서 읽고 쓰는 내용입니다. Amazon EBS 볼륨은 계정에 생성되므로 기존 계정 컨트롤이 해당 볼륨에 적용됩니다. 볼륨 암호화 방법에 대한 자세한 내용은 런타임 인스턴스의 유휴 시 암호화를 참조하세요.

에이전트는 탑재 경로에서 볼륨 콘텐츠를 읽고 쓰므로 해당 콘텐츠를 생성한 것과 동일한 방식으로 변경합니다. 다음 표에는 다른 모든 작업에 대한 작업을 찾을 수 있는 위치가 나와 있습니다.

목적	다음을 참조하십시오.
에이전트 외부에서 볼륨 콘텐츠 읽기 또는 변경	AgentCore 런타임 세션에서 셸 명령을 실행합니다.는 에이전트가 보는 것과 동일한 파일 시스템을 사용하여 실행 중인 세션에서 셸 명령을 `InvokeAgentRuntimeCommand` 실행합니다.
세션을 지원하는 인스턴스 및 볼륨 찾기	Amazon EC2 관리형 인스턴스. AgentCore는 기본적으로 목록 작업 및 Amazon EC2 콘솔 보기에서 숨겨지는 관리형 인스턴스로 프로비저닝합니다. `describe-instances --include-managed-resources`를 사용하여 나열하거나 관리형 리소스 가시성 설정을 변경합니다.
탑재 경로 및 스토리지 설정 보기	AgentCore 런타임에 대한 파일 시스템 구성
용량 공급자 구성 보기	`GetCapacityProvider` 및 `ListCapacityProviders`. 에이전트 런타임을 사용하는 에이전트 런타임을 찾으려면를 사용합니다`ListAgentRuntimeVersionsByCapacityProvider`.
용량 공급자 구성 변경	를 통해 설명만 변경할 수 있습니다`UpdateCapacityProvider`. 다른 설정의 경우 새 용량 공급자를 생성하고 에이전트 런타임을이 공급자와 연결합니다. 콘솔에서 중복 흐름을 사용하여 기존 구성에서 시작합니다.
지표 및 로그 보기	콘솔의 런타임 세부 정보 페이지에서 관찰성 또는 관찰성 및 로그 및 추적

볼륨 콘텐츠에 대한 내보내기 작업은 없으며 용량 공급자 볼륨의 Amazon EBS 스냅샷을 생성할 수 없습니다. AgentCore는 이러한 볼륨을 관리형 리소스로 생성하고 운영하므로 직접 생성한 볼륨에서 사용하는 스냅샷 작업은 해당 볼륨에서 사용할 수 없습니다.

볼륨 콘텐츠를 가져오려면 Amazon S3 버킷과 같이 제어하는 대상에 기록합니다. 두 가지 방법으로이 작업을 수행할 수 있습니다.

를 사용하여 세션에서 명령을 실행합니다InvokeAgentRuntimeCommand. 자세한 내용은 AgentCore 런타임 세션에서 셸 명령 실행을 참조하세요.
에이전트를 호출하여 데이터를 복사하거나 응답에 반환하도록 합니다.

어느 쪽이든 복사는 에이전트 런타임 실행 역할과 함께 실행되므로 해당 역할에 대상에 대한 쓰기 액세스 권한을 부여합니다. 역할에 대한 자세한 내용은 AWS Identity and Access Management(IAM) 역할을 참조하세요.

세션 또는 용량 공급자를 삭제하기 전에 유지하려는 내용을 내보냅니다. 둘 중 하나를 삭제하면 볼륨이 삭제됩니다.

용량 공급자 구성을 내보내려면를 호출GetCapacityProvider하고 응답을 저장합니다.

볼륨 콘텐츠 삭제는 개별 에이전트가 아닌 세션의 속성입니다. 세션에서 한 에이전트 런타임을 중지해도 데이터가 삭제되지 않으며 인스턴스가 종료되지 않습니다.

영구 볼륨만 세션 중지를 통해 데이터를 보관합니다. 루트 볼륨과 임시 볼륨은 인스턴스가 종료될 때 사라지므로 에이전트가 영구 탑재 경로 외부에 쓰는 모든 것은 일시적입니다. 볼륨 유형에 대한 자세한 내용은 런타임 인스턴스의 저장 데이터 암호화를 참조하세요.

영구 볼륨은 명시적 삭제를 제외한 모든 이벤트에서 유지됩니다. 다음 표에는 각 이벤트가 수행하는 작업이 나와 있습니다.

Event	중지 대상	영구 볼륨은 어떻게 되나요?
`StopRuntimeSession`	세션 내 에이전트 런타임 1개. 세션의 다른 에이전트 런타임은 영향을 받지 않습니다.	보관됨. AgentCore는 볼륨을 세션에 연결된 상태로 유지합니다.
유휴 제한 시간	모든 에이전트가 `idleInstanceTimeout` 초 동안 유휴 상태가 된 후의 인스턴스입니다.	보관됨. 세션을 다시 호출하면 AgentCore가 볼륨을 다시 연결합니다.
최대 수명에 도달함	에서 활동에 관계없이 인스턴스입니다`maxLifetime`.	보관됨. 세션을 다시 호출하면 AgentCore가 볼륨을 다시 연결합니다.
`DeleteCapacityProviderSession`	Amazon EC2 인스턴스 및 네트워크 인터페이스를 포함한 전체 세션입니다.	삭제되었습니다. AgentCore는 세션의 영구 볼륨을 삭제합니다.
`DeleteCapacityProvider`	용량 공급자 및 모든 세션.	삭제되었습니다. AgentCore는 용량 공급자에 속하는 모든 세션의 볼륨을 삭제합니다.

유휴 및 수명 주기 설정에 대한 자세한 내용은 Amazon Bedrock AgentCore 수명 주기 설정 구성을 참조하세요.

세션을 삭제하려면 세션을 호출할 때 제공한 runtimeSessionId가 필요합니다. 사용하는 세션 IDs해 둡니다. 더 이상 없는 경우 용량 공급자를 삭제하여 모든 세션과 볼륨을 삭제합니다.

용량 공급자를 삭제하려면 먼저 연결된 런타임, 버전 또는 엔드포인트를 삭제하여 용량 공급자를 참조하는 에이전트 런타임을 제거합니다. 그렇지 않으면에서 요청이 실패합니다ValidationException.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

저장 시 암호화

리소스 기반 정책