Udostępnij za pośrednictwem

wtyczka http_request

  • Artykuł

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

Wtyczka http_request wysyła żądanie HTTP GET i konwertuje odpowiedź na tabelę.

Wymagania wstępne

Składnia

evaluatehttp_request ( Identyfikator URI [, RequestHeaders [, Opcje]])

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
Identyfikator URI string ✔️ Docelowy identyfikator URI żądania HTTP lub HTTPS.
RequestHeaders dynamic Torba właściwości zawierająca nagłówki HTTP do wysłania za pomocą żądania.
Opcje dynamic Torba właściwości zawierająca dodatkowe właściwości żądania.

Uwaga

  • Aby określić opcjonalny parametr, który jest zgodny z opcjonalnym parametrem, upewnij się, że podano wartość poprzedniego opcjonalnego parametru. Aby uzyskać więcej informacji, zobacz Praca z parametrami opcjonalnymi.
  • Jeśli używasz uwierzytelniania, użyj protokołu HTTPS. Próby użycia protokołu HTTP z uwierzytelnianiem powoduje wystąpienie błędu.

Uwierzytelnianie i autoryzacja

Aby przeprowadzić uwierzytelnianie, użyj nagłówka standardowego Authorization HTTP lub dowolnego niestandardowego nagłówka obsługiwanego przez usługę internetową.

Uwaga

Jeśli zapytanie zawiera poufne informacje, upewnij się, że odpowiednie części tekstu zapytania są zaciemnione, aby pominąć je z dowolnego śledzenia. Aby uzyskać więcej informacji, zobacz zaciemnione literały ciągu.

Zwraca

Wtyczka zwraca tabelę z pojedynczym rekordem z następującymi kolumnami dynamicznymi:

  • ResponseHeaders: torba właściwości z nagłówkiem odpowiedzi.
  • ResponseBody: Treść odpowiedzi analizowana jako wartość typu dynamic.

Jeśli odpowiedź HTTP wskazuje (za pośrednictwem nagłówka Content-Type odpowiedzi), że typ nośnika to application/json, treść odpowiedzi jest automatycznie analizowana tak, jakby był to obiekt JSON. W przeciwnym razie jest zwracany zgodnie z rzeczywistymi wartościami.

Nagłówki

Argument RequestHeaders może służyć do dodawania niestandardowych nagłówków do wychodzącego żądania HTTP. Oprócz standardowych nagłówków żądań HTTP i nagłówków niestandardowych udostępnianych przez użytkownika wtyczka dodaje również następujące nagłówki niestandardowe:

Nazwa/nazwisko opis
x-ms-client-request-id Identyfikator korelacji identyfikujący żądanie. Wiele wywołań wtyczki w tym samym zapytaniu będzie miało ten sam identyfikator.
x-ms-readonly Flaga wskazująca, że procesor tego żądania nie powinien wprowadzać żadnych trwałych zmian.

Ostrzeżenie

Flaga x-ms-readonly jest ustawiana dla każdego żądania HTTP wysyłanego przez wtyczkę, która została wyzwolona przez zapytanie, a nie dla polecenia zarządzania. Usługi sieci Web powinny traktować wszelkie żądania z tą flagą jako takie, które nie wprowadza wewnętrznych zmian stanu, w przeciwnym razie powinny odrzucać żądanie. Chroni to użytkowników przed wysyłaniem pozornie niewinnych zapytań, które kończą się wprowadzaniem niechcianych zmian przy użyciu zapytania Kusto jako startpadu do takich ataków.

Przykład

Poniższy przykład pobiera ceny sprzedaży detalicznej platformy Azure dla usługi Azure Purview w regionie Europa Zachodnia:

let Uri = "https://prices.azure.com/api/retail/prices?$filter=serviceName eq 'Azure Purview' and location eq 'EU West'";
evaluate http_request(Uri)
| project ResponseBody.Items
| mv-expand ResponseBody_Items
| evaluate bag_unpack(ResponseBody_Items)

Wyjście

armRegionName armSkuName currencyCode effectiveStartDate isPrimaryMeterRegion lokalizacja meterId meterName productId productName retailPrice serviceFamily serviceId serviceName skuId skuName tierMinimumUnits type unitOfMeasure unitPrice
westeurope Szczegółowe informacje o danych USD 2022-06-01T00:00:00Z fałsz Europa Zachodnia 8ce915f7-20db-564d-8cc3-5702a7c952ab Użycie raportu usługi Data Insights DZH318Z08M22 Mapowanie danych w usłudze Azure Purview 0.21 Analiza DZH318Q66D0F Azure Purview DZH318Z08M22/006C Szczegółowe informacje dotyczące wykazu 0 Zużycie 1 Wywołania interfejsu API 0.21
westeurope Wzbogacanie mapy danych — generowanie szczegółowych informacji o danych USD 2022-06-01T00:00:00Z fałsz Europa Zachodnia 7ce2db1d-59a0-5193-8a57-0431a10622b6 Wzbogacanie mapy danych — rdzeń wirtualny generowania szczegółowych informacji o danych DZH318Z08M22 Mapowanie danych w usłudze Azure Purview 0.82 Analiza DZH318Q66D0F Azure Purview DZH318Z08M22/005C Wzbogacanie mapy danych — generowanie szczegółowych informacji 0 Zużycie 1 godzina 0.82
westeurope USD 2021-09-28T00:00:00Z fałsz Europa Zachodnia 053e2dcb-82c0-5e50-86cd-1f1c8d803705 Rdzenie wirtualne usługi Power BI DZH318Z08M23 Pozyskiwanie i klasyfikacja skanowania usługi Azure Purview 0 Analiza DZH318Q66D0F Azure Purview DZH318Z08M23/0005 Power BI 0 Zużycie 1 godzina 0
westeurope USD 2021-09-28T00:00:00Z fałsz Europa Zachodnia a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9 Zestaw zasobów — rdzeń wirtualny DZH318Z08M22 Mapowanie danych w usłudze Azure Purview 0.21 Analiza DZH318Q66D0F Azure Purview DZH318Z08M22/000X Zestaw zasobów 0 Zużycie 1 godzina 0.21
westeurope USD 2021-09-28T00:00:00Z fałsz Europa Zachodnia 5d157295-441c-5ea7-ba7c-5083026dc456 Rdzeń wirtualny programu SQL Server DZH318Z08M23 Pozyskiwanie i klasyfikacja skanowania usługi Azure Purview 0 Analiza DZH318Q66D0F Azure Purview DZH318Z08M23/000F SQL Server 0 Zużycie 1 godzina 0
westeurope USD 2021-09-28T00:00:00Z fałsz Europa Zachodnia 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 Jednostka pojemności standardowej DZH318Z08M22 Mapowanie danych w usłudze Azure Purview 0.411 Analiza DZH318Q66D0F Azure Purview DZH318Z08M22/0002 Standardowa 0 Zużycie 1 godzina 0.411
westeurope USD 2021-09-28T00:00:00Z fałsz Europa Zachodnia 811e3118-5380-5ee8-a5d9-01d48d0a0627 Standardowa rdzeń wirtualny DZH318Z08M23 Pozyskiwanie i klasyfikacja skanowania usługi Azure Purview 0.63 Analiza DZH318Q66D0F Azure Purview DZH318Z08M23/0009 Standardowa 0 Zużycie 1 godzina 0.63