Espaço de nomes: microsoft.graph.security
Atualize as propriedades de um objeto de sensor .
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) |
SecurityIdentitiesSensors.ReadWrite.All |
Indisponível. |
| Delegado (conta pessoal da Microsoft) |
Sem suporte. |
Sem suporte. |
| Application |
SecurityIdentitiesSensors.ReadWrite.All |
Indisponível. |
Solicitação HTTP
PATCH /security/identities/sensors/{sensorId}
| 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 |
| settings |
microsoft.graph.security.sensorSettings |
Informações sobre as definições do sensor. A propriedade description pode ser atualizada para todos os tipos de sensores. A propriedade isDelayedUpdateEnabled pode ser atualizada para todos os sensores com a versão < 3.X. A propriedade domainControllerDnsNames pode ser atualizada para todos os sensores com a versão < 3.X, exceto para sensores de controlador de domínio. |
Resposta
Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto microsoft.graph.security.sensor 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/sensors/d31dd827-92cd-4cd6-b269-c151a0eec55d
Content-Type: application/json
{
"settings": {
"description": "dc1 settings new description",
"domainControllerDnsNames": [
"DC1.domain1.test.local"
],
"isDelayedDeploymentEnabled": false
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models.Security;
var requestBody = new Sensor
{
Settings = new SensorSettings
{
Description = "dc1 settings new description",
DomainControllerDnsNames = new List<string>
{
"DC1.domain1.test.local",
},
IsDelayedDeploymentEnabled = false,
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Security.Identities.Sensors["{sensor-id}"].PatchAsync(requestBody);
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodelssecurity "github.com/microsoftgraph/msgraph-sdk-go/models/security"
//other-imports
)
requestBody := graphmodelssecurity.NewSensor()
settings := graphmodelssecurity.NewSensorSettings()
description := "dc1 settings new description"
settings.SetDescription(&description)
domainControllerDnsNames := []string {
"DC1.domain1.test.local",
}
settings.SetDomainControllerDnsNames(domainControllerDnsNames)
isDelayedDeploymentEnabled := false
settings.SetIsDelayedDeploymentEnabled(&isDelayedDeploymentEnabled)
requestBody.SetSettings(settings)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
sensors, err := graphClient.Security().Identities().Sensors().BySensorId("sensor-id").Patch(context.Background(), requestBody, nil)
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.models.security.Sensor sensor = new com.microsoft.graph.models.security.Sensor();
com.microsoft.graph.models.security.SensorSettings settings = new com.microsoft.graph.models.security.SensorSettings();
settings.setDescription("dc1 settings new description");
LinkedList<String> domainControllerDnsNames = new LinkedList<String>();
domainControllerDnsNames.add("DC1.domain1.test.local");
settings.setDomainControllerDnsNames(domainControllerDnsNames);
settings.setIsDelayedDeploymentEnabled(false);
sensor.setSettings(settings);
com.microsoft.graph.models.security.Sensor result = graphClient.security().identities().sensors().bySensorId("{sensor-id}").patch(sensor);
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
const options = {
authProvider,
};
const client = Client.init(options);
const sensor = {
settings: {
description: 'dc1 settings new description',
domainControllerDnsNames: [
'DC1.domain1.test.local'
],
isDelayedDeploymentEnabled: false
}
};
await client.api('/security/identities/sensors/d31dd827-92cd-4cd6-b269-c151a0eec55d')
.update(sensor);
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\Security\Sensor;
use Microsoft\Graph\Generated\Models\Security\SensorSettings;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new Sensor();
$settings = new SensorSettings();
$settings->setDescription('dc1 settings new description');
$settings->setDomainControllerDnsNames(['DC1.domain1.test.local', ]);
$settings->setIsDelayedDeploymentEnabled(false);
$requestBody->setSettings($settings);
$result = $graphServiceClient->security()->identities()->sensors()->bySensorId('sensor-id')->patch($requestBody)->wait();
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
Import-Module Microsoft.Graph.Security
$params = @{
settings = @{
description = "dc1 settings new description"
domainControllerDnsNames = @(
"DC1.domain1.test.local"
)
isDelayedDeploymentEnabled = $false
}
}
Update-MgSecurityIdentitySensor -SensorId $sensorId -BodyParameter $params
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.security.sensor import Sensor
from msgraph.generated.models.security.sensor_settings import SensorSettings
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = Sensor(
settings = SensorSettings(
description = "dc1 settings new description",
domain_controller_dns_names = [
"DC1.domain1.test.local",
],
is_delayed_deployment_enabled = False,
),
)
result = await graph_client.security.identities.sensors.by_sensor_id('sensor-id').patch(request_body)
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
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.sensor",
"id": "b3c1b5fc-828c-45fa-a1e1-10d74f6d6e9c",
"displayName": "DC1",
"sensorType": "domainControllerIntegrated",
"version": "2.239.18124.58593",
"deploymentStatus": "upToDate",
"createdDateTime": "2023-11-16T09:41:24.2585071Z",
"domainName": "domain1.test.local",
"healthStatus": "healthy",
"openHealthIssuesCount": 0,
"settings": {
"@odata.type": "microsoft.graph.security.sensorSettings",
"description": "dc1 settings new description",
"domainControllerDnsNames": [
"DC1.domain1.test.local"
],
"isDelayedDeploymentEnabled": false
}
}