Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

엔드포인트 속성 참조

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

이 주제에서는 메시지와 연결 동작을 제어하기 위해 TargetEndpoint 및 ProxyEndpoint 구성에서 설정할 수 있는 전송 속성에 대해 설명합니다. TargetEndpoint 및 ProxyEndpoint 구성의 전체 콘텐츠는 API 프록시 구성 참조를 확인하세요.

TargetEndpoint 전송 속성

TargetEndpoint 구성의 HTTPTargetConnection 요소는 HTTP 전송 속성 집합을 정의합니다. 이러한 속성을 사용하여 전송 수준 구성을 설정할 수 있습니다.

속성은 아래와 같이 TargetEndpoint HTTPTargetConnection 요소에 설정됩니다.

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <URL>http://mocktarget.apigee.net</URL>
    <Properties>
      <Property name="supports.http10">true</Property>
      <Property name="request.retain.headers">User-Agent,Referer,Accept-Language</Property>
      <Property name="retain.queryparams">apikey</Property>
    </Properties>
    <CommonName>COMMON_NAME_HERE</CommonName>
  </HTTPTargetConnection>
</TargetEndpoint>

TargetEndpoint 전송 속성 사양

속성 이름	기본값	설명
`keepalive.timeout.millis`	`60000`	연결 풀에서 대상 연결의 연결 유휴 상태 제한 시간. 풀의 연결이 지정된 한도를 초과하여 유휴 상태이면 연결이 닫힙니다.
`connect.timeout.millis`	`3000`	대상 연결 제한 시간. 연결 시간 초과가 발생하면 Edge는 HTTP `503` 상태 코드를 반환합니다. TargetServer 정의에 `LoadBalancer` 가 사용되고 시간 초과가 발생하면 HTTP 504 상태 코드가 반환될 수 있습니다. 참고: 경우에 따라 Apigee는 최대 세 번까지 자동으로 연결을 재시도합니다. 따라서 총 재시도 시간이 `connect.timeout.millis`에 구성된 시간을 초과할 수 있습니다.
`io.timeout.millis`	`55000`	지정된 밀리초 동안 읽을 데이터가 없거나 지정된 밀리초 동안 소켓 데이터를 작성할 준비가 되지 않은 경우, 트랜잭션이 시간 초과로 처리됩니다. HTTP 요청을 작성하는 동안 시간 초과가 발생하면 `408, Request Timeout`이 반환됩니다. HTTP 응답을 읽는 동안 시간 초과가 발생하면 `504, Gateway Timeout` 이 반환됩니다. 이 값은 항상 가상 호스트의 proxy_read_timeout 속성 값보다 작아야 합니다. 이 값은 라우터가 메시지 프로세서와 통신하는 데 사용하는 시간 초과보다 작아야 합니다. 자세한 내용은 라우터 시간 초과 구성을(를) 참조하세요. 자세한 내용은 Edge의 io.timeout.millis 및 api.timeout 설정 을 참조하세요.
`supports.http10`	`true`	이 값이 `true`이고 클라이언트가 1.0 요청을 전송하면 대상에도 1.0 요청이 전송됩니다. 그 외의 경우 1.1 요청이 대상으로 전송됩니다.
`supports.http11`	`true`	이 값이 `true`이고 클라이언트가 1.1 요청을 전송하면 대상에도 1.1 요청이 전송됩니다. 그렇지 않으면 1.0 요청이 대상으로 전송됩니다.
`use.proxy`	`true`	이것이 `true`로 설정되어 있고 프록시 구성이 `http.properties` (온프레미스 배포만 해당)에 지정된 경우 대상 연결이 지정된 프록시를 사용하도록 설정됩니다.
`use.proxy.tunneling`	`true`	이것이 `true`로 설정되어 있고 프록시 구성이 `http.properties` (온프레미스 배포만 해당)에 지정된 경우 대상 연결이 지정된 터널을 사용하도록 설정됩니다. 대상이 TLS/SSL을 사용하는 경우 이 속성은 무시되며 항상 터널을 통해 전송됩니다.
`enable.method.override`	`false`	지정된 HTTP 메서드의 경우 대상 서비스에 대한 아웃바운드 요청에서 `X-HTTP-Method-Override` 헤더를 설정합니다. 예를 들면 `<Property name="GET.override.method">POST</Property>`입니다.
`*.override.method`	해당 없음	지정된 HTTP 메서드의 경우 아웃바운드 요청에서 `X-HTTP-Method-Override` 헤더를 설정합니다. 예를 들면 `<Property name="GET.override.method">POST</Property>`입니다.
`request.streaming.enabled`	`false`	기본적으로 (`false`) HTTP 요청 페이로드는 버퍼로 읽히며 페이로드에서 작동하는 정책은 예상대로 작동합니다. 페이로드가 버퍼 사이즈 (10MB)보다 큰 경우 이 속성을 `true`로 설정할 수 있습니다. `true`이면 HTTP 요청 페이로드가 버퍼로 읽히지 않으며 있는 그대로 대상 엔드포인트에 스트리밍됩니다. 이 경우 TargetEndpoint 요청 흐름의 페이로드에서 작동하는 모든 정책이 우회됩니다. 스트리밍 요청 및 응답도 참조하세요.
`response.streaming.enabled`	`false`	기본적으로 (`false`) HTTP 응답 페이로드는 버퍼로 읽히며 페이로드에서 작동할 수 있는 정책은 예상대로 작동합니다. 페이로드가 버퍼 사이즈 (10MB)보다 큰 경우 이 속성을 `true`로 설정할 수 있습니다. `true`이면 HTTP 응답 페이로드가 버퍼로 읽히지 않으며 있는 그대로 ProxyEndpoint 응답 흐름에 스트리밍됩니다. 이 경우 TargetEndpoint 응답 흐름의 페이로드에서 작동하는 모든 정책이 우회됩니다. 스트리밍 요청 및 응답 도 참조하세요.
`success.codes`	해당 없음	기본적으로 Apigee Edge는 HTTP 코드 `4XX` 또는 `5XX`를 오류로 처리하고 HTTP 코드 `1XX`, `2XX`, `3XX`를 성공으로 취급합니다. 이 속성은 성공 코드를 명시적으로 정의할 수 있습니다. 예를 들어 `2XX, 1XX, 505`는 모든 `100`, `200` 및 `505` HTTP 응답 코드를 성공으로 취급합니다. 이 속성을 설정하면 기본값을 덮어씁니다. 따라서 기본 성공 코드 목록에 HTTP 코드 `400`를 추가하려면 이 속성을 다음과 같이 설정합니다. <Property name="success.codes">1XX,2XX,3XX,400</Property> HTTP 코드 `400`만 성공 코드로 취급하려면 속성을 다음과 같이 설정합니다. <Property name="success.codes">400</Property> HTTP 코드 `400`을 유일한 성공 코드로 설정하면 코드 `1XX`, `2XX`, `3XX`이 실패로 취급됩니다.
`compression.algorithm`	해당 없음	기본적으로 Apigee Edge는 클라이언트 요청과 동일한 압축 유형 을 사용하여 요청을 대상으로 전달합니다. 예를 들어 gzip 압축을 사용하여 클라이언트로부터 요청을 수신한 경우 Apigee Edge는 gzip 압축을 사용하여 요청을 대상으로 전달합니다. 대상에서 수신한 응답이 deflate를 사용하는 경우 Apigee Edge는 deflate를 사용하여 응답을 클라이언트에 전달합니다. 지원되는 값은 다음과 같습니다. gzip: 항상 gzip 압축을 사용하여 메시지 전송 deflate: 항상 deflate 압축을 사용하여 메시지 전송 없음: 항상 압축 없이 메시지 전송 참조: Apigee는 GZIP/deflate 압축 방식의 압축/압축 풀기를 지원하나요?
`request.retain.headers. enabled`	`true`	기본적으로 Apigee Edge는 발신 메시지에 모든 HTTP 헤더를 항상 보관합니다. ``true``로 설정하면 인바운드 요청에 있는 모든 HTTP 헤더가 아웃바운드 요청에 설정됩니다.
`request.retain.headers`	해당 사항 없음	대상 서비스에 대한 아웃바운드 요청에서 설정해야 하는 요청에서 특정 HTTP 헤더를 정의합니다. 예를 들어 `User-Agent` 헤더를 패스 스루하려면 `request.retain.headers` 값을 `User-Agent`로 설정합니다. 여러 HTTP 헤더는 쉼표로 구분된 목록(예: `User-Agent,Referer,Accept-Language`)으로 지정됩니다. 이 속성은 `request.retain.headers.enabled`를 재정의합니다. `request.retain.headers.enabled` 가 `false`로 설정된 경우 `request.retain.headers` 속성에 지정된 헤더는 여전히 발신 메시지에 설정됩니다.
`response.retain.headers. enabled`	`true`	기본적으로 Apigee Edge는 발신 메시지에 모든 HTTP 헤더를 항상 보관합니다. ``true``로 설정하면 대상 서비스의 인바운드 응답에 있는 모든 HTTP 헤더가 ProxyEndpoint에 전달되기 전에 아웃바운드 응답에 설정됩니다.
`response.retain.headers`	해당 없음	ProxyEndpoint로 전달하기 전에 아웃바운드 응답에서 설정해야 하는 응답에서 특정 HTTP 헤더를 정의합니다. 예를 들어 패스 스루하려면 `Expires` 헤더를 `response.retain.headers` 값을 `Expires`로 설정합니다. 여러 HTTP 헤더는 쉼표로 구분된 목록(예: `Expires,Set-Cookie`)으로 지정됩니다. 이 속성은 `response.retain.headers.enabled`를 재정의합니다. `response.retain.headers.enabled`가 `false`로 설정된 경우 `response.retain.headers` 속성에 지정된 헤더는 여전히 발신 메시지에 설정됩니다.
`retain.queryparams. enabled`	`true`	기본적으로 Apigee Edge는 아웃바운드 요청에 대한 모든 쿼리 매개변수를 보관합니다. ``true``로 설정하면 인바운드 요청에 있는 모든 쿼리 매개변수가 대상 서비스에 대한 아웃바운드 요청에 설정됩니다.
`retain.queryparams`	해당 사항 없음	아웃바운드 요청에 설정할 특정 쿼리 매개변수를 정의합니다. 예를 들어 요청 메시지의 쿼리 매개변수 `apikey`를 포함하려면 `retain.queryparams`를 `apikey`로 설정합니다. 여러 쿼리 매개변수는 쉼표로 구분된 목록(예: `apikey,environment`)으로 지정됩니다. 이 속성은 `retain.queryparams.enabled`를 재정의합니다.

ProxyEndpoint 전송 속성

ProxyEndpoint HTTPTargetConnection 요소는 HTTP 전송 속성 집합을 정의합니다. 이러한 속성을 사용하여 전송 수준 구성을 설정할 수 있습니다.

속성은 다음과 같이 ProxyEndpoint HTTPProxyConnection 요소에 설정됩니다.

<ProxyEndpoint name="default">
  <HTTPProxyConnection>
    <BasePath>/v1/weather</BasePath>
    <Properties>
      <Property name="request.streaming.enabled">true</Property>
    </Properties>
    <VirtualHost>default</VirtualHost>
    <VirtualHost>secure</VirtualHost>
  </HTTPProxyConnection>
</ProxyEndpoint>

가상 호스트에 대한 상세 내용은 가상 호스트 정보를 참조하세요.

ProxyEndpoint 전송 속성 사양

속성 이름	기본값	설명
`X-Forwarded-For`	`false`	`true`로 설정하면 가상 호스트의 IP 주소가 아웃바운드 요청에 HTTP `X-Forwarded-For` 헤더 값으로 추가됩니다.
`request.streaming. enabled`	`false`	기본적으로 (`false`) HTTP 요청 페이로드는 버퍼로 읽히며 페이로드에서 작동할 수 있는 정책은 예상대로 작동합니다. 페이로드가 버퍼 사이즈 (10MB)보다 큰 경우 이 속성을 `true`로 설정할 수 있습니다. `true`이면 HTTP 요청 페이로드가 버퍼로 읽히지 않으며 있는 그대로 TargetEndpoint 요청 흐름에 스트리밍됩니다. 이 경우 ProxyEndpoint 요청 흐름의 페이로드에서 작동하는 모든 정책이 우회됩니다. 스트리밍 요청 및 응답도 참조하세요.
`response.streaming. enabled`	`false`	기본적으로 (`false`) HTTP 응답 페이로드는 버퍼로 읽히며 페이로드에서 작동할 수 있는 정책은 예상대로 작동합니다. 페이로드가 버퍼 사이즈 (10MB)보다 큰 경우 이 속성을 `true`로 설정할 수 있습니다. `true`이면 HTTP 응답 페이로드가 버퍼로 읽히지 않으면 있는 그대로 클라이언트에 스트리밍됩니다. 이 경우 ProxyEndpoint 응답 흐름의 페이로드에서 작동하는 모든 정책이 우회됩니다. 스트리밍 요청 및 응답도 참조하세요.
`compression.algorithm`	해당 없음	기본적으로 Apigee Edge는 수신하는 모든 메시지에 설정된 압축 유형을 따릅니다. 예를 들어 클라이언트가 gzip 압축을 사용하는 요청을 제출하면 Apigee Edge는 gzip 압축을 사용하여 요청을 대상으로 전달합니다. TargetEndpoint 또는 ProxyEndpoint에 이 속성을 설정하여 압축 알고리즘이 명시적으로 적용되도록 구성할 수 있습니다. 지원되는 값은 다음과 같습니다. gzip: 항상 gzip 압축을 사용하여 메시지 전송 deflate: 항상 deflate 압축을 사용하여 메시지 전송 없음: 항상 압축 없이 메시지 전송 참조: Apigee는 GZIP/deflate 압축 방식의 압축/압축 풀기를 지원하나요?
`api.timeout`	해당 없음	개별 API 프록시의 시간 제한 구성 스트리밍이 사용 설정되어 있더라도 스트리밍을 이용해 지정한 시간이 지나면 타임아웃되도록 API 프록시를 구성할 수 있습니다. `504 Gateway Timeout` 기본 사용 사례는 실행하는 데 시간이 오래 걸리는 API 프록시가 있는 고객을 위한 것입니다. 예를 들어 특정 프록시가 3 분 후에 타임아웃되도록 해야 한다고 가정해 보겠습니다. 다음은 `api.timeout`을 사용하는 방법입니다. 먼저 3분 후 부하 분산기, 라우터, 메시지 프로세서가 타임아웃되도록 구성해야 합니다. 그런 다음 관련 3분 안에 프록시가 타임아웃되도록 구성합니다. 값을 밀리초 단위로 지정하세요. 예를 들면 `<Property name="api.timeout">180000</Property>`입니다. 그러나 시스템 시간 제한을 늘리면 api.timeout 설정이 없는 모든 프록시가 새로운 상위 부하 분산기, 라우터, 메시지 프로세서 시간 제한을 사용하므로 성능 문제가 발생할 수 있습니다. 따라서 더 짧은 시간 제한을 사용하기 위해 더 이상 시간 제한이 필요 없는 다른 API 프록시를 구성합니다. 예를 들어 다음은 1분 후 API 프록시가 시간 초과되도록 설정합니다. `<Property name="api.timeout">60000</Property>` 이 속성은 변수로 설정할 수 없습니다. Edge 시간 제한을 수정할 수 없는 고객은 표준 Edge 메시지 프로세서 시간 제한인 57초보다 짧은 경우 API 프록시 시간 제한도 구성할 수 있습니다. 자세한 내용은 Edge의 io.timeout.millis 및 api.timeout 설정 을 참조하세요.

Edge의 io.timeout.millis 및 api.timeout 설정

Edge에서 io.timeout.millis 및 api.timeout 의 작업은 관련이 있습니다. API 프록시에 대한 모든 요청에서 다음을 실행합니다.

라우터는 제한 시간 값을 메시지 프로세서로 보냅니다. 라우터 제한 시간 값은 요청을 처리하는 가상 호스트에서 설정한 proxy_read_timeout 값 또는 기본 제한 시간 값인 57초입니다.
그런 다음 메시지 프로세서가 api.timeout을 설정합니다.
1. api.timeout이 프록시 수준에서 설정되지 않은 경우 라우터 시간 제한으로 설정합니다.
2. api.timeout이 프록시 수준에서 설정된 경우 메시지 프로세서에서 라우터 시간 제한이나 api.timeout 값보다 작은 값으로 설정합니다.
api.timeout 값은 API 요청에서 응답에 이르기까지 API 프록시가 실행되어야 하는 최대 시간을 지정합니다.

API 프록시의 각 정책이 실행된 후 또는 메시지 프로세서가 요청을 대상 엔드포인트로 보내기 전에 메시지 프로세서는 (api.timeout - 요청 시작 시점부터 경과된 시간)을 계산합니다. 이 값이 0보다 작으면 요청을 처리하는 최대 시간이 만료된 후 메시지 프로세서가 504를 반환합니다.
io.timeout.millis 값은 대상 엔드포인트 가 응답해야 하는 최대 시간을 지정합니다.

메시지 프로세서는 대상 엔드포인트에 연결하기 전에 (api.timeout - 요청 시작 시점부터 경과된 시간) 및 io.timeout.millis 중에서 작은 값을 확인합니다. 그런 다음 io.timeout.millis를 해당 값으로 설정합니다.
- HTTP 요청을 작성하는 동안 시간 초과가 발생하면 408, Request Timeout가 반환됩니다.
- HTTP 응답을 읽는 동안 시간 초과가 발생하면 504, Gateway Timeout 이 반환됩니다.

Node.js 애플리케이션의 ScriptTarget 정보

ScriptTarget 요소는 Node.js 애플리케이션을 프록시에 통합하는 데 사용됩니다. Node.js 및 ScriptTarget 사용에 대한 자세한 내용은 다음을 참고하세요:

HostedTarget 엔드포인트 정보

빈 <HostedTarget/> 태그는 Edge에 Hosted Targets 환경에 배포된 Node.js 애플리케이션을 대상으로 사용하도록 지시합니다. 자세한 내용은 Hosted Targets 개요를 참조하세요.