

# 라이브 인벤토리 테이블 활성화 또는 비활성화
<a name="metadata-tables-enable-disable-inventory-tables"></a>

기본적으로 메타데이터 테이블 구성에는 버킷의 객체에 대해 발생하는 이벤트를 기록하는 *저널 테이블*이 포함되어 있습니다. 저널 테이블은 각 메타데이터 테이블 구성에 필요합니다.

선택적으로 메타데이터 테이블 구성에 *라이브 인벤토리 테이블*을 추가할 수 있습니다. 라이브 인벤토리 테이블은 버킷의 모든 객체와 해당 버전에 대한 간단하고 쿼리 가능한 인벤토리를 제공하므로 데이터의 최신 상태를 확인할 수 있습니다.

**참고**  
2025년 7월 15일 이전에 S3 Metadata 구성을 만든 경우 해당 구성에서 인벤토리 테이블을 활성화할 수 없습니다. 인벤토리 테이블을 만들고 저널 테이블 레코드를 만료시킬 수 있도록 구성을 삭제하고 다시 만드는 것이 좋습니다. 자세한 내용은 [2025년 7월 15일 이전에 만들어진 메타데이터 구성에 대한 인벤토리 테이블 활성화](metadata-tables-create-configuration.md#metadata-tables-migration) 섹션을 참조하세요.

인벤토리 테이블에는 버킷의 모든 객체에 대한 최신 메타데이터가 포함되어 있습니다. 이 표를 사용하여 다양한 워크로드에 대해 처리하려는 객체를 식별하여 비즈니스 워크플로와 빅 데이터 작업을 간소화하고 속도를 높일 수 있습니다. 예를 들어 인벤토리 테이블을 쿼리하여 다음을 수행할 수 있습니다.
+ S3 Glacier Deep Archive 스토리지 클래스에 저장된 모든 객체를 찾습니다.
+ 객체 태그 배포를 생성하거나 태그가 없는 객체를 찾습니다.
+ AWS Key Management Service(AWS KMS) 키를 사용한 서버 측 암호화(SSE-KMS)를 사용하여 암호화되지 않은 모든 객체를 찾습니다.
+ 서로 다른 두 시점의 인벤토리 테이블을 비교하여 특정 태그가 있는 객체의 증가를 파악합니다.

메타데이터 테이블 구성에 인벤토리 테이블을 활성화하도록 선택한 경우 테이블은 *채우기*라는 프로세스를 거치며,이 과정에서 Amazon S3는 범용 버킷을 스캔하여 버킷에 있는 모든 객체의 초기 메타데이터를 검색합니다. 버킷의 객체 수에 따라 이 프로세스는 몇 분(최소 15분)에서 몇 시간이 걸릴 수 있습니다. 채우기 프로세스가 완료되면 인벤토리 테이블의 상태가 **채우기**에서 **활성**으로 변경됩니다. 채우기가 완료되면 객체에 대한 업데이트는 일반적으로 1시간 이내에 인벤토리 테이블에 반영됩니다.

**참고**  
인벤토리 테이블 채우기에 대한 요금이 부과됩니다. 범용 버킷에 10억 개 이상의 객체가 있는 경우 인벤토리 테이블에 대한 월별 요금도 부과됩니다. 자세한 내용은 [Amazon S3 요금](https://aws.amazon.com/s3/pricing/)을 참조하세요.
인벤토리 테이블에 대한 업데이트를 일시 중지한 다음 재개할 수 없습니다. 그러나 인벤토리 테이블 구성을 비활성화할 수는 있습니다. 인벤토리 테이블을 비활성화해도 삭제되지는 않습니다. 인벤토리 테이블은 삭제하기로 결정할 때까지 레코드에 유지됩니다.  
인벤토리 테이블을 비활성화한 후 나중에 다시 활성화하려면 먼저 AWS 관리형 테이블 버킷에서 이전 인벤토리 테이블을 삭제해야 합니다. 인벤토리 테이블 구성을 다시 활성화하면 Amazon S3가 새 인벤토리 테이블을 만들고 새 인벤토리 테이블을 채우는 데 따른 요금이 다시 청구됩니다.

Amazon S3 콘솔, AWS Command Line Interface(AWS CLI), AWS SDK 또는 Amazon S3 REST API를 사용하여 인벤토리 테이블을 활성화 또는 비활성화할 수 있습니다.

**사전 조건**  
인벤토리 테이블을 비활성화한 후 다시 활성화하려면 먼저 AWS 관리형 테이블 버킷에서 이전 인벤토리 테이블을 수동으로 삭제해야 합니다. 그러지 않으면 인벤토리 테이블이 테이블 버킷에 이미 존재하기 때문에 인벤토리 테이블을 다시 활성화하지 못합니다. 인벤토리 테이블을 삭제하려면 [메타데이터 테이블 삭제](metadata-tables-delete-table.md#delete-metadata-table-procedure) 섹션을 참조하세요.

인벤토리 테이블 구성을 다시 활성화하면 Amazon S3가 새 인벤토리 테이블을 만들고 새 인벤토리 테이블을 채우는 데 따른 요금이 다시 청구됩니다.

## 인벤토리 테이블 활성화 또는 비활성화
<a name="metadata-tables-enable-disable-inventory-tables-procedure"></a>

### S3 콘솔 사용
<a name="metadata-tables-enable-disable-inventory-tables-console"></a>

**인벤토리 테이블 활성화 또는 비활성화**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **범용 버킷**을 선택합니다.

1. 인벤토리 테이블을 활성화하거나 비활성화하려는 메타데이터 테이블 구성이 있는 범용 버킷을 선택합니다.

1. 버킷의 세부 정보 페이지에서 **메타데이터** 탭을 선택합니다.

1. **메타데이터** 탭에서 **편집**을 선택한 다음 **인벤토리 테이블 구성 편집**을 선택합니다.

1. **인벤토리 테이블 구성 편집** 페이지의 **인벤토리 테이블**에서 **활성화됨** 또는 **비활성화됨**을 선택합니다.
**참고**  
**활성화됨**을 선택하기 전에 [사전 조건](#inventory-table-config-prereqs)을 검토하고 충족했는지 확인합니다.
   + **활성화됨**을 선택한 경우 AWS Key Management Service(AWS KMS) 키(SSE-KMS)를 사용한 서버 측 암호화로 테이블을 암호화할지 여부를 선택할 수 있습니다. 기본적으로 인벤토리 테이블은 Amazon S3 관리형 키를 사용한 서버 측 암호화(SSE-S3)를 사용하여 암호화됩니다.

     SSE-KMS를 사용하기로 선택한 경우 범용 버킷과 동일한 리전에 고객 관리형 KMS 키를 제공해야 합니다.
**중요**  
테이블을 만드는 중에만 메타데이터 테이블에 대한 암호화 유형을 설정할 수 있습니다. AWS 관리형 테이블이 만들어진 후에는 암호화 설정을 변경할 수 없습니다.
     + SSE-S3(기본값)로 인벤토리 테이블을 암호화하려면 **암호화 유형을 지정하지 않음**을 선택합니다.
     + SSE-KMS로 인벤토리 테이블을 암호화하려면 **암호화 유형 지정**을 선택합니다. **암호화 유형**에서 **AWS Key Management Service(AWS KMS) 키를 사용한 서버 측 암호화(SSE-KMS)**를 선택합니다. **AWS KMS 키**에서 기존 KMS 키 중에 선택하거나 KMS 키 ARN을 입력합니다. 아직 KMS 키가 없는 경우 **KMS 키 ARN 입력**을 선택한 다음 **KMS 키 생성**을 선택합니다.
   + **비활성화**를 선택한 경우 **인벤토리 테이블이 비활성화된 후 테이블이 더 이상 업데이트되지 않고 업데이트를 재개할 수 없음** 아래의 확인란을 선택합니다.

1. **변경 사항 저장**을 선택합니다.

### AWS CLI 사용
<a name="metadata-tables-enable-disable-inventory-tables-cli"></a>

다음 명령을 실행하려면 AWS CLI를 설치하고 구성해야 합니다. AWS CLI를 설치하지 않은 경우 *AWS Command Line Interface 사용 설명서*에서 [최신 버전의 AWS CLI 설치 또는 업데이트](https://docs.aws.amazon.com//cli/latest/userguide/getting-started-install.html)를 참조하세요.

또는 AWS CloudShell을 사용하여 콘솔에서 AWS CLI 명령을 실행할 수 있습니다. AWS CloudShell은 브라우저 기반의 사전 인증된 쉘로, AWS Management Console에서 직접 시작할 수 있습니다. 자세한 내용은 *AWS CloudShell 사용 설명서*에서 [CloudShell이란 무엇인가요?](https://docs.aws.amazon.com//cloudshell/latest/userguide/welcome.html) 및 [AWS CloudShell 시작하기](https://docs.aws.amazon.com//cloudshell/latest/userguide/getting-started.html)를 참조하세요.

**AWS CLI를 사용하여 인벤토리 테이블 활성화 또는 비활성화**

다음 예제 명령을 사용하려면 `user input placeholders`를 사용자의 정보로 대체하세요.
**참고**  
인벤토리 구성을 활성화하기 전에 [사전 조건](#inventory-table-config-prereqs)을 검토하고 충족했는지 확인합니다.

1. 인벤토리 테이블 구성이 포함된 JSON 파일을 만들고 저장합니다(예: `inventory-config.json`). 다음은 새 인벤토리 테이블을 활성화하기 위한 샘플 구성입니다.

   인벤토리 테이블을 활성화하는 경우 선택적으로 암호화 구성을 지정할 수 있습니다. 기본적으로 메타데이터 테이블은 `SseAlgorithm`을 `AES256`으로 설정하여 지정할 수 있는 Amazon S3 관리형 키를 사용한 서버 측 암호화(SSE-S3)로 암호화됩니다.

   AWS Key Management Service(AWS KMS) 키를 사용한 서버 측 암호화(SSE-KMS)로 인벤토리 테이블을 암호화하려면 `SseAlgorithm`을 `aws:kms`로 설정합니다. 또한 범용 버킷이 위치한 동일한 리전에서 고객 관리형 KMS 키의 ARN으로 `KmsKeyArn`을 설정해야 합니다.

   ```
   {
     "ConfigurationState": "ENABLED",
     "EncryptionConfiguration": {       
       "SseAlgorithm": "aws:kms",
       "KmsKeyArn": "arn:aws:kms:us-east-2:account-id:key/key-id"
     }  
   }
   ```

   기존 인벤토리 테이블을 비활성화하려면 다음 구성을 사용합니다.

   ```
   {
     "ConfigurationState": "DISABLED"  }  
   }
   ```

1. 다음 명령을 사용하여 인벤토리 테이블 구성을 범용 버킷에 업데이트합니다(예: `amzn-s3-demo-bucket`).

   ```
   aws s3api update-bucket-metadata-inventory-table-configuration \
   --bucket amzn-s3-demo-source-bucket \
   --inventory-table-configuration file://./inventory-config.json \
   --region us-east-2
   ```

### REST API 사용
<a name="metadata-tables-enable-disable-inventory-tables-rest-api"></a>

REST 요청을 전송하여 인벤토리 테이블을 활성화하거나 비활성화할 수 있습니다. [자세한 내용은 UpdateBucketMetadataInventoryTableConfiguration 단원을 참조하세요.](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataInventoryTableConfiguration.html)

### AWS SDK 사용
<a name="metadata-tables-enable-disable-inventory-tables-sdk"></a>

AWS SDK를 사용하여 Amazon S3에서 인벤토리 테이블을 활성화하거나 비활성화할 수 있습니다. 자세한 내용은 [지원되는 SDK 목록](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataInventoryTableConfiguration.html#API_UpdateBucketMetadataInventoryTableConfiguration_SeeAlso)을 참조하세요.