흐름 변수 참조

이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.

Apigee Edge 문서 보기

이 섹션에서는 흐름 변수에 대한 참조 정보를 제공합니다.

Apigee는 다음 흐름 변수를 정의합니다.

apigee                 is                       request
apiproduct             loadbalancing            response
apiproxy               message                  route
client                 messageid                servicecallout
current                mint                     system
environment            organization             target
error                  proxy                    variable
fault                  publishmessage           
graphql                ratelimit

다음 섹션에서 각 변수를 설명합니다.

apigee

정책의 실행 시간에 대한 정보를 제공하는 도우미 변수입니다.

다음 표에서는 apigee 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
apigee.metrics.policy.policy_name.timeTaken 정수 읽기 전용 정책 실행에 소요된 시간(나노초)입니다. 정책

apiproduct

API 제품에 대한 정보를 제공하는 도우미 변수입니다.

다음 표에서는 apiproduct 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
apiproduct.operation 문자열 읽기 전용

API 제품 작업의 이름입니다. 이 변수는 할당량 정책의 설정 및 API 제품 작업의 할당량 설정을 구분하는 데 도움이 됩니다.

예를 들면 my-operation입니다.

 프록시 요청
apiproduct.operation.resource 문자열 읽기 전용

요청과 일치하는 작업의 리소스 이름입니다.

 프록시 요청
apiproduct.operation.methods 배열 읽기 전용

일치하는 작업이 허용하는 HTTP 메서드의 배열입니다.

 프록시 요청
apiproduct.operation.attributes.key_name 배열 읽기 전용

key_name와 일치하는 맞춤 속성 값을 가져옵니다.

 프록시 요청

자세한 내용은 다음을 참조하세요.

apiproxy

API 프록시를 설명합니다.

다음 표에서는 apiproxy 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
apiproxy.name 문자열 읽기 전용 API 프록시 이름입니다. 예를 들면 My Proxy입니다. 프록시 요청
apiproxy.revision 문자열 읽기 전용 API 프록시의 버전 번호입니다. 예를 들면 6입니다. 프록시 요청
apiproxy.basepath 문자열 읽기 전용 배포 기본 경로(API 배포 중에 지정됨)입니다. 프록시 요청

API 프록시 작업에 대한 자세한 내용은 API 및 API 프록시 이해하기를 참조하세요.

client

부하 분산기에 요청을 전송한 애플리케이션 또는 시스템입니다.

다음 표에서는 client 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
client.cn 문자열 읽기 전용

클라이언트 앱에서 제공한 TLS/SSL 인증서에 지정된 일반 이름입니다.

 프록시 요청
client.country 문자열 읽기 전용

클라이언트 앱에서 제공한 TLS/SSL 인증서의 국가입니다.

 프록시 요청
client.email.address 문자열 읽기 전용

클라이언트 앱에서 제공한 TLS/SSL 인증서의 이메일 주소입니다.

 프록시 요청
client.host 문자열 읽기 전용

ProxyEndpoint에서 수신한 요청과 연결된 HTTP 호스트 IP입니다.

 프록시 요청
client.ip 문자열 읽기 전용

부하 분산기에 메시지를 보내는 클라이언트 또는 시스템의 IP 주소입니다. 예를 들어 원래 클라이언트 IP 또는 부하 분산기 IP일 수 있습니다.

 프록시 요청
client.locality 문자열 읽기 전용

클라이언트에서 제공한 TLS/SSL 인증서의 지역(도시)입니다.

 프록시 요청
client.organization 문자열 읽기 전용 클라이언트에서 제공한 TLS/SSL 인증서의 조직입니다. Apigee의 조직과 반드시 동일한 것은 아닙니다. 프록시 요청
client.organization.unit 문자열 읽기 전용

클라이언트에서 제공한 TLS/SSL 인증서의 조직 단위입니다.

 프록시 요청
client.port 정수 읽기 전용

ProxyEndpoint에 보내는 발신 클라이언트의 요청과 연결된 HTTP 포트입니다.

 프록시 요청
client.received.end.time 문자열 읽기 전용

프록시가 ProxyEndpoint의 발신 클라이언트로부터 요청 수신을 완료한 시간을 문자열 형식으로 표현한 것입니다. 예를 들어 'Wed, 21 Aug 2013 19:16:47 UTC'입니다.

이 시간 값은 해당 32비트 타임스탬프 수량의 문자열 표현입니다. 예를 들어 'Wed, 21 Aug 2013 19:16:47 UTC'는 타임스탬프 값 1377112607413에 해당합니다.

 프록시 요청
client.received.end.timestamp 긴 형식 읽기 전용

프록시가 ProxyEndpoint의 발신 클라이언트로부터 요청 수신을 완료한 시간을 지정하는 타임스탬프 값입니다. 1970년 1월 1일(UTC) 자정부터 경과한 시간(밀리초)을 포함하는 64비트(long) 정수 값입니다.

 프록시 요청
client.received.start.time 문자열 읽기 전용

프록시가 ProxyEndpoint의 발신 클라이언트로부터 요청 수신을 시작한 시간을 문자열 형식으로 표현한 것입니다. 예를 들어 'Wed, 21 Aug 2013 19:16:47 UTC'입니다.

이 시간 값은 해당 32비트 타임스탬프 수량의 문자열 표현입니다. 예를 들어 'Wed, 21 Aug 2013 19:16:47 UTC'는 타임스탬프 값 1377112607413에 해당합니다.

 프록시 요청
client.received.start.timestamp 긴 형식 읽기 전용

프록시가 ProxyEndpoint의 발신 클라이언트로부터 요청 수신을 시작한 시간을 지정하는 타임스탬프 값입니다. 1970년 1월 1일(UTC) 자정부터 경과한 시간(밀리초)을 포함하는 64비트(long) 정수 값입니다.

 프록시 요청
client.scheme 문자열 읽기 전용

클라이언트 앱이 요청 메시지를 보내는 데 사용한 전송에 따라 HTTP 또는 HTTPS를 반환합니다.

 프록시 요청
client.sent.end.time 문자열 읽기 전용

프록시가 ProxyEndpoint에서 클라이언트로 응답 전송을 완료한 시간을 문자열 형식으로 표현한 것입니다. 예를 들어 'Wed, 21 Aug 2013 19:16:47 UTC'입니다.

이 값은 해당 32비트 client.sent.end.timestamp의 문자열 표현입니다. 예를 들어 'Wed, 21 Aug 2013 19:16:47 UTC'는 타임스탬프 값 1377112607413에 해당합니다.

 PostClientFlow
client.sent.end.timestamp 긴 형식 읽기 전용 ProxyEndpoint가 원래 클라이언트 앱에 응답 반환을 완료한 시기를 지정하는 타임스탬프 값입니다. 이 값은 1970년 1월 1일 자정(UTC) 이후 경과된 밀리초 수를 포함하는 64비트(긴) 정수입니다. PostClientFlow
client.sent.start.time 문자열 읽기 전용 ProxyEndpoint가 발신 클라이언트 앱에 응답 반환을 시작한 시간으로 문자열 형식으로 표현한 것입니다. 예를 들면 'Wed, 21 Aug 2013 19:16:47 UTC'입니다.

이 값은 해당 32비트 client.sent.start.timestamp의 문자열 표현입니다. 예를 들어 'Wed, 21 Aug 2013 19:16:47 UTC'는 타임스탬프 값 1377112607413에 해당합니다.

 PostClientFlow
client.sent.start.timestamp 긴 형식 읽기 전용 프록시가 ProxyEndpoint에서 클라이언트에 응답을 보내기 시작할 때입니다. 이 값은 1970년 1월 1일 자정(UTC) 이후 경과된 밀리초 수를 포함하는 64비트(긴) 정수로 표현됩니다. PostClientFlow
client.ssl.enabled 문자열 읽기 전용

ProxyEndpoint가 TLS/SSL에 구성된 경우 true 그렇지 않으면 false입니다.

 프록시 요청
client.state 문자열 읽기 전용

클라이언트에서 제공한 TLS/SSL 인증서의 상태입니다.

 프록시 요청

current

현재 API 프록시 흐름에 대한 정보를 포함합니다.

다음 표에서는 current 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
current.flow.name 문자열 읽기 전용 현재 실행 중인 흐름의 이름입니다(예: PreFlow, PostFlow 또는 조건부 흐름의 이름). 프록시 요청
current.flow.description 문자열 읽기 전용 현재 실행 중인 흐름의 설명입니다. 이 값은 흐름의 XML 구성에 있는 <Description> 요소의 값과 동일합니다. 프록시 요청

Apigee UI의 Trace 뷰에서 이러한 속성을 볼 수 있습니다.

environment

environment.name 속성의 컨테이너입니다.

다음 표에서는 environment 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
environment.name 문자열 읽기 전용 트랜잭션이 실행된 환경의 이름입니다. 프록시 요청

error

오류 흐름의 오류 메시지를 나타내는 컨텍스트 객체입니다.

다음 표에서는 error 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
error message 읽기/쓰기 오류 흐름의 컨텍스트 객체인 message 유형의 오류입니다. 오류
error.content 문자열 읽기/쓰기 오류의 콘텐츠입니다. 오류
error.message 문자열 읽기 전용

오류와 관련된 메시지로, 해당 값은 오류 흐름이 실행되기 전에만 사용할 수 있습니다.

 오류
error.status.code 정수 읽기 전용

오류와 관련된 HTTP 상태 코드입니다. 예를 들면 400입니다.

 오류
error.reason.phrase 문자열 읽기 전용

오류와 관련된 이유 구문입니다. Bad Request).

 오류
error.transport.message TransportMessage 읽기 전용

TransportMessage 유형의 오류입니다.

 오류
error.state 정수 읽기 전용

오류가 발생한 흐름의 상태입니다.

 오류
error.header.header_name 문자열 읽기/쓰기

응답 헤더를 가져오거나 설정합니다.

 오류

fault

런타임 오류 소스, 이유, 세부정보에 대한 정보를 제공합니다. Apigee는 정책에서 오류가 발생할 때 이러한 변수를 설정하고 값은 각 정책에 따라 다릅니다. fault 변수가 설정되는 때를 확인하려면 정책 오류 정보를 참고하세요.

속성 유형 읽기/쓰기 설명 범위 시작
fault.name 문자열 읽기 전용 오류 이름으로, 각 정책 참조 주제에 포함된 런타임 오류 표에 설명되어 있습니다. 이 변수는 FaultRule에 적용되는 조건에서 유용할 수 있습니다. 오류
fault.reason 문자열 읽기 전용 오류의 원인입니다. 예를 들어 OASValidation 정책은 인바운드 요청이 OpenAPI 사양에 대해 검증되지 않은 것을 감지하면 정책 이름, 사양 이름, 요청이 이 사양에 대해 검증되지 않은 이유를 설명하는 세부 정보를 설명하는 문자열로 이 변수를 설정합니다. 다른 정책에서는 이 변수를 오류에 적합한 메시지로 설정합니다. 오류
fault.category 문자열 읽기 전용 카테고리. 예를 들어 정책 단계에서 오류가 발생하면 이 변수에서 '단계' 값을 보존할 수 있습니다. 이 변수는 FaultRule에 적용되는 조건에서 유용할 수 있습니다. 오류
fault.subcategory 문자열 읽기 전용 하위 카테고리. 예를 들어 OASValidation 정책에서 요청이 OpenAPI 사양에 대해 검증되지 않음을 감지하면 이 변수를 'OASValidationFailure'로 설정합니다. 이 변수는 FaultRule에 적용되는 조건에서 유용할 수 있습니다. 오류

graphql

런타임에 GraphQL 쿼리 결과에 대해 액세스 권한을 부여합니다. 자세한 내용은 GraphQL 정책을 참조하세요.

다음 표에서는 graphql 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명
graphql 복합 유형 읽기 전용/읽기 쓰기 루트 GraphQL 쿼리입니다. 범위
graphql.fragment 복합 유형 읽기 전용/읽기 쓰기 이 쿼리의 기본 조각에 대한 참조입니다. 범위
graphql.fragment.count 정수 읽기 전용 이 GraqhQL 쿼리로 생성된 프레임 수입니다. 범위
graphql.fragment.INDEX.selectionSet.INDEX 유형 읽기 전용/읽기 쓰기 지정된 색인에 있는 선택 항목 집합에 대한 참조입니다. 범위
graphql.fragment.INDEX.selectionSet.INDEX.name 문자열 읽기 전용/읽기 쓰기 지정된 색인에 있는 선택 항목 집합의 이름입니다. 범위
graphql.fragment.INDEX.selectionSet.count 정수 읽기 전용 이 조각에 있는 선택 항목 집합 수입니다. 범위
graphql.fragment.INDEX.selectionSet.name 문자열 읽기 전용/읽기 쓰기 조각에 있는 기본 선택 항목 집합의 이름입니다. 범위
graphql.operation 복합 유형 읽기 전용/읽기 쓰기 쿼리의 기본 작업에 대한 참조입니다.

작업 수준에서 할당량을 설정할 수 없습니다. 대신 환경 수준에서 설정합니다.

 범위
graphql.operation.name 문자열 읽기 전용 쿼리의 기본 작업의 이름입니다. 범위
graphql.operation.operationType 열거 읽기 전용 이 API 프록시에 대해 실행될 수 있는 쿼리의 기본 작업의 유형입니다. 가능한 값은 query, mutation, all입니다. 범위
graphql.operation.selectionSet 복합 유형 쿼리의 기본 작업에 대한 기본 선택 항목 집합입니다. 범위
graphql.operation.selectionSet.count 정수 읽기 전용 쿼리의 기본 작업에 있는 선택 항목 집합 수입니다. 범위
graphql.operation.selectionSet.name 문자열 읽기 전용 쿼리의 기본 작업의 기본 선택 항목 집합의 이름입니다. 범위
graphql.operation.selectionSet.INDEX 정수 읽기 전용 선택 항목 집합 목록에서 지정된 색인에 있는 선택 항목 집합에 대한 참조입니다. 범위
graphql.operation.selectionSet.INDEX.name 문자열 읽기 전용 이 작업에 대해 선택 항목 집합 목록에서 지정된 색인에 있는 선택 항목의 이름입니다. 범위
graphql.operation.selectionSet.INDEX.[selectionSet] 복합 유형 읽기 전용/읽기 쓰기 하나 이상의 추가적인 선택 항목 집합 객체입니다.

선택 항목 집합에 재귀적으로 액세스할 수 있습니다. 예를 들어 selectionSet.index 다음에 name 속성이 아닌 또 다른 selectionSet.index가 있을 수 있습니다. 그런 다음 GraphQL 정책에 설정한 <MaxCount> 값에 도달할 때까지 이것이 계속됩니다.

범위
graphql.operation.selectionSet.INDEX.directive 복합 유형 지정된 선택 항목 집합의 기본 지시문에 대한 참조입니다. 범위
graphql.operation.selectionSet.INDEX.directive.count 복합 유형 범위
graphql.operation.selectionSet.INDEX.directive.INDEX 정수 읽기 전용 지정된 색인의 지시문에 대한 참조입니다. 범위
graphql.operation.selectionSet.INDEX.directive.INDEX.argument.INDEX 정수 읽기 전용 지정된 색인의 인수에 대한 참조입니다. 범위
graphql.operation.selectionSet.INDEX.directive.INDEX.argument.INDEX.name 문자열 지정된 색인의 인수 이름입니다. 범위
graphql.operation.selectionSet.INDEX.directive.INDEX.argument.INDEX.value 문자열 지정된 색인의 인수 값입니다. 범위
graphql.operation.selectionSet.INDEX.directive.name 문자열 범위
graphql.operation.variableDefinitions 복합 유형 쿼리의 기본 작업에 대한 변수 정의 목록에 대한 참조입니다. 범위
graphql.operation.variableDefinitions.count 정수 쿼리의 기본 작업에 대한 변수 정의 수입니다. 범위
graphql.operation.variableDefinitions.INDEX 정수 지정된 색인의 변수 정의에 대한 참조입니다. 범위
graphql.operation.variableDefinitions.INDEX.name 문자열 지정된 색인의 변수 정의의 이름입니다. 범위
graphql.operation.variableDefinitions.INDEX.type 지정된 색인에서 변수 정의 값의 유형입니다. 범위

is

is.error 속성의 컨테이너입니다.

다음 표에서는 is 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
is.error 부울 읽기 전용

오류 플래그입니다.

 프록시 요청

loadbalancing

TargetEndpoint의 부하 분산 상태에 대한 정보를 제공합니다.

다음 표에서는 loadbalancing 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
loadbalancing.failedservers 문자열 배열 읽기 전용

TargetEndpoint의 부하 분산 중 실패한 TargetServer 목록입니다.

 대상 응답
loadbalancing.isfallback 부울 읽기 전용

TargetEndpoint에서 부하 분산 중에 호출되는 TargetServer에 대한 대체가 사용 설정된 경우 true입니다.

 대상 응답
loadbalancing.targetserver 문자열 읽기 전용

TargetEndpoint에서 부하 분산 중에 호출되는 TargetServer입니다. 부하 분산기 요소를 정의할 때 <Path> 요소가 설정된 경우에만 설정합니다.

 대상 응답

message

요청 흐름의 request 또는 응답 흐름의 response 또는 오류 흐름의 error와 같은 값을 사용하는 컨텍스트 객체입니다.

다음 표에서는 message 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
message message 읽기/쓰기

요청 흐름의 request 또는 응답 흐름의 response 또는 오류 흐름의 error와 같은 값을 사용하는 컨텍스트 객체입니다.

 프록시 요청
message.content 문자열 읽기/쓰기

요청, 응답, 오류 메시지의 콘텐츠입니다.

 프록시 요청
message.formparam.param_name 문자열 읽기/쓰기

지정된 양식 매개변수의 값입니다.

 프록시 요청
message.formparam.param_name.
 values		 컬렉션 읽기 전용

메시지에서 지정된 양식 매개변수의 모든 값입니다.

 프록시 요청
message.formparam.param_name.
 values.count		 정수 읽기 전용

메시지에서 지정된 양식 매개변수 값의 수입니다.

 프록시 요청
message.formparams.count 정수 읽기 전용

메시지에서 모든 양식 매개변수의 수입니다.

 프록시 요청
message.formparams.names 컬렉션 읽기 전용

메시지에서 모든 양식 매개변수의 값입니다.

 프록시 요청
message.formparams.names.string 문자열 읽기 전용

메시지에 있는 모든 양식 매개변수의 이름을 쉼표로 구분한 목록입니다.

 프록시 요청
message.formstring 문자열 읽기 전용

메시지에서 양식 문자열 값입니다.

 프록시 요청
message.header.header_name 문자열 읽기/쓰기

요청에서 발견한 특정 헤더의 값을 가져오거나 설정합니다. 헤더에 쉼표가 포함된 경우, 읽을 때 첫 번째 쉼표까지만 텍스트 세그먼트를 수신합니다.

예를 들어 Cache-control 헤더가 public, maxage=16544이면 message.header.cache-control의 반환 값은 public입니다.

전체 헤더를 문자열로 사용하려면 message.header.header_name.values.string과 같은 변수를 사용합니다.

 프록시 요청
message.header.header_name.N 문자열 읽기/쓰기

메시지에서 N번째 특정 헤더의 값(흐름의 상태에 따라 요청 또는 응답)입니다. Apigee는 헤더 텍스트 값을 쉼표로 분할합니다. 색인은 가장 왼쪽 값에 대해 1부터 시작합니다.

예를 들어 Cache-control 헤더가 public,maxage=16544이면 message.header.cache-control.2의 반환 값은 maxage=16544입니다.

 프록시 요청
message.header.header_name.
 values		 컬렉션 읽기 전용

메시지에서 지정된 HTTP 헤더 이름의 모든 값입니다.

 프록시 요청
message.header.header_name.
 values.count		 정수 읽기 전용

메시지에서 지정된 HTTP 헤더 이름 값의 수입니다.

 프록시 요청
message.header.header_name.
 values.string		 문자열 읽기 전용

메시지에서 단일 문자열 형식으로 된 특정 헤더의 모든 값입니다.

예를 들어 Cache-control 헤더가 public,maxage=16544이면 message.header.cache-control.values.string의 반환 값은 public,maxage=16544입니다.

 프록시 요청
message.headers.count 정수 읽기 전용

메시지에서 모든 HTTP 헤더의 수입니다.

 프록시 요청
message.headers.names 컬렉션 읽기 전용

메시지의 모든 HTTP 헤더 값입니다.

 프록시 요청
message.headers.names.string 문자열 읽기 전용

메시지에 있는 모든 헤더 이름을 쉼표로 구분한 목록입니다.

 프록시 요청
message.path 문자열 읽기/쓰기

쿼리 매개변수를 제외한 URL의 전체 요청 메시지 경로입니다.

프록시 요청
message.queryparam.param_name 문자열 읽기 전용

지정된 메시지 쿼리 매개변수를 반환합니다.

 프록시 요청
message.queryparam.param_name.N 문자열 읽기/쓰기

메시지에서 N번째 쿼리 매개변수의 값입니다. 예를 들어 request.querystring이 a=hello&a=world이면 message.queryparam.a.1의 반환 값은 hello입니다.

단일 쿼리 매개변수 이름(예: type=siteid:1&type=language:us-en&type=currency:USD)에 여러 값을 작성하는 예시를 보려면 다음을 설정합니다.

  • siteid:1에게 message.queryparam.type.1 부여
  • message.queryparam.type.2에서 language:en-us으로 변환
  • currency:USD에게 message.queryparam.type.3 부여
 프록시 요청
message.queryparam.param_name.
 values		 컬렉션 읽기 전용

메시지에 있는 특정 쿼리 매개변수의 모든 값이며 쉼표로 구분된 목록 형식으로 되어 있습니다.

예를 들어 쿼리 문자열이 a=hello&a=world이면 message.queryparam.a.values 값은 ['hello', 'world']code>입니다.

 프록시 요청
message.queryparam.param_name.
 values.count		 정수 읽기 전용

클라이언트 앱에서 ProxyEndpoint로 전송된 요청과 연결된 지정 쿼리 매개변수의 총 개수입니다.

 프록시 요청
message.queryparams.count 정수 읽기 전용

클라이언트 앱에서 ProxyEndpoint로 전송된 요청과 연결된 모든 쿼리 매개변수의 총 수입니다.

 프록시 요청
message.queryparams.names 컬렉션 읽기 전용

클라이언트 앱에서 ProxyEndpoint로 전송된 요청과 연결된 모든 쿼리 매개변수 이름의 목록입니다.

 프록시 요청
message.queryparams.names.string 문자열 읽기 전용

메시지에 있는 모든 쿼리 매개변수의 이름을 쉼표로 구분한 목록입니다.

 프록시 요청
message.querystring 문자열 읽기 전용

클라이언트 앱에서 ProxyEndpoint로 전송된 요청과 연결된 모든 쿼리 매개변수 이름 및 값을 포함하는 문자열입니다.

예를 들어 http://api.apifactory.com/inventors?name=nick&surname=danger 요청의 경우 message.querystring 값은 name=nick&surname=danger입니다.

 프록시 요청
message.status.code 정수 읽기 전용

대상 응답 메시지의 HTTP 상태 코드입니다.

 대상 응답
message.transport.message TransportMessage 읽기 전용

컨텍스트 객체인 TransportMessage 유형의 메시지입니다.

 프록시 요청
message.uri 문자열 읽기 전용

쿼리 매개변수를 포함한 전체 URI 경로(도메인 URL 뒤에 위치)입니다.

예를 들어 http://api.apifactory.com/inventors?name=nikola&surname=tesla 요청의 경우 이 변수는 inventors?name=nikola&surname=tesla를 반환합니다.

 프록시 요청
message.verb 문자열 읽기 전용

요청과 관련된 HTTP 동사(GET, PUT, POST, DELETE 등)입니다.

 프록시 요청
message.version 문자열 읽기/쓰기

클라이언트 애플리케이션에서 ProxyEndpoint로 전송된 요청과 연결된 HTTP 버전입니다.

 프록시 요청

메시지에 대한 자세한 내용은 메시지 템플릿 함수 참조를 참조하세요.

messageid

요청에 대한 전역 고유 ID의 컨테이너입니다.

다음 표에서는 messageid 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
messageid 문자열 읽기 전용

부하 분산기 호스트 이름을 포함하여 요청에 대한 전역 고유 ID를 보유합니다. 이 ID를 사용하면 부하 분산기에서 수신된 요청을 메시지 프로세서로 전송된 후에 추적할 수 있습니다.

messageid와 오류를 결부시키기 위해 ID는 Apigee 오류 로그에 로깅됩니다.

 프록시 요청

mint

수익 창출 정보를 제공하는 도우미 변수입니다.

다음 표에서는 mint 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
mint.limitscheck.is_request_blocked 부울 읽기 전용

API 요청이 차단되었는지 여부를 지정하는 플래그입니다. is_subscription_found가 false이면 true로 설정합니다.

이 흐름 변수는 MonetizationLimitsCheck 정책이 API 프록시에 연결된 경우에 사용할 수 있습니다. API 프록시에서 수익 창출 한도 적용을 참고하세요.

 프록시 요청
mint.limitscheck.is_subscription_found 부울 읽기 전용

개발자가 API 제품에 대한 활성화된 구독을 가지고 있는지 여부를 지정하는 플래그입니다. 개발자가 정기 결제를 구독하는 경우 true로 설정하세요.

이 흐름 변수는 MonetizationLimitsCheck 정책이 API 프록시에 연결된 경우에 사용할 수 있습니다. API 프록시에서 수익 창출 한도 적용을 참고하세요.

 프록시 요청
mint.limitscheck.prepaid_developer_balance 숫자 읽기 전용

요금제의 통화와 연결된 개발자의 선불 계정 지갑의 현재 잔액입니다.

 프록시 요청
mint.limitscheck.prepaid_developer_currency 문자열 읽기 전용

mint.limitscheck.prepaid_developer_balance 변수에서 사용 가능한 잔액의 통화입니다.

 프록시 요청
mint.limitscheck.purchased_product_name 문자열 읽기 전용

연결된 API 제품의 이름입니다.

이 흐름 변수는 MonetizationLimitsCheck 정책이 API 프록시에 연결된 경우에 사용할 수 있습니다. API 프록시에서 수익 창출 한도 적용을 참고하세요.

 프록시 요청
mint.limitscheck.status_message 문자열 읽기 전용

디버깅 목적의 MonetizationLimitsCheck 정책 실행에 대한 추가 정보입니다.

이 흐름 변수는 MonetizationLimitsCheck 정책이 API 프록시에 연결된 경우에 사용할 수 있습니다. API 프록시에서 수익 창출 한도 적용을 참고하세요.

 프록시 요청
mint.mintng_consumption_pricing_rates 문자열 읽기 전용

소비 기반 요금입니다.

요금제를 만들 때 요금을 설정합니다.

 PostClientFlow
mint.mintng_consumption_pricing_type 문자열 읽기 전용

소비 기반 가격 책정 유형입니다. 예: FIXED_PER_UNIT

요금제를 만들 때 소비 기반 요금을 설정합니다.

 PostClientFlow
mint.mintng_currency 문자열 읽기 전용

수익 계산을 위한 통화입니다.

이 흐름 변수에는 currency 수익 창출 변수의 값이 포함됩니다.

 DataCapture 정책
mint.mintng_dev_share 숫자 읽기 전용

개발자와 공유할 수익입니다.

요금제를 만들 때 개발자와 공유할 수익을 설정합니다.

 PostClientFlow
mint.mintng_is_apiproduct_monetized 부울 읽기 전용

API 제품이 현재 수익을 창출하는지 여부를 지정하는 플래그입니다(즉, 활성 요금제가 적용되는 경우).

이 흐름 변수는 API 프록시에 연결된 VerifyAPIKey 또는 VerifyAccessToken 정책에 의해 추가됩니다. 인증 정책 추가를 참조하세요.

 프록시 요청
mint.mintng_price 숫자 읽기 전용

개발자 공유를 계산할 수익입니다.

흐름 변수에는 revShareGrossPrice 수익 창출 변수의 값이 포함됩니다.

 DataCapture 정책 및 PostClientFlow
mint.mintng_price_multiplier 숫자 읽기 전용

트랜잭션당 비용에 곱할 계수(배수)입니다.

흐름 변수에는 perUnitPriceMultiplier 수익 창출 변수의 값이 포함됩니다.

 DataCapture 정책 및 PostClientFlow
mint.mintng_rate 숫자 읽기 전용

API 호출 요금입니다.

이 흐름 변수는 API 호출당 소비 기반 요금을 보여줍니다. 요금제를 만들 때 소비 기반 요금을 설정합니다. DataCapture 정책에서 perUnitPriceMultiplier 수익 창출 변수를 구성한 경우 Apigee가 perUnitPriceMultiplier 변수의 값을 고려한 후에 트랜잭션 비용을 계산합니다. 자세한 내용은 측정항목의 Api price multiplier를 참조하세요.

 PostClientFlow
mint.mintng_rate_before_multipliers 숫자 읽기 전용

perUnitPriceMultiplier 계산 없이 API 호출에 청구되는 요금입니다.

DataCapture 정책이 perUnitPriceMultiplier 수익 창출 변수를 캡처하는 경우 이 흐름 변수는 perUnitPriceMultiplier로 비용을 곱하기 전의 트랜잭션 비용을 보여줍니다.

 PostClientFlow
mint.mintng_rate_plan_id 문자열 읽기 전용

요금제의 ID입니다.

이 흐름 변수는 API 프록시에 연결된 VerifyAPIKey 또는 VerifyAccessToken 정책에 의해 추가됩니다. 인증 정책 추가를 참조하세요.

 프록시 요청
mint.mintng_revenue_share_rates 문자열 읽기 전용

수익 공유 요금입니다.

요금제를 만들 때 수익 공유 요금을 설정합니다.

 PostClientFlow
mint.mintng_revenue_share_type 문자열 읽기 전용

수익 공유 유형입니다. 예를 들면 FIXED입니다.

요금제를 만들 때 수익 공유 유형을 설정합니다.

 PostClientFlow
mint.mintng_tx_success 부울 읽기 전용

트랜잭션이 수익 창출되는지를 지정합니다.

이 흐름 변수에는 transactionSuccess 수익 창출 변수의 값이 포함됩니다.

 DataCapture 정책
mint.prepaid_updated_developer_usage 숫자 읽기 전용

선불 개발자의 현재 사용량입니다.

사용량은 요금제 구성 및 perUnitPriceMultiplier 수익 창출 변수의 값을 기준으로 계산됩니다.

 PostClientFlow
mint.rateplan_end_time_ms 숫자 읽기 전용

에포크 이후 요금제 만료 시간(밀리초)입니다.

이 흐름 변수는 API 프록시에 연결된 VerifyAPIKey 또는 VerifyAccessToken 정책에 의해 추가됩니다. 인증 정책 추가를 참조하세요.

 프록시 요청
mint.rateplan_start_time_ms 숫자 읽기 전용

에포크 이후 요금제 활성화 시간(밀리초)입니다.

이 흐름 변수는 API 프록시에 연결된 VerifyAPIKey 또는 VerifyAccessToken 정책에 의해 추가됩니다. 인증 정책 추가를 참조하세요.

 프록시 요청
mint.status 문자열 읽기 전용

수익 창출된 호출의 상태입니다. 오류 시에만 채워집니다.

 PostClientFlow
mint.status_code 숫자 읽기 전용

수익 창출된 호출의 HTTP 상태 코드입니다. 오류 시에만 채워집니다.

 PostClientFlow
mint.subscription_end_time_ms 숫자 읽기 전용

에포크 이후 API 제품 구독의 만료 시간(밀리초)입니다.

이 흐름 변수는 MonetizationLimitsCheck 정책이 API 프록시에 연결된 경우에 사용할 수 있습니다. API 프록시에서 수익 창출 한도 적용을 참고하세요.

 프록시 요청
mint.subscription_start_time_ms 숫자 읽기 전용

에포크 이후 API 제품 구독의 활성화 시간(밀리초)입니다.

이 흐름 변수는 MonetizationLimitsCheck 정책이 API 프록시에 연결된 경우에 사용할 수 있습니다. API 프록시에서 수익 창출 한도 적용을 참고하세요.

 프록시 요청
mint.tx_success_result 부울 읽기 전용

트랜잭션에 대해 수익 창출이 성공했는지 여부를 나타냅니다.

mint.tx_success_result 변수는 다음 값을 포함할 수 있습니다.

  • tx_success를 true로 설정: transactionSuccess 변수가 true이고, 트랜잭션이 수익 창출됩니다. 트랜잭션이 수익 창출되므로 mint.mintng_rate 및 mint.mintng_dev_share 변수의 값이 계산됩니다.
  • tx_success를 false로 설정: transactionSuccess 변수가 false이고, 트랜잭션이 수익 창출되지 않습니다. 트랜잭션이 수익 창출되지 않으므로 mint.mintng_rate 및 mint.mintng_dev_share 변수의 값이 계산되지 않습니다.
  • tx_success를 찾을 수 없습니다. 메시지 상태 코드가 2xx가 아님: transactionSuccess 변수가 캡처되지 않고 트랜잭션의 HTTP 상태 코드(message.status.code)가 2xx가 아닙니다. 트랜잭션이 수익 창출되지 않습니다.
  • tx_success를 찾을 수 없습니다. 메시지 상태 코드가 2xx임: transactionSuccess 변수가 캡처되지 않고 트랜잭션의 HTTP 상태 코드(message.status.code)가 2xx입니다. 트랜잭션이 수익 창출됩니다.
 PostClientFlow

자세한 내용은 다음을 참조하세요.

organization

organization.name 속성의 컨테이너입니다.

다음 표에서는 organization 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
organization.name 문자열 읽기 전용

조직의 이름입니다.

 프록시 요청

조직에 대한 자세한 내용은 조직 이해하기를 참조하세요.

proxy

API 프록시 구성

다음 표에서는 proxy 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
proxy.basepath 문자열 읽기 전용

API 프록시 엔드포인트 구성의 기본 경로 값입니다. 기본 경로는 URL의 호스트 다음에 오는 가장 왼쪽 URI의 프래그먼트입니다. 조건부 흐름 URI는 기본 경로를 따릅니다.

기본 경로가 /v2/weatherapi인 API 프록시 엔드포인트가 구성되어 있다고 가정합니다. (자세한 내용은 프록시 엔드포인트 구성을 참조하세요.) 이 경우 인바운드 요청이 URL https://myhost.example.net/v2/weatherapi/forecastrss?w=12797282를 사용하면 다음과 같이 처리됩니다.

  • 호스트 이름은 myhost.example.net입니다. request.header.host 변수를 읽어 이를 검색할 수 있습니다.
  • 기본 경로는 /v2/weatherapi입니다. proxy.basepath 변수를 읽어 검색합니다.
  • 경로 서픽스는 /forecastrss입니다. proxy.pathsuffix 변수를 읽어 검색합니다.

API 프록시 구성에서 /v2/*/weatherapicode>와 같은 동적 기본 경로를 정의하면 proxy.basepath 변수는 동적 경로로 설정됩니다. 요청의 실제 URL을 검색하려면 proxy.url 변수를 읽고 파싱합니다.

 프록시 요청
proxy.client.ip 문자열 읽기 전용

Apigee가 최종 외부 TCP 핸드셰이크에서 수신한 IP 주소인 인바운드 호출의 X-Forwarded-For 주소입니다. 호출 클라이언트 또는 부하 분산기일 수 있습니다.

 프록시 요청
proxy.name 문자열 읽기 전용

ProxyEndpoint에 구성된 이름 속성입니다.

 프록시 요청
proxy.pathsuffix 문자열 읽기 전용

클라이언트에서 전송되고 ProxyEndpoint에 수신되는 URL의 경로 서픽스 값입니다.

기본 경로는 환경 그룹 내에서 API 프록시를 고유하게 식별하는 가장 왼쪽 경로 구성요소입니다. 기본 경로가 /v2/weatherapi인 API 프록시 엔드포인트가 구성되어 있다고 가정합니다. 이 경우 https://myhost.example.net/v2/weatherapi/forecastrss?w=12797282로 전송되는 요청은 proxy.pathsuffix 변수에 /forecastrss 문자열이 포함됩니다.

 프록시 요청
proxy.url 문자열 읽기 전용

쿼리 매개변수를 포함하여 ProxyEndpoint에서 수신한 프록시 요청과 연결된 전체 URL을 가져옵니다.

 프록시 요청

API 프록시 작업에 대한 자세한 내용은 API 및 API 프록시 이해하기를 참조하세요.

publishmessage

PublishMessage 정책이 실행될 때 채워집니다.

속성 유형 읽기/쓰기 설명 범위 시작
publishmessage.message.id 문자열 읽기 전용 Pub/Sub 서버에서 messageId(게시된 메시지의 ID)를 반환합니다.

Apigee는 게시 요청이 성공한 경우에만 이 흐름 변수를 설정합니다.

 프록시 요청

ratelimit

할당량 또는 SpikeArrest 정책이 실행될 때 채워집니다.

다음 표에서는 ratelimit 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
ratelimit.policy_name.allowed.count 긴 형식 읽기 전용 허용되는 할당량 수를 반환합니다. PostClientFlow
ratelimit.policy_name.used.count 긴 형식 읽기 전용 할당량 간격 내에서 사용되는 현재 할당량을 반환합니다. PostClientFlow
ratelimit.policy_name.available.count 긴 형식 읽기 전용 할당량 간격에서 사용 가능한 할당량 수를 반환합니다. PostClientFlow
ratelimit.policy_name.exceed.count 긴 형식 읽기 전용 할당량을 초과하면 1을 반환합니다. PostClientFlow
ratelimit.policy_name.total.exceed.count 긴 형식 읽기 전용 할당량을 초과하면 1을 반환합니다. PostClientFlow
ratelimit.policy_name.expiry.time 긴 형식 읽기 전용

할당량이 만료되는 시점과 새 할당량 간격이 시작되는 시기를 결정하는 UTC 시간(밀리초)을 반환합니다.

할당량 정책 유형이 rollingwindow이면 할당량 간격이 만료되지 않으므로 이 값은 유효하지 않습니다.

 PostClientFlow
ratelimit.policy_name.identifier 문자열 읽기 전용 정책에 연결된 (클라이언트) 식별자 참조를 반환합니다. PostClientFlow
ratelimit.policy_name.class 문자열 읽기 전용 클라이언트 식별자와 연결된 클래스를 반환합니다. PostClientFlow
ratelimit.policy_name.class.allowed.count 긴 형식 읽기 전용 클래스에 정의된 허용 할당량 수를 반환합니다. PostClientFlow
ratelimit.policy_name.class.used.count 긴 형식 읽기 전용 클래스 내에서 사용된 할당량을 반환합니다. PostClientFlow
ratelimit.policy_name.class.available.count 긴 형식 읽기 전용 클래스에서 사용 가능한 할당량 수를 반환합니다. PostClientFlow
ratelimit.policy_name.class.exceed.count 긴 형식 읽기 전용 현재 할당량 간격의 클래스 한도를 초과하는 요청 수를 반환합니다. PostClientFlow
ratelimit.policy_name.class.total.exceed.count 긴 형식 읽기 전용 모든 할당량 간격에서 클래스의 한도를 초과하는 요청의 총 개수를 반환하므로 모든 할당량 간격에 대한 class.exceed.count 합계입니다. PostClientFlow
ratelimit.policy_name.failed 부울 읽기 전용

정책 실패 여부를 나타냅니다(true 또는 false).

 PostClientFlow

자세한 내용은 다음을 참조하세요.

request

제공된 페이로드를 포함한 전체 요청입니다.

요청 데이터에 대한 자세한 내용은 요청 데이터는 백엔드 서버로 어떻게 전달되나요?를 참조하세요.

다음 표에서는 request 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
request message 읽기 전용

제공된 페이로드를 포함한 전체 요청입니다.

 프록시 요청
request.content 문자열 읽기/쓰기

요청 메시지의 페이로드를 가져오거나 설정합니다.

 프록시 요청
request.formparam.param_name 문자열 읽기/쓰기

클라이언트 애플리케이션에서 전송된 요청에서 지정된 양식 매개변수 값을 가져오거나 설정합니다.

 프록시 요청
request.formparam.param_name.
 values		 컬렉션 읽기 전용

요청에 있는 특정 양식 매개변수의 모든 값이며 쉼표로 구분된 목록 형식으로 되어 있습니다.

예를 들어 페이로드가 a=hello&x=greeting&a=world이면 request.formparam.a.values 값은 ['hello', 'world']입니다.

 프록시 요청
request.formparam.param_name.
 values.count		 정수 읽기 전용

요청과 연결된 지정된 양식 매개변수의 모든 값의 수입니다.

 프록시 요청
request.formparam.param_name.N 문자열 읽기/쓰기

메시지에서 N번째 특정 양식 매개변수 값입니다. 예를 들어 양식 문자열이 a=hello&a=world이면 request.formparam.a.1의 반환 값은 hello입니다.

 프록시 요청
request.formparams.count 정수 읽기 전용

클라이언트 애플리케이션에서 전송된 요청과 연결된 모든 매개변수의 수입니다.

 프록시 요청
request.formparams.names 컬렉션 읽기 전용

요청과 연결된 모든 매개변수 이름의 목록입니다.

 프록시 요청
request.formparams.names.string 문자열 읽기 전용

요청과 연결된 모든 양식 매개변수 이름을 쉼표로 구분한 목록입니다.

 프록시 요청
request.formstring 문자열 읽기 전용

클라이언트 앱에서 전송된 요청의 전체 formparam입니다.

예를 들면 name=test&type=first&group=A입니다.

 프록시 요청
request.grpc.rpc.name 문자열 읽기 전용

gRPC 대상 서버를 사용할 때만 적용됩니다. RPC 이름입니다. gRPC 프록시에 대한 자세한 내용은 gRPC API 프록시 만들기를 참조하세요.

프록시 요청
request.grpc.service.name 문자열 읽기 전용

gRPC 대상 서버를 사용할 때만 적용됩니다. gRPC 상태 서비스 이름입니다. gRPC 프록시에 대한 자세한 내용은 gRPC API 프록시 만들기를 참조하세요.

프록시 요청
request.header.header_name 문자열 읽기/쓰기

요청에서 발견한 특정 헤더의 값을 가져오거나 설정합니다. 헤더에 쉼표가 포함된 경우, 읽을 때 첫 번째 쉼표까지만 텍스트 세그먼트를 수신합니다.

예를 들어 Cache-control 헤더가 public, maxage=16544이면 request.header.cache-control의 반환 값은 public입니다.

전체 헤더를 문자열로 사용하려면 request.header.header_name.values.string과 같은 변수를 사용합니다.

 프록시 요청
request.header.header_name.N 문자열 읽기/쓰기

요청에서 N번째 특정 헤더의 값입니다. Apigee는 헤더 텍스트 값을 쉼표로 분할합니다. 색인은 가장 왼쪽 값에 대해 1부터 시작합니다.

예를 들어 Cache-control 헤더가 public, maxage=16544이면 request.header.cache-control.2의 반환 값은 maxage=16544입니다.

 프록시 요청
request.header.header_name.
 values		 컬렉션 읽기 전용

요청에서 특정 헤더의 모든 값입니다.

 프록시 요청
request.header.header_name.
 values.count		 정수 읽기 전용

요청에서 특정 헤더의 모든 값의 수입니다.

 프록시 요청
request.header.header_name.
 values.string		 문자열 읽기 전용

요청에서 단일 문자열 형식으로 된 특정 헤더의 모든 값입니다.

예를 들어 Cache-control 헤더가 public, maxage=16544이면 request.header.cache-control.values.string의 반환 값은 public, maxage=16544입니다.

 프록시 요청
request.headers.count 정수 읽기 전용

요청에서 모든 헤더의 수입니다.

 프록시 요청
request.headers.names 컬렉션 읽기 전용

요청에서 모든 헤더의 이름입니다.

 프록시 요청
request.headers.names.string 문자열 읽기 전용

요청의 모든 헤더 이름을 쉼표로 구분한 목록입니다.

 프록시 요청
request.path 문자열 읽기 전용

쿼리 매개변수를 제외하고 백엔드 서비스에 대한 프록시되지 않은 리소스 경로(호스트 제외)입니다.

예를 들어 백엔드 서비스의 URI가 https://example.com/rest/api/latest이면 request.path의 값은 /rest/api/latest입니다.

 프록시 요청
request.queryparam.param_name 문자열 읽기/쓰기

요청에서 발견한 특정 쿼리 매개변수의 값입니다.

 프록시 요청
request.queryparam.param_name.N 문자열 읽기/쓰기

요청에 있는 N번째 쿼리 매개변수의 값입니다.

예를 들어,request.querystring이 a=hello&a=world인 경우 request.queryparam.a.1의 반환 값은 hello입니다.

단일 쿼리 매개변수 이름(예: type=siteid:1&type=language:us-en&type=currency:USD)에 여러 값을 작성하는 예시를 보려면 다음을 설정합니다.

  • siteid:1에게 request.queryparam.type.1 부여
  • request.queryparam.type.2에서 language:en-us으로 변환
  • currency:USD에게 request.queryparam.type.3 부여
 프록시 요청
request.queryparam.param_name.
 values		 컬렉션 읽기 전용

요청에 있는 특정 쿼리 매개변수의 모든 값이며 쉼표로 구분된 목록 형식으로 되어 있습니다.

예를 들어 request.querystring이 a=hello&b=lovely&a=world이면 request.queryparam.a.values의 값은 ['hello', 'world']입니다.

 프록시 요청
request.queryparam.param_name.
 values.count		 정수 읽기 전용

요청에서 특정 쿼리 매개변수의 모든 값의 수입니다.

 프록시 요청
request.queryparams.count 정수 읽기 전용

요청에서 모든 쿼리 매개변수의 수입니다.

 프록시 요청
request.queryparams.names 컬렉션 읽기 전용

요청에서 모든 쿼리 매개변수의 이름입니다.

 프록시 요청
request.queryparams.names.string 문자열 읽기 전용

요청에 있는 모든 쿼리 매개변수의 이름을 쉼표로 구분한 목록입니다.

 프록시 요청
request.querystring 문자열 읽기 전용

클라이언트 앱에서 전송된 요청의 전체 쿼리 매개변수 목록입니다.

예를 들어 요청이 http://host.com/123?name=first&surname=second&place=address이면 이 변수는 name=first&surname=second&place=address를 반환합니다.

 프록시 요청
request.transportid 문자열 읽기 전용

컨텍스트인 TransportMessage 유형의 요청 ID입니다.

 프록시 요청
request.transport.message 전송 메시지 읽기 전용

컨텍스트인 TransportMessage 유형의 요청입니다.

 프록시 요청
request.uri 문자열 읽기 전용

API 프록시에서 프록시의 기본 URL 외에도 ProxyEndpoint의 프록시 <BasePath>는 TargetEndpoint의 대상 서비스 URL에 매핑됩니다. 예를 들면 다음과 같습니다.

<ProxyEndpoint>
...
  <BasePath>/my-mock-proxy</BasePath>

가리키는 대상

<TargetEndpoint>
...
  <HTTPTargetConnection>
    http://mocktarget.apigee.net
  </HTTPTargetConnection>

요청에서 request.uri는 프록시 기본 경로 + 쿼리 매개변수를 포함한 주소의 나머지 부분입니다.

응답에서 request.uri는 HTTPTargetConnection 이후 쿼리 매개변수를 포함한 주소의 나머지 부분입니다.

원래 요청은 프록시에 들어왔는데 프록시는 대상 서비스에 또 다른 요청을 수행하기 때문에 차이가 발생합니다.

/my-mock-proxy의 기본 경로가 있는 샘플 프록시에 대해 다음 호출이 수행되었다고 가정해 보겠습니다.

http://my_org-test.apigee.net/my-mock-proxy/user?user=Dude

프록시는 다음을 호출합니다.

http://mocktarget.apigee.net

이는 /user?user=Dude를 해당 URL에 추가합니다.

  • 요청 request.uri = /my-mock-proxy/user?user=Dude
  • 응답: request.uri = /user?user=Dude
 프록시 요청(응답에서 차이를 보임)
request.url 문자열 읽기 전용

대상 엔드포인트에 대한 요청의 전체 URL이며, 쿼리 문자열 매개변수는 포함하지만 포트 번호(지정된 경우)는 포함되지 않습니다.

예를 들어 샘플 프록시 http://my_org-test.apigee.net/my-mock-proxy/user?user=Dude를 호출하고 대상 엔드포인트가 http://example.com:8080인 경우 값은 다음과 같습니다.

  • 요청: 해당 없음
  • 응답: http://example.com/user?user=Dude
 대상 응답
request.verb 문자열 읽기 전용

요청에 사용되는 HTTP 동사입니다. 예를 들면 GET, PUT, DELETE입니다.

 프록시 요청
request.version 문자열 읽기 전용

요청의 HTTP 버전입니다. 예를 들면 1.1입니다.

 프록시 요청

response

제공된 페이로드를 포함한 전체 응답입니다.

다음 표에서는 response 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
response message 읽기/쓰기

대상이 반환한 전체 응답 메시지입니다.

 대상 응답
response.content 문자열 읽기/쓰기

대상이 반환한 응답 메시지의 페이로드 콘텐츠입니다.

 대상 응답
response.header.header_name 문자열 읽기/쓰기

응답에서 지정된 HTTP 헤더 값을 가져오거나 설정합니다.

헤더 텍스트에 쉼표가 포함된 경우 Apigee는 여러 값을 추론합니다. 이 경우 response.header.header_name은 첫 번째 값만 반환합니다.

예를 들어 Cache-control 헤더가 public,maxage=16544이면 response.header.cache-control의 반환 값은 public입니다.

전체 헤더를 문자열로 사용하려면 response.header.header_name.values.string과 같은 변수를 사용합니다.

 대상 응답
response.header.header_name.
 values		 컬렉션 읽기 전용

응답에서 지정된 HTTP 헤더의 모든 값입니다.

 대상 응답
response.header.header_name.
 values.count		 정수 읽기 전용

응답에서 지정된 HTTP 헤더의 모든 값의 수입니다.

 대상 응답
response.header.header_name.
 values.string		 문자열 읽기 전용

응답에서 단일 문자열 형식으로 된 특정 헤더의 모든 값입니다.

예를 들어 Cache-control 헤더가 public,maxage=16544이면 response.header.cache-control.values.string의 반환 값은 public,maxage=16544입니다.

 대상 응답
response.header.header_name.N 문자열 읽기/쓰기

응답에서 N번째 특정 헤더 값의 값입니다. Apigee는 헤더 텍스트 값을 쉼표로 분할합니다. 색인은 가장 왼쪽 값에 대해 1부터 시작합니다.

예를 들어 Cache-control 헤더가 public,maxage=16544이면 response.header.cache-control.2은 maxage=16544를 반환합니다.

 대상 응답
response.headers.count 정수 읽기 전용

응답에서 모든 헤더의 수입니다.

 대상 응답
response.headers.names 컬렉션 읽기 전용

응답에서 모든 헤더의 이름입니다.

 대상 응답
response.headers.names.string 문자열 읽기 전용

응답에서 모든 헤더의 이름을 쉼표로 구분한 목록입니다.

 대상 응답
response.reason.phrase 문자열 읽기/쓰기

특정 요청에 대한 응답 이유 구문입니다.

 대상 응답
response.status.code 정수 읽기/쓰기

요청에 대해 반환된 응답 코드입니다. 이 변수를 사용하여 message.status.code에 저장된 응답 상태 코드를 재정의할 수 있습니다. 자세한 내용은 message를 참조하세요.

 대상 응답
response.transport.message 문자열 읽기 전용

컨텍스트 객체인 TransportMessage 유형의 응답입니다.

 대상 응답

route

<RouteRule> 및 TargetEndpoint의 이름을 지정합니다.

다음 표에서는 route 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
route.name 문자열 읽기 전용

ProxyEndpoint에서 실행된 <RouteRule>의 이름입니다. 예를 들면 default입니다. RouteRule은 실행할 API 프록시 TargetEndpoint를 참조합니다.

 대상 요청
route.target 문자열 읽기 전용

실행된 TargetEndpoint의 이름입니다. 예를 들면 default입니다.

 대상 요청

servicecallout

ServiceCallout 정책에 대한 TargetEndpoint를 설명합니다.

다음 표에서는 servicecallout 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
servicecallout.policy_name.expectedcn 문자열 읽기/쓰기

ServiceCallout 정책에서 참조하는 TargetEndpoint의 일반적인 예상 이름입니다. 이는 TargetEndpoint가 TLS/SSL 엔드포인트를 참조하는 경우에만 의미가 있습니다.

 프록시 요청
servicecallout.policy_name.target.url 문자열 읽기/쓰기

특정 ServiceCallout 정책의 TargetEndpoint URL입니다.

 프록시 요청
servicecallout.requesturi 문자열 읽기/쓰기

ServiceCallout 정책의 TargetEndpoint URI입니다. URI는 프로토콜 및 도메인 사양이 없는 TargetEndpoint URL입니다.

 프록시 요청

system

시스템의 IP 주소 및 프록시에 대한 세부정보를 지정합니다.

다음 표에서는 system 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
system.interface.interface_name 문자열 읽기 전용

시스템의 IP 주소입니다.

 프록시 요청
system.pod.name 문자열 읽기 전용

프록시가 실행 중인 pod의 이름입니다.

 프록시 요청
system.region.name 문자열 읽기 전용

프록시가 실행 중인 데이터 센터 리전의 이름입니다.

 프록시 요청
system.time 문자열 읽기 전용

이 변수를 읽은 시간입니다. 예를 들어 2013년 8월 21일 수요일 19:16:47 GMT입니다.

이 값은 해당 값인 system.timestamp의 문자열 표현입니다. 예를 들어 2013년 8월 21일 수요일 19:16:47 GMT는 타임스탬프 값 1377112607413에 해당합니다.

 프록시 요청
system.time.year 정수 읽기 전용

system.time의 연도 부분입니다.

 프록시 요청
system.time.month 정수 읽기 전용

system.time의 월 부분입니다.

 프록시 요청
system.time.day 정수 읽기 전용

system.time의 날짜 부분입니다.

 프록시 요청
system.time.dayofweek 정수 읽기 전용

system.time의 요일 부분입니다.

 프록시 요청
system.time.hour 정수 읽기 전용

system.time의 시 부분입니다.

 프록시 요청
system.time.minute 정수 읽기 전용

system.time의 분 부분입니다.

 프록시 요청
system.time.second 정수 읽기 전용

system.time의 초 부분입니다.

 프록시 요청
system.time.millisecond 정수 읽기 전용

system.time의 밀리초 부분입니다.

 프록시 요청
system.time.zone 문자열 읽기 전용

시스템의 시간대입니다.

 프록시 요청
system.timestamp 긴 형식 읽기 전용

이 변수를 읽은 시간을 나타내는 64비트(long) 정수입니다. 1970년 1월 1일(UTC) 자정부터 경과한 시간을 밀리초 단위로 나타낸 값입니다. 예를 들면 1534783015000입니다.

 프록시 요청
system.uuid 문자열 읽기 전용

프록시를 처리하는 메시지 프로세서의 UUID입니다.

 프록시 요청

target

요청 대상을 설명합니다.

다음 표에서는 target 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
target.basepath 문자열 읽기 전용

프록시의 TargetEndpoint에 정의된 대상 서비스(쿼리 매개변수 제외)에 대한 리소스 경로(도메인 제외)입니다.

예를 들어 API 프록시가 다음 대상을 호출한다고 가정해 보겠습니다.

<TargetEndpoint name="default">
...
  <HTTPTargetConnection>
    <URL>http://mocktarget.apigee.net/user?user=Dude</URL>
  </HTTPTargetConnection>

이 예시에서 target.basepath는 /user입니다.

대상이 다음과 같은 경우:

<TargetEndpoint name="default">
...
  <HTTPTargetConnection>
    <URL>http://mocktarget.apigee.net</URL>
  </HTTPTargetConnection>

target.basepath는 null입니다.

 대상 요청
target.copy.pathsuffix 부울 읽기/쓰기

true인 경우 ProxyEndpoint에서 TargetEndpoint로 전달되는 요청은 경로 서픽스(ProxyEndpoint 기본 경로에 정의된 URI 뒤에 오는 URI 경로 프로그래먼트)를 보유합니다.

 대상 요청
target.copy.queryparams 부울 읽기/쓰기

true인 경우 ProxyEndpoint에서 TargetEndpoint로 전달되는 요청은 쿼리 매개변수를 보유합니다.

 대상 요청
target.country 문자열 읽기 전용

대상 서버에서 제공한 TLS/SSL 인증서의 국가입니다.

 대상 응답
target.cn 문자열 읽기 전용

TargetEndpoint의 일반 이름입니다. 이는 TargetEndpoint가 TLS/SSL 엔드포인트를 참조하는 경우에만 의미가 있습니다.

 대상 요청
target.email.address 문자열 읽기 전용

대상 서버에서 제공한 TLS/SSL 인증서의 이메일 주소입니다.

 대상 응답
target.expectedcn 문자열 읽기/쓰기

TargetEndpoint의 일반 이름입니다. 이는 TargetEndpoint가 TLS/SSL 엔드포인트를 참조하는 경우에만 의미가 있습니다.

 프록시 요청
target.host 문자열 읽기 전용

API 프록시에 응답을 반환하는 대상 서비스의 도메인 이름입니다.

 대상 응답
target.ip 문자열 읽기 전용

API 프록시에 응답을 반환하는 대상 서비스의 IP 주소입니다.

 대상 응답
target.locality 문자열 읽기 전용

대상 서버에서 제공한 TLS/SSL 인증서의 지역(도시)입니다.

 대상 응답
target.name 문자열 읽기 전용

targetendpoint에서 메시지가 도달하는 대상입니다.

 대상 요청
target.organization 문자열 읽기 전용

대상 서버에서 제공한 TLS/SSL 인증서의 조직입니다.

 대상 응답
target.organization.unit 문자열 읽기 전용

대상 서버에서 제공한 TLS/SSL 인증서의 조직 단위입니다.

 대상 응답
target.port 정수 읽기 전용

API 프록시에 대한 응답을 반환하는 대상 서비스의 포트 번호입니다.

 대상 응답
target.received.end.time 문자열 읽기 전용

TargetEndpoint가 대상으로부터 응답 수신을 완료한 시간을 문자열 형식으로 표현한 것입니다. 예를 들어 'Wed, 21 Aug 2013 19:16:47 UTC'입니다.

이 시간 값은 해당 32비트 타임스탬프 수량의 문자열 표현입니다. 예를 들어 'Wed, 21 Aug 2013 19:16:47 UTC'는 타임스탬프 값 1377112607413에 해당합니다.

 대상 응답
target.received.end.
  timestamp		 긴 형식 읽기 전용

TargetEndpoint가 대상으로부터 응답 수신을 완료한 시간을 지정하는 타임스탬프 값입니다. 예를 들면 1534783015000입니다. 1970년 1월 1일(UTC) 자정부터 경과한 시간(밀리초)을 포함하는 64비트(long) 정수 값입니다.

 대상 응답
target.received.start.time 문자열 읽기 전용

TargetEndpoint가 대상으로부터 응답 수신을 시작한 시간을 문자열 형식으로 표현한 것입니다. 예를 들어 'Wed, 21 Aug 2013 19:16:47 UTC'입니다.

이 시간 값은 해당 32비트 타임스탬프 수량의 문자열 표현입니다. 예를 들어 'Wed, 21 Aug 2013 19:16:47 UTC'는 타임스탬프 값 1377112607413에 해당합니다.

 대상 응답
target.received.start.
  timestamp		 긴 형식 읽기 전용

TargetEndpoint가 대상으로부터 응답 수신을 시작한 시간을 지정하는 타임스탬프 값입니다. 예를 들면 1534783015000입니다. 1970년 1월 1일(UTC) 자정부터 경과한 시간(밀리초)을 포함하는 64비트(long) 정수 값입니다.

 대상 응답
target.scheme 문자열 읽기 전용

범위 시작: 대상 응답
유형: 문자열
권한: 읽기/쓰기

요청 메시지에 따라 http 또는 https를 반환합니다.

 대상 요청
target.sent.end.time 문자열 읽기 전용

프록시가 TargetEndpoint에 지정된 URL로 요청 전송을 중단한 시간을 문자열 형식으로 표현한 것입니다. 예를 들어 'Wed, 21 Aug 2013 19:16:47 UTC'입니다.

이 시간 값은 해당 32비트 타임스탬프 수량의 문자열 표현입니다. 예를 들어 'Wed, 21 Aug 2013 19:16:47 UTC'는 타임스탬프 값 1377112607413에 해당합니다.

 대상 요청
target.sent.end.timestamp 긴 형식 읽기 전용

프록시가 TargetEndpoint에 지정된 URL로 요청 전송을 완료한 시간을 지정하는 타임스탬프 값입니다. 예를 들어 1377112607413입니다. 1970년 1월 1일(UTC) 자정부터 경과한 시간(밀리초)을 포함하는 64비트(long) 정수 값입니다.

 대상 요청
target.sent.start.time 문자열 읽기 전용

프록시가 TargetEndpoint에 지정된 URL로 요청 전송을 시작한 시간을 문자열 형식으로 표현한 것입니다. 예를 들어 'Wed, 21 Aug 2013 19:16:47 UTC'입니다.

이 시간 값은 해당 32비트 타임스탬프 수량의 문자열 표현입니다. 예를 들어 'Wed, 21 Aug 2013 19:16:47 UTC'는 타임스탬프 값 1377112607413에 해당합니다.

 대상 요청
target.sent.start.timestamp 긴 형식 읽기 전용

프록시가 TargetEndpoint에 지정된 URL로 요청 전송을 시작한 시간을 지정하는 타임스탬프 값입니다. 예를 들면 1534783015000입니다. 1970년 1월 1일(UTC) 자정부터 경과한 시간(밀리초)을 포함하는 64비트(long) 정수 값입니다.

 대상 요청
target.ssl.enabled 부울 읽기 전용

TargetEndpoint가 TLS/SSL에서 실행 중인지 여부를 나타냅니다.

 프록시 요청
target.state 문자열 읽기 전용

대상 서버에서 제공한 TLS/SSL 인증서의 상태입니다.

 대상 응답
target.url 문자열 읽기/쓰기

TargetEndpoint XML 파일 또는 동적 대상 URL에서 구성된 URL(메시지 흐름 중에 target.url가 설정된 경우)입니다. 변수는 추가 경로 요소 또는 쿼리 매개변수를 포함하지 않습니다. 지원 범위를 벗어나거나 설정되지 않은 경우 null을 반환합니다.

 대상 요청

variable

variable.expectedcn 속성의 컨테이너입니다.

다음 표에서는 variable 변수의 속성을 설명합니다.

속성 유형 읽기/쓰기 설명 범위 시작
variable.expectedcn 문자열 읽기/쓰기

TLS/SSL에서 실행 중인 경우 일반 이름에 노출된 변수입니다.

 프록시 요청

TLS 작업에 대한 자세한 내용은 TLS 구성 옵션을 참조하세요.