學(xué)習(xí)筆記-Exchange Web Service API-設(shè)計

Exchange版本的API功能

Exchange Web服務(wù)API（包括EWS和自動發(fā)現(xiàn)）在開發(fā)時考慮了多版本兼容性。因此，針對Exchange 2007的應(yīng)用程序也適用于從Exchange 2013開始的Exchange版本，包括Exchange Online和Exchange Online作為Office 365的一部分。

https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/web-service-api-feature-availability-in-exchange-and-the-ews-managed-api

EWS架構(gòu)定義了可以發(fā)送到Exchange并由Exchange返回的數(shù)據(jù)結(jié)構(gòu)。每個包含EWS功能重大更改的新版Exchange都將包含新架構(gòu)。EWS和EWS模式都是向后的，并且在某些情況下，向前兼容 - 針對早期版本的EWS設(shè)計的應(yīng)用程序在大多數(shù)情況下將與更高版本的EWS一起工作，并且針對更高版本的EWS的應(yīng)用程序?qū)⒃谙嗤那闆r下工作功能包含在早期版本中。

在設(shè)計EWS應(yīng)用程序時，考慮當(dāng)前Exchange的版本

https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/ews-schema-versions-in-exchange

針對EWS API，在內(nèi)部和online部署上的一些區(qū)別

內(nèi)部部署只能使用NTLM或者基本身份驗證，而online部署可以使用Oauth身份認(rèn)證；

內(nèi)部部署EWS提供豐富的日志信息，而online部署限制了EWS日志的查看權(quán)限；

內(nèi)部部署自動發(fā)現(xiàn)類型支持SOAP、SCP、POX；而online不支持SCP；

EWS在Exchange中進行限制

限制是對過度使用可能影響服務(wù)可靠性和功能的系統(tǒng)資源的響應(yīng)性響應(yīng)。Exchange不斷監(jiān)視關(guān)鍵基礎(chǔ)架構(gòu)資源（例如郵箱數(shù)據(jù)庫）的運行狀況。當(dāng)檢測到高負(fù)載因素會降低這些資源的性能時，EWS連接會根據(jù)每個調(diào)用方對此高負(fù)載條件的貢獻量按比例進行限制。

Exchange中的每個客戶端訪問協(xié)議（包括EWS）都有一個限制策略。在設(shè)計使用EWS的應(yīng)用程序時，必須考慮限制策略，以幫助確保應(yīng)用程序可靠性和Exchange服務(wù)器的運行狀況。

如果您是應(yīng)用程序開發(fā)人員，則需要將限制因素納入應(yīng)用程序設(shè)計中。

Exchange中的限制策略不僅影響EWS，還影響到Exchange服務(wù)器的所有客戶端連接，包括Office Outlook，Outlook Web App和Exchange ActiveSync使用的協(xié)議。下面是一個例子：

該CPUStartPercent在運行Exchange 2010時，限制策略可能會影響EWS性能。當(dāng)客戶端訪問服務(wù)器（包括但不限于EWS進程）上運行的Exchange進程的平均CPU利用率超過此策略指定的值時，入站請求將被延遲以降低CPU利用率。您無法更改此策略的值，但了解它可以幫助您解決性能問題?？蛻舳嗽L問服務(wù)器為此值執(zhí)行的采樣邏輯是10秒滾動窗口的平均值。這允許進程適當(dāng)?shù)仨憫?yīng)CPU利用率的快速峰值。超過此閾值時，將延遲到EWS的入站連接。在每個EWS請求的理論100％CPU使用率下，此延遲的上限為500毫秒（msecs）。如果批量EWS請求獲得100個項目，服務(wù)器將檢查CPU使用率100次（每個項目一次），最長延遲為50秒。延遲時間與CPU使用率成線性比例。在CPUStartPercent，延遲為0（線程良率），并且在100％CPU使用率下線性增加至500毫秒。由于限制策略適用于所有Exchange用戶，因此CPU使用率不可能超過Exchange客戶端訪問服務(wù)器上的CPUStartPercent限制，因為單個用戶或應(yīng)用程序無法獲得足夠的CPU利用率來影響服務(wù)器操作。

您可以使用以下cmdlet顯示內(nèi)部部署Exchange Server部署的限制策略：

Get-ThrottlingPolicy - 獲取一個或多個限制策略的客戶端限制設(shè)置。

Get-ThrottlingPolicyAssociation - 使您可以查看對象及其關(guān)聯(lián)的限制策略之間的關(guān)系。對象可以是具有郵箱的用戶，沒有郵箱的用戶或聯(lián)系人。

對EWS批處理請求的限制影響

EWS使您可以將多個項目請求批處理到客戶端訪問服務(wù)器執(zhí)行的單個請求中。這樣可以提高效率和性能。當(dāng)Exchange服務(wù)器執(zhí)行批處理請求時，它會在批處理中的每個項目執(zhí)行后檢查用戶的預(yù)算。如果應(yīng)用程序超出預(yù)算，則批處理中下一個項目的處理將延遲，直到該用戶的預(yù)算已充值為止。要確保使用批處理操作的應(yīng)用程序成功運行，請限制可以包含在單個批處理中的項目請求數(shù)，并將大批量劃分為多個較小批處理以提高結(jié)果的可靠性。批處理操作對特定限制閾值的影響取決于請求的類型，要處理的項的大?。ɡ?，UploadItems或ExportItems操作）和郵箱內(nèi)容。限制策略會導(dǎo)致請求需要更長時間來處理，從而影響批處理操作。因此，調(diào)用者必須等待更長時間才能響應(yīng)，并且由于EWS將批處理請求的執(zhí)行時間限制為一分鐘，因此調(diào)用可能會超時。

注意：發(fā)送大量電子郵件時可能超過EWS的并發(fā)限制

MessageRateLimit數(shù)指定可以通過任何Exchange客戶端，包括EWS提交每分鐘的消息數(shù)。默認(rèn)情況下，此策略設(shè)置為每分鐘30條消息。對于普通用戶來說，這通常就足夠了。但是，發(fā)送大批電子郵件的應(yīng)用程序（例如作為開票計劃的一部分）可能會遇到問題。超出此策略限制時，郵箱的郵件傳遞會延遲。具體而言，當(dāng)用戶或應(yīng)用程序提交的消息數(shù)量大于MessageRateLimit指定的值時，消息將顯示在“發(fā)件箱”或“草稿”文件夾中較長時間參數(shù)。在開發(fā)交付跟蹤系統(tǒng)時，請務(wù)必考慮這一點，尤其是當(dāng)您的應(yīng)用程序使用用戶通過Outlook連接的郵箱時。當(dāng)延遲項目存儲在“發(fā)件箱”或“草稿”文件夾中時，用戶可能會將其解釋為錯誤。

該RecipientRateLimit參數(shù)指定的收件人，用戶可以在24小時內(nèi)解決的數(shù)量限制。例如，如果此值設(shè)置為500，則表示單個Exchange郵箱帳戶每天可以向不超過500個收件人發(fā)送郵件。此限制適用于組織內(nèi)部和外部的收件人的郵件。此默認(rèn)限制可能會導(dǎo)致某些業(yè)務(wù)線應(yīng)用程序出現(xiàn)問題，這些應(yīng)用程序會執(zhí)行月末發(fā)票運行，并且需要向此數(shù)量以上的收件人發(fā)送郵件。您可以使用啟用批處理消息的外部服務(wù)或單獨的本地出站中繼解決方案來解決此限制。

更多關(guān)于客戶端限制的信息參考：https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/ews-throttling-in-exchange

更多信息，請關(guān)注下方微信公眾號