共用方式為

Azure 資源通知 - Azure 事件方格 中的 ContainerService 事件 （預覽）

  • 發行項

Azure Kubernetes Service （AKS） 會使用容器服務事件資源系統主題，針對 AKS 叢集上的排程維護活動傳遞先占通知。 這項功能可針對不同事件階段的基本維護工作接收推播通知，包括已排程、起始、已完成、取消和失敗。 值得注意的是，針對排程階段，通知會在實際維護活動前 7 天和 24 小時分派。

通知包含：

  • AKS 起始的維護（例如，底底移轉、Konnectivity Tunnel Switch）
  • 客戶起始的維護（例如自動升級、節點 OS 升級和每周發行時段）

這些前瞻性通知可協助客戶提供機會，以更好地準備潛在的中斷，最終旨在將營運費用降到最低。

本文提供 Azure 資源通知 ContainerService 事件的屬性和架構。 如需一般事件結構描述的簡介，請參閱 Azure Event Grid 事件結構描述。 此外，您還可以找到所產生事件的範例，以及有關如何建立本主題類型之系統主題的相關文章連結。

事件類型

ContainerService 提供下列事件類型以供取用：

事件類型 描述
Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted 會針對 AKS 叢集上的排程維護事件提供預先通知。

角色型存取控制

目前，這些事件只會在 Azure 訂用帳戶範圍發出。 這表示建立本主題類型事件訂用帳戶的實體會在此 Azure 訂用帳戶中接收通知。 基於安全性考慮，必須限制在本主題上建立事件訂用帳戶的能力，以在整個 Azure 訂用帳戶上具有讀取權限的主體。 若要透過此系統主題存取數據，除了事件方格所需的一般許可權之外，還需要下列 Azure 資源通知特定許可權：''。

Microsoft.ResourceNotifications/systemTopics/subscribeToContainerServiceEventResources/action

事件結構描述

以下是結構描述：

{
	"id": "string",
	"source": "string",
	"subject": "string",
	"type": "Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted",
	"time ": "string in date-time",
	"data": {
		"resourceInfo": {
			"id": "string",
			"name": "string",
			"type": "string",
			"location": "string",
			"properties": {
				"description": "string",
				"eventId": "string",
				"eventSource": "string",
				"eventStatus": "string",
				"eventDetails": "string",
				"scheduledTime": "string in date-time",
				"startTime": "string in date-time",
				"lastUpdateTime": "string in date-time",
				"resources": "array of strings",
				"resourceType": "string"
			}
		},
		"operationalInfo": {
			"resourceEventTime": "string in date-time"
		},
		"apiVersion": "string"
	},
	"specversion": "string"
}

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

屬性 類型​ 描述
id String 活動的唯一識別碼
source String 建立此系統主題的 Azure 訂用帳戶。
subject String 發行者定義發出此事件之基底資源的路徑。
type String 此系統主題類型的已註冊事件類型
time String
格式：2022-11-07T18:43:09.2894075Z		 事件產生的時間，以提供者之 UTC 時間為準
data Object 包含資源提供者特有的事件資料。 如需詳細資訊，請參閱下一個表格。
specversion String CloudEvents 結構描述規格版本。

data 物件具有下列屬性：

屬性 類型​ 描述
resourceInfo Object 資源特有的資料。 如需詳細資訊，請參閱下一個表格。
apiVersion String 資源執行階段的 API 版本。
operationalInfo Object 與資源相關的作業資訊詳細資料。

resourceInfo 物件具有下列屬性：

屬性 類型​ 描述
id String 發行者定義事件主體的路徑
name String 此欄位表示事件標識碼。 它一律會採用欄位最後一個區段 id 的值。
type String 正在發出的事件類型。
location String 資源所在的位置或區域。
properties Object 資源的承載。 如需詳細資訊，請參閱下一個表格。

operationalInfo 物件具有下列屬性：

屬性 類型​ 描述
resourceEventTime Datetime 更新資源的日期和時間。

事件 ScheduledEventEmitted 具有下列屬性：

屬性 類型​ 描述
description String 事件的描述。
eventId String 事件的事件標識碼。
eventSource String 事件的 來源。
eventStatus 列舉 （字串） 事件的狀態– 已排程、已啟動、已完成、已取消、失敗。
eventDetails String 事件的詳細數據。
scheduledTime 字串 （日期時間格式） 事件的開始時間。
lastUpdateTime 字串 （日期時間格式） 上次更新事件狀態的時間。
resources 字串陣列 （Azure Resource Manager 識別元格式） 受事件影響的資源清單。
resourceType String 事件的資源類型

範例事件

下列範例顯示機碼值修改事件的結構描述：

{
	"id": "5bdb52cf-5489-4845-86c8-7fe94a4fc6c1",
	"source": "/subscriptions/{subscription-id}",
	"subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.ContainerService/managedClusters/{managedcluster-name}/scheduledEvents/{event-id}",
	"data": {
		"resourceInfo": {
			"id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.ContainerService/managedClusters/{managedcluster-name}/scheduledEvents/{event-id}",
			"name": "{event-id}",
			"type": "Microsoft.ContainerService/managedClusters/scheduledEvents",
			"properties": {
				"description": "ScheduledEvents",
				"eventId": "bbe82027-0444-4f73-897a-0bbfe3af66f1",
				"eventSource": "AutoUprader",
				"eventStatus": "Started",
				"eventDetails": "Start to upgrade security vhd",
				"scheduledTime": "2024-04-16T22:17:12.103268606Z",
				"startTime": "0001-01-01T00:00:00.0000000Z",
				"lastUpdateTime": "0001-01-01T00:00:00.0000000Z",
				"resources": [
				  "/subscriptions/{subscription-id}/resourcegroups/{rg-name}/providers/Microsoft.ContainerService/managedClusters/{managedcluster-name}"
				],
				"resourceType": "ManagedCluster"
			}
		},
		"operationalInfo": {
			"resourceEventTime": "2024-04-16T22:17:12.1032748"
		},
		"apiVersion": "2023-11-02-preview"
	},
	"type": "Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted",
	"specversion": "1.0",
	"time": "2024-04-16T22:17:12.1032748Z"
}

與我們連絡

如果您對這項功能有任何疑問或意見反應，請立即與我們連絡：arnsupport@microsoft.com。

為了更妥善地協助您處理特定事件的特定意見反應，請提供下列資訊：

針對遺失的事件：

  • 系統主題類型名稱
  • 執行作業時，UTC 的近似時間戳記
  • 產生通知的基底資源識別碼
  • 在 Azure 入口網站中瀏覽至您的資源，然後選取最右側的 JSON 檢視。 資源識別碼是 JSON 檢視頁面上的第一個欄位。
  • 預期的事件類型
  • 執行的作業 (例如 VM 已啟動或停止、已建立記憶體帳戶等)
  • 發生問題的描述 (例如，VM 已啟動，且未產生 Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged 事件)
  • 可能的話，請提供所執行作業的相互關聯識別碼

針對延遲或有非預期內容的事件

  • 系統主題類型名稱
  • 通知的整個內容 (排除 data.resourceInfo.properties)
  • 所遇到問題的描述和受影響欄位的值

請確定您在共用此資料時，未提供任何終端使用者可識別的資訊。

下一步

請參閱 訂閱 Azure 資源通知 - 容器服務事件。