Skip to content

Latest commit

 

History

History
162 lines (127 loc) · 5.73 KB

security-healthissue-update.md

File metadata and controls

162 lines (127 loc) · 5.73 KB
Raw
title description author ms.localizationpriority doc_type ms.date
Update healthIssue
Update the properties of a healthIssue object.
amirfeldman
medium
apiPageType
03/20/2024

Update healthIssue

Namespace: microsoft.graph.security

[!INCLUDE beta-disclaimer]

Update the properties of a healthIssue object.

[!INCLUDE national-cloud-support]

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

[!INCLUDE permissions-table]

HTTP request

PATCH /security/identities/healthIssues/{healthIssueId}

Request headers

Name Description
Authorization Bearer {token}. Required. Learn more about authentication and authorization.
Content-Type application/json. Required.

Request body

[!INCLUDE table-intro]

Property Type Description
status microsoft.graph.security.healthIssueStatus The status of the health issue. The possible values are: open, closed, suppressed, unknownFutureValue.

Response

If successful, this method returns a 200 OK response code and an updated microsoft.graph.security.healthIssue object in the response body.

Examples

Request

The following example shows a request.

HTTP

PATCH https://graph.microsoft.com/beta/security/identities/healthIssues/b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c
Content-Type: application/json

{
  "status": "closed"
}

C#

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

CLI

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Go

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Java

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

JavaScript

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PHP

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PowerShell

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Python

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Response

The following example shows the response.

Note: The response object shown here might be shortened for readability.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.security.healthIssue",
  "ID": "b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c",
  "displayName": "Directory Services Object Auditing is not configured as required",
  "healthIssueType": "Global",
  "issueTypeId": "1031",
  "severity": "medium",
  "status": "closed",
  "createdDateTime": "2022-07-15T12:19:27.7211305Z",
  "lastModifiedDateTime": "2022-07-15T12:19:27.7211305Z",
  "domainNames": [
    "domain1.contoso.com",
    "domain2.contoso.com"
  ],
  "sensorDNSNames": [
    "DC1.domain1.contoso.com",
    "DC2.domain2.contoso.com"
  ],
  "description": "Directory Services Object Auditing is not configured as required on domain1.contoso.com",
  "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",
    "Set-MDIConfiguration -Configuration DomainObjectAuditing -Mode Domain -Force"
  ],
  "additionalInformation": [
    "Descendant User Objects (Schema-Id-Guid: bf967aba-0de6-11d0-a285-00aa003049e2)",
    "Descendant Group Objects (Schema-Id-Guid: bf967a9c-0de6-11d0-a285-00aa003049e2)",
    "Descendant Computer Objects (Schema-Id-Guid: bf967a86-0de6-11d0-a285-00aa003049e2)",
    "Descendant msDS-GroupManagedServiceAccount Objects (Schema-Id-Guid: 7b8b558a-93a5-4af7-adca-c017e67f1057)",
    "Descendant msDS-ManagedServiceAccount Objects (Schema-Id-Guid: ce206244-5827-4a86-ba1c-1c0c386c1b64)"
  ]
}