

# S3 객체 Lambda에 대한 모범 사례 및 지침
<a name="olap-best-practices"></a>

**참고**  
2025년 11월 7일부터 S3 Object Lambda는 현재 서비스를 사용하고 있는 기존 고객과 AWS 파트너 네트워크(APN) 파트너를 선택하는 고객만 사용할 수 있습니다. S3 Object Lambda와 유사한 기능의 경우 [Amazon S3 Object Lambda 가용성 변경](https://docs.aws.amazon.com/AmazonS3/latest/userguide/amazons3-ol-change.html) 섹션에서 자세히 알아보세요.

S3 객체 Lambda를 사용하는 경우 다음 모범 사례 및 지침에 따라 작업 및 성능을 최적화하십시오.

**Topics**
+ [S3 객체 Lambda 작업](#olap-working-with)
+ [S3 객체 Lambda와 관련하여 사용되는 AWS 서비스](#olap-services)
+ [`Range` 및 `partNumber` 헤더](#olap-managing-range-part)
+ [`expiry-date` 변환](#olap-console-download)
+ [AWS CLI 및 AWS SDK 작업](#olap-cli-sdk)

## S3 객체 Lambda 작업
<a name="olap-working-with"></a>

S3 객체 Lambda는 `GET`, `LIST`, `HEAD` 요청 처리만 지원합니다. 다른 요청은 AWS Lambda을 반환하지 않고 변환되지 않은 표준 API 응답을 반환합니다. AWS 계정에 대해 리전당 최대 1,000개의 객체 Lambda 액세스 포인트를 생성할 수 있습니다. 사용하는 AWS Lambda 함수는 객체 Lambda 액세스 포인트와 동일한 AWS 계정 및 리전에 있어야 합니다.

S3 객체 Lambda는 최대 60초 동안 호출자에게 전체 응답을 스트리밍할 수 있습니다. 함수에는 AWS Lambda 기본 할당량도 적용됩니다. 자세한 내용은 *AWS Lambda 개발자 안내서*에서 [Lambda 할당량](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html)을 참조하십시오.

S3 객체 Lambda가 지정된 Lambda 함수를 호출할 때 지정된 Lambda 함수 또는 애플리케이션에 의해 Amazon S3에서 덮어쓰거나 삭제되는 데이터가 의도된 것이고 올바른지 확인할 책임은 사용자에게 있습니다.

S3 객체 Lambda는 객체에 대한 작업을 수행하는 데만 사용할 수 있습니다. S3 객체 Lambda를 사용하여 버킷 수정 또는 삭제와 같은 다른 Amazon S3 작업을 수행할 수 없습니다. 액세스 포인트를 지원하는 전체 S3 작업 목록은 [S3 작업과의 액세스 포인트 호환성](access-points-service-api-support.md#access-points-operations-support) 섹션을 참조하세요.

이 목록 외에도 Object Lambda 액세스 포인트는 [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html), [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html)(소스) 및 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_SelectObjectContent.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_SelectObjectContent.html) API 작업을 지원하지 않습니다.

## S3 객체 Lambda와 관련하여 사용되는 AWS 서비스
<a name="olap-services"></a>

S3 객체 Lambda는 Amazon S3, AWS Lambda, 선택적으로 원하는 다른 AWS 서비스를 연결하여 요청 애플리케이션과 관련된 객체를 전달합니다. S3 객체 Lambda와 함께 사용되는 모든 AWS 서비스는 각 서비스 수준에 관한 계약(SLA)에 따라 규제됩니다. 예를 들어, 한 AWS 서비스가 서비스 약정을 충족하지 못하는 경우 해당 서비스의 SLA에 명시된 서비스 크레딧을 받을 수 있습니다.

## `Range` 및 `partNumber` 헤더
<a name="olap-managing-range-part"></a>

대용량 객체로 작업하는 경우 `Range` HTTP 헤더를 사용하면 객체에서 지정된 바이트 범위를 다운로드할 수 있습니다. `Range` 헤더를 사용하는 경우 요청은 객체의 지정된 부분만 가져옵니다. `partNumber` 헤더를 사용하여 객체에서 지정된 부분에 대해 범위가 지정된 요청을 수행할 수도 있습니다.

자세한 내용은 [Range 및 partNumber 헤더 작업](range-get-olap.md) 섹션을 참조하세요.

## `expiry-date` 변환
<a name="olap-console-download"></a>

AWS Management Console의 객체 Lambda 액세스 포인트에서 변환된 객체를 열거나 다운로드할 수 있습니다. 이러한 객체는 만료되지 않은 상태여야 합니다. Lambda 함수가 객체의 `expiry-date`를 변환하는 경우 열거나 다운로드할 수 없는 만료된 객체를 볼 수 있습니다. 이 동작은 S3 Glacier Deep Retrieval 및 S3 Glacier Deep Archive 복원된 객체에만 적용됩니다.

## AWS CLI 및 AWS SDK 작업
<a name="olap-cli-sdk"></a>

AWS Command Line Interface(AWS CLI) S3 하위 명령(`cp`, `mv`, `sync`) 및 AWS SDK for Java `TransferManager` 클래스 사용은 S3 객체 Lambda와 함께 사용할 수 없습니다.