Mettre à jour une application
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta
dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Mettez à jour les propriétés d’un objet application .
Importante
L’utilisation d’un correctif pour établir passwordCredential n’est pas prise en charge. Utilisez les méthodes addPassword et removePassword pour mettre à jour le mot de passe ou le secret d’une application.
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) | Application.ReadWrite.All | Non disponible. |
Déléguée (compte Microsoft personnel) | Application.ReadWrite.All | Non disponible. |
Application | Application.ReadWrite.OwnedBy | Application.ReadWrite.All |
Requête HTTP
Vous pouvez traiter l’application à l’aide de son id ou de son id d’application.
id et appId sont respectivement appelés ID d’objet et ID d’application (client) dans les inscriptions d’applications dans le Centre d’administration Microsoft Entra. Remplacez par {applicationObjectId}
l’ID de l’objet application.
PATCH /applications/{applicationObjectId}
PATCH /applications(appId='{appId}')
Pour mettre à jour le logo, utilisez la méthode PUT comme suit.
PUT /applications/{applicationObjectId}/logo
PUT /applications(appId='{appId}')/logo
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 les valeurs pour les champs appropriés qui doivent être mis à 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é. Pour de meilleures performances, n’incluez pas de valeurs existantes qui n’ont pas été modifiées.
Propriété | Type | Description |
---|---|---|
api | apiApplication | Spécifie les paramètres d’une application qui implémente une API Web. |
appRoles | Collection de appRole | Collection de rôles définis pour l’application. Ces rôles peuvent être affectés à des utilisateurs, des groupes ou des principaux de service. Ne pouvant accepter la valeur null. |
displayName | String | Nom d’affichage de l’application. |
groupMembershipClaims | String | Configure la revendication de groupes émise dans un jeton d’accès utilisateur ou OAuth 2.0 attendu par l’application. Pour définir cet attribut, utilisez l’une des valeurs de chaîne valides suivantes :
|
identifierUris | String collection | URI qui identifient l’application au sein de son locataire Microsoft Entra ou dans un domaine personnalisé vérifié si l’application est multilocataire. Pour en savoir plus, consultez l’article Objets application et principal du service. L’opérateur any est requis pour les expressions de filtre sur des propriétés à valeurs multiples. Ne peut accepter une valeur null. |
info | informationalUrl | Informations de profil de base de l’application, telles que le marketing, le support, les conditions d’utilisation et les URL de déclaration de confidentialité de l’application. Les conditions d’utilisation et la déclaration de confidentialité sont présentées aux utilisateurs par le biais de l’expérience de consentement de l’utilisateur. Pour plus d’informations, consultez Ajouter des conditions d’utilisation du service et déclaration de confidentialité pour les applications Microsoft Entra inscrites. |
isFallbackPublicClient | Boolean | Désigne le type d’application de base comme étant client public (une application installée exécutée sur un appareil mobile, par exemple). La valeur par défaut est false , ce qui signifie que le type d’application de secours est un client confidentiel tel que l’application web. Dans certains scénarios, l’ID Microsoft Entra ne peut pas déterminer le type d’application cliente (par exemple, le flux ROPC où il est configuré sans spécifier d’URI de redirection). Dans ce cas, l’ID Microsoft Entra interprète le type d’application en fonction de la valeur de cette propriété. |
keyCredentials | Collection keyCredential | Collection d’informations d’identification clés associées à l’application. Ne pouvant accepter la valeur null. |
logo | Stream | Logo principal de l’application. Ne pouvant accepter la valeur null. Utilisez la méthode PUT pour mettre à jour le logo. |
nativeAuthenticationApisEnabled | Chaîne | Spécifie si les API d’authentification native sont activées afin que l’application puisse les utiliser pour fournir une authentification native. Les valeurs possibles sont : none , all etunknownFutureValue . Pour plus d’informations, consultez Authentification native. |
onPremisesPublishing | onPremisesPublishing | Représente l’ensemble de propriétés permettant de configurer le proxy d’application Microsoft Entra pour une application locale. Cette propriété ne peut être définie qu’après la création de l’application et ne peut pas être mise à jour dans la même requête que les autres propriétés de l’application. |
optionalClaims | optionalClaims | Les développeurs d’applications peuvent configurer des revendications facultatives dans leurs applications Microsoft Entra pour spécifier les revendications qu’ils souhaitent dans les jetons envoyés à leur application par le service de jeton de sécurité Microsoft. Pour plus d’informations , consultez revendications facultatives . |
parentalControlSettings | parentalControlSettings | Spécifie les paramètres de contrôle parental d’une application. |
publicClient | publicClientApplication | Spécifie les paramètres des clients installés, tels que les appareils mobiles ou de bureau. |
requiredResourceAccess | collection requiredResourceAccess | Spécifie les ressources auxquelles l’application doit accéder. Cette propriété spécifie également l’ensemble des autorisations déléguées et des rôles d’application dont elle a besoin pour chacune de ces ressources. Cette configuration de l'accès aux ressources requises détermine l'expérience du consentement. Vous ne pouvez pas configurer plus de 50 services de ressources (API). À compter de la mi-octobre 2021, le nombre total d’autorisations requises ne doit pas dépasser 400. Ne pouvant accepter la valeur null. |
samlMetadataUrl | Chaîne | L’URL dans laquelle le service affiche les métadonnées SAML pour la fédération. Cette propriété est valide uniquement pour les applications monolocataires. |
signInAudience | String | Indique les comptes Microsoft pris en charge pour l’application en cours. Les valeurs prises en charge sont :
La valeur de cette propriété a des implications sur d’autres propriétés d’objet d’application. Par conséquent, si vous modifiez cette propriété, vous devrez peut-être d’abord modifier d’autres propriétés. Pour plus d’informations, consultez Différences de validation pour signInAudience. |
SPA | spaApplication | Spécifie les paramètres d’une application à page unique, y compris les URL de connexion et les URLs de redirection des codes d’autorisation et des jetons d’accès. |
étiquettes | String collection | Chaînes personnalisées qui peuvent servir à catégoriser et à identifier l’application. Ne pouvant accepter la valeur null. |
tokenEncryptionKeyId | String | Spécifie la keyId d’une clé publique de la collection keyCredentials. Une fois configuré, l’ID Microsoft Entra chiffre tous les jetons qu’il émet à l’aide de la clé vers laquelle pointe cette propriété. Le code d'application qui reçoit le jeton chiffré doit utiliser la clé privée correspondante pour déchiffrer le jeton avant de pouvoir l'utiliser pour l'utilisateur connecté. |
uniqueName | String | Identificateur unique qui peut être affecté à une application et utilisé comme clé de remplacement. Peut être mis à jour uniquement si null et est immuable une fois défini. |
uniqueName | String | Identificateur unique qui peut être affecté à une application en tant qu’identificateur de remplacement. Non modifiable. En lecture seule. |
web | WebApplication | Spécifie les paramètres d’une application web. |
SPA | spaApplication | Spécifie les paramètres d’une application à page unique, y compris les URL de connexion et les URLs de redirection des codes d’autorisation et des jetons d’accès. |
windows | windowsApplication | Spécifie les paramètres des applications exécutant Microsoft Windows et publiées dans le magasin de jeux Microsoft Store ou Xbox. Inclut le SID de package et les URI de redirection pour les codes d’autorisation et les jetons d’accès. |
Réponse
Si elle réussit, cette méthode renvoie un 204 No Content
code de réponse et ne retourne rien dans le corps de la réponse.
Exemples
Exemple 1 : Mettre à jour le displayName pour une application
Demande
La requête suivante montre un exemple.
PATCH https://graph.microsoft.com/beta/applications/{id}
Content-type: application/json
{
"displayName": "New display name"
}
Réponse
HTTP/1.1 204 No Content
Exemple 2 : Mettre à jour les rôles d’application pour une application
L’exemple suivant met à jour la collection appRoles pour une application. Pour conserver les rôles d’application existants, incluez-les dans la demande. Tous les objets existants dans la collection qui ne sont pas inclus dans la requête sont remplacés par les nouveaux objets. Cet objet est synchronisé avec la propriété correspondante du principal de service dans le locataire.
Demande
PATCH https://graph.microsoft.com/beta/applications/fda284b5-f0ad-4763-8289-31a273fca865
Content-type: application/json
{
"appRoles": [
{
"allowedMemberTypes": [
"User",
"Application"
],
"description": "Survey.Read",
"displayName": "Survey.Read",
"id": "ebb7c86c-fb47-4e3f-8191-420ff1b9de4a",
"isEnabled": false,
"origin": "Application",
"value": "Survey.Read"
}
]
}
Réponse
HTTP/1.1 204 No Content