다음을 통해 공유


상태 코드 처리 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됩니다.