람다 함수에 적용 가능한 환경 변수

람다 함수에 적용할 수 있는 환경 변수를 이해합니다.

다음은 HeartBeat, API 및 메트릭 람다 함수에 적용할 수 있는 속성입니다.

Amazon API Gateway 구성을 사용하면 Amazon API Gateway 에서 AWS 연결에 필요한 구성을 지정할 수 있습니다.

특성 설명
AWS_STAGE 필수입니다. Amazon의 스테이지(런타임) 이름 API Gateway.

에이전트 구성에서는 AWS 에이전트에서 하트비트 간격, 자산 동기화 간격, 메트릭 동기화 간격 등과 같은 구성을 지정할 수 있습니다.

특성 설명 가능한 값
APICP_HEARTBEAT_SEND_INTERVAL_초 선택사항. 에이전트가 상태 확인 상태를 API 컨트롤 플레인으로 전송해야 하는 기간(초)입니다. 최소: 15초 최대: 900초 (5분). 기본값: 60초. 이 속성의 값을 지정하지 않으면 기본값이 고려됩니다.

런타임 구성을 사용하면 런타임 이름, 설명, 태그 등과 같이 연합 API 관리에서 관리할 Amazon API Gateway 의 메타데이터를 지정할 수 있습니다.

특성 설명
Apicp_runtime_name 필수입니다. 런타임 이름. 이 속성은 연합 API 관리에서 런타임을 식별하는 방식을 정의합니다. 이름은 50자를 초과할 수 없습니다. 런타임이 연합 API 관리 에 처음 등록될 때, 현재 구현은 런타임 ID를 <AWS_계정_ID><AWS_리전><AWS_스테이지> 형식으로 생성합니다. 따라서 런타임 이름을 변경해도 런타임 ID는 변경되지 않습니다. 에이전트 재시작 사이에 런타임 이름이 변경되더라도, 페더레이션 API 관리에서는 새 런타임이 생성되지 않습니다. 대신 기존 런타임에 대해 런타임 이름이 업데이트됩니다.
APICP_RUN타임_설명 선택사항. 런타임 설명입니다. 설명은 300자를 초과해서는 안 됩니다. 기본값: AWS 런타임. 이 속성의 값을 지정하지 않으면 기본값이 고려됩니다.
Apicp_runtime_region 선택사항. 런타임이 호스팅되는 지역 이름. 예시: 미국 동부 지역명은 50자를 초과할 수 없습니다.
APICP_RUNNING_LOCATION 선택사항. 런타임이 배포되는 위치. 국가|주|도시 형식으로 위치를 지정하십시오.
참고:
  • 전체 APICP_RUNTIME_LOCATION 값과 개별 필드(APICP_RUNTIME_COUNTRY, APICP_RUNTIME_STATE, 및 APICP_RUNTIME_CITY)가 모두 제공된 경우, 개별 필드(APICP_RUNTIME_COUNTRY, APICP_RUNTIME_STATE, 및 APICP_RUNTIME_CITY)의 값이 우선 적용됩니다.
  • 필드에 APICP_RUNTIME_LOCATION 고유한 도시 이름만 지정하고 국가 또는 주를 지정하지 않은 경우, 연방 API 관리(federated API management)가 자동으로 국가, 주 및 도시 값을 필드에 APICP_RUNTIME_LOCATION 채웁니다.
APICP_런타임_국가 선택사항. 런타임이 배포된 국가.
APICP_RUNTIME_STATE 선택사항. 런타임이 배포된 주(州).
APICP_런타임_시티 선택사항. 런타임이 배포된 도시. 도시명이 고유하고 국가 및 주 필드가 지정되지 않은 경우, 연방 API 관리가 자동으로 국가 및 주 값을 채웁니다.
Apicp_runtime_tags 선택사항. 런타임의 태그 이름. 이 속성에 값을 지정하지 않으면 기본값 AWS 이 적용됩니다. 태그는 런타임을 구성하고 분류하는 데 사용됩니다. 여러 태그는 쉼표를 추가하여 지정할 수 있습니다. 예시: 테스트, 로컬, 개발 각 태그는 50자를 초과해서는 안 됩니다. 공백을 포함해서는 안 됩니다. 태그의 총 개수는 100개를 초과해서는 안 됩니다.
APICP_RUN타임_용량_값 선택사항. 런타임이 지정된 기간 동안 처리할 수 있는 트랜잭션 호출 수입니다. 용량 값은 음이 아닌 정수로 설정할 수 있습니다. 기본값: 500000
APICP_RUN타임_용량_단위 선택사항. 용량 값은 음수가 아닌 정수로, 기간은 다음 단위 중 원하는 기간으로 구성할 수 있습니다:
  • 초당
  • 당_분
  • 당_시간
  • 당_일
  • 당_주
  • 당월
  • PER_YEAR(기본값)
이 속성의 값을 지정하지 않으면 기본값이 고려됩니다.

페더레이션 API 관리 구성을 사용하면 Amazon API Gateway 이 연결을 설정해야 하는 페더레이션 API 관리 세부 정보를 지정할 수 있습니다.

특성 설명
APICP_URL 필수입니다. 페더레이션 API 관리에 액세스하는 데 사용되는 유효한 URL.
APICP_사용자명 필수입니다. 페더레이션 API 관리에 로그인하는 데 사용되는 사용자 이름입니다.
APICP_PASSWORD 필수입니다. 기본 인증을 통해 페더레이션 API 관리에 로그인할 때 사용되는 해당 사용자 이름의 비밀번호입니다.
Apicp_ssl_enabled 선택사항. 페더레이션 API 관리의 SSL 인증.가능한 값: 또는 거짓
APICP_신뢰 저장소 경로 선택사항. 트러스트스토어의 위치 file.If APICP_SSL_ENABLED가 true로 설정되어 있으면 이 속성에 대한 값을 지정해야 합니다.
APICP_신뢰 저장소 암호 선택사항. 트러스트 스토어에 액세스하기 위한 비밀번호 file.If APICP_SSL_ENABLED가 true로 설정되어 있으면 이 속성의 값을 지정해야 합니다.
APICP_신뢰 저장소 유형 선택사항. truststore.If APICP_SSL_ENABLED의 유형이 true로 설정된 경우 이 속성의 값을 지정해야 합니다.
APICP_키스토어_경로 선택사항. 키 저장소 위치 file.If APICP_SSL_ENABLED가 true로 설정된 경우 이 속성의 값을 지정해야 합니다.
APICP_키스토어_암호 선택사항. 키 저장소에 액세스하기 위한 비밀번호 file.If APICP_SSL_ENABLED가 true로 설정되어 있으면 이 속성에 대한 값을 지정해야 합니다.
Apicp_keystore_type 선택사항. keystore.If APICP_SSL_ENABLED의 유형이 true로 설정된 경우 이 속성의 값을 지정해야 합니다.
Apicp_key_alias 선택사항. keystore.If APICP_SSL_ENABLED에서 키의 별칭이 true로 설정된 경우 이 속성에 대한 값을 지정해야 합니다.
APICP_KEY_PASSWORD 선택사항. keystore.If APICP_SSL_ENABLED에서 키의 비밀번호가 true로 설정되어 있으면 이 속성에 대한 값을 지정해야 합니다.
APICP_HTTP_연결_시간_초과 선택사항. 에이전트가 연합 API 관리 (federated API management)와 연결을 설정해야 하는 시간(초). 에이전트가 페더레이션된 API 관리와 연결을 시도하는 동안 대기할 최대 시간을 지정합니다. 이 시간 내에 연결이 성공적으로 설정되지 않으면 연결 시간 초과 오류가 발생합니다. 기본값은 10초입니다.
APICP_HTTP_읽기_시간_초과 선택사항. 에이전트가 연결이 이미 설정된 후 데이터를 수신하기 위해 대기할 최대 시간을 정의합니다. 해당 시간 내에 에이전트가 응답을 받지 못하면 요청은 읽기 시간 초과 오류로 실패합니다. 기본값은 10초입니다.
APICP_HTTP_최대_연결수 선택사항. 동된 API 관리(HTTP )와 동시에 설정할 수 있는 최대 동시 연결 수를 지정합니다. 기본값: 5.
APICP_HTTP_최대_재시도_횟수 선택사항. HTTP 요청이 실패할 때 시스템이 재시도할 횟수를 정의합니다. 기본값: 0.
APICP_HTTP_재시도_간격 선택사항. HTTP 요청이 실패할 때 재시도 간격으로 대기할 시간을 지정합니다. 기본값: 5초

다음은 메트릭 람다 함수에만 해당하는 속성입니다.

특성 설명
Aws_metrics_by_data_or_statistics 선택사항. CloudWatch.Values에서 메트릭을 검색하는 메서드입니다:
  • 데이터
  • 통계
기본값은 통계입니다. 이 속성의 값을 지정하지 않으면 기본값이 고려됩니다.
Aws_metrics_sync_buffer_interval_seconds 선택사항. 기본적으로 Amazon API Gateway 메트릭 데이터는 1분 간격으로 Amazon CloudWatch 으로 자동 전송됩니다. 즉, 대부분의 Amazon API Gateway 지표는 원본 데이터 point.But 로부터 1분 이내에 Amazon CloudWatch 에서 사용할 수 있으며, 적절한 지표 동기화를 위해 CloudWatch 버퍼 시간 간격을 600초(10분) 이상으로 설정합니다(기본값은 600초). 이 속성의 값을 지정하지 않으면 기본값이 고려됩니다.
Apicp_metrics_send_interval_seconds 선택사항. 에이전트가 Amazon CloudWatch 에서 메트릭을 검색하여 페더레이션 API 관리로 메트릭을 전송해야 하는 기간(초)입니다. 지원되는 메트릭 동기화 값:
  • 60초(1분)(기본값)(기본값)
  • 300초(5분)
  • 600초(10분)
  • 1800초(30분)
  • 3600초(60분)
  • 7200초(120분)
이 속성의 값을 지정하지 않으면 기본값이 고려됩니다.

다음은 에셋 람다 함수 전용 프로퍼티입니다.

특성 설명
Apicp_assets_sync_interval_seconds 선택사항. 에이전트가 Amazon CloudTrail 에서 연합 API 관리로 자산에 대한 변경 사항을 동기화해야 하는 기간(초)입니다.

Min:60 초

최대: 21600초(6시간)

기본값: 300초

이 속성의 값을 지정하지 않으면 기본값이 고려됩니다.
Aws_assets_sync_buffer_interval_seconds 필수입니다. CloudTrail 는 일반적으로 API 호출 후 약 5분 이내에 Amazon API Gateway 관리 이벤트를 전달합니다. CloudTrail 이벤트의 표준 배송 시간입니다.

따라서 CloudTrail 이벤트 시간 간격을 300초(5분) 이상으로 설정하고 기본값은 300초로 설정합니다. 이 속성의 값을 지정하지 않으면 기본값이 고려됩니다.