Usar as APIs REST para acessar caixas de correio em implantações híbridas do Exchange (visualização)Use REST APIs to access mailboxes in Exchange hybrid deployments (preview)

O Microsoft Graph sempre forneceu acesso a caixas de correio do cliente na nuvem no Exchange Online como parte do Office 365. A CU3 (atualização cumulativa 3) do Exchange 2016, lançada em setembro de 2016 para os servidores do Exchange no local, adiciona suporte à integração da API REST com o Office 365. Se o seu aplicativo usa a versão 1.0 da API de Email, Calendário ou Contatos, agora você também encontrará uma experiência integrada de aplicativo e autenticação em implantações híbridas, independentemente de a caixa de correio estar no local ou na nuvem, desde que a implantação atenda a requisitos específicos.Microsoft Graph has always provided access to customer mailboxes in the cloud on Exchange Online as part of Office 365. Exchange 2016 Cumulative Update 3 (CU3), released in September 2016 for Exchange on-premises servers, adds support for REST API integration with Office 365. If your app uses v1.0 of the Mail, Calendar, or Contacts API, you will now also find a seamless authentication and application experience in hybrid deployments, regardless of whether the mailbox is on-premises or in the cloud, provided that the deployment meets specific requirements.

Nos bastidores, quando o Microsoft Graph identifica que uma chamada à API REST está tentando acessar uma caixa de correio no local em uma implantação híbrida, ele cria um proxy da solicitação REST para um ponto de extremidade REST local, que processa a solicitação. Essa descoberta possibilita o acesso à API REST.Behind the scenes, when Microsoft Graph identifies that a REST API call is attempting to access an on-premises mailbox in a hybrid deployment, it proxies the REST request to an on-premises REST endpoint which then processes the request. This discovery makes accessing the REST API possible.

Observação: A capacidade de usar essas APIs REST em implantações híbridas está, atualmente, no modo de visualização.Note: The ability to use these REST APIs in hybrid deployments is currently in preview.

Somente a versão 1.0 da API de Email, Calendário e Contatos está disponível para caixas de correio em implantações híbridas. Outros conjuntos de API da versão 1.0, como a API de Grupos ou APIs em outras versões, não estão disponíveis. Se tentar usar uma API que não faça parte do conjunto compatível em uma implantação híbrida, você receberá a seguinte mensagem de erro:Only v1.0 of the Mail, Calendar and Contacts API are available for mailboxes in hybrid deployments. Other v1.0 API sets, such as the Groups API, or APIs in other versions, are not. If you attempt to use an API that is not part of the supported set in a hybrid deployment, you will get the following error message:

"As APIs REST para essa caixa de correio estão em modo de visualização no momento. Você pode encontrar mais informações sobre as APIs REST de modo de visualização em https://dev.outlook.com.""REST APIs for this mailbox are currently in preview. You can find more information about the preview REST APIs at https://dev.outlook.com."

Requisitos para a API REST funcionar em implantações híbridasRequirements for the REST API to work in hybrid deployments

O Microsoft Graph fornece abertura (suporte a padrões abertos como JSON, OAUTH e ODATA, conectando-se à maioria das plataformas conhecidas) e flexibilidade (permissões granulares e rigidamente supervisionadas para acessar dados do usuário).Microsoft Graph provides openness (open standards support like JSON, OAUTH and ODATA, connecting from most popular platforms) and flexibility (granular, tightly scoped permissions to access user data). Se sua organização estiver interessada em habilitar o desenvolvimento de aplicativos do Microsoft Graph e atualmente estiver em uma implantação híbrida ou considerando essa opção, esteja ciente dos requisitos de implantação a seguir:If your organization is interested in enabling Microsoft Graph app development and is currently in or considering a hybrid deployment, be aware of the following deployment requirements:

  • Requisitos de caixa de correioMailbox requirements

    • Todas as caixas de correio locais que usarão as APIs REST devem estar localizadas em bancos de dados localizados em servidores Exchange 2016 CU3.All on-premises mailboxes that will use the REST APIs must be located on databases located on Exchange 2016 CU3 servers. 
  • Requisitos de infraestruturaInfrastructure requirements

    • Todos os servidores do Exchange 2016 devem ser atualizados para o CU3 ou posterior.All Exchange 2016 servers must be upgraded to CU3 or later.
    • O Microsoft Active Directory local deve ser sincronizado com o Azure Active Directory.On-premises Active Directory must synchronize with Azure Active Directory.
    • Todos os servidores do Exchange 2013 que coexistem na mesma matriz com carga balanceada com servidores do Exchange 2016 devem ser removidos da matriz.Any Exchange 2013 servers coexisting in the same load-balanced array with Exchange 2016 servers must be removed from the array.
  • Requisitos de redeNetworking requirements

    • De uma perspectiva de DNS, o namespace de descoberta automática e o namespace do cliente local devem ter os registros de DNS da Internet.From a DNS perspective, the Autodiscover namespace and on-premises client namespace must have Internet DNS records.
    • Se você tiver um firewall ou gateway de aplicativo que inspeciona e restringe o acesso, atualize as configurações apropriadas para permitir o acesso e a descoberta.If you have a firewall or application gateway that inspects and restricts access, update the appropriate settings to allow discovery and access.

Os administradores de TI podem encontrar mais informações nos seguintes recursos:IT administrators can find more information in the following resources: