Partager via


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 :
  • None
  • SecurityGroup: Pour les groupes de sécurité et les rôles Microsoft Entra
  • All: obtient tous les groupes de sécurité, groupes de distribution et rôles d’annuaire Microsoft Entra dont l’utilisateur connecté est membre
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 :
  • AzureADMyOrg: utilisateurs disposant d’un compte professionnel ou scolaire Microsoft dans le locataire Microsoft Entra de mon organisation (c’est-à-dire un seul locataire)
  • AzureADMultipleOrgs: utilisateurs disposant d’un compte professionnel ou scolaire Microsoft dans le locataire Microsoft Entra de toute organisation (c’est-à-dire multilocataire)
  • AzureADandPersonalMicrosoftAccount: utilisateurs disposant d’un compte Microsoft personnel ou d’un compte professionnel ou scolaire dans le locataire Microsoft Entra d’une organisation

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