Forward request

적용 대상: 모든 API Management 계층

forward-request 정책은 들어오는 요청을 요청 컨텍스트에 지정된 백 엔드 서비스에 전달합니다. 백 엔드 서비스 URL이 API 설정에 지정되며 백 엔드 서비스 설정 정책을 사용하여 변경할 수 있습니다.

Policy statement

<forward-request http-version="1 | 2or1 | 2" timeout="time in seconds (alternatively, use timeout-ms)" | timeout-ms="time in milliseconds (alternatively, use timeout)" continue-timeout="time in seconds" follow-redirects="false | true" buffer-request-body="false | true" buffer-response="true | false" fail-on-error-status-code="false | true"/>

Attributes

Usage

• 정책 섹션: backend
• 정책 범위: 전역, 작업 영역, 제품, API, 작업
• 게이트웨이: 클래식, v2, 사용량, 자체 호스팅, 작업 영역

Usage notes

• http-version 특성을 사용하여 게이트웨이에서 백 엔드로 HTTP/2 프로토콜 아웃바운드를 사용하도록 설정합니다. 특성을 로 설정하거나 .로 설정합니다. 현재 HTTP/2 아웃바운드는 자체 호스팅 게이트웨이 및 v2 게이트웨이의 미리 보기에서 지원됩니다.

  Important

  v2 게이트웨이에서 HTTP/2는 API Management 게이트웨이에 대한 인바운드 및 게이트웨이에서 백 엔드로의 아웃바운드가 지원되지만 엔드투엔드는 지원되지 않습니다. 현재 v2 게이트웨이는 요청을 백 엔드로 전달하기 전에 들어오는 HTTP/2 연결을 HTTP/1로 다운그레이드합니다.

Examples

HTTP/2 백 엔드에 요청 보내기

다음 API 수준 정책은 모든 API 요청을 HTTP/2 백 엔드 서비스로 전달합니다. 예를 들어 이 정책을 사용하여 자체 호스팅 게이트웨이의 요청을 gRPC 백 엔드로 전달합니다.

<!-- api level -->
<policies>
    <inbound>
        <base/>
    </inbound>
    <backend>
        <forward-request http-version="2or1"/>
    </backend>
    <outbound>
        <base/>
    </outbound>
</policies>

시간 제한 간격으로 요청 전달

다음 API 레벨 정책은 60초의 시간 초과 간격으로 모든 API 요청을 백 엔드 서비스로 전달합니다.

<!-- api level -->
<policies>
    <inbound>
        <base/>
    </inbound>
    <backend>
        <forward-request timeout="60"/>
    </backend>
    <outbound>
        <base/>
    </outbound>
</policies>

부모 범위에서 정책 상속

이 작업 수준 정책은 base 요소를 사용하여 상위 API 수준 범위에서 백 엔드 정책을 상속합니다.

<!-- operation level -->
<policies>
    <inbound>
        <base/>
    </inbound>
    <backend>
        <base/>
    </backend>
    <outbound>
        <base/>
    </outbound>
</policies>

부모 범위에서 정책 상속하지 않음

이 작업 수준 정책은 120의 시간 초과로 모든 요청을 백 엔드 서비스로 명시적으로 전달하며 상위 API 수준 백 엔드 정책을 상속하지 않습니다. 백 엔드 서비스가 400~599(포함)의 오류 상태 코드로 응답하면 오류 발생 시 섹션이 트리거됩니다.

<!-- operation level -->
<policies>
    <inbound>
        <base/>
    </inbound>
    <backend>
        <forward-request timeout="120" fail-on-error-status-code="true" />
        <!-- effective policy. note the absence of <base/> -->
    </backend>
    <outbound>
        <base/>
    </outbound>
</policies>

백 엔드에 요청 전달 안 함

이 작업 수준 정책은 요청을 백 엔드 서비스로 전달하지 않습니다.

<!-- operation level -->
<policies>
    <inbound>
        <base/>
    </inbound>
    <backend>
        <!-- no forwarding to backend -->
    </backend>
    <outbound>
        <base/>
    </outbound>
</policies>

Related policies

• Routing

Related content

정책 작업에 대한 자세한 내용은 다음을 참조하세요.

• 자습서: API 변환 및 보호
• 정책 문 및 해당 설정에 대한 전체 목록에 대한 정책 참조
• Policy expressions
• 정책 설정 또는 편집
• 정책 구성 재사용
• 정책 코드 조각 리포지토리
• 정책 플레이그라운드 리포지토리
• Azure API Management 정책 도구 키트
• Copilot 지원을 받아 정책을 만들고, 설명하며, 문제를 해결하세요.