List Whois By Domain - List Whois By Domain

Servicio:

Sentinel

Versión de la API:

2025-04-01-preview

Obtener información de whois para un nombre de dominio único

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
enrichmentType	path	True	EnrichmentType	Tipo de enriquecimiento
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
workspaceName	path	True	string minLength: 1 maxLength: 90 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Nombre del área de trabajo.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre	Tipo	Description
domain	string	El nombre de dominio

Respuestas

Nombre	Tipo	Description
200 OK	EnrichmentDomainWhois	De acuerdo
Other Status Codes	CloudError	Respuesta de error que describe por qué la operación no pudo enriquecer este dominio.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

Get whois information for a single domain name

Solicitud de ejemplo

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"
}

Respuesta de muestra

status code:

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"
    ]
  }
}

Definiciones

Nombre	Description
CloudError	Estructura de respuesta de error.
CloudErrorBody	Detalles del error.
EnrichmentDomainBody	Nombre de dominio que se va a enriquecer
EnrichmentDomainWhois	Información de Whois para un dominio determinado y metadatos asociados
EnrichmentDomainWhoisContact	Un contacto individual asociado a este dominio
EnrichmentDomainWhoisContacts	Conjunto de contactos asociados a este dominio
EnrichmentDomainWhoisDetails	Registro whois de un dominio determinado
EnrichmentDomainWhoisRegistrarDetails	Registrador asociado a este dominio
EnrichmentType	Tipo de enriquecimiento

CloudError

Object

Estructura de respuesta de error.

Nombre	Tipo	Description
error	CloudErrorBody	Datos de error

CloudErrorBody

Object

Detalles del error.

Nombre	Tipo	Description
code	string	Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
message	string	Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.

EnrichmentDomainBody

Object

Nombre de dominio que se va a enriquecer

Nombre	Tipo	Description
domain	string	El nombre de dominio

EnrichmentDomainWhois

Object

Información de Whois para un dominio determinado y metadatos asociados

Nombre	Tipo	Description
created	string (date-time)	Marca de tiempo en la que se creó este registro
domain	string	Dominio de este registro whois
expires	string (date-time)	Marca de tiempo en la que expirará este registro
parsedWhois	EnrichmentDomainWhoisDetails	Registro whois de un dominio determinado
server	string	Nombre de host del servidor whois de este registrador
updated	string (date-time)	Marca de tiempo en la que se actualizó por última vez este registro

EnrichmentDomainWhoisContact

Object

Un contacto individual asociado a este dominio

Nombre	Tipo	Description
city	string	La ciudad de este contacto
country	string	El país de este contacto
email	string	La dirección de correo electrónico de este contacto
fax	string	Número de fax de este contacto
name	string	Nombre de este contacto
org	string	La organización de este contacto
phone	string	Número de teléfono de este contacto
postal	string	El código postal de este contacto
state	string	Estado de este contacto
street	string[]	Lista que describe la dirección postal de este contacto

EnrichmentDomainWhoisContacts

Object

Conjunto de contactos asociados a este dominio

Nombre	Tipo	Description
admin	EnrichmentDomainWhoisContact	Contacto de administrador para este registro whois
billing	EnrichmentDomainWhoisContact	Contacto de facturación para este registro whois
registrant	EnrichmentDomainWhoisContact	Contacto del registrador para este registro whois
tech	EnrichmentDomainWhoisContact	Contacto técnico para este registro whois

EnrichmentDomainWhoisDetails

Object

Registro whois de un dominio determinado

Nombre	Tipo	Description
contacts	EnrichmentDomainWhoisContacts	Conjunto de contactos asociados a este dominio
nameServers	string[]	Lista de servidores de nombres asociados a este dominio
registrar	EnrichmentDomainWhoisRegistrarDetails	Registrador asociado a este dominio
statuses	string[]	Conjunto de marcas de estado para este registro whois

EnrichmentDomainWhoisRegistrarDetails

Object

Registrador asociado a este dominio

Nombre	Tipo	Description
abuseContactEmail	string	Correo electrónico de contacto de abuso de este registrador
abuseContactPhone	string	Número de teléfono de contacto del registrador
ianaId	string	Identificador de autoridad de números asignados por Internet de este registrador
name	string	Nombre de este registrador
url	string	Dirección URL de este registrador
whoisServer	string	Nombre de host del servidor whois de este registrador

EnrichmentType

Enumeración

Tipo de enriquecimiento

Valor	Description
main