你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

List Whois By Domain - List Whois By Domain

服务:: Sentinel

API 版本:: 2025-04-01-preview

获取单个域名的 whois 信息

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/enrichment/main/listWhoisByDomain?api-version=2025-04-01-preview

URI 参数

名称	在	必需	类型	说明
enrichmentType	path	True	EnrichmentType	扩充类型
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。此名称不区分大小写。
subscriptionId	path	True	string (uuid)	目标订阅的 ID。该值必须是 UUID。
workspaceName	path	True	string minLength: 1 maxLength: 90 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	工作区的名称。
api-version	query	True	string minLength: 1	用于此操作的 API 版本。

请求正文

名称	类型	说明
domain	string	域名

响应

名称	类型	说明
200 OK	EnrichmentDomainWhois	好的
Other Status Codes	CloudError	描述作未能扩充此域的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Get whois information for a single domain name

示例请求

HTTP

POST https://management.azure.com/subscriptions/bd794837-4d29-4647-9105-6339bfdb4e6a/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/enrichment/main/listWhoisByDomain?api-version=2025-04-01-preview

{
  "domain": "microsoft.com"
}

示例响应

状态代码:: 200

{
  "domain": "microsoft.com",
  "server": null,
  "created": "2021-09-01T16:15:01.187045Z",
  "updated": "2021-09-01T16:15:01.187045Z",
  "expires": null,
  "parsedWhois": {
    "registrar": {
      "name": "MarkMonitor, Inc",
      "abuseContactPhone": "12083895770",
      "abuseContactEmail": "abuse@microsoft.com",
      "url": "http://www.markmonitor.com",
      "whoisServer": "whois.markmonitor.com"
    },
    "contacts": {
      "admin": {
        "name": "Administrator",
        "org": "Microsoft",
        "street": [
          "One Microsoft Way"
        ],
        "city": null,
        "state": "WA",
        "postal": "98052",
        "country": "United States",
        "phone": "1-800-555-1234",
        "fax": null,
        "email": "mail@microsoft.com"
      },
      "registrant": null,
      "billing": {
        "name": "Administrator",
        "org": "Microsoft",
        "street": [
          "One Microsoft Way"
        ],
        "city": null,
        "state": "WA",
        "postal": "98052",
        "country": "United States",
        "phone": "1-800-555-1234",
        "fax": null,
        "email": "mail@microsoft.com"
      },
      "tech": {
        "name": "Administrator",
        "org": "Microsoft",
        "street": [
          "One Microsoft Way"
        ],
        "city": null,
        "state": "WA",
        "postal": "98052",
        "country": "United States",
        "phone": "1-800-555-1234",
        "fax": null,
        "email": "mail@microsoft.com"
      }
    },
    "nameServers": [
      "ns1-205.azure-dns.com",
      "ns2-205.azure-dns.net",
      "ns3-205.azure-dns.org",
      "ns4-205.azure-dns.info"
    ],
    "statuses": [
      "clientUpdateProhibited",
      "clientTransferProhibited",
      "clientDeleteProhibited",
      "serverUpdateProhibited",
      "serverTransferProhibited",
      "serverDeleteProhibited"
    ]
  }
}

定义

名称	说明
CloudError	错误响应结构。
CloudErrorBody	错误详细信息。
EnrichmentDomainBody	要扩充的域名
EnrichmentDomainWhois	给定域和关联元数据的 Whois 信息
EnrichmentDomainWhoisContact	与此域关联的单个联系人
EnrichmentDomainWhoisContacts	与此域关联的联系人集
EnrichmentDomainWhoisDetails	给定域的 whois 记录
EnrichmentDomainWhoisRegistrarDetails	与此域关联的注册机构
EnrichmentType	扩充类型

CloudError

Object

错误响应结构。

名称	类型	说明
error	CloudErrorBody	错误数据

CloudErrorBody

Object

错误详细信息。

名称	类型	说明
code	string	错误的标识符。代码是固定的，旨在以编程方式使用。
message	string	描述错误的消息，旨在适合在用户界面中显示。

EnrichmentDomainBody

Object

要扩充的域名

名称	类型	说明
domain	string	域名

EnrichmentDomainWhois

Object

给定域和关联元数据的 Whois 信息

名称	类型	说明
created	string (date-time)	创建此记录的时间戳
domain	string	此 whois 记录的域
expires	string (date-time)	此记录过期的时间戳
parsedWhois	EnrichmentDomainWhoisDetails	给定域的 whois 记录
server	string	此注册机构的 whois 服务器的主机名
updated	string (date-time)	上次更新此记录的时间戳

EnrichmentDomainWhoisContact

Object

与此域关联的单个联系人

名称	类型	说明
city	string	此联系人的城市
country	string	此联系人的国家/地区
email	string	此联系人的电子邮件地址
fax	string	此联系人的传真号
name	string	此联系人的名称
org	string	此联系人的组织
phone	string	此联系人的电话号码
postal	string	此联系人的邮政编码
state	string	此联系人的状态
street	string[]	描述此联系人的街道地址的列表

EnrichmentDomainWhoisContacts

Object

与此域关联的联系人集

名称	类型	说明
admin	EnrichmentDomainWhoisContact	此 whois 记录的管理员联系人
billing	EnrichmentDomainWhoisContact	此 whois 记录的计费联系人
registrant	EnrichmentDomainWhoisContact	此 whois 记录的注册联系人
tech	EnrichmentDomainWhoisContact	此 whois 记录的技术联系人

EnrichmentDomainWhoisDetails

Object

给定域的 whois 记录

名称	类型	说明
contacts	EnrichmentDomainWhoisContacts	与此域关联的联系人集
nameServers	string[]	与此域关联的名称服务器列表
registrar	EnrichmentDomainWhoisRegistrarDetails	与此域关联的注册机构
statuses	string[]	此 whois 记录的状态标志集

EnrichmentDomainWhoisRegistrarDetails

Object

与此域关联的注册机构

名称	类型	说明
abuseContactEmail	string	此注册机构的滥用联系人电子邮件
abuseContactPhone	string	此注册机构的滥用联系人电话号码
ianaId	string	此注册机构的 Internet 分配号码颁发机构 ID
name	string	此注册机构的名称
url	string	此注册机构的 URL
whoisServer	string	此注册机构的 whois 服务器的主机名

EnrichmentType

枚举

扩充类型

值	说明
main

通过

List Whois By Domain - List Whois By Domain

URI 参数

请求正文

响应

安全性

azure_auth

作用域

示例

Get whois information for a single domain name

示例请求

示例响应

定义

CloudError

CloudErrorBody

EnrichmentDomainBody

EnrichmentDomainWhois

EnrichmentDomainWhoisContact

EnrichmentDomainWhoisContacts

EnrichmentDomainWhoisDetails

EnrichmentDomainWhoisRegistrarDetails

EnrichmentType