Partager via

Vue d’ensemble de l’API Exchange Online Administration

Remarque

Les fonctionnalités décrites dans cet article sont actuellement en préversion, ne sont pas disponibles dans toutes les organisations et sont susceptibles d’être modifiées.

L’API Exchange Online Administration est une surface d’administration basée sur REST qui active un ensemble ciblé d’applets de commande et de paramètres Exchange en tant que points de terminaison POST uniquement. L’API permet d’accéder à quelques tâches clés qui étaient auparavant disponibles via les services Web Exchange (EWS), dont la dépréciation est prévue en octobre 2026. L’API est conçue pour ces scénarios spécifiques et ne remplace pas la surface d’administration Exchange complète dans Exchange Online PowerShell.

L’API Exchange Online Administration prend en charge le sous-ensemble suivant de fonctions de gestion Exchange :

  • Afficher organization configuration Exchange : récupérez les paramètres organization tels que les domaines acceptés, la configuration des infos-courrier et les limites de boîte aux lettres (par exemple, MaxSendSize).
  • Afficher l’appartenance au groupe de distribution et au groupe de distribution dynamique.
  • Afficher et gérer les autorisations de dossier de boîte aux lettres : lire et modifier les autorisations de dossier pour les boîtes aux lettres (afficher, ajouter, définir et supprimer des autorisations).
  • Affichez et mettez à jour Envoyer au nom (délégation) pour les boîtes aux lettres.

Les organisations qui migrent hors d’EWS peuvent utiliser l’API Administration pour obtenir une administration de style d’applet de commande comparable sur HTTP tout en s’intégrant à des modèles d’automatisation et de gouvernance modernes.

L’API Exchange Online Administration a les fonctionnalités suivantes :

  • Surface de style applet de commande REST : l’API Administration expose un ensemble ciblé de tâches d’administration Exchange en tant que points de terminaison HTTP. Les administrateurs Exchange qui utilisent les applets de commande PowerShell doivent être familiers, mais vous l’appelez via HTTP.
  • Opérations POST uniquement : chaque opération utilise la méthode HTTP POST. Chaque requête spécifie une applet de commande et les paramètres pris en charge pour cette applet de commande dans le point de terminaison sélectionné.
  • Ensemble délimité d’applets de commande et de paramètres : l’API ne fait pas apparaître chaque applet de commande ou paramètre Exchange. Chaque point de terminaison expose uniquement un sous-ensemble d’applets de commande, et chaque applet de commande prend en charge un sous-ensemble de paramètres.
  • Étendue prioritaire : l’API couvre un ensemble limité de scénarios : paramètres organization, appartenance à un groupe, autorisations de dossier de boîte aux lettres et délégation de boîte aux lettres. Il ne s’agit pas d’un remplacement complet pour Exchange Online PowerShell. Au lieu de cela, il s’agit d’une surface complémentaire, d’abord REST pour ces tâches spécifiques.
  • Pagination et sélection de propriétés : les jeux de résultats volumineux sont retournés dans les pages. Côté client, vous pouvez demander uniquement les propriétés dont vous avez besoin pour réduire la taille de la charge utile.
  • Indicateurs de routage : pour toutes les opérations, l’API utilise l’en-tête X-AnchorMailbox pour router votre demande vers le serveur principal approprié. Pour plus d’informations, consultez Prise en main de l’API Exchange Online.
  • Accès sécurisé : les appels nécessitent des jetons OAuth et des rôles RBAC Exchange appropriés. Pour plus d’informations, consultez Authentification et autorisation pour l’API Exchange Online Administration.

API Administration et Exchange Online PowerShell

L’API Administration fournit un sous-ensemble ciblé de fonctionnalités de gestion Exchange en tant que points de terminaison REST pour couvrir les scénarios affectés par la dépréciation d’EWS. Exchange Online PowerShell continue de fournir une surface de gestion Exchange complète.

  • API Administration : utilisez lorsque vous avez besoin d’une surface REST-first équivalente à l’applet de commande pour les scénarios décrits précédemment (configuration organization, appartenance à un groupe, autorisations de dossier et délégation) uniquement.
  • Exchange Online PowerShell : utilisez lorsque vous avez besoin de toute l’étendue des applets de commande Exchange, des opérations avancées ou des scripts et runbooks PowerShell existants.

L’API Exchange Online Administration ne remplace pas Exchange Online PowerShell. L’API est une surface complémentaire basée sur REST pour un ensemble ciblé de tâches d’administration provoquées par les scénarios EWS déconseillés. Pour toutes les autres tâches de gestion Exchange, continuez à utiliser Exchange Online PowerShell.

points de terminaison d’API Exchange Online Administration

Chaque point de terminaison d’API Administration fournit une ou plusieurs applets de commande pour remplacer les fonctionnalités précédemment disponibles via EWS. Le tableau suivant fournit des détails sur chaque point de terminaison et l’alternative EWS correspondante.

Endpoint Description Opération EWS
OrganizationConfig Récupérez la configuration Exchange de niveau organization, liée aux paramètres d’info-courrier. GetServiceConfiguration
AcceptedDomain Affichez les domaines acceptés et leurs configurations pour le organization. GetServiceConfiguration
Boîte aux lettres Afficher les propriétés de boîte aux lettres. Par exemple : nom d’affichage, adresse SMTP principale, limites de taille et informations de délégué (affichage et mise à jour). AddDelegate et RemoveDelegate
MailboxFolderPermission Afficher et gérer les autorisations sur les dossiers de boîte aux lettres (ajouter, définir et supprimer des autorisations). GetFolder, UpdateFolder et CreateFolder
DistributionGroupMember Récupérer les détails de l’appartenance pour les groupes de distribution. ExpandDL
DynamicDistributionGroupMember Récupérer les détails de l’appartenance pour les groupes de distribution dynamiques. ExpandDL

Étapes suivantes

  • Last updated on