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 변수 참조를 확인하세요.