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

# 런타임 인스턴스에서 데이터 관리
<a name="runtime-instances-data-management"></a>

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

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

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

## 인스턴스가 저장하는 항목 및 위치
<a name="runtime-instances-data-management-what"></a>

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


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

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

## 데이터 읽기 및 변경
<a name="runtime-instances-data-management-read-change"></a>

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


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

## 데이터 내보내기
<a name="runtime-instances-data-management-export"></a>

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

볼륨 콘텐츠를 가져오려면 Amazon S3 버킷과 같이 제어하는 대상에 기록합니다. 두 가지 방법으로이 작업을 수행할 수 있습니다.
+ 를 사용하여 세션에서 명령을 실행합니다`InvokeAgentRuntimeCommand`. 자세한 내용은 [ AgentCore 런타임 세션에서 셸 명령 실행](runtime-execute-command.md)을 참조하세요.
+ 에이전트를 호출하여 데이터를 복사하거나 응답에 반환하도록 합니다.

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

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

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

## 데이터 삭제
<a name="runtime-instances-data-management-delete"></a>

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

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

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


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

유휴 및 수명 주기 설정에 대한 자세한 내용은 [Amazon Bedrock AgentCore 수명 주기 설정 구성을](runtime-lifecycle-settings.md) 참조하세요.

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

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

작업 및 예제에 대한 자세한 내용은 [AWS CLI 또는 SDK를 사용하여 인스턴스 시작하기를 참조하세요](runtime-instances-get-started-cli.md). 콘솔 단계에 대한 자세한 내용은 [콘솔을 사용하여 인스턴스 시작하기를 참조하세요](runtime-instances-get-started-console.md).