Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Nota:
Las características descritas en este artículo están actualmente en versión preliminar, no están disponibles en todas las organizaciones y están sujetas a cambios.
La API de Exchange Online Administración es una superficie administrativa basada en REST que permite un conjunto centrado de cmdlets y parámetros de Exchange como puntos de conexión solo POST. La API permite el acceso a algunas tareas clave que estaban disponibles anteriormente a través de Exchange Web Services (EWS), que está prevista para su desuso en octubre de 2026. La API se compila para estos escenarios específicos y no reemplaza la superficie de administración completa de Exchange en Exchange Online PowerShell.
La API Exchange Online Administración admite el siguiente subconjunto de funciones de administración de Exchange:
- Ver la configuración de Exchange de la organización: recupere la configuración de la organización, como dominios aceptados, configuración mailtips y límites de buzones (por ejemplo, MaxSendSize).
- Ver el grupo de distribución y la pertenencia dinámica a grupos de distribución.
- Ver y administrar permisos de carpeta de buzón: permisos de lectura y modificación de carpetas para buzones de correo (ver, agregar, establecer y quitar permisos).
- Vea y actualice Enviar en nombre (delegación) para buzones de correo.
Las organizaciones que migran fuera de EWS pueden usar la API de Administración para lograr una administración comparable del estilo de cmdlet a través de HTTP mientras se integran con los patrones modernos de automatización y gobernanza.
La API de Exchange Online Administración tiene las siguientes características:
- Superficie de estilo cmdlet basada en REST: la API de Administración expone un conjunto centrado de tareas administrativas de Exchange como puntos de conexión HTTP. Debería ser familiar para los administradores de Exchange que usan cmdlets de PowerShell, pero lo llama a través de HTTP.
- Operaciones solo POST: cada operación usa el método HTTP POST. Cada solicitud especifica un cmdlet y los parámetros que se admiten para ese cmdlet en el punto de conexión seleccionado.
- Conjunto de cmdlets y parámetros con ámbito: la API no expone todos los cmdlets o parámetros de Exchange. Cada punto de conexión expone solo un subconjunto de cmdlets y cada cmdlet admite un subconjunto de parámetros.
- Ámbito centrado: la API cubre un conjunto limitado de escenarios:configuración de la organización, pertenencia a grupos, permisos de carpeta de buzón y delegación de buzones. No es un reemplazo completo para Exchange Online PowerShell. En su lugar, es una superficie complementaria y de rest primero para estas tareas específicas.
- Paginación y selección de propiedades: los conjuntos de resultados grandes se devuelven en las páginas. En el lado cliente, solo puede solicitar las propiedades que necesita para reducir el tamaño de carga.
- Sugerencias de enrutamiento: para todas las operaciones, la API usa el encabezado X-AnchorMailbox para enrutar la solicitud al servidor back-end correcto. Para obtener más información, consulte Introducción a la API de Exchange Online.
- Acceso seguro: las llamadas requieren tokens de OAuth y roles de RBAC de Exchange adecuados. Para obtener más información, consulte Autenticación y autorización para la API de Exchange Online Administración.
API de Administración frente a Exchange Online PowerShell
La API de Administración proporciona un subconjunto de la funcionalidad de administración de Exchange como puntos de conexión REST para cubrir escenarios afectados por el desuso de EWS. Exchange Online PowerShell sigue proporcionando la superficie de administración completa de Exchange.
- Administración API: use cuando necesite una superficie rest-first, equivalente a cmdlets para los escenarios descritos anteriormente (configuración de la organización, pertenencia a grupos, permisos de carpeta y delegación).
- Exchange Online PowerShell: use cuando necesite toda la amplitud de cmdlets de Exchange, operaciones avanzadas o scripts y runbooks de PowerShell existentes.
La API de Exchange Online Administración no reemplaza a Exchange Online PowerShell. La API es una superficie complementaria basada en REST para un conjunto centrado de tareas administrativas causadas por los escenarios de EWS en desuso. Para todas las demás tareas de administración de Exchange, siga usando Exchange Online PowerShell.
puntos de conexión de API de Exchange Online Administración
Cada punto de conexión de API Administración proporciona uno o varios cmdlets para reemplazar la funcionalidad anteriormente disponible a través de EWS. En la tabla siguiente se proporcionan detalles sobre cada punto de conexión y la alternativa de EWS correspondiente.
| Endpoint | Description | Operación de EWS |
|---|---|---|
| OrganizationConfig | Recupere la configuración de Exchange de nivel de organización, relacionada con la configuración de MailTips. | GetServiceConfiguration |
| AcceptedDomain | Vea los dominios aceptados y sus configuraciones para la organización. | GetServiceConfiguration |
| Mailbox | Ver las propiedades del buzón. Por ejemplo: nombre para mostrar, dirección SMTP principal, límites de tamaño e información de delegado (ver y actualizar). | AddDelegate y RemoveDelegate |
| MailboxFolderPermission | Ver y administrar permisos en carpetas de buzón de correo (agregar, establecer y quitar permisos). | GetFolder, UpdateFolder y CreateFolder |
| DistributionGroupMember | Recupere los detalles de pertenencia de los grupos de distribución. | ExpandDL |
| DynamicDistributionGroupMember | Recupere los detalles de pertenencia de los grupos de distribución dinámica. | ExpandDL |