Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Espaço de nomes: microsoft.graph.security
Atualize as propriedades de um objeto healthIssue .
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | SecurityIdentitiesHealth.ReadWrite.All | Indisponível. |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | SecurityIdentitiesHealth.ReadWrite.All | Indisponível. |
Solicitação HTTP
PATCH /security/identities/healthIssues/{healthIssueId}
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type | application/json. Obrigatório. |
Corpo da solicitação
No corpo do pedido, forneça apenas os valores das propriedades a atualizar. As propriedades existentes que não estão incluídas no corpo do pedido mantêm os valores anteriores ou são recalculadas com base em alterações a outros valores de propriedade.
A tabela a seguir especifica as propriedades que podem ser atualizadas.
| Propriedade | Tipo | Descrição |
|---|---|---|
| status | microsoft.graph.security.healthIssueStatus | A status do problema de saúde. Os valores possíveis são: open, closed, suppressed, unknownFutureValue. |
Resposta
Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto microsoft.graph.security.healthIssue atualizado no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
PATCH https://graph.microsoft.com/v1.0/security/identities/healthIssues/b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c
Content-Type: application/json
{
"status": "closed"
}
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
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"
}