Mettre à jour endUserSettings

Espace de noms: microsoft.graph

Mettez à jour les propriétés d’un objet endUserSettings qui contrôle l’expérience de l’utilisateur final pour les suggestions de package d’accès et la découverte des ressources.

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)	EntitlementManagement.ReadWrite.All	Non disponible.
Déléguée (compte Microsoft personnel)	Non prise en charge.	Non prise en charge.
Application	EntitlementManagement.ReadWrite.All	Non disponible.

Conseil

Pour l’accès délégué à l’aide de comptes professionnels ou scolaires, l’utilisateur connecté doit se voir attribuer un rôle d’administrateur avec des autorisations de rôle prises en charge via l’une des options suivantes :

• Un rôle Microsoft Entra où le rôle le moins privilégié est Administrateur de gouvernance des identités. Il s’agit de l’option la moins privilégiée.

Dans les scénarios d’application uniquement, l’application appelante peut se voir attribuer l’un des rôles pris en charge précédents au lieu de l’autorisation d’application EntitlementManagement.ReadWrite.All . Le rôle Administrateur de gouvernance des identités est moins privilégié que l’autorisation de l’application EntitlementManagement.ReadWrite.All .

Pour plus d’informations, consultez Délégation et rôles dans la gestion des droits d’utilisation et comment déléguer la gouvernance des accès aux gestionnaires de package d’accès dans la gestion des droits d’utilisation.

Requête HTTP

PUT /identityGovernance/entitlementManagement/controlConfigurations/endUserSettings

En-têtes de demande

Nom	Description
Autorisation	Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type	application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON de l’objet endUserSettings .

Le tableau suivant indique les propriétés requises lorsque vous mettez à jour endUserSettings.

Propriété	Type	Description
relatedPeopleInsightLevel	accessPackageSuggestionRelatedPeopleInsightLevel	Niveau des insights de personnes associées à afficher dans les suggestions de package d’accès. Les valeurs possibles sont : disabled, count, countAndNames, unknownFutureValue.
showApproverDetailsToMembers	Booléen	Indique si les détails de l’approbateur sont affichés aux membres. Lorsque truela valeur est , les informations de l’approbateur sont visibles par les membres.

Réponse

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet endUserSettings mis à jour dans le corps de la réponse.

Exemples

Demande

L’exemple suivant illustre une demande.

HTTP

PUT https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/controlConfigurations/endUserSettings
Content-type: application/json

{
  "@odata.type": "#microsoft.graph.endUserSettings",
  "relatedPeopleInsightLevel": "countAndNames",
  "showApproverDetailsToMembers": true
}

C#

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new EndUserSettings
{
	OdataType = "#microsoft.graph.endUserSettings",
	RelatedPeopleInsightLevel = AccessPackageSuggestionRelatedPeopleInsightLevel.CountAndNames,
	ShowApproverDetailsToMembers = true,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.IdentityGovernance.EntitlementManagement.ControlConfigurations["{controlConfiguration-id}"].PutAsync(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).

Go

// 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"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewControlConfiguration()
relatedPeopleInsightLevel := graphmodels.COUNTANDNAMES_ACCESSPACKAGESUGGESTIONRELATEDPEOPLEINSIGHTLEVEL 
requestBody.SetRelatedPeopleInsightLevel(&relatedPeopleInsightLevel) 
showApproverDetailsToMembers := true
requestBody.SetShowApproverDetailsToMembers(&showApproverDetailsToMembers) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
controlConfigurations, err := graphClient.IdentityGovernance().EntitlementManagement().ControlConfigurations().ByControlConfigurationId("controlConfiguration-id").Put(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).

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

EndUserSettings controlConfiguration = new EndUserSettings();
controlConfiguration.setOdataType("#microsoft.graph.endUserSettings");
controlConfiguration.setRelatedPeopleInsightLevel(AccessPackageSuggestionRelatedPeopleInsightLevel.CountAndNames);
controlConfiguration.setShowApproverDetailsToMembers(true);
ControlConfiguration result = graphClient.identityGovernance().entitlementManagement().controlConfigurations().byControlConfigurationId("{controlConfiguration-id}").put(controlConfiguration);

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).

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const controlConfiguration = {
  '@odata.type': '#microsoft.graph.endUserSettings',
  relatedPeopleInsightLevel: 'countAndNames',
  showApproverDetailsToMembers: true
};

await client.api('/identityGovernance/entitlementManagement/controlConfigurations/endUserSettings')
	.put(controlConfiguration);

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

<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\EndUserSettings;
use Microsoft\Graph\Generated\Models\AccessPackageSuggestionRelatedPeopleInsightLevel;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new EndUserSettings();
$requestBody->setOdataType('#microsoft.graph.endUserSettings');
$requestBody->setRelatedPeopleInsightLevel(new AccessPackageSuggestionRelatedPeopleInsightLevel('countAndNames'));
$requestBody->setShowApproverDetailsToMembers(true);

$result = $graphServiceClient->identityGovernance()->entitlementManagement()->controlConfigurations()->byControlConfigurationId('controlConfiguration-id')->put($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).

PowerShell

Import-Module Microsoft.Graph.Identity.Governance

$params = @{
	"@odata.type" = "#microsoft.graph.endUserSettings"
	relatedPeopleInsightLevel = "countAndNames"
	showApproverDetailsToMembers = $true
}

Set-MgEntitlementManagementControlConfiguration -ControlConfigurationId $controlConfigurationId -BodyParameter $params

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).

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.end_user_settings import EndUserSettings
from msgraph.generated.models.access_package_suggestion_related_people_insight_level import AccessPackageSuggestionRelatedPeopleInsightLevel
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = EndUserSettings(
	odata_type = "#microsoft.graph.endUserSettings",
	related_people_insight_level = AccessPackageSuggestionRelatedPeopleInsightLevel.CountAndNames,
	show_approver_details_to_members = True,
)

result = await graph_client.identity_governance.entitlement_management.control_configurations.by_control_configuration_id('controlConfiguration-id').put(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.context": "https://graph.microsoft.com/v1.0/$metadata#identityGovernance/entitlementManagement/controlConfigurations/endUserSettings",
  "relatedPeopleInsightLevel": "countAndNames",
  "showApproverDetailsToMembers": true
}