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