다음을 통해 공유

http_request 플러그 인

  • 아티클

플러그 인은 http_request HTTP GET 요청을 보내고 응답을 테이블로 변환합니다.

사전 요구 사항

Syntax

evaluatehttp_request(Uri [,RequestHeaders [,옵션]] )

구문 규칙에 대해 자세히 알아봅니다.

매개 변수

이름 형식 필수 Description
Uri string ✔️ HTTP 또는 HTTPS 요청에 대한 대상 URI입니다.
RequestHeaders dynamic 요청과 함께 보낼 HTTP 헤더가 포함된 속성 모음입니다.
옵션 dynamic 요청의 추가 속성을 포함하는 속성 모음입니다.

참고

  • 선택적 매개 변수 뒤에 오는 선택적 매개 변수를 지정하려면 이전 선택적 매개 변수에 대한 값을 제공해야 합니다. 자세한 내용은 선택적 매개 변수 작업을 참조하세요.
  • 인증을 사용하는 경우 HTTPS 프로토콜을 사용합니다. 인증과 함께 HTTP를 사용하려고 시도하면 오류가 발생합니다.

인증 및 권한 부여

인증하려면 HTTP 표준 Authorization 헤더 또는 웹 서비스에서 지원하는 사용자 지정 헤더를 사용합니다.

참고

쿼리에 기밀 정보가 포함된 경우 쿼리 텍스트의 관련 부분이 난독 처리되어 추적에서 생략되도록 합니다. 자세한 내용은 난독 처리를 한 문자열 리터럴을 참조하세요.

반환

플러그 인은 다음과 같은 동적 열이 있는 단일 레코드가 있는 테이블을 반환합니다.

  • ResponseHeaders: 응답 헤더가 있는 속성 모음입니다.
  • ResponseBody: 형식 dynamic의 값으로 구문 분석된 응답 본문입니다.

HTTP 응답이 (응답 헤더를 Content-Type 통해) 미디어 형식이 임을 application/json나타내는 경우 응답 본문은 JSON 개체인 것처럼 자동으로 구문 분석됩니다. 그렇지 않으면 그대로 반환됩니다.

헤더

RequestHeaders 인수를 사용하여 나가는 HTTP 요청에 사용자 지정 헤더를 추가할 수 있습니다. 플러그 인은 표준 HTTP 요청 헤더 및 사용자가 제공한 사용자 지정 헤더 외에도 다음과 같은 사용자 지정 헤더를 추가합니다.

Name Description
x-ms-client-request-id 요청을 식별하는 상관 관계 ID입니다. 동일한 쿼리에서 플러그 인의 여러 호출은 모두 동일한 ID를 갖습니다.
x-ms-readonly 이 요청의 프로세서가 영구적으로 변경해서는 안 됨을 나타내는 플래그입니다.

경고

플래그는 x-ms-readonly 관리 명령이 아닌 쿼리에 의해 트리거된 플러그 인에서 보낸 모든 HTTP 요청에 대해 설정됩니다. 웹 서비스는 이 플래그가 있는 모든 요청을 내부 상태를 변경하지 않는 요청으로 처리해야 합니다. 그렇지 않으면 요청을 거부해야 합니다. 이렇게 하면 Kusto 쿼리를 이러한 공격에 대한 실행 패드로 사용하여 원치 않는 변경을 하는 무고해 보이는 쿼리가 전송되지 않도록 사용자를 보호합니다.

예제

다음 예제에서는 서유럽의 Azure Purview에 대한 Azure 소매 가격을 검색합니다.

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)

출력

armRegionName armSkuName currencyCode effectiveStartDate isPrimaryMeterRegion 위치 meterId meterName productId productName retailPrice serviceFamily serviceId serviceName skuId skuName tierMinimumUnits 형식 unitOfMeasure unitPrice
westeurope 데이터 인사이트 USD 2022-06-01T00:00:00Z false 서유럽 8ce915f7-20db-564d-8cc3-5702a7c952ab Data Insights 보고서 사용량 DZH318Z08M22 Azure Purview 데이터 맵 0.21 분석 DZH318Q66D0F Azure Purview DZH318Z08M22/006C Catalog Insights 0 Consumption 1 API 호출 0.21
westeurope 데이터 맵 보강 - Data Insights 생성 USD 2022-06-01T00:00:00Z false 서유럽 7ce2db1d-59a0-5193-8a57-0431a10622b6 데이터 맵 보강 - Data Insights 생성 vCore DZH318Z08M22 Azure Purview 데이터 맵 0.82 분석 DZH318Q66D0F Azure Purview DZH318Z08M22/005C 데이터 맵 보강 - 인사이트 생성 0 Consumption 1시간 0.82
westeurope USD 2021-09-28T00:00:00Z false 서유럽 053e2dcb-82c0-5e50-86cd-1f1c8d803705 Power BI vCore DZH318Z08M23 Azure Purview 검사 수집 및 분류 0 분석 DZH318Q66D0F Azure Purview DZH318Z08M23/0005 Power BI 0 Consumption 1시간 0
westeurope USD 2021-09-28T00:00:00Z false 서유럽 a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9 리소스 집합 vCore DZH318Z08M22 Azure Purview 데이터 맵 0.21 분석 DZH318Q66D0F Azure Purview DZH318Z08M22/000X 리소스 집합 0 Consumption 1시간 0.21
westeurope USD 2021-09-28T00:00:00Z false 서유럽 5d157295-441c-5ea7-ba7c-5083026dc456 vCore SQL Server DZH318Z08M23 Azure Purview 검사 수집 및 분류 0 분석 DZH318Q66D0F Azure Purview DZH318Z08M23/000F SQL Server 0 Consumption 1시간 0
westeurope USD 2021-09-28T00:00:00Z false 서유럽 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 표준 용량 단위 DZH318Z08M22 Azure Purview 데이터 맵 0.411 분석 DZH318Q66D0F Azure Purview DZH318Z08M22/0002 표준 0 Consumption 1시간 0.411
westeurope USD 2021-09-28T00:00:00Z false 서유럽 811e3118-5380-5ee8-a5d9-01d48d0a0627 표준 vCore DZH318Z08M23 Azure Purview 검사 수집 및 분류 0.63 분석 DZH318Q66D0F Azure Purview DZH318Z08M23/0009 표준 0 Consumption 1시간 0.63

이 기능은 Azure Monitor에서 지원되지 않습니다.