Azure リソース通知 - Azure Event Grid の AKS リソース イベント (プレビュー)

Azure Kubernetes Fleet Manager は、お客様が安全かつ制御された方法で複数の AKS クラスターをアップグレードできるように設計されています。 Fleet Manager サービスを使用すると、特定のシーケンスで Kubernetes クラスターをアップグレードするワークフローを作成できます。 アップグレードには重大なリスクがあるため、お客様は通常、ダウンタイムや回帰を防ぐために、アップグレードの前後に正常性メトリックを確認します。 このプロセスを強化するために、Fleet Manager は Gate リソースを使用して承認をサポートします。 ゲートを使用すると、ワークフローの進行に応じてアップグレードを承認できるため、マルチクラスター アップグレード エクスペリエンスをより詳細に制御できます。 AKS リソースには、Azure Kubernetes Fleet Manager Update Run Gates ( FleetGateCreated、 FleetGateUpdated 、 FleetGateDeleted) の 3 種類のイベントが用意されています。

この記事では、Azure Resource Notifications AKS リソース イベントのプロパティとスキーマについて説明します。 イベント スキーマの概要については、 Azure Event Grid のイベント スキーマに関するページを参照してください。 さらに、生成されたイベントのサンプルと、このトピックの種類のシステム トピックを作成する方法に関する関連記事へのリンクを見つけることができます。

イベントの種類

AKS リソースでは、次の 3 種類のイベントを使用できます。

イベントの種類 Description
Microsoft.ResourceNotifications.AKSResources.FleetGateCreated Azure Kubernetes Fleet Manager Update Run が Gate リソースのインスタンスに到達したときに発生します。
Microsoft.ResourceNotifications.AKSResources.FleetGateUpdated Azure Kubernetes Fleet Manager Update Run Gate リソースの状態が [保留中] から [完了] に変更されたときに発生します。
Microsoft.ResourceNotifications.AKSResources.FleetGateDeleted Gate のインスタンスを含む Azure Kubernetes Fleet Manager Update Run が削除されたときに発生します。

ロールベースのアクセス制御

現時点では、これらのイベントは Azure サブスクリプション スコープでのみ出力されます。 これは、このトピックの種類のイベント サブスクリプションを作成するエンティティが、この Azure サブスクリプション全体で通知を受け取っていることを意味します。 セキュリティ上の理由から、このトピックでイベント サブスクリプションを作成する機能を、Azure サブスクリプション全体に対する読み取りアクセス権を持つプリンシパルに制限することが不可欠です。 このシステム トピックを介してデータにアクセスするには、Event Grid に必要な汎用アクセス許可に加えて、次の Azure リソース通知固有のアクセス許可が必要です: Microsoft.ResourceNotifications/systemTopics/subscribeToAKSResources/action。

イベント スキーマ

スキーマを次に示します。

{
    "id": string,
    "source": string,
    "subject": string,
    "type": string,
    "time ": string, 
    "data": {
        "resourceInfo": {
            "id": string,
            "name": string,
            "type": string,
            "properties": {                           
            }
        },
        "operationalInfo":{
			"resourceEventTime": date-time
		},
        "apiVersion": string 
    }, 
    "specversion": string
}

イベントのトップレベルのデータを次に示します。

プロパティ タイプ Description
id 糸 イベントの一意識別子
source 糸 このシステム トピックが作成されている Azure サブスクリプション。
subject 糸 このイベントが生成されるベース リソースへのパブリッシャー定義パス。
type 糸 このシステム トピック タイプの登録済みイベント タイプ。 値は、Microsoft.ResourceNotifications.AKSResources.FleetGateCreated または Microsoft.ResourceNotifications.AKSResources.FleetGateUpdated または Microsoft.ResourceNotifications.AKSResources.FleetGateDeleted のいずれかです
time String
形式: 2022-11-07T18:43:09.2894075Z
プロバイダーの UTC 時刻に基づいてイベントが生成される時間
data Object リソース プロバイダーに固有のイベント データが含まれています。 詳細については、次の表を参照してください。
specversion 糸 CloudEvents スキーマ仕様バージョン。

data オブジェクトには、次のプロパティがあります。

プロパティ タイプ Description
resourceInfo Object リソースに固有のデータ。 詳細については、次の表を参照してください。
apiVersion 糸 リソース プロパティの API バージョン。
operationalInfo Object リソースに関連する運用情報の詳細。

resourceInfo オブジェクトには、次のプロパティがあります。

プロパティ タイプ Description
id 糸 イベントの件名へのパブリッシャー定義のパス
name 糸 このフィールドはイベント ID を示します。常に、 id フィールドの最後のセクションの値を受け取ります。
type 糸 生成されるイベントの種類。 このコンテキストでは、 Microsoft.ResourceNotifications.AKSResources.FleetGateCreated、 Microsoft.ResourceNotifications.AKSResources.FleetGateUpdated、 Microsoft.ResourceNotifications.AKSResources.FleetGateDeleted
properties Object リソースのデータ負荷。 詳細については、次の表を参照してください。

operationalInfo オブジェクトには、次のプロパティがあります。

プロパティ タイプ Description
resourceEventTime DateTime リソースが更新された日時。

data オブジェクトには、次のプロパティがあります。

FleetGateCreated/FleetGateCreated/FleetGateDeleted イベントのプロパティ

            "properties": {
                "displayName": string,
                "gateType": string,
                "provisioningState": string,
                "state": string,
                "target": object
            }

properties オブジェクトには、次のプロパティがあります。

プロパティ タイプ Description
displayName 糸 更新戦略で承認ゲートを定義するときに指定する省略可能な名前。
gateType 糸 ゲートの種類。 現時点では、"承認" の有効な選択肢は 1 つだけです。
provisioningState 糸 Gate リソースのプロビジョニング状態。
state 糸 Gate の状態。 "Pending" = 承認待ち;"完了" = 承認が適用されました。
target Object ゲートが制御しているターゲット。

target オブジェクトには、次のプロパティがあります。

target オブジェクトのプロパティ

            "target": {
                "id": string,
                "updateRunProperties": object,
            }

target オブジェクトのプロパティの説明

プロパティ タイプ Description
id 糸 イベントを生成する更新実行の完全な Azure リソース識別子。
updateRunProperties Object 更新プログラムの実行に関連するプロパティ。 詳細については、以下の表を参照してください。

updateRunProperties オブジェクトのプロパティ

プロパティ タイプ Description
group 糸 ゲートが適用される更新グループの名前。 グループ内でのみ使用可能です。
name 糸 イベントを生成する更新実行の名前。
stage 糸 更新ステージの名前。 ステージ内のステージ ゲートとグループ ゲートに表示できます。
timing 糸 ゲートがステージまたはグループの前または後に適用されるかどうかを示します。

イベントの例

FleetGateCreated イベント

次の例は、FleetGateCreated の変更されたイベントのスキーマを示しています。

  {
    "source": "/subscriptions/{subscription-id}",
    "subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.ContainerService/fleets/{fleet-name}/gates/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "type": "Microsoft.ResourceNotifications.AksResources.FleetGateCreated",
    "time": "2025-09-09T01:10:58.4955907Z",
    "id": "m7m4mf0x-740g-4c2d-a0ab-a4r8h4uuf018",
    "data": {
      "resourceInfo": {
        "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.ContainerService/fleets/{fleet-name}/gates/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "name": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "type": "Microsoft.ContainerService/fleets/gates",
        "properties": {
          "displayName": "before-stage",
          "gateType": "Approval",
          "provisioningState": "Succeeded",
          "state": "Pending",
          "target": {
            "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.ContainerService/fleets/{fleet-name}/updateRuns/run-1",
            "updateRunProperties": {
              "name": "run-1",
              "stage": "stage-1",
              "timing": "Before"
            }
          }
        }
      },
      "operationalInfo": {
        "resourceEventTime": "2025-09-08T18:10:58.4955907-07:00"
      },
      "apiVersion": "2025-04-01-preview"
    },
    "specVersion": "1.0"
  }

FleetGateUpdated イベント

次の例は、FleetGateUpdated イベントのスキーマを示しています。

  {
    "source": "/subscriptions/{subscription-id}",
    "subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.ContainerService/fleets/{fleet-name}/gates/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
    "type": "Microsoft.ResourceNotifications.AksResources.FleetGateUpdated",
    "time": "2025-09-09T01:12:25.8924289Z",
    "id": "a9f8d51g-c114-4565-buee-5q1jb6fb0b08",
    "data": {
      "resourceInfo": {
        "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.ContainerService/fleets/{fleet-name}/gates/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "name": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "type": "Microsoft.ContainerService/fleets/gates",
        "properties": {
          "displayName": "before group",
          "gateType": "Approval",
          "provisioningState": "Succeeded",
          "state": "Completed",
          "target": {
            "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.ContainerService/fleets/{fleet-name}/updateRuns/run-1",
            "updateRunProperties": {
              "group": "group-1",
              "name": "run-1",
              "stage": "stage-1",
              "timing": "Before"
            }
          }
        }
      },
      "operationalInfo": {
        "resourceEventTime": "2025-09-08T18:12:25.8924289-07:00"
      },
      "apiVersion": "2025-04-01-preview"
    },
    "specVersion": "1.0"
  }

FleetGateDeleted イベント

次の例は、FleetGateDeleted の変更されたイベントのスキーマを示しています。

  {
    "source": "/subscriptions/{subscription-id}",
    "subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.ContainerService/fleets/{fleet-name}/gates/8a63212d-9dp1-4oa6-8135-14ghghg311ea6",
    "type": "Microsoft.ResourceNotifications.AksResources.FleetGateDeleted",
    "time": "2025-09-22T09:01:22.5495164Z",
    "id": "48e92180-a34e-57b2-b989-7056ccd42c0b",
    "data": {
      "resourceInfo": {
        "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.ContainerService/fleets/{fleet-name}/gates/8a63212d-9dp1-4oa6-8135-14ghghg311ea6",
        "name": "8a63212d-9dp1-4oa6-8135-14ghghg311ea6",
        "type": "Microsoft.ContainerService/fleets/gates",
        "properties": {
          "displayName": "stage-after",
          "gateType": "Approval",
          "provisioningState": "Succeeded",
          "state": "Pending",
          "target": {
            "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.ContainerService/fleets/{fleet-name}/updateRuns/run-delete",
            "updateRunProperties": {
              "name": "run-delete",
              "stage": "stage-1",
              "timing": "After"
            }
          }
        }
      },
      "operationalInfo": {
        "resourceEventTime": "2025-09-22T02:01:22.5495164-07:00"
      },
      "apiVersion": "2025-04-01-preview"
    },
    "specVersion": "1.0"
  }

お問い合わせ

この機能に関するご質問やフィードバックがある場合は、このスタックオーバーフロー リンクでお気軽にお問い合わせください

特定のイベントに関する特定のフィードバックをより適切に支援するには、次の情報を提供します。

見つからないイベントの場合:

  • システム トピックの種類名
  • 操作が実行されたときの UTC のおおよそのタイムスタンプ
  • 通知が生成されたベース リソース ID
  • Azure portal でリソースに移動し、右端にある JSON ビューを選択します。 リソース ID は、JSON ビュー ページの最初のフィールドです。
  • 予期されるイベントの種類
  • 実行された操作 (VM の開始または停止、作成されたストレージ アカウントなど)
  • 発生した問題の説明 (VM が開始され、Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged イベントが生成されないなど)
  • 可能であれば、実行される操作の関連付け ID を指定します

遅延または予期しないコンテンツを含むイベントの場合

  • システム トピックの種類名
  • data.resourceInfo.properties を除く通知の内容全体
  • 発生した問題と影響を受けたフィールド値の説明

このデータを共有している間、エンド ユーザーを特定できる情報を提供していないことを確認します。

次のステップ

「Azure リソース通知のサブスクライブ - AKS リソース イベント」を参照してください。