Espace de noms : microsoft.graph.security
Mettez à jour les propriétés d’un objet capteur .
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) |
SecurityIdentitiesSensors.ReadWrite.All |
Non disponible. |
| Déléguée (compte Microsoft personnel) |
Non prise en charge. |
Non prise en charge. |
| Application |
SecurityIdentitiesSensors.ReadWrite.All |
Non disponible. |
Requête HTTP
PATCH /security/identities/sensors/{sensorId}
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 |
| paramètres |
microsoft.graph.security.sensorSettings |
Informations sur les paramètres du capteur. La propriété description peut être mise à jour pour tous les types de capteurs. La propriété isDelayedUpdateEnabled peut être mise à jour pour tous les capteurs avec la version < 3.X. La propriété domainControllerDnsNames peut être mise à jour pour tous les capteurs avec la version < 3.X, à l’exception des capteurs de contrôleur de domaine. |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet microsoft.graph.security.sensor 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/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);
Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (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)
Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (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);
Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (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();
Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (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)
Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).
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.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
},
"serviceStatus": "running"
}