Mettre à jour l’intégritéIssue
Espace de noms : microsoft.graph.security
Mettez à jour les propriétés d’un objet healthIssue .
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) | SecurityIdentitiesHealth.ReadWrite.All | Non disponible. |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | SecurityIdentitiesHealth.ReadWrite.All | Non disponible. |
Requête HTTP
PATCH /security/identities/healthIssues/{healthIssueId}
En-têtes de demande
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Content-Type | application/json. Obligatoire. |
Corps de la demande
Dans le corps de la demande, fournissez uniquement les valeurs des propriétés à mettre à jour. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conservent leurs valeurs précédentes ou sont recalculées en fonction des modifications apportées à d’autres valeurs de propriété.
Le tableau suivant spécifie les propriétés qui peuvent être mises à jour.
Propriété | Type | Description |
---|---|---|
status | microsoft.graph.security.healthIssueStatus | Status du problème d’intégrité. Les valeurs possibles sont : open , closed , suppressed , unknownFutureValue . |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK
code de réponse et un objet microsoft.graph.security.healthIssue mis à jour dans le corps de la réponse.
Exemples
Demande
L’exemple suivant illustre une demande.
PATCH https://graph.microsoft.com/v1.0/security/identities/healthIssues/b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c
Content-Type: application/json
{
"status": "closed"
}
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
{
"@odata.type": "#microsoft.graph.security.healthIssue",
"additionalInformation": ["Descendant User Objects (Schema-Id-Guid: bf967aba-0de6-11d0-a285-00aa003049e2)"],
"createdDateTime": "2022-07-15T12:19:27.7211305Z",
"description": "Directory Services Object Auditing isn't configured as required on domain1.contoso.com",
"displayName": "Directory Services Object Auditing isn't configured as required",
"domainNames": ["domain1.contoso.com", "domain2.contoso.com"],
"healthIssueType": "Global",
"id": "b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c",
"issueTypeId": "1031",
"lastModifiedDateTime": "2022-07-15T12:19:27.7211305Z",
"recommendations": ["Please configure the Directory Services Object Auditing events according to the guidance as described in https://aka.ms/mdi/objectauditing"],
"recommendedActionCommands": ["Import-Module DefenderForIdentity"],
"sensorDNSNames": ["DC1.domain1.contoso.com", "DC2.domain2.contoso.com"],
"severity": "medium",
"status": "closed"
}