기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 데이터 보존
## 개요
Amazon Bedrock을 사용하면 프롬프트와 출력이 추론 요청에서 유지되는지 여부를 명시적으로 제어할 수 있습니다. 계정 또는 프로젝트 수준에서 데이터 보존을 구성할 수 있으며 설정은 메시지, 채팅 완료 및 응답 APIs에서 일관되게 적용됩니다.
데이터 보존 구성은 사용자가 관리할 수 있습니다. 계정 또는 프로젝트가 제로 데이터 보존(`data_retention_mode: none`)으로 구성되어 있고 보존이 필요한 모델을 호출하는 경우 Amazon Bedrock은 요청을 차단하고 오류를 반환합니다. 사용자는 항상 보존 정책을 제어합니다.
**중요**
Claude Fable 5 이전에 릴리스된 모델에 대한 데이터 보존 변경은 없습니다. AWS는 사용자가 데이터를 보관 및 공유하는 시기와 대상을 완전히 제어할 수 있도록 최선을 다합니다.
## 데이터 보존 모드
데이터 보존은 간단한 켜기/끄기 토글이 아닌 **모드로** 제어됩니다.
| **Mode(모드)** | **동작** |
| --- | --- |
| default | 기본값은 모델의 데이터 보존 정책이 적용됨을 의미합니다. 이전 모델 보존 동작은 변경되지 않습니다. 이전에 ZDR을 적용한 경우에도 ZDR이 계속 적용됩니다. 실제 보존은 모델에 따라 다릅니다. specifics는 모델의 조건을 참조하세요. 안전 및 남용 방지를 위해 데이터를 보존할 AWS 수 있습니다. 모델 공급자는 이를 수신하지 않습니다. 응답 API에서 기본`store`값은 `true` 이고는 두 값 중 하나로 설정될 수 있습니다.를 설정`store=false`해도 데이터 보존이 보장되지 않습니다. 일부 모델은 안전 검토를 위해 데이터를 보존할 수 있습니다. `store=false`이 경우 데이터는 보존되지만를 통해 고객이 검색할 수 없습니다`GET /v1/responses/{id}`. 제로 보존을 보장해야 하는 경우를 `data_retention_mode`로 설정합니다`none`. |
| provider\_data\_share | 이 모드를 사용하면 Amazon Bedrock이 요구 사항에 따라 추론 데이터를 유지하고 모델 공급자와 공유할 수 있습니다. 특정 모델에 액세스하려면 필요합니다. [Amazon Bedrock 침해 탐지](https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html) 및 [AWS 서비스 약관을](https://aws.amazon.com/service-terms/) 참조하세요. |
| none | 데이터 보존이 없습니다. 요청 또는 응답 데이터는 모델 공급자에 의해 내구성 있는 스토리지에 기록 AWS 되거나 모델 공급자와 공유되지 않습니다. 응답 API에서 기본store값은 false 이고 store=true는 거부됩니다. 배경 모드를 사용할 수 없습니다. 채팅 완료 및 메시지 요청은 유지되지 않습니다. |
| inherit | 이 범위에 의견 없음 - 더 넓은 범위로 연기합니다. 새 계정 및 프로젝트의 기본값입니다. |
**중요**
계정 또는 프로젝트를 로 구성한다고 `provider_data_share` 해서 모든 모델이 공급자와 데이터 공유를 시작하는 것은 *아닙니다*. 구성된 모드는 사용자가 허용하는 것을 설정합니다. 각 모델은를 통해 지원하는 모드를 독립적으로 선언합니다`allowed_modes`. 현재 대부분의 모델은를 요구하거나 요청하지 않습니다`provider_data_share`. 상호 작용은 다음과 같이 작동합니다.
모델의에가 `allowed_modes` 포함된 경우 아무것도 유지되지 `none`않습니다.
모델의에가 `allowed_modes` 포함되지`default`만 그렇지 않은 경우는 데이터를 `none` AWS 유지합니다. 모델 공급자는 데이터를 수신하지 않습니다.
모델의 유일한 허용 모드가 인 경우 유효 모드에서 허용하는 경우에만 `provider_data_share`데이터가 공급자와 공유됩니다. 유효 모드가 `none` 또는 인 경우 `default`모델을 사용할 수 없는 것으로 표시됩니다.
## 보존 모드 결정 방법
데이터 보존은 두 가지 범위로 구성되며 모델의 기본값은 대체입니다.
+ **프로젝트**(가장 구체적) -를 통해 설정 `POST /v1/organization/projects/{project_id}`
+ **계정** -를 통해 설정 `PUT /v1/data_retention`
+ **모델 기본값**(최소 특정, 읽기 전용) - 모델의 기본 제공 기본값
모든 요청에 대한 유효 모드는 값이가 아닌 첫 번째 범위를 가져와서 결정됩니다. `inherit`
```
effective mode = first non-inherit value of (project → account → model default)
```
예를 들어 프로젝트가 로 설정`inherit`되고 계정이 로 설정된 경우 `none`유효 모드는 해당 프로젝트에서 호출된 모든 모델에 `none` 적용됩니다.
## 데이터 보존 구성
### 계정 전체의 데이터 보존 설정
```
curl -X PUT https://bedrock-mantle.us-east-1.api.aws/v1/data_retention \
-H "x-api-key: $BEDROCK_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "mode": "provider_data_share" }'
```
**응답**:
```
{
"mode": "provider_data_share",
"updated_at": 1733529600
}
```
**Bedrock 컨트롤 플레인:**
```
curl -X PUT https://bedrock.us-east-1.amazonaws.com/data-retention \
-H "Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK" \
-H "Content-Type: application/json" \
-d '{ "mode": "provider_data_share" }'
```
**응답**:
```
{
"mode": "provider_data_share",
"updated_at": "2026-06-07T20:19:44.723Z"
}
```
### 프로젝트 수준 데이터 보존 설정
```
curl https://bedrock-mantle.us-east-1.api.aws/v1/organization/projects/proj_abc123 \
-H "x-api-key: $BEDROCK_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "data_retention": { "mode": "provider_data_share" } }'
```
### 현재 구성 확인
```
# Account level
curl https://bedrock-mantle.us-east-1.api.aws/v1/data_retention \
-H "x-api-key: $BEDROCK_API_KEY"
# Project level
curl https://bedrock-mantle.us-east-1.api.aws/v1/organization/projects/proj_abc123 \
-H "x-api-key: $BEDROCK_API_KEY"
```
**Bedrock 컨트롤 플레인:**
```
# Account level
curl https://bedrock.us-east-1.amazonaws.com/data-retention \
-H "Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK"
```
### 모델의 유효 모드 및 허용 모드 확인
```
curl https://bedrock-mantle.us-east-1.api.aws/v1/models/anthropic.claude-fable-5 \
-H "x-api-key: $BEDROCK_API_KEY"
```
**응답**:
```
{
"id": "anthropic.claude-fable-5",
"created": 1733443200,
"owned_by": "system",
"status": "available",
"data_retention": {
"mode": "provider_data_share",
"source": "account",
"allowed_modes": ["provider_data_share"]
}
}
```
## 모델 가용성 및 데이터 보존
각 모델은를 통해 허용되는 보존 모드를 지정합니다`allowed_modes`. 유효 모드가 모델의에 없는 경우 `allowed_modes`모델 목록에 모델이 `status: "unavailable"` 로 표시되고 모델에 대한 요청이 차단됩니다.
**예:** Claude Fable 5 및 Claude Mythos 5에는 공급자 데이터 공유()가 필요합니다`allowed_modes: ["provider_data_share"]`. 고객은 이러한 모델을 호출하기 `provider_data_share` 전에 데이터 보존 모드를 로 명시적으로 설정해야 합니다. 유효 모드가 `none` 또는 인 경우 `default`이러한 모델을 사용할 수 없습니다.
를 설정하면 요구 사항에 따라 모델 공급자와 데이터를 유지하고 공유하도록 지시하는 `provider_data_share`것을 명시적으로 승인하는 것입니다. 특정 모델에 액세스하려면 필요합니다. [남용 감지 페이지](https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html) 및 [AWS 서비스 약관을](https://aws.amazon.com/service-terms/) 참조하세요.
**참고**
시작 시 데이터 보존을 구성하기 위한 콘솔 UI가 없습니다. 고객은 API(위의 "데이터 보존 구성" 참조) 또는 Bedrock SDK를 사용해야 합니다.
**보존 정책으로 인해 모델을 사용할 수 없는 경우의 응답:**
```
{
"id": "anthropic.claude-fable-5",
"created": 1733443200,
"owned_by": "system",
"status": "unavailable",
"status_reason": "This model is not available under data retention mode 'default'.",
"data_retention": {
"mode": "default",
"source": "account",
"allowed_modes": ["provider_data_share"]
}
}
```
### 옵트인 방법
계정에서 Claude Fable 5 및 Claude Mythos 5를 활성화하려면:
```
curl https://bedrock-mantle.us-east-1.api.aws/v1/data_retention \
-H "x-api-key: $BEDROCK_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "mode": "provider_data_share" }'
```
또는 프로젝트 수준에서(공급자 데이터 공유를 특정 프로젝트로 제한하려는 경우):
```
curl https://bedrock-mantle.us-east-1.api.aws/v1/organization/projects/proj_abc123 \
-H "x-api-key: $BEDROCK_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "data_retention": { "mode": "provider_data_share" } }'
```
**혼합 모델 프로젝트**
프로젝트를 로 설정한다고 `provider_data_share`해서 해당 프로젝트의 모든 모델 트래픽이 모델 공급자와 공유되는 것은 아닙니다. 각 모델의는 데이터에 실제로 어떤 일이 발생하는지 `allowed_modes` 결정합니다.
`allowed_modes`가 인 모델`["provider_data_share"]`(예: Claude Fable 5) - 데이터는 보관되고 공급자와 공유됩니다.
`allowed_modes`가 인 모델`["default", "provider_data_share"]`(예: Claude Opus 4.8) - 데이터는 AWS에서만 보존됩니다. 모델은 `provider_data_share`를 유효한 모드로 허용하지만 AWS 경계를 벗어나는 데 데이터가 필요하지 않습니다.
안전 분류자가 Claude Fable 5 요청을 거부하고 Claude Opus 4.8에서 폴백 크레딧을 사용하는 경우 폴백 호출은 Fable 5가 아닌 Opus 4.8의 데이터 처리 규칙을 따릅니다. Opus 4.8 응답은 유지되거나 Anthropic과 공유되지 않습니다.
## 제로 데이터 보존(ZDR) 액세스
일부 모델은 안전 및 남용 방지를 위해 데이터 보존이 필요합니다. 규정 준수 이유로 조직에서 데이터 보존이 필요 없고 이러한 모델에 액세스해야 하는 경우 AWS 계정 관리자에게 문의하여 자격을 논의하세요. ZDR 액세스는 모델 공급자와 협력하여 계정별, 모델별로 평가됩니다.
특정 모델에서 ZDR에 대해 승인된 계정은 해당 모델의에 `"none"` 포함됩니다`allowed_modes`.
## IAM을 사용하여 보존 정책 적용
IAM 정책 또는 서비스 제어 정책(SCPs. 쓰기 작업은 설정할 수 있는 모드를 제한할 수 있는 `bedrock-mantle:DataRetentionMode` 조건 키를 게시합니다.
**예제 SCP - 조직 전체에서 제로 데이터 보존 필요:**
```
{
"Effect": "Deny",
"Action": [
"bedrock-mantle:PutAccountDataRetention",
"bedrock-mantle:CreateProject",
"bedrock-mantle:UpdateProject"
],
"Condition": {
"StringNotEquals": {
"bedrock-mantle:DataRetentionMode": "none"
}
}
}
```
**Bedrock 컨트롤 플레인:**
```
{
"Effect": "Deny",
"Action": [
"bedrock:PutAccountDataRetention"
],
"Condition": {
"StringNotEquals": {
"bedrock:DataRetentionMode": "none"
}
}
}
```
이렇게 하면 조직의 모든 사용자가 데이터 보존을 이외의 다른 것으로 설정하여 추론 데이터가 보존되지 `none`않도록 할 수 있습니다.
## 보존되는 데이터 및 기간
`provider_data_share` (현재 Claude Mythos 5 및 Claude Fable 5)가 필요한 모델의 경우: 사용자 프롬프트 및 완료는 Anthropic과 공유되며 신뢰 및 안전을 위해 최대 30일 동안 보관됩니다.
`default` 모드에 있는 모델의 경우: 남용 탐지를 위해 데이터가 보존될 수 있습니다. 필요한 보존 세부 정보는 [Amazon Bedrock 남용 탐지](https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html)를 참조하세요. 남용 탐지 이후 보존(예:를 사용한 응답 API`store=true`)은 모델의 설명서 및 용어를 참조하세요.
이러한 모델에 대해 교차 리전 추론이 활성화된 경우 보존된 입력 및 출력은 대상 리전(예: 추론 요청이 처리되는 리전)에 저장됩니다.
모델별 데이터 처리 세부 정보는 [Anthropic 서비스 약관을](https://aws.amazon.com/legal/bedrock/third-party-models/) 참조하세요.
## IAM 작업 참조
| **경로** | **IAM 작업** |
| --- | --- |
| GET /v1/models | bedrock-mantle:ListModels |
| GET /v1/models/{model} | bedrock-mantle:GetModel |
| GET /v1/data\_retention | bedrock-mantle:GetAccountDataRetention |
| PUT /v1/data\_retention | bedrock-mantle:PutAccountDataRetention |
| GET /v1/organization/projects/{project\_id} | bedrock-mantle:GetProject |
| POST /v1/organization/projects/{project\_id} | bedrock-mantle:UpdateProject |
| **경로** | **IAM 작업** |
| --- | --- |
| GET /data-retention | bedrock:GetAccountDataRetention |
| PUT /data-retention | bedrock:PutAccountDataRetention |