상태 코드 처리 Web.Contents
이 Web.Contents
함수에는 특정 HTTP 상태 코드를 처리하기 위한 몇 가지 기본 제공 기능이 있습니다. 옵션 레코드의 필드를 사용하여 확장에서 기본 동작을 재정의 ManualStatusHandling
할 수 있습니다.
자동 다시 시도
Web.Contents
는 다음 상태 코드 중 하나로 실패한 요청을 자동으로 다시 시도합니다.
코드 | 상태 |
---|---|
408 | Request Timeout |
429 | 요청이 너무 많음 |
503 | Service Unavailable |
504 | 게이트웨이 시간 초과 |
509 | 대역폭 한도 초과 |
요청은 실패하기 전에 최대 세 번 다시 시도됩니다. 응답에 헤더가 포함되지 않는 한 엔진은 지수 백오프 알고리즘을 사용하여 다음 재시도까지 대기하는 시간을 결정합니다 Retry-after
. 헤더가 발견되면 엔진은 다음 재시도 전에 지정된 시간(초)을 기다립니다. 지원되는 최소 대기 시간은 0.5초이고 최대값은 120초입니다.
참고 항목
값은 Retry-after
형식이어야 delta-seconds
합니다. 형식은 HTTP-date
현재 지원되지 않습니다.
인증 예외
다음 상태 코드는 자격 증명 예외를 발생시켜 사용자에게 자격 증명을 제공하도록 요청하는 인증 프롬프트를 발생합니다(또는 만료된 OAuth 토큰의 경우 다시 로그인).
코드 | 상태 |
---|---|
401 | Unauthorized |
403 | 금지 |
참고 항목
확장은 상태 코드 401 및 403에서 이 옵션을 사용할 ManualStatusHandling
수 있습니다. 이 옵션은 사용자 지정 데이터 커넥터 외부에서 수행되는 호출(즉, 파워 쿼리에서 직접)에서 Web.Contents
수행할 수 있는 작업이 아닙니다.
리디렉션
다음 상태 코드는 헤더에 지정된 Location
URI로 자동 리디렉션됩니다. 헤더가 없 Location
으면 오류가 발생합니다.
코드 | 상태 |
---|---|
300 | 여러 선택 항목 |
301 | Moved Permanently |
302 | Found |
303 | 기타 참조 |
307 | Temporary Redirect |
참고 항목
상태 코드 307만 요청 메서드를 POST
유지합니다. 다른 모든 리디렉션 상태 코드로 전환GET
됩니다.