List Whois By Domain - List Whois By Domain

Service:: Sentinel

Version d'API:: 2025-04-01-preview

Obtenir des informations de whois pour un nom de domaine unique

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
enrichmentType	path	True	EnrichmentType	Type d’enrichissement
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
workspaceName	path	True	string minLength: 1 maxLength: 90 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Nom de l’espace de travail.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Type	Description
domain	string	Nom de domaine

Réponses

Nom	Type	Description
200 OK	EnrichmentDomainWhois	Ok
Other Status Codes	CloudError	Réponse d’erreur décrivant pourquoi l’opération n’a pas pu enrichir ce domaine.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

Get whois information for a single domain name

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
    ]
  }
}

Définitions

Nom	Description
CloudError	Structure de réponse d’erreur.
CloudErrorBody	Détails de l’erreur.
EnrichmentDomainBody	Nom de domaine à enrichir
EnrichmentDomainWhois	Informations de whois pour un domaine donné et les métadonnées associées
EnrichmentDomainWhoisContact	Contact individuel associé à ce domaine
EnrichmentDomainWhoisContacts	Ensemble de contacts associés à ce domaine
EnrichmentDomainWhoisDetails	Enregistrement whois pour un domaine donné
EnrichmentDomainWhoisRegistrarDetails	Bureau d’enregistrement associé à ce domaine
EnrichmentType	Type d’enrichissement

CloudError

Object

Structure de réponse d’erreur.

Nom	Type	Description
error	CloudErrorBody	Données d’erreur

CloudErrorBody

Object

Détails de l’erreur.

Nom	Type	Description
code	string	Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.
message	string	Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.

EnrichmentDomainBody

Object

Nom de domaine à enrichir

Nom	Type	Description
domain	string	Nom de domaine

EnrichmentDomainWhois

Object

Informations de whois pour un domaine donné et les métadonnées associées

Nom	Type	Description
created	string (date-time)	Horodatage auquel cet enregistrement a été créé
domain	string	Domaine de cet enregistrement whois
expires	string (date-time)	Horodatage auquel cet enregistrement expirera
parsedWhois	EnrichmentDomainWhoisDetails	Enregistrement whois pour un domaine donné
server	string	Nom d’hôte du serveur whois de ce bureau d’enregistrement
updated	string (date-time)	Horodatage auquel cet enregistrement a été mis à jour pour la dernière fois

EnrichmentDomainWhoisContact

Object

Contact individuel associé à ce domaine

Nom	Type	Description
city	string	La ville pour ce contact
country	string	Le pays pour ce contact
email	string	Adresse e-mail de ce contact
fax	string	Numéro de télécopie de ce contact
name	string	Nom de ce contact
org	string	L’organisation pour ce contact
phone	string	Numéro de téléphone de ce contact
postal	string	Code postal pour ce contact
state	string	État de ce contact
street	string[]	Liste décrivant l’adresse postale de ce contact

EnrichmentDomainWhoisContacts

Object

Ensemble de contacts associés à ce domaine

Nom	Type	Description
admin	EnrichmentDomainWhoisContact	Contact administrateur pour cet enregistrement whois
billing	EnrichmentDomainWhoisContact	Contact de facturation pour cet enregistrement whois
registrant	EnrichmentDomainWhoisContact	Contact de l’inscription pour cet enregistrement whois
tech	EnrichmentDomainWhoisContact	Contact technique pour cet enregistrement whois

EnrichmentDomainWhoisDetails

Object

Enregistrement whois pour un domaine donné

Nom	Type	Description
contacts	EnrichmentDomainWhoisContacts	Ensemble de contacts associés à ce domaine
nameServers	string[]	Liste des serveurs de noms associés à ce domaine
registrar	EnrichmentDomainWhoisRegistrarDetails	Bureau d’enregistrement associé à ce domaine
statuses	string[]	Jeu d’indicateurs d’état pour cet enregistrement whois

EnrichmentDomainWhoisRegistrarDetails

Object

Bureau d’enregistrement associé à ce domaine

Nom	Type	Description
abuseContactEmail	string	E-mail de contact d’abus de ce bureau d’enregistrement
abuseContactPhone	string	Numéro de téléphone de contact d’abus de ce bureau d’enregistrement
ianaId	string	ID de l’autorité des numéros attribués par Internet de ce bureau d’enregistrement
name	string	Nom de ce bureau d’enregistrement
url	string	URL de ce bureau d’enregistrement
whoisServer	string	Nom d’hôte du serveur whois de ce bureau d’enregistrement

EnrichmentType

Énumération

Type d’enrichissement

Valeur	Description
main

Partager via

List Whois By Domain - List Whois By Domain

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

Get whois information for a single domain name

Exemple de requête

Exemple de réponse

Définitions

CloudError

CloudErrorBody

EnrichmentDomainBody

EnrichmentDomainWhois

EnrichmentDomainWhoisContact

EnrichmentDomainWhoisContacts

EnrichmentDomainWhoisDetails

EnrichmentDomainWhoisRegistrarDetails

EnrichmentType