Mettre à jour windowsPrivacyDataAccessControlItem
Espace de noms: microsoft.graph
Important: Les API Microsoft Graph sous la version /beta sont susceptibles d’être modifiées ; l’utilisation de production n’est pas prise en charge.
Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.
Mettez à jour les propriétés d’un objet windowsPrivacyDataAccessControlItem .
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
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.
Type d’autorisation | Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins) |
---|---|
Déléguée (compte professionnel ou scolaire) | DeviceManagementConfiguration.ReadWrite.All |
Déléguée (compte Microsoft personnel) | Non prise en charge. |
Application | DeviceManagementConfiguration.ReadWrite.All |
Requête HTTP
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windows10GeneralConfiguration/privacyAccessControls/{windowsPrivacyDataAccessControlItemId}
En-têtes de demande
En-tête | Valeur |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Accepter | application/json |
Corps de la demande
Dans le corps de la demande, fournissez une représentation JSON pour l’objet windowsPrivacyDataAccessControlItem .
Le tableau suivant présente les propriétés requises lorsque vous créez l’objet windowsPrivacyDataAccessControlItem.
Propriété | Type | Description |
---|---|---|
id | String | Clé de WindowsPrivacyDataAccessControlItem. |
accessLevel | windowsPrivacyDataAccessLevel | Cela indique un niveau d’accès pour la catégorie de données de confidentialité à laquelle l’application spécifiée sera attribuée. Les valeurs possibles sont les suivantes : notConfigured , forceAllow , forceDeny , userInControl . |
dataCategory | windowsPrivacyDataCategory | Cela indique une catégorie de données de confidentialité à laquelle le contrôle d’accès spécifique s’appliquera. Les valeurs possibles sont , accountInfo notConfigured , appsRunInBackground , calendar , callHistory , camera contacts , diagnosticsInfo , email , messaging notifications motion phone radios microphone location , , tasks , . trustedDevices syncWithDevices |
appPackageFamilyName | String | Nom de la famille de packages d’une application Windows. Lorsqu’il est défini, le niveau d’accès s’applique à l’application spécifiée. |
appDisplayName | String | Nom de la famille de packages d’une application Windows. Lorsqu’il est défini, le niveau d’accès s’applique à l’application spécifiée. |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK
code de réponse et un objet windowsPrivacyDataAccessControlItem mis à jour dans le corps de la réponse.
Exemple
Demande
Voici un exemple de demande.
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windows10GeneralConfiguration/privacyAccessControls/{windowsPrivacyDataAccessControlItemId}
Content-type: application/json
Content-length: 250
{
"@odata.type": "#microsoft.graph.windowsPrivacyDataAccessControlItem",
"accessLevel": "forceAllow",
"dataCategory": "accountInfo",
"appPackageFamilyName": "App Package Family Name value",
"appDisplayName": "App Display Name value"
}
Réponse
Voici un exemple de 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.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 299
{
"@odata.type": "#microsoft.graph.windowsPrivacyDataAccessControlItem",
"id": "03b15556-5556-03b1-5655-b1035655b103",
"accessLevel": "forceAllow",
"dataCategory": "accountInfo",
"appPackageFamilyName": "App Package Family Name value",
"appDisplayName": "App Display Name value"
}