Type de ressource applicationapplication resource type

Espace de noms : microsoft.graphNamespace: microsoft.graph

Important

Les API sous la /beta version de Microsoft Graph peuvent faire l’objet de modifications.APIs under the /beta version in Microsoft Graph are subject to change. L’utilisation de ces API dans des applications de production n’est pas prise en charge.Use of these APIs in production applications is not supported. Pour déterminer si une API est disponible dans la version 1.0, utilisez le sélecteur de version .To determine whether an API is available in v1.0, use the Version selector.

Represents an application. Any application that outsources authentication to Azure Active Directory (Azure AD) must be registered in a directory. Application registration involves telling Azure AD about your application, including the URL where it's located, the URL to send replies after authentication, the URI to identify your application, and more. For more information, see Basics of Registering an Application in Azure AD. Inherits from directoryObject.Represents an application. Any application that outsources authentication to Azure Active Directory (Azure AD) must be registered in a directory. Application registration involves telling Azure AD about your application, including the URL where it's located, the URL to send replies after authentication, the URI to identify your application, and more. For more information, see Basics of Registering an Application in Azure AD. Inherits from directoryObject.

Notes

Des modifications sont actuellement en cours de développement pour le type de ressource application.Changes to the application resource type are currently in development. Pour en savoir plus, consultez les problèmes connus avec Microsoft Graph.For more information, see Known issues with Microsoft Graph.

Cette ressource prend en charge l’utilisation d’une requête delta pour effectuer un suivi des suppressions, des mises à jour et des ajouts incrémentiels à l’aide d’une fonction delta.This resource supports using delta query to track incremental additions, deletions, and updates, by providing a delta function.

MéthodesMethods

MéthodeMethod Type renvoyéReturn Type DescriptionDescription
Répertorier les applicationsList applications collection applicationapplication collection Récupère la liste des applications de l’organisation.Retrieve the list of applications in the organization.
Créer une applicationCreate application applicationapplication Crée (inscrit) une application.Creates (registers) a new application.
Obtenir une applicationGet application applicationapplication Lit les propriétés et les relations de l’objet application.Read properties and relationships of application object.
Mettre à jour une applicationUpdate application applicationapplication Met à jour l’objet application.Update application object.
Supprimer l’applicationDelete application AucunNone Supprime l’objet application.Delete application object.
Répertorier les applications suppriméesList deleted applications collection directoryObjectdirectoryObject collection Récupère une liste d’applications supprimées récemment.Retrieve a list of recently deleted applications.
Obtenir l’application suppriméeGet deleted application directoryObjectdirectoryObject Récupère les propriétés d’une application récemment supprimée à partir des applications supprimées.Retrieve the properties of a recently deleted application.
Supprimer définitivement l’applicationPermanently delete application AucunNone Supprime définitivement d’une application.Permanently delete an applications.
Restaurer l’application suppriméeRestore deleted application directoryObjectdirectoryObject Restaure une application supprimée récemment.Restore a recently deleted application.
deltadelta collection applicationapplication collection Obtient des modifications incrémentielles d’applications.Get incremental changes for applications.
Créer un appelCreate call callcall Crée un appel en le publiant dans la collection d’objets call.Create a new call by posting to the calls collection.
Créer une réunion en ligneCreate online meeting onlineMeetingonlineMeeting Crée une réunion en ligne en la publiant dans la collection d’objets onlineMeeting.Create a new online meeting by posting to the onlineMeetings collection.
Certificats et secretsCertificates and secrets
Ajouter un mot de passeAdd password passwordCredentialpasswordCredential Ajoute un mot de passe fort à une application.Add a strong password to an application.
Supprimer le mot de passeRemove password passwordCredentialpasswordCredential Supprime un mot de passe d’une application.Remove a password from an application.
Touche AjouterAdd key keyCredentialkeyCredential Ajouter une touche relative aux informations d’identification à une application.Add a key credential to an application.
Supprimer la toucheRemove key AucunNone Supprimer une touche relative aux informations d’identification dans une application.Remove a key credential from an application.
ExtensionsExtensions
Répertorier les extensionsList extensions collection extensionPropertyextensionProperty collection Répertorie les propriétés d’extension sur un objet d’application.List extension properties on an application object.
Créer une extensionCreate extension extensionPropertyextensionProperty Crée une propriété d’extension sur un objet d’application.Create an extension property on an application object.
Supprimer une extensionDelete extension AucunNone Crée une propriété d’extension à partir d’un objet d’application.Delete an extension property from an application object.
PropriétairesOwners
Liste des propriétairesList owners collection directoryObjectdirectoryObject collection Obtient une collection d’objets owner.Get an owner object collection.
Ajouter un propriétaireAdd owner directoryObjectdirectoryObject Ajoute un propriétaire en publiant dans la collection des propriétaires.Add an owner by posting to the owners collection.
Supprimer un propriétaireRemove owner AucunNone Supprime un propriétaire d’une application.Remove an owner from an application.
StratégiesPolicies
Attribuer une tokenIssuancePolicyAssign tokenIssuancePolicy Collection de tokenIssuancePolicytokenIssuancePolicy collection Attribuer une tokenIssuancePolicy à cet objet.Assign a tokenIssuancePolicy to this object.
Répertorier les tokenIssuancePoliciesList tokenIssuancePolicies Collection de tokenIssuancePolicytokenIssuancePolicy collection Obtenir toutes les tokenIssuancePolicies attribuées à cet objet.Get all tokenIssuancePolicies assigned to this object.
Supprimer la tokenIssuancePolicyRemove tokenIssuancePolicy Collection de tokenIssuancePolicytokenIssuancePolicy collection Supprimer une tokenIssuancePolicy de cet objet.Remove a tokenIssuancePolicy from this object.
Attribuer une tokenLifetimePolicyAssign tokenLifetimePolicy Collection de tokenLifetimePolicytokenLifetimePolicy collection Attribuer une tokenLifetimePolicy à cet objet.Assign a tokenLifetimePolicy to this object.
Répertorier les tokenLifetimePoliciesList tokenLifetimePolicies Collection de tokenLifetimePolicytokenLifetimePolicy collection Obtenir les tokenLifetimePolicies attribuées à cet objet.Get all tokenLifetimePolicies assigned to this object.
Supprimer une tokenLifetimePolicyRemove tokenLifetimePolicy Collection de tokenLifetimePolicytokenLifetimePolicy collection Supprimer la tokenLifetimePolicy de cet objet.Remove a tokenLifetimePolicy from this object.
Serveur de publication vérifiéVerified publisher
Activer le serveur de publication vérifiéSet verified publisher AucuneNone Activez le serveur de publication vérifié d’une application.Set the verified publisher of an application.
Annuler le serveur de publication vérifiéUnset verified publisher AucuneNone Annulez le serveur de publication vérifié d’une application.Unset the verified publisher of an application.

PropriétésProperties

PropriétéProperty TypeType DescriptionDescription
addInsaddIns Collection addInaddIn collection Définit un comportement personnalisé qu’un service d’utilisation peut utiliser pour appeler une application dans des contextes spécifiques.Defines custom behavior that a consuming service can use to call an app in specific contexts. Par exemple, les applications qui peuvent afficher les flux de fichier peuvent spécifier la propriété addIns pour sa fonctionnalité « FileHandler ».For example, applications that can render file streams may set the addIns property for its "FileHandler" functionality. Cela permettra aux services tels que Office 365 d’appeler l’application dans le contexte d’un document sur lequel travaille l’utilisateur.This will let services like Office 365 call the application in the context of a document the user is working on.
apiapi apiApplicationapiApplication Spécifie les paramètres d’une application qui implémente une API Web.Specifies settings for an application that implements a web API.
appIdappId StringString Identificateur unique de l’application affectée par Azure AD.The unique identifier for the application that is assigned by Azure AD. Ne pouvant accepter la valeur null.Not nullable. En lecture seule.Read-only.
appRolesappRoles Collection de appRoleappRole collection Collection de rôles attribués à l’application.The collection of roles assigned to the application. Avec affectations de rôle d’application, ces rôles peuvent être affectés à des utilisateurs, des groupes ou des principaux de service associés à d’autres applications.With app role assignments, these roles can be assigned to users, groups, or service principals associated with other applications. Ne pouvant accepter la valeur null.Not nullable.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Date et heure d’inscription de l’application.The date and time the application was registered. En lecture seule.Read-only.
deletedDateTimedeletedDateTime DateTimeOffsetDateTimeOffset Date et heure de suppression de l’application.The date and time the application was deleted. En lecture seule.Read-only.
displayNamedisplayName StringString Nom d’affichage de l’application.The display name for the application.
groupMembershipClaimsgroupMembershipClaims StringString Configure la revendication groups émise dans un utilisateur ou un jeton d’accès OAuth 2.0 attendu par l’application.Configures the groups claim issued in a user or OAuth 2.0 access token that the application expects. Pour définir cet attribut, utilisez l’une des valeurs de chaîne suivantes :To set this attribute, use one of the following string values:
  • None
  • SecurityGroup : Pour groupes de sécurité et rôles Azure ADSecurityGroup: For security groups and Azure AD roles
  • All : Ceci permet d’obtenir tous les groupes de sécurité, les groupes de distribution et les rôles d’annuaire Azure AD dont l’utilisateur connecté est membre.All: This gets all of the security groups, distribution groups, and Azure AD directory roles that the signed-in user is a member of.
idid StringString Identificateur unique de l’application.The unique identifier for the application. Hérité de directoryObject.Inherited from directoryObject. Clé.Key. Ne peut pas avoir la valeur Null.Not nullable. En lecture seule.Read-only.
identifierUrisidentifierUris Collection de chaînesString collection Les URI qui identifient l’application au sein de son locataire Azure AD ou au sein d’un domaine personnalisé vérifié si l’application est multi-locataires.The URIs that identify the application within its Azure AD tenant, or within a verified custom domain if the application is multi-tenant. Pour en savoir plus, consultez l’article Objets application et principal du service.For more information, see Application Objects and Service Principal Objects. L’opérateur any est requis pour les expressions de filtre sur des propriétés à valeurs multiples.The any operator is required for filter expressions on multi-valued properties. Ne pouvant accepter la valeur null.Not nullable.
infoinfo informationalUrlinformationalUrl Les 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é.Basic profile information of the application, such as it's marketing, support, terms of service, and privacy statement URLs. 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.The terms of service and privacy statement are surfaced to users through the user consent experience. Pour plus d’informations, voir Procédure : ajouter les conditions d’utilisation et la déclaration de confidentialité des applications Azure AD inscrites.For more information, see How to: Add Terms of service and privacy statement for registered Azure AD apps.
isFallbackPublicClientisFallbackPublicClient BooléenBoolean 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).Specifies the fallback application type as public client, such as an installed application running on a mobile device. La valeur par défaut est false, ce qui signifie que le type d’application de secours est client confidentiel, une application web par exemple.The default value is false which means the fallback application type is confidential client such as a web app. Dans certains scénarios, Azure AD ne peut pas déterminer le type de l’application cliente.There are certain scenarios where Azure AD cannot determine the client application type. Par exemple, le flux ROPC où l’application est configurée sans spécifier d’URI de redirection.For example, the ROPC flow where the application is configured without specifying a redirect URI. Dans ce cas, Azure AD interprète le type d’application en fonction de la valeur de cette propriété.In those cases Azure AD interprets the application type based on the value of this property.
keyCredentialskeyCredentials Collection keyCredentialkeyCredential collection Collection d’informations d’identification clés associées à l’application.The collection of key credentials associated with the application. Ne pouvant accepter la valeur null.Not nullable.
logologo StreamStream Logo principal de l’application.The main logo for the application. Ne pouvant accepter la valeur null.Not nullable.
oauth2RequiredPostResponseoauth2RequiredPostResponse BooléenBoolean Spécifie si, dans le cadre des requêtes de jeton OAuth 2.0, Azure AD autorise les requêtes POST, par opposition aux requêtes GET.Specifies whether, as part of OAuth 2.0 token requests, Azure AD allows POST requests, as opposed to GET requests. La valeur par défaut est false, ce qui indique que seules les requêtes GET sont autorisées.The default is false, which specifies that only GET requests are allowed.
onPremisesPublishingonPremisesPublishing onPremisesPublishingonPremisesPublishing Représente l’ensemble de propriétés requises pour configurer le proxy d’application pour cette application.Represents the set of properties required for configuring Application Proxy for this application. La configuration de ces propriétés vous permet de publier votre application locale pour l’accès à distance sécurisé.Configuring these properties allows you to publish your on-premises application for secure remote access.
optionalClaimsoptionalClaims optionalClaimsoptionalClaims Les développeurs d'applications peuvent configurer des revendications facultatives dans leurs applications Azure AD pour spécifier les revendications qui sont envoyées à leur application par le service de jeton de sécurité de Microsoft.Application developers can configure optional claims in their Azure AD applications to specify the claims that are sent to their application by the Microsoft security token service. Pour plus d’informations, consultez Comment : fournir des revendications facultatives à votre application.For more information, see How to: Provide optional claims to your app.
parentalControlSettingsparentalControlSettings parentalControlSettingsparentalControlSettings Spécifie les paramètres de contrôle parental d’une application.Specifies parental control settings for an application.
passwordCredentialspasswordCredentials Collection passwordCredentialpasswordCredential collection Collection d’informations d’identification associées à l’application.The collection of password credentials associated with the application. Ne peut accepter une valeur null.Not nullable.
publicClientpublicClient publicClientApplicationpublicClientApplication Spécifie les paramètres des clients installés, tels que les appareils mobiles ou de bureau.Specifies settings for installed clients such as desktop or mobile devices.
publisherDomainpublisherDomain StringString Domaine de l’éditeur vérifié de l’application.The verified publisher domain for the application. En lecture seule.Read-only.
requiredResourceAccessrequiredResourceAccess collection requiredResourceAccessrequiredResourceAccess collection Spécifie les ressources auxquelles l’application doit accéder.Specifies the resources that the application needs to access. Cette propriété spécifie également le groupe d’étendues d’autorisations OAuth et de rôles d’application dont elle a besoin pour chacune de ces ressources.This property also specifies the set of OAuth permission scopes and application roles that it needs for each of those resources. Cette configuration de l'accès aux ressources requises détermine l'expérience du consentement.This configuration of access to the required resources drives the consent experience. Ne pouvant accepter la valeur null.Not nullable.
signInAudiencesignInAudience StringString Spécifie les comptes Microsoft qui sont pris en charge pour l’application actuelle.Specifies the Microsoft accounts that are supported for the current application. Les valeurs prises en charge sont :Supported values are:
  • AzureADMyOrg : utilisateurs avec un compte professionnel ou scolaire Microsoft dans le client Azure AD de mon organisation (locataire unique)AzureADMyOrg: Users with a Microsoft work or school account in my organization’s Azure AD tenant (single-tenant).
  • AzureADMultipleOrgs : utilisateurs avec un compte professionnel ou scolaire Microsoft dans le client Azure AD de n’importe quelle organisation (multi-client).AzureADMultipleOrgs: Users with a Microsoft work or school account in any organization’s Azure AD tenant (multi-tenant).
  • AzureADandPersonalMicrosoftAccount : utilisateurs avec un compte Microsoft personnel, ou un compte professionnel ou scolaire dans un client Azure AD de n’importe quelle organisation.AzureADandPersonalMicrosoftAccount: Users with a personal Microsoft account, or a work or school account in any organization’s Azure AD tenant.
  • PersonalMicrosoftAccount : utilisateurs avec un compte Microsoft personnel uniquement.PersonalMicrosoftAccount: Users with a personal Microsoft account only.
étiquettestags String collectionString collection Chaînes personnalisées qui peuvent servir à catégoriser et à identifier l’application.Custom strings that can be used to categorize and identify the application. Ne pouvant accepter la valeur null.Not nullable.
tokenEncryptionKeyIdtokenEncryptionKeyId StringString Spécifie la keyId d’une clé publique de la collection keyCredentials.Specifies the keyId of a public key from the keyCredentials collection. Une fois configuré, Azure AD chiffre tous les jetons qu’il émet à l’aide de la clé vers laquelle pointe cette propriété.When configured, Azure AD encrypts all the tokens it emits by using the key this property points to. 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é.The application code that receives the encrypted token must use the matching private key to decrypt the token before it can be used for the signed-in user.
verifiedPublisherverifiedPublisher verifiedPublisherverifiedPublisher Spécifie l’éditeur vérifié de l’application.Specifies the verified publisher of the application.
webweb WebApplicationwebApplication Spécifie les paramètres d’une application web.Specifies settings for a web application.

RelationsRelationships

RelationRelationship TypeType DescriptionDescription
Lynccalls collection callcall collection En lecture seule. Peut avoir la valeur Null.Read-only. Nullable.
connectorGroupconnectorGroup connectorGroupconnectorGroup Objet connectorGroup utilisé par l’application avec le Proxy d’application Azure AD.The connectorGroup the application is using with Azure AD Application Proxy. Pouvant accepter la valeur Null.Nullable.
createdOnBehalfOfcreatedOnBehalfOf directoryObjectdirectoryObject En lecture seule.Read-only.
extensionPropertiesextensionProperties collection extensionPropertyextensionProperty collection En lecture seule. Peut avoir la valeur Null.Read-only. Nullable.
onlineMeetingsonlineMeetings collection onlineMeetingonlineMeeting collection En lecture seule. Peut avoir la valeur Null.Read-only. Nullable.
Propriétairesowners collection directoryObjectdirectoryObject collection Objets de répertoire propriétaires de l’application.Directory objects that are owners of the application. Les propriétaires sont un ensemble d’utilisateurs non administrateurs qui sont autorisés à modifier cet objet.The owners are a set of non-admin users who are allowed to modify this object. Nécessite la version 2013-11-08 ou ultérieure.Requires version 2013-11-08 or newer. En lecture seule.Read-only. Pouvant accepter la valeur Null.Nullable.
tokenLifetimePoliciestokenLifetimePolicies Collection de tokenLifetimePolicytokenLifetimePolicy collection Les tokenLifetimePolicies attribuées à cette application.The tokenLifetimePolicies assigned to this application.

Représentation JSONJSON representation

Voici une représentation JSON de la ressource.The following is a JSON representation of the resource.

{
  "addIns": [{"@odata.type": "microsoft.graph.addIn"}],
  "api": {"@odata.type": "microsoft.graph.apiApplication"},
  "appId": "String",
  "appRoles": [{"@odata.type": "microsoft.graph.appRole"}],
  "createdDateTime": "String (timestamp)",
  "deletedDateTime": "String (timestamp)",
  "displayName": "String",
  "groupMembershipClaims": "String",
  "id": "String (identifier)",
  "identifierUris": ["String"],
  "info": {"@odata.type": "microsoft.graph.informationalUrl"},
  "isFallbackPublicClient": false,
  "keyCredentials": [{"@odata.type": "microsoft.graph.keyCredential"}],
  "logo": "Stream",
  "oauth2RequiredPostResponse": false,
  "optionalClaims": {"@odata.type": "microsoft.graph.optionalClaims"},
  "parentalControlSettings": {"@odata.type": "microsoft.graph.parentalControlSettings"},
  "passwordCredentials": [{"@odata.type": "microsoft.graph.passwordCredential"}],
  "publicClient": {"@odata.type": "microsoft.graph.publicClientApplication"},
  "publisherDomain": "String",
  "requiredResourceAccess": [{"@odata.type": "microsoft.graph.requiredResourceAccess"}],
  "signInAudience": "String",
  "tags": ["String"],
  "tokenEncryptionKeyId": "String",
  "verifiedPublisher": {"@odata.type": "microsoft.graph.verifiedPublisher"},
  "web": {"@odata.type": "microsoft.graph.webApplication"}
}