透過 REST API 在 Microsoft Sentinel 中以地理位置資料擴充實體 (公開預覽版)
本文顯示如何使用 REST API 在 Microsoft Sentinel 中以地理位置資料擴充實體。
重要
這項功能目前為「預覽」狀態。 Azure 預覽補充條款 包含適用於 Azure 功能 (搶鮮版 (Beta)、預覽版,或尚未發行的版本) 的其他法律條款。
通用 URI 參數
以下是地理位置 API 的常見 URI 參數:
名稱 | 位於 | 必要 | 類型 | 描述 |
---|---|---|---|---|
{subscriptionId} | path | 是 | GUID | Azure 訂用帳戶識別碼 |
{resourceGroupName} | path | 是 | 字串 | 訂用帳戶內的資源群組名稱 |
{api-version} | 查詢 | 是 | 字串 | 用來提出此要求的通訊協定版本。 自 2021 年 4 月 30 日起,地理位置 API 版本為 2019-01-01-preview。 |
{ipAddress} | 查詢 | 是 | 字串 | 需要地理位置資訊的 IP 位址 (IPv4 或 IPv6 格式)。 |
使用地理位置資訊來擴充 IP 位址
此命令會擷取所指定 IP 位址的地理位置資料。
要求 URI
方法 | 要求 URI |
---|---|
GET | https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SecurityInsights/enrichment/ip/geodata/?ipaddress={ipAddress}&api-version={api-version} |
回應
狀態碼 | 描述 |
---|---|
200 | Success |
400 | 未提供 IP 位址,或 IP 位址的格式無效 |
404 | 找不到此 IP 位址的地理位置資料 |
429 | 要求太多,請在指定的時間範圍內再試一次 |
回應中傳回的欄位
欄位名稱 | 描述 |
---|---|
ASN | 與此 IP 位址相關聯的自發系統號碼 |
carrier | 此 IP 位址的電訊廠商名稱 |
city | 此 IP 位址所在的城市 |
cityCf | 信賴度數值評等,表示 'city' 欄位中的值在 0-100 小數位數上正確 |
continent | 此 IP 位址所在的大陸 |
country | 此IP位址所在的國家/地區 |
countryCf | 信賴度數值評等,表示 'country' 欄位中的值在 0-100 小數位數上正確 |
ipAddr | IP 位址的小數點十進位或冒號區隔字串表示 |
ipRoutingType | 此 IP 位址的連線類型描述 |
緯度 | 此 IP 位址的緯度 |
經度 | 此 IP 位址的經度 |
organization | 此 IP 位址的組織名稱 |
organizationType | 此 IP 位址的組織類型 |
region | 此 IP 位址所在的地理區域 |
state | 此 IP 位址所在的州/省 |
stateCf | 信賴度數值評等,表示 'state' 欄位中的值在 0-100 小數位數上正確 |
stateCode | 此 IP 位址所在州/省的縮寫名稱 |
API 的節流限制
此 API 限制為每小時每個使用者 100 次呼叫。
範例回應
"body":
{
"asn": "12345",
"carrier": "Microsoft",
"city": "Redmond",
"cityCf": 90,
"continent": "north america",
"country": "united states",
"countryCf": 99
"ipAddr": "1.2.3.4",
"ipRoutingType": "fixed",
"latitude": "40.2436",
"longitude": "-100.8891",
"organization": "Microsoft",
"organizationType": "tech",
"region": "western usa",
"state": "washington",
"stateCf": null
"stateCode": "wa"
}
後續步驟
若要深入了解 Microsoft Sentinel,請參閱下列文章: