Apigee-access 모듈 사용

Apigee Edge 문서입니다.
Go to the Apigee X 문서로 이동합니다.
info

apigee-access 모듈을 사용하면 Node.js 애플리케이션 코드 내에서 API 프록시 흐름 변수 및 캐시에 액세스할 수 있습니다. 이 모듈은 Apigee Edge 플랫폼에 포함되어 있으므로 다른 Node.js 모듈과 같이 설치할 필요가 없습니다.

apigee-access 가져오기

apigee-access 모듈은 Apigee Edge 플랫폼에 통합되어 있습니다. Node.js 코드를 Edge에 배포하면 이 모듈을 사용할 수 있습니다. 배포하는 Node.js 코드에서 이 모듈을 요구하기만 하면 됩니다. 예를 들면 다음과 같습니다.

var access=require('apigee-access');

흐름 변수 액세스

Node.js 애플리케이션을 Edge에 배포하면 지원되는 '기본' 흐름 변수, 정책으로 생성된 흐름 변수, Node.js 코드 내에서 직접 만든 흐름 변수에 액세스할 수 있습니다. 흐름 변수는 Edge에서 실행되는 API 프록시의 컨텍스트 내에서 생성되고 존재합니다. 자세한 내용은 Node.js에서 흐름 변수 액세스를 참조하세요.

캐시 액세스

apigee-access 모듈을 사용하면 Node.js 코드에서 Apigee Edge 분산 캐시에 액세스할 수 있습니다. 자세한 내용은 Node.js에서 캐시 액세스를 참조하세요.

할당량 서비스 사용

apigee-access 모듈을 사용하면 Node.js 코드에서 Apigee Edge 할당량 서비스에 액세스할 수 있습니다. 자세한 내용은 Node.js에서 할당량 서비스 액세스를 참조하세요.

키-값 맵 액세스

apigee-access 모듈을 사용하면 Node.js 코드에서 Apigee Edge 키-값 맵 (KVM)에 액세스할 수 있습니다. 자세한 내용은 Node.js에서 키-값 맵 액세스를 참조하세요.

로컬 모드와 배포된 모드에서 실행

로컬 개발 및 테스트를 지원하기 위해 apigee-access 모듈 은 Apigee Edge에 종속되지 않는 로컬 모드에서 작동합니다. 하지만 모듈이 Edge에 배포된 API 프록시와 함께 사용되면 '로컬' 기능이 기본 Edge 기능으로 대체됩니다. 예를 들어 배포된 모드에서는 모든 흐름 변수에 액세스할 수 있지만 Node.js 애플리케이션을 로컬에서 실행할 때는 작은 하위 집합만 사용할 수 있습니다. 이러한 로컬 모드 변수 목록은 로컬 모드에서 실행을 참조하세요.

모듈이 실행되는 모드 확인

apigee-access가 실행되는 모드를 확인하려면 다음 단계를 따르세요.

var access = require('apigee-access')
console.log('The deployment mode is ' + access.getMode());

getMode()의 반환 값은 Node.js 애플리케이션이 Apigee Edge에 배포되었는지 아니면 독립형 모드로 실행 중인지 알려줍니다. 이 메서드는 다음 두 문자열 결과 중 하나를 반환합니다.

  • apigee - Node.js 애플리케이션이 Apigee Edge에서 실행 중이며 모든 기능이 지원됩니다.
  • standalone - Node.js 애플리케이션이 Apigee Edge 환경 외부에서 실행 중이며 문서 상단에 설명된 기본 기능이 적용됩니다.

배포된 모드에서 실행

Edge에 배포되면 정책으로 설정된 변수가 apigee-access에 표시되고 이 모듈의 메서드로 추가되거나 수정된 변수는 프록시 흐름의 후속 정책에 표시됩니다.

지원되는 변수의 링크는 변수 참조에서 확인할 수 있습니다. 이러한 변수와 자체 이름으로 만든 변수는 apigee-access에 표시됩니다. 일부 변수는 읽기 전용입니다. 이러한 변수는 변수 참조에서 확인할 수 있습니다.

로컬 모드에서 실행

'로컬 모드'에서는 Apigee Edge 컨텍스트 외부에서 Node.js 코드를 실행합니다. 이 모드에서는 대부분의 사전 정의된 흐름 변수에 Node.js 코드 내에서 액세스할 수 없습니다. 이 표는 사용 가능한 흐름 변수의 작은 하위 집합을 보여줍니다. 이러한 변수 는 Apigee Edge용 Node.js 애플리케이션의 로컬 개발 및 테스트를 지원하기 위해 여기에서 지원됩니다.

변수 읽기 전용 유형 참고
client.received.start.time 예 문자열 요청이 수신된 시간
client.received.end.time 예 문자열 요청이 수신된 시간
client.received.start.timestamp 예 정수 요청이 수신된 시간
client.received.end.timestamp 예 정수 요청이 수신된 시간

Apigee Edge 플랫폼에서는 훨씬 더 큰 사전 정의된 변수 집합이 지원됩니다. 전체 목록은 Apigee Edge 변수 참조를 확인하세요.