Web.Headers

Syntax

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

About

Gibt die Kopfzeilen zurück, die als url Datensatz heruntergeladen wurden. Ein optionaler Datensatzparameter kann bereitgestellt werden, optionsum zusätzliche Eigenschaften anzugeben. Der Datensatz kann die folgenden Felder enthalten:

• Query: Fügen Sie der URL programmgesteuert Abfrageparameter hinzu, ohne sich Gedanken über das Escapen machen zu müssen.
• ApiKeyName: Wenn die Zielwebsite einen API-Schlüssel hat, kann dieser Parameter verwendet werden, um den Namen (nicht den Wert) des Schlüsselparameters anzugeben, der in der URL verwendet werden muss. Der tatsächliche Schlüsselwert wird in den Anmeldeinformationen bereitgestellt.
• Headers: Wenn Sie diesen Wert als Datensatz angeben, werden zusätzliche Header für eine HTTP-Anforderung bereitgestellt.
• Timeout: Wenn Sie diesen Wert als Dauer angeben, ändert sich das Timeout für eine HTTP-Anforderung. Der Standardwert ist 100 Sekunden.
• ExcludedFromCacheKey: Wenn Sie diesen Wert als Liste angeben, werden diese HTTP-Headerschlüssel von der Berechnung zum Zwischenspeichern von Daten ausgeschlossen.
• IsRetry: Wenn Sie diesen Wahrheitswert als "true" angeben, werden beim Abrufen von Daten alle vorhandenen Antworten im Cache ignoriert.
• ManualStatusHandling: Die Angabe dieses Werts als Liste verhindert die integrierte Verarbeitung für HTTP-Anforderungen, deren Antwort einen dieser Statuscodes aufweist.
• RelativePath: Gibt diesen Wert als Text an, fügt ihn an die Basis-URL an, bevor die Anforderung ausgeführt wird.

Die HTTP-Anforderung wird mit der HEAD-Methode durchgeführt. Außerhalb eines benutzerdefinierten Datenkonnektorkontexts ist nur eine Teilmenge von Antwortheadern verfügbar (aus Sicherheitsgründen).

Beispiel 1

Rufen Sie die HTTP-Header für "https://bing.com/search?q=Power+Query" die Verwendung der RelativePath- und Abfrageoptionen ab.

Verwendung

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

Output

([
    #"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
])