Différences de propriété entre Azure AD Graph et Microsoft Graph

Cet article fait partie de l’étape 1 : passez en revue les différences d’API du processus de migration des applications.

En général, la meilleure façon de comparer les API Graph Azure Active Directory (Azure AD) à Microsoft Graph consiste à comparer les métadonnées sous-jacentes de chaque service, en particulier les descriptions de ressources :

Cet article met en évidence les différences de propriétés entre les ressources. Si aucune propriété n’est affichée dans cette liste, elle est déjà disponible dans la version v1.0 de Microsoft Graph, avec exactement le même nom que dans Azure AD Graph.

Étant donné que les ressources d’utilisateur et de groupe sont si fréquemment utilisées, elles sont répertoriées en premier. Les autres ressources sont répertoriées par ordre alphabétique.

Différences de propriétés utilisateur

La ressource utilisateur Azure AD Graph hérite d’DirectoryObject ; elle a été renommée en utilisateur dans Microsoft Graph et hérite de directoryObject. Voici les différences de propriétés :

Azure AD Graph
Propriété (v1.6)
Microsoft Graph
propriété
Commentaires
deletedTimestamp beta  -  deletedDateTime
v1.0  -  deletedDateTime
dirSyncEnabled beta  - onPremisesSyncEnabled
v1.0  -  onPremisesSyncEnabled
facsimileTelephoneNumber beta  -  faxNumber
faxNumber v1.0  - 
immutableId beta  - onPremisesImmutableId
v1.0  -  onPremisesImmutableId
isCompromised bêta  -  Non disponible
v1.0  -  Non disponible
L’API microsoft Graph identity protection fournit des fonctionnalités plus sophistiquées.
lastDirSyncDateTime beta  - onPremisesLastSyncDateTime
v1.0  -  onPremisesLastSyncDateTime
mobile beta  -  mobilePhone
v1.0  -  mobilePhone
passwordProfile/enforceChangePasswordPolicy beta  -  passwordProfile/forceChangePasswordNextSignIn
v1.0  -  passwordProfile/forceChangePasswordNextSignIn
passwordProfile/forceChangePasswordNextLogin beta  -  passwordProfile/forceChangePasswordNextSignInWithMfa
v1.0  -  passwordProfile/forceChangePasswordNextSignInWithMfa
provisioningErrors bêta  -  Non disponible
v1.0  -  Non disponible
Cette propriété et ses informations sont déconseillées. Toutefois, une nouvelle propriété décrivant les erreurs d’approvisionnement liées à AD Connecter se trouve dans onPremisesProvisioningErrors.
refreshTokensValidFromDateTime betasigninSessionsValidFromDateTime - 
v1.0signinSessionsValidFromDateTime - 
signinNames identités bêta  -  /signInType
identités v1.0  -  /signInType
Cette propriété fait désormais partie de la ressource objectIdentity .
telephoneNumber beta  -  businessPhones
v1.0  -  businessPhones
thumbnailPhoto photo bêta - , photos
photo v1.0 - , photos
La photo de miniature Azure AD n’est pas disponible via Microsoft Graph. Utilisez plutôt l’API photo .
userIdentities identités bêta  - 
Identités v1.0  - 
Pour plus d’informations, consultez le type de ressource objectIdentity .
userState beta  -  externalUserState
v1.0  -  externalUserState
userStateChangedOn betaexternalUserStateChangeDateTime - 
v1.0externalUserStateChangeDateTime - 

Différences de propriétés de groupe

La ressource de groupe Azure AD Graph hérite de DirectoryObject ; elle a été renommée en groupe dans Microsoft Graph et hérite de directoryObject. Voici les différences de propriétés :

Azure AD Graph
Propriété (v1.6)
Microsoft Graph
propriété
Commentaires
dirSyncEnabled beta  - onPremisesSyncEnabled
v1.0  -  onPremisesSyncEnabled
immutableId beta  - onPremisesImmutableId
v1.0  -  onPremisesImmutableId
lastDirSyncDateTime betaonPremisesLastSyncDateTime - 
v1.0onPremisesLastSyncDateTime - 
provisioningErrors bêta  -  Non disponible
v1.0  -  Non disponible
Cette propriété et ses informations sont déconseillées. Toutefois, une nouvelle propriété décrivant les erreurs d’approvisionnement liées à AD Connecter se trouve dans onPremisesProvisioningErrors.

Différences de propriétés d’application

La ressource application Azure AD Graph hérite d’DirectoryObject ; elle a été renommée en application dans Microsoft Graph et hérite de directoryObject. Voici les différences de propriétés :

Azure AD Graph
Propriété (v1.6)
Microsoft Graph
propriété
Commentaires
acceptMappedClaims api bêta  - /acceptMappedClaims
api/acceptMappedClaims v1.0  - 
acceptMappedClaims fait désormais partie de la nouvelle ressource api.
availableToOtherTenants beta  -  signInAudience
signInAudience v1.0  - 
La valeur par défaut pour availableToOtherTenants est false (signification AzureADMyOrg) tandis que pour signInAudience est AzureADandPersonalMicrosoftAccount.
errorUrl bêta  - non disponible
v1.0  -  non disponible
Cette propriété est déconseillée.
homepage beta  - web/homePageUrl
v1.0  -  web/homePageUrl
la page d’accueil fait désormais partie de la nouvelle ressource web.
informationalUrls informations bêta  - 
Informations v1.0  - 
knownClientApplications betaapi - /knownClientApplications
api/knownClientApplications v1.0  - 
knownClientApplications fait désormais partie de la nouvelle ressource api.
logoutUrl beta  - web/logoutUrl
v1.0  -  web/logoutUrl
logoutUrl fait désormais partie de la ressource web.
logoUrl beta  - info/logoUrl
v1.0  -  info/logoUrl
logoUrl fait désormais partie de la nouvelle ressource d’informations.
mainLogo logo bêta  - 
Logo v1.0  - 
oauth2AllowIdTokenImplicitFlow betaweb - /implicitGrantSettings/enableIdTokenIssuance
v1.0  - web/implicitGrantSettings/enableIdTokenIssuance
Renommé et faisant désormais partie de la nouvelle ressource implicitGrantSettings.
oauth2AllowImplicitFlow betaweb - /implicitGrantSettings/enableAccessTokenIssuance
v1.0  - web/implicitGrantSettings/enableAccessTokenIssuance
Renommé et faisant désormais partie de la nouvelle ressource implicitGrantSettings.
oauth2AllowUrlPathMatching bêta  - non disponible
v1.0  -  non disponible
Cette propriété est déconseillée.
oauth2Permissions betaapi - /oauth2PermissionScopes
v1.0  - api/oauth2PermissionScopes
Renommé et faisant désormais partie de la nouvelle ressource d’API.
publicClient beta  -  isFallbackPublicClient
v1.0  -  isFallbackPublicClient
Cette propriété a maintenant une nouvelle signification,  -  car elle contient les paramètres du client public tels que redirectUris. Déterminer si l’application est un client public ou confidentiel est désormais effectué automatiquement, avec la propriété isFallbackPublicClient qui gère le seul cas spécial qui ne peut pas être déterminé automatiquement.
recordConsentConditions bêta  - non disponible
v1.0  -  non disponible
Cette propriété est déconseillée.
replyUrls betaweb - /redirectUris, publicClient/redirectUris
v1.0  - web/redirectUris, publicClient/redirectUris
En plus d’être renommé, redirectUris fait désormais partie des nouvelles ressources web et publicClient. Cela permet aux développeurs d’utiliser des URI spécifiques pour leurs clients web et publics (par exemple, une application installée sur un appareil de bureau).
samlMetadataUrl bêta  -  Non encore disponible
v1.0  -  Non encore disponible
serviceEndpoints bêta  -  Non disponible
v1.0  -  Non disponible
Cette propriété est déconseillée, mais est planifiée pour servicePrincipal.

Différences AppRoleAssignment

La ressource Azure AD Graph AppRoleAssignment hérite de DirectoryObject ; elle a été renommée appRoleAssignment dans Microsoft Graph et hérite de directoryObject. Voici les différences de propriétés :

Azure AD Graph
Propriété (v1.6)
Microsoft Graph
propriété
Commentaires
creationTimestamp beta  - creationTimestamp
v1.0  - createdDateTime
id beta  - appRoleId
v1.0  - appRoleId

Différences de propriétés de contact

La ressource Azure AD Graph Contact hérite de DirectoryObject ; elle a été renommée orgContact dans Microsoft Graph et hérite de directoryObject. Voici les différences de propriétés :

Azure AD Graph
Propriété (v1.6)
Microsoft Graph
propriété
Commentaires
Ville betaaddresse - /city
adresses/ville v1.0  - 
La propriété city fait partie de la collection de ressources d’adresses .
country betaaddresses - /countryOrRegion
v1.0addresses - /countryOrRegion
La propriété countryOrRegion fait partie de la collection de ressources d’adresses .
dirSyncEnabled beta  - onPremisesSyncEnabled
v1.0  - onPremisesSyncEnabled
facsimileTelephoneNumber betaphones - /businessFax
v1.0  - phones/businessFax
Maintenant, une partie de la collection de téléphones qui prend en charge différents types de téléphone.
physicalDeliveryOfficeName beta  - officeLocation
officeLocation v1.0  - 
postalCode betaaddresses - /postalCode
adresses v1.0  - /postalCode
La propriété postalCode fait partie de la collection de ressources d’adresses .
provisioningErrors bêta  -  non disponible
v1.0  -  non disponible
Cette propriété et ses informations sont déconseillées. Toutefois, une nouvelle propriété décrivant n’importe quelle Connecter erreurs d’approvisionnement associées se trouve dans onPremisesProvisioningErrors. Actuellement, ce n’est disponible que dans beta.
sipProxyAddress beta  - imAddresses
v1.0  - imAddresses
state adresses bêta - /état
adresses/état v1.0  - 
La propriété d’état fait partie de la collection de ressources d’adresses .
streetAddress adresses bêta - /rue
adresses/rue v1.0  - 
La propriété street fait partie de la collection de ressources d’adresses .
telephoneNumber betaphones - /business
v1.0  - téléphones/entreprise
Maintenant, une partie de la collection de téléphones qui prend en charge différents types de téléphone.
thumbnailPhoto beta  - _Notyetavailable  _ 
v1.0  -  Non encore disponible

Différences de propriétés de contrat

La ressource de contrat Azure AD Graph hérite d’DirectoryObject ; elle a été renommée en contrat dans Microsoft Graph et hérite de directoryObject. Voici les différences de propriétés :

Azure AD Graph
Propriété (v1.6)
Microsoft Graph
propriété
Commentaires
customerContextId beta  - customerId
customerId v1.0  - 

Différences de propriétés d’appareil

La ressource Azure AD Graph Device hérite de DirectoryObject ; elle a été renommée en appareil dans Microsoft Graph et hérite de directoryObject. Voici les différences de propriétés :

Azure AD Graph
Propriété (v1.6)
Microsoft Graph
propriété
Commentaires
approximateLastLogonTimestamp betaapproximateLastSignInDateTime - 
v1.0  -  approximateLastSignInDateTime
complianceExpiryTime betacomplianceExpirationDateTime - 
v1.0  -  complianceExpirationDateTime
deviceObjectVersion betadeviceVersion - 
v1.0  -  deviceVersion
deviceOSType betaoperatingSystem - 
v1.0  -  operatingSystem
deviceOSVersion betaoperatingSystemVersion - 
v1.0  -  operatingSystemVersion
devicePhysicalIds betaphysicalIds - 
physicalIds v1.0  - 
deviceTrustType betatrustType - 
trustType v1.0  - 
dirSyncEnabled betaonPremisesSyncEnabled - 
v1.0  -  onPremisesSyncEnabled
lastDirSyncTime betaonPremisesLastSyncDateTime - 
v1.0  -  onPremisesLastSyncDateTime

Différences de propriétés DirectoryObject

La ressource Azure AD Graph DirectoryObject a été renommée directoryObject dans Microsoft Graph. Les modifications apportées à ses propriétés sont également visibles dans d’autres ressources qui héritent de DirectoryObject. Voici les différences de propriétés :

Azure AD Graph
Propriété (v1.6)
Microsoft Graph
propriété
Commentaires
deletionTimestamp betadeletedDateTime - 
v1.0  -  deletedDateTime
Bien que deletionTimestamp soit de type DateTime, deletedDateTime est un type DateTimeOffset.
Objectid betaid - 
ID v1.0  - 
La propriété id dans Microsoft Graph est héritée de la ressource d’entité.
objectType betaNot -  disponible
v1.0  -  Non disponible
Cette propriété n’est pas utilisée dans Microsoft Graph. Au lieu de cela, Microsoft Graph renvoie la propriété @odata.type, mais uniquement pour les API qui peuvent retourner des objets de différents types ou types dérivés. Par exemple, l’API List group members peut renvoyer des membres qui sont des utilisateurs, des groupes, des principaux de service, des contacts organisationnels ou des appareils. Pour les utilisateurs, **le @odata.type** est #microsoft.graph.user.

Différences de propriétés DirectoryObjectReference

La ressource Azure AD Graph DirectoryObjectReference hérite de DirectoryObject ; elle a été renommée directoryObjectPartnerReference dans Microsoft Graph et hérite de directoryObject. Voici les différences de propriétés :

Azure AD Graph
Propriété (v1.6)
Microsoft Graph
propriété
Commentaires
externalContextId betaexternalPartnerTenantId - 
v1.0  -  externalPartnerTenantId

Différences de propriétés de domaine

La ressource domaine Azure AD Graph a été renommée domaine dans Microsoft Graph. Voici les différences de propriétés :

Azure AD Graph
Propriété (v1.6)
Microsoft Graph
propriété
Commentaires
name betaid - 
ID v1.0  - 
Dans Microsoft Graph, l’identificateur unique (ID) contient le nom de domaine ; la name propriété n’existe pas.
forceDeleteState betastate - 
État v1.0  - 
Dans Azure AD Graph, il existe des propriétés forceDelete et d’état de domaine distinctes. Dans Microsoft Graph, tous les états de domaine sont gérés par la propriété d’état.
isDefaultForCloudRedirections _betaNotyetavailable  _ -  
v1.0  -  Non encore disponible

Différences de propriété oAuth2PermissionsGrant

La ressource OAuth2PermissionsGrant Azure AD Graph a été renommée oAuth2PermissionsGrant dans Microsoft Graph. Voici les différences de propriétés :

Azure AD Graph
Propriété (v1.6)
Microsoft Graph
propriété
Commentaires
expiryTime betaexpiryTime - 
v1.0Removed - 
Cette propriété n’est pas utilisée et est supprimée dans Microsoft Graph v1.0.
Starttime betastartTime - 
v1.0Removed - 
Cette propriété n’est pas utilisée et est supprimée dans Microsoft Graph v1.0.

Différences de propriétés de stratégie

Dans Microsoft Graph, il existe des types de stratégie nommés (tels que tokenIssuancePolicy ou tokenLifetimePolicy) plutôt qu’un type de ressource de stratégie générique. Vous trouverez plus d’informations dans la vue d’ensemble de la stratégie.

Différences de propriétés ServiceEndpoint

La ressource ServiceEndpoint Azure AD Graph hérite de DirectoryObject ; elle a été renommée en point de terminaison dans Microsoft Graph et hérite de directoryObject. Voici les différences de propriétés :

Azure AD Graph
Propriété (v1.6)
Microsoft Graph
propriété
Commentaires
serviceId betaproviderId - 
providerId v1.0  - 
Servicename betaproviderName - 
v1.0  - providerName
resourceId betaproviderResourceId - 
v1.0  - providerResourceId

Différences de propriétés ServicePrincipal

La ressource ServicePrincipal Azure AD Graph hérite de DirectoryObject ; elle a été renommée servicePrincipal dans Microsoft Graph et hérite de directoryObject. Voici les différences de propriétés :

Azure AD Graph
Propriété (v1.6)
Microsoft Graph
propriété
Commentaires
appOwnerTenantId betaappOwnerOrganizationId - 
v1.0  - appOwnerOrganizationId
Renommé.
informationalUrls informations bêta  - 
Informations v1.0  - 
oauth2Permissions beta  - publishedPermissionScopes
v1.0  - oauth2PermissionScopes
Renommé.
preferredTokenSigningKeyEndDateTime betaNot -  encore disponible
v1.0  - Non encore disponible
signInAudience betaNot -  encore disponible
v1.0  - Non encore disponible
serviceEndpoints betaendpoint - 
Point de terminaison v1.0  - 
Renommé.

Différences de propriété TenantDetails

La ressource Azure AD Graph TenantDetail hérite d’DirectoryObject ; elle a été renommée en organisation dans Microsoft Graph et hérite de directoryObject. Voici les différences de propriétés :

Azure AD Graph
Propriété (v1.6)
Microsoft Graph
propriété
Commentaires
companyLastDirSyncTime betaonPremisesLastSyncDateTime - 
v1.0onPremisesLastSyncDateTime - 
dirSyncEnabled betaonPremisesSyncEnabled - 
v1.0  -  onPremisesSyncEnabled
provisioningErrors betaNot -  disponible
v1.0Not -  disponible
Cette propriété et ses informations sont déconseillées.
telephoneNumber betabusinessPhones - 
v1.0businessPhones - 

Différences de propriété TrustedCasForPasswordlessAuth

La ressource Azure AD Graph TrustedCasForPasswordlessAuth a été renommée certificateBasedAuthConfiguration. Il n’y a aucune différence de propriété ; toutefois, il existe des différences dans le type de ressource certificateAuthority utilisé par la propriété certificateAuthorities .

Différences de propriété CertificateAuthorityInformation

CertificateAuthorityInformation Azure AD Graph a été renommé certificateAuthority dans Microsoft Graph. Voici les différences de propriétés.

Azure AD Graph
Propriété (v1.6)
Microsoft Graph
propriété
Commentaires
authorityType betaisRootAuthority - 
v1.0  - isRootAuthority
Le type de cette propriété est également devenu booléen. Auparavant, cette propriété devait être définie sur « RootAuthority » ou « IntermediateAuthority ». La définition de la nouvelle propriété sur true équivaut à « RootAuthority ».
crlDistributionPoint betacertificateRevocationListUrl - 
v1.0certificateRevocationListUrl - 
deltaCrlDistributionPoint betadeltaCertificateRevocationListUrl - 
v1.0deltaCertificateRevocationListUrl - 
trustedCertificate betacertificate - 
v1.0deltaCertificateRevocationListUrl - 
trustedIssuer betaissuer - 
v1.0issuer - 
trustedIssuerSki betaissuerSki - 
v1.0  - issuerSki

Étapes suivantes