다음을 통해 공유

Web.Headers

  • 아티클

통사론

Web.Headers(url as text, optional options as nullable record) as record

정보

url에서 다운로드한 헤더를 레코드로 반환합니다. 추가 속성을 지정하기 위해 선택적 레코드 매개 변수인 options제공할 수 있습니다. 레코드에는 다음 필드가 포함될 수 있습니다.

  • Query: 이스케이프에 대해 걱정할 필요 없이 프로그래밍 방식으로 URL에 쿼리 매개 변수를 추가합니다.
  • ApiKeyName: 대상 사이트에 API 키의 개념이 있는 경우 이 매개 변수를 사용하여 URL에 사용해야 하는 키 매개 변수의 이름(값이 아님)을 지정할 수 있습니다. 실제 키 값은 자격 증명에 제공됩니다.
  • Headers: 이 값을 레코드로 지정하면 HTTP 요청에 추가 헤더가 제공됩니다.
  • Timeout: 이 값을 기간으로 지정하면 HTTP 요청에 대한 시간 제한이 변경됩니다. 기본값은 100초입니다.
  • ExcludedFromCacheKey: 이 값을 목록으로 지정하면 이러한 HTTP 헤더 키가 데이터 캐싱 계산에 포함되지 않습니다.
  • IsRetry: 이 논리 값을 true로 지정하면 데이터를 가져올 때 캐시의 기존 응답이 무시됩니다.
  • ManualStatusHandling: 이 값을 목록으로 지정하면 응답에 이러한 상태 코드 중 하나가 있는 HTTP 요청에 대한 기본 제공 처리가 차단됩니다.
  • RelativePath: 이 값을 텍스트로 지정하면 요청을 만들기 전에 기본 URL에 추가됩니다.

HTTP 요청은 HEAD 메서드를 사용하여 이루어집니다. 사용자 지정 데이터 커넥터 컨텍스트 외부에서는 보안상의 이유로 응답 헤더의 하위 집합만 사용할 수 있습니다.

예제 1

RelativePath 및 쿼리 옵션을 사용하여 "https://bing.com/search?q=Power+Query" HTTP 헤더를 검색합니다.

사용량

let
    searchText = "Power Query"
in
    Web.Headers(
        "https://www.bing.com",
        [
            RelativePath = "search",
            Query = [q = searchText]
        ]
    )

출력

([
    #"Cache-Control" = "private, max-age=0",
    #"Content-Encoding" = "gzip",
    #"Content-Length" = "0",
    #"Content-Type" = "text/html; charset=utf-8",
    Date = "Tue, 14 Dec 2021 16:57:25 GMT",
    Expires = "Tue, 14 Dec 2021 16:56:25 GMT",
    Vary = "Accept-Encoding"
]
meta [
    Response.Status = 200
])