Microsoft Sharepoint 事件

本文說明 Microsoft Sharepoint 事件的屬性和結構描述，這些事件是由 Microsoft Graph API 所發佈。 如需事件結構描述簡介，請參閱 CloudEvents 結構描述。

可用的事件類型

使用 Microsoft Graph API 操作這些資源藉以更新 listItem 時，就會觸發這些事件。

事件名稱	描述
Microsoft.Graph.ListUpdated	在 Microsoft Sharepoint 中的清單更新時觸發。

事件範例

觸發事件時，事件格線服務會將該事件的相關資料傳送至訂閱目的地。 本節提供相關範例說明每個 Microsoft Sharepoint 事件的資料呈現的樣貌。

Microsoft.Graph.ListUpdated 事件

{
  "id": "00d8a100-2e92-4bfa-86e1-0056dacd0fce",
  "type": "Microsoft.Graph.ListUpdated",
  "source": "/tenants/<tenant-id>/applications/<application-id>",
  "subject": "listItem/<listItem-id>",
  "time": "2022-05-24T22:24:31.3062901Z",
  "datacontenttype": "application/json",
  "specversion": "1.0",
  "data": {
    "subscriptionId": "<microsoft-graph-subscription-id>",
    "tenantId": "<tenant-id>",
    "clientState": "<user-provided secret>",
    "expirationDateTime": "2023-10-05T18:11:08.587Z",
    "resource": "<guid>",
    "siteUrl": "<relative path>",
    "webId": "<guid>",
    "resourceData": {
      "@odata.type": "#Microsoft.Graph.listItem"
    },    
  }
}

---

事件屬性

事件具有下列的最高層級資料：

屬性	類型​	描述
source	string	租用戶事件來源。 此欄位無法寫入。 Microsoft 圖形 API 提供此值。
subject	string	發行者定義事件主旨的路徑。
type	string	此事件來源的其中一種事件類型。
time	string	事件產生的時間，以提供者之 UTC 時間為準
id	string	事件的唯一識別碼。
data	object	提供關於資源狀態變更之資料的事件承載。
specversion	string	CloudEvents 結構描述規格版本。

---

資料物件具有下列屬性：

屬性	類型​	描述
changeType	string	資源狀態變更的類型。
resource	string	引起事件的資源識別碼。
tenantId	string	保留清單的組織識別碼。
clientState	string	使用者在建立圖形 API 訂用帳戶時所提供的祕密。
@odata.type	string	圖形 API 變更類型。
@odata.id	string	引起事件的圖形 API 資源識別碼。
id	string	引起事件的資源識別碼。
subscriptionExpirationDateTime	string	圖形 API 訂用帳戶到期的時間 (格式為 RFC 3339)。
subscriptionId	string	圖形 API 訂用帳戶識別碼。
tenantId	string	Microsoft Entra 租用戶識別碼。

下一步

• 如需 Azure 事件格線合作夥伴事件的簡介，請參閱合作夥伴事件概觀
• 如需如何訂閱 Microsoft Graph API 以接收事件的相關資訊，請參閱訂閱 Microsoft Graph API 事件。
• 如需 Azure 事件格線事件處理常式的相關資訊，請參閱事件處理常式。
• 如需建立 Azure Event Grid 訂用帳戶的詳細資訊，請參閱建立事件訂用帳戶和 Event Grid 訂用帳戶結構描述。
• 若想了解如何設定事件訂用帳戶以選取要傳遞的特定事件，請參閱事件篩選。 您也可參考篩選事件。