Répertorier whoisRecords
Espace de noms : microsoft.graph.security
Importante
Les API sous la version /beta
dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Remarque
Microsoft API Graph pour Microsoft Defender Threat Intelligence nécessite une licence active du portail Defender Threat Intelligence et une licence de module complémentaire d’API pour le locataire.
Obtenez la liste des objets whoisRecord .
Note: Vous devez inclure le paramètre de
$search
requête dans l’URL de la requête pour cette API.
Cette API est disponible dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | ThreatIntelligence.Read.All | Non disponible. |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | ThreatIntelligence.Read.All | Non disponible. |
Requête HTTP
GET /security/threatIntelligence/whoisRecords?$search="{value}"
Paramètres facultatifs de la requête
Cette méthode prend en charge les $count
paramètres de requête , $orderby
$select
$search
, , $skip
, et $top
OData pour vous aider à personnaliser la réponse. Pour des informations générales, consultez paramètres de la requête OData.
Nom | Description |
---|---|
$count |
$count est pris en charge pour retourner un décompte holistique du nombre d’objets whoisRecord .
$count est pris en charge en tant que paramètre de requête (?$count=true ) ou en tant que paramètre de chemin d’accès (/$count ). |
$orderby |
$orderby prend en charge certaines propriétés de la ressource whoisRecord . Pour plus d’informations, consultez Propriétés prises en charge avec $orderby. |
$search |
$search est requis dans l’URL de requête de cette API. Actuellement, l’API ne prend en charge la recherche que par un seul champ dans un appel. Pour plus d’informations, consultez Propriétés prises en charge avec $search. |
$select |
$select est pris en charge pour limiter les propriétés retournées dans cette requête. |
$skip |
$skip est pris en charge pour ignorer les éléments dans les pages. Combinez avec $top pour effectuer la pagination ou utilisez pour la @odata.nextLink pagination côté serveur. |
$top |
$top est pris en charge pour limiter le nombre d’éléments par page. Combinez avec $skip pour effectuer la pagination ou utilisez pour la @odata.nextLink pagination côté serveur. |
Propriétés prises en charge avec $orderby
Les propriétés suivantes peuvent être utilisées pour $orderby
les appels.
Propriété | Exemple | Notes |
---|---|---|
expirationDateTime | $orderby=expirationDateTime desc |
|
hôte/id | $orderby=host/id asc |
Le chemin d’accès complet est requis pour $orderby l’utilisation. |
registrationDateTime | $orderby=registrationDateTime desc |
Propriétés prises en charge avec $search
Les propriétés suivantes peuvent être utilisées pour $search
les appels.
Propriété | Exemple | Notes |
---|---|---|
Abus | $search="abuse/address/state:WA" |
doit $search cibler un champ spécifique du whoisContact. |
Admin | $search="admin/address/state:WA" |
doit $search cibler un champ spécifique du whoisContact. |
Facturation | $search="billing/address/state:WA" |
doit $search cibler un champ spécifique du whoisContact. |
Nameservers | $search="nameservers/host/id:contoso.com" |
le $search doit rechercher en tant qu’ID d’hôte spécifique. |
Cnp | $search="noc/address/state:WA" |
doit $search cibler un champ spécifique du whoisContact. |
Déclarant | $search="registrant/address/state:WA" |
doit $search cibler un champ spécifique du whoisContact. |
Registraire | $search="registrar/address/state:WA" |
doit $search cibler un champ spécifique du whoisContact. |
Technique | $search="technical/address/state:WA" |
doit $search cibler un champ spécifique du whoisContact. |
zone | $search="zone/address/state:WA" |
doit $search cibler un champ spécifique du whoisContact. |
En-têtes de demande
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Corps de la demande
N’indiquez pas le corps de la demande pour cette méthode.
Réponse
Si elle réussit, cette méthode renvoie un 200 OK
code de réponse et un objet microsoft.graph.security.whoisRecord dans le corps de la réponse.
Exemples
Demande
L’exemple suivant illustre une demande.
GET https://graph.microsoft.com/beta/security/threatIntelligence/whoisRecords?$search="admin/address/state:WA&$orderby=registrationDateTime desc"
Réponse
L’exemple suivant illustre la réponse.
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"@odata.type": "#microsoft.graph.security.whoisRecord",
"id": "Y29udG9zby5jb20kJDY5NjQ3ODEyMDc3NDY1NzI0MzM=",
"expirationDateTime": "2023-08-31T00:00:00Z",
"registrationDateTime": "2022-07-30T09:43:19Z",
"firstSeenDateTime": null,
"lastSeenDateTime": null,
"lastUpdateDateTime": "2023-06-24T08:34:15.984Z",
"billing": null,
"noc": null,
"zone": null,
"whoisServer": "rdap.markmonitor.com",
"domainStatus": "client update prohibited,client transfer prohibited,client delete prohibited",
"rawWhoisText": "Registrar: \n Handle: 1891582_DOMAIN_COM-VRSN\n LDH Name: contoso.com\n Nameserver: \n LDH Name: ns1.contoso.com\n Event: \n Action: last changed\n...",
"abuse": {
"email": "noreply@contoso.com",
"name": null,
"organization": null,
"telephone": "+1.5555555555",
"fax": null,
"address": {
"city": null,
"countryOrRegion": null,
"postalCode": null,
"state": null,
"street": null,
"type": "unknown"
}
},
"admin": {
"email": "noreply@contoso.com",
"name": "Domain Administrator",
"organization": "Contoso Org",
"telephone": "+1.5555555555",
"fax": "+1.5555555555",
"address": {
"city": "Redmond",
"countryOrRegion": "US",
"postalCode": "98052",
"state": "WA",
"street": "123 Fake St.",
"type": "unknown"
}
},
"registrar": {
"email": null,
"name": null,
"organization": "MarkMonitor Inc.",
"telephone": null,
"fax": null,
"address": null
},
"registrant": {
"email": "noreply@contoso.com",
"name": "Domain Administrator",
"organization": "Contoso Corporation",
"telephone": "+1.5555555555",
"fax": "+1.5555555555",
"address": {
"city": "Redmond",
"countryOrRegion": "US",
"postalCode": "98052",
"state": "WA",
"street": "123 Fake St.",
"type": "unknown"
}
},
"technical": {
"email": "noreply@contoso.com",
"name": "Hostmaster",
"organization": "Contoso Corporation",
"telephone": "+1.5555555555",
"fax": "+1.5555555555",
"address": {
"city": "Redmond",
"countryOrRegion": "US",
"postalCode": "98052",
"state": "WA",
"street": "123 Fake St.",
"type": "unknown"
}
},
"nameservers": [
{
"firstSeenDateTime": null,
"lastSeenDateTime": null,
"host": {
"id": "ns1.contoso-dns.com"
}
},
{
"firstSeenDateTime": null,
"lastSeenDateTime": null,
"host": {
"id": "ns2.contoso-dns.com"
}
},
{
"firstSeenDateTime": null,
"lastSeenDateTime": null,
"host": {
"id": "ns3.contoso-dns.com"
}
},
{
"firstSeenDateTime": null,
"lastSeenDateTime": null,
"host": {
"id": "ns4.contoso-dns.com"
}
}
],
"host": {
"id": "contoso.com"
}
}
]
}