함수에 계층 추가 - AWS Lambda
계층 정보 찾기

함수에 계층 추가

Lambda 계층은 추가 코드 또는 데이터를 포함하는 .zip 파일 아카이브입니다. 계층에는 일반적으로 라이브러리 종속 항목, 사용자 지정 런타임 또는 구성 파일이 포함됩니다.

이 섹션에서는 Lambda 함수에 계층을 추가하는 방법을 설명합니다. 계층에 대한 개념 정보와 계층 사용을 고려하는 이유에 대한 자세한 내용은 계층으로 Lambda 종속성 관리 섹션을 참조하세요.

계층을 사용하도록 Lambda 함수를 구성하려면 먼저 다음을 수행해야 합니다.

Lambda 함수에 최대 5개의 계층을 추가할 수 있습니다. 함수 및 모든 계층의 압축되지 않은 총 크기는 압축 해제된 배포 패키지 크기 할당량인 250MB를 초과할 수 없습니다. 자세한 내용은 Lambda 할당량 섹션을 참조하세요.

함수는 이미 추가한 모든 계층 버전을 계속 사용할 수 있습니다. 이는 해당 계층 버전이 삭제되거나 계층 액세스 권한이 취소된 후에도 마찬가지입니다. 그러나 삭제된 계층 버전을 사용하는 새 함수는 작성할 수 없습니다.

함수에 계층을 추가하려면 다음을 수행하세요.

  1. Lambda 콘솔의 함수 페이지를 엽니다.

  2. 함수를 선택합니다.

  3. 아래로 스크롤하여 계층 섹션으로 이동하고 계층 추가를 선택하세요.

  4. 계층 선택에서 계층 소스를 선택합니다.

    1. AWS 계층: AWS 관리형 확장 목록에서 선택합니다.

    2. 사용자 지정 계층: AWS 계정에서 생성된 계층을 선택합니다.

    3. ARN 지정: 타사 확장 등의 다른 AWS 계정의 계층을 사용하려면 Amazon 리소스 이름(ARN)을 입력합니다.

  5. 추가를 선택합니다.

계층을 추가하는 순서에 따라 나중에 Lambda가 계층 콘텐츠를 실행 환경에 병합하는 순서가 결정됩니다. 콘솔을 사용하여 계층 병합 순서를 변경할 수 있습니다.

함수의 계층 병합 순서 업데이트(콘솔)

  1. Lambda 콘솔의 함수 페이지를 엽니다.

  2. 구성할 함수를 선택합니다.

  3. [계층(Layers)]에서 [편집(Edit)]을 선택합니다.

  4. 계층 중 하나를 선택합니다.

  5. [앞에 병합(Merge earlier)] 또는 [뒤에 병합(Merge later)]을 선택하여 계층의 순서를 조정합니다.

  6. 저장을 선택합니다.

계층의 버전이 지정됩니다. 각 계층 버전의 콘텐츠는 변경할 수 없습니다. 계층의 소유자는 새 계층 버전을 릴리스하여 업데이트된 콘텐츠를 제공할 수 있습니다. 콘솔을 사용하여 함수에 연결된 계층 버전을 업데이트할 수 있습니다.

함수의 계층 버전 업데이트(콘솔)

  1. Lambda 콘솔의 계층 페이지를 엽니다.

  2. 버전을 업데이트하려는 계층을 선택합니다.

  3. 이 버전을 사용하는 함수 탭을 선택합니다.

  4. 수정하려는 함수를 선택하고 편집을 선택합니다.

  5. 계층 버전에서 변경할 계층 버전을 선택합니다.

  6. 함수 업데이트(Update functions)를 선택합니다.

여러 AWS 계정에 걸쳐 함수의 계층 버전을 업데이트할 수 없습니다.

계층 정보 찾기

계정에서 함수의 런타임과 호환되는 계층을 찾으려면 ListLayers API를 사용하세요. 예를 들어, 다음 list-layers AWS Command Line Interface(CLI) 명령을 사용할 수 있습니다.

aws lambda list-layers --compatible-runtime python3.13

다음과 유사한 출력 화면이 표시되어야 합니다.

{
    "Layers": [
        {
            "LayerName": "my-layer",
            "LayerArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer",
            "LatestMatchingVersion": {
                "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2",
                "Version": 2,
                "Description": "My layer",
                "CreatedDate": "2025-04-15T00:37:46.592+0000",
                "CompatibleRuntimes": [
                    "python3.13"
                ]
            }
        }
    ]
}

계정의 모든 계층을 나열하려면 --compatible-runtime 옵션을 생략합니다. 응답 세부 정보에는 각 계층의 최신 버전이 표시됩니다.

ListLayerVersions API를 사용하여 최신 버전의 계층을 가져올 수도 있습니다. 예를 들어, 다음 list-layer-versions CLI 명령을 사용할 수 있습니다. 

aws lambda list-layer-versions --layer-name my-layer

다음과 유사한 출력 화면이 표시되어야 합니다.

{
    "LayerVersions": [
        {
            "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2",
            "Version": 2,
            "Description": "My layer",
            "CreatedDate": "2023-11-15T00:37:46.592+0000",
            "CompatibleRuntimes": [
                "java11"
            ]
        },
        {
            "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:1",
            "Version": 1,
            "Description": "My layer",
            "CreatedDate": "2023-11-15T00:27:46.592+0000",
            "CompatibleRuntimes": [
                "java11"
            ]
        }
    ]
}