재시도

적용 대상: 모든 API Management 계층

retry 정책은 자식 정책을 한 번 실행한 후 다시 시도 condition이 false가 되거나 다시 시도 count를 모두 사용할 때까지 실행을 다시 시도합니다.

정책에는 retry 정책을 제외한 wait 다른 정책이 자식 요소로 포함될 수 있습니다.

정책 문

<retry
    condition="Boolean expression or literal"
    count="number of retry attempts"
    interval="retry interval in seconds"
    max-interval="maximum retry interval in seconds"
    delta="retry interval delta in seconds"
    first-fast-retry="boolean expression or literal">
        <!-- One or more child policies. No restrictions. -->
</retry>

특성

다시 시도 대기 시간

• interval만 지정된 경우, 고정된 간격 재시도가 수행됩니다.

• interval 및 delta만 지정하면 선형 간격 다시 시도 알고리즘이 사용됩니다. 다시 시도 사이의 대기 시간은 interval + (count - 1)*delta 수식에 따라 늘어납니다.

• interval, max-interval 및 delta가 지정되면 지수 간격 다시 시도 알고리즘이 적용됩니다. 다시 시도 사이의 대기 시간은 다음 수식에 따라 기하급수적으로 interval + (2^(count - 1)) * random(delta * 0.8, delta * 1.2), max-interval에 의해 설정된 최대 간격까지 증가합니다.

  예를 들어 interval 및 delta가 모두 10초로 설정되고 max-interval이 100초인 경우 다시 시도 사이의 대략적인 대기 시간은 10초, 20초, 40초, 80초, 100초(남은 다시 시도에 사용된 대기 시간(초))로 증가합니다.

요소들

정책에는 retry 정책을 제외한 wait 다른 정책이 자식 요소로 포함될 수 있습니다.

사용

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

사용 현황 정보

• 정책은 첫 번째 재시도 실행을 평가하기 전에 블록에서 retry 자식 정책을 실행합니다 condition .

예제

지수 다시 시도를 사용하여 요청 전달

다음 예제에서는 지수 재시도 알고리즘을 사용하여 요청 전달을 최대 10회까지 다시 시도합니다. first-fast-retry가 false로 설정되어 있으므로 다시 시도하려고 할 때마다 다시 시도 대기 시간이 최대 max-interval까지 기하급수적으로 증가합니다(이 예에서는 약 10초, 20초, 40초, ...).

<retry
    condition="@(context.Response.StatusCode == 500)"
    count="10"
    interval="10"
    max-interval="100"
    delta="10"
    first-fast-retry="false">
        <forward-request buffer-request-body="true" />
</retry>

초기 요청 실패 시 요청 보내기

다음 예제에서는 연결이 끊어지거나 시간이 초과되거나 요청으로 서버 쪽 오류가 발생하는 경우 정의된 백 엔드 이외의 URL로 요청을 보내는 것이 최대 세 번 다시 시도됩니다. first-fast-retry가 true로 설정되었으므로 첫 번째 재시도는 초기 요청 실패 시 즉시 실행됩니다. 오류가 발생할 경우 send-request이 null이 되도록 하려면 ignore-error에서 response-variable-name를 true로 설정해야 합니다.

<retry
    condition="@(context.Variables["response"] == null || ((IResponse)context.Variables["response"]).StatusCode >= 500)"
    count="3"
    interval="1"
    first-fast-retry="true">
        <send-request 
            mode="new" 
            response-variable-name="response" 
            timeout="3" 
            ignore-error="true">
		        <set-url>https://api.contoso.com/products/5</set-url>
		        <set-method>GET</set-method>
		</send-request>
</retry>

오류가 수신되면 백 엔드 전환

다음 예제에서는 초기 요청이 기본 백 엔드로 디스패치됩니다. 429 Too Many Requests 응답 상태 코드가 반환되면 요청이 즉시 다시 시도되고 보조 백 엔드로 전달됩니다.

<backend>
    <retry
        condition="@(context.Response != null && context.Response.StatusCode == 429)"
        count="1"
        interval="1"
        first-fast-retry="true">
           <set-variable name="attempt-count" value="@(context.Variables.GetValueOrDefault<int>("attempt-count", 0)+1)" />
           <set-backend-service backend-id="@(context.Variables.GetValueOrDefault<int>("attempt-count") < 2 ? "primary-backend" : "secondary-backend" )" />
           <forward-request />
    </retry>
</backend>

관련 정책

• 정책 제어 및 흐름

관련 콘텐츠

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

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