현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보
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 변수 참조를 확인하세요.