Mettre à jour deviceConfigurationDeviceStatusUpdate deviceConfigurationDeviceStatus

Espace de noms: microsoft.graphNamespace: microsoft.graph

Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Met à jour les propriétés d’un objet deviceConfigurationDeviceStatus.Update the properties of a deviceConfigurationDeviceStatus object.

Conditions préalablesPrerequisites

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (par ordre décroissant du niveau de privilège)Permissions (from most to least privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported.
ApplicationApplication Non prise en charge.Not supported.

Requête HTTPHTTP Request

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/deviceStatuses/{deviceConfigurationDeviceStatusId}

En-têtes de demandeRequest headers

En-têteHeader ValeurValue
AutorisationAuthorization Porteur <token> obligatoire.Bearer <token> Required.
AccepterAccept application/jsonapplication/json

Corps de la demandeRequest body

Dans le corps de la demande, fournissez une représentation JSON de l’objet deviceConfigurationDeviceStatus.In the request body, supply a JSON representation for the deviceConfigurationDeviceStatus object.

Le tableau suivant indique les propriétés qui sont requises lorsque vous créez l’objet deviceConfigurationDeviceStatus.The following table shows the properties that are required when you create the deviceConfigurationDeviceStatus.

PropriétéProperty TypeType DescriptionDescription
idid ChaîneString Clé de l’entité.Key of the entity.
deviceDisplayNamedeviceDisplayName StringString Nom d’appareil de l’objet DevicePolicyStatus.Device name of the DevicePolicyStatus.
userNameuserName ChaîneString Nom d’utilisateur signaléThe User Name that is being reported
deviceModeldeviceModel ChaîneString Modèle d’appareil signaléThe device model that is being reported
complianceGracePeriodExpirationDateTimecomplianceGracePeriodExpirationDateTime DateTimeOffsetDateTimeOffset Date et heure d’expiration de la période de grâce de conformité de l’appareilThe DateTime when device compliance grace period expires
statusstatus complianceStatuscomplianceStatus Statut de conformité du rapport de stratégie.Compliance status of the policy report. Les valeurs possibles sont les suivantes : unknown, notApplicable, compliant, remediated, nonCompliant, error, conflict et notAssigned.Possible values are: unknown, notApplicable, compliant, remediated, nonCompliant, error, conflict, notAssigned.
lastReportedDateTimelastReportedDateTime DateTimeOffsetDateTimeOffset Dernière modification du rapport de stratégie.Last modified date time of the policy report.
userPrincipalNameuserPrincipalName StringString UserPrincipalName.UserPrincipalName.

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et un objet deviceConfigurationDeviceStatus mis à jour dans le corps de la réponse.If successful, this method returns a 200 OK response code and an updated deviceConfigurationDeviceStatus object in the response body.

ExempleExample

DemandeRequest

Voici un exemple de demande.Here is an example of the request.

PATCH https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations/{deviceConfigurationId}/deviceStatuses/{deviceConfigurationDeviceStatusId}
Content-type: application/json
Content-length: 429

{
  "@odata.type": "#microsoft.graph.deviceConfigurationDeviceStatus",
  "deviceDisplayName": "Device Display Name value",
  "userName": "User Name value",
  "deviceModel": "Device Model value",
  "complianceGracePeriodExpirationDateTime": "2016-12-31T23:56:44.951111-08:00",
  "status": "notApplicable",
  "lastReportedDateTime": "2017-01-01T00:00:17.7769392-08:00",
  "userPrincipalName": "User Principal Name value"
}

RéponseResponse

Voici un exemple de la réponse. Remarque : L’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

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

{
  "@odata.type": "#microsoft.graph.deviceConfigurationDeviceStatus",
  "id": "674e98e5-98e5-674e-e598-4e67e5984e67",
  "deviceDisplayName": "Device Display Name value",
  "userName": "User Name value",
  "deviceModel": "Device Model value",
  "complianceGracePeriodExpirationDateTime": "2016-12-31T23:56:44.951111-08:00",
  "status": "notApplicable",
  "lastReportedDateTime": "2017-01-01T00:00:17.7769392-08:00",
  "userPrincipalName": "User Principal Name value"
}