概述

事件通知功能支持当镜像加签、镜像扫描和实例同步状态发生变更时，发送通知消息到用户指定的HTTP或HTTPS地址。

前置条件

已开通容器镜像服务企业版实例

创建事件通知规则

1. 进入容器镜像服务控制台。

2. 点击已开通的企业版实例名称。

3. 左侧导航栏点击 "分发交付" - "事件通知"，在事件规则标签页点击创建规则按钮。

4. 在创建页面填写规则相关的参数进行创建。

   

    

   参数	说明
   规则名称	事件规则的名称。
   事件类型	触发事件通知的事件类型，包括：1. 镜像加签 2. 镜像扫描 3. 实例同步
   生效范围	事件通知生效的范围，包括： 1. 实例：在当前实例下，满足Tag匹配条件时触发事件通知。  2. 命名空间：在指定命名空间下，满足Tag匹配条件时触发事件通知。  3. 仓库：在指定仓库下，满足Tag匹配条件时触发事件通知。
   Tag匹配条件	通过正则表达式设置规则匹配的镜像版本。使用方式示例如下： 匹配全部: .*  匹配多个版本: v1|v2|v3  匹配前缀: v1.*
   通知URL	用户用于接收事件通知的URL地址，以http://或https://开头。
   通知参数	事件通知包含的通知参数。

   不同事件类型对应的通知参数示例如下：

   • 镜像加签

     {
         "EventType": "SigningCompleted", // 事件类型
         "Region": "b342b77ef26b11ecb0ac0242ac110002", // 资源池编码
         "InstanceId": "b030a75ec73649b8b81a4d979ee522ba", // 实例ID
         "NamespaceId": "5a10444724ef4b498653075ac3578416", // 命名空间ID
         "NamespaceName": "oras-test", // 命名空间名称
         "RepositoryId": "75263a80e98048668b7bb56f60564129", // 仓库ID
         "RepositoryName": "oras", // 仓库名称
         "Tag": "v1", // 镜像版本
         "Time": "2025-01-03 16:47:19", // 加签时间
         "Result": "Success" // 加签结果
     }

   • 镜像扫描

     {
         "EventType": "ScanCompleted", // 事件类型
         "Region": "b342b77ef26b11ecb0ac0242ac110002", // 资源池编码
         "InstanceId": "b030a75ec73649b8b81a4d979ee522ba", // 实例ID
         "NamespaceId": "5a10444724ef4b498653075ac3578416", // 命名空间ID
         "NamespaceName": "test", // 命名空间名称
         "RepositoryId": "75263a80e98048668b7bb56f60564129", // 仓库ID
         "RepositoryName": "mysql", // 仓库名称
         "Tag": "latest", // 镜像版本
         "CriticalSeverity": 1, // 严重漏洞数
         "HighSeverity": 3, // 高危漏洞数
         "MediumSeverity": 10, // 中危漏洞数
         "LowSeverity": 3, // 低危漏洞数
         "UnknownSeverity": 1, // 未知等级漏洞数
         "TotalSeverity": 18, // 总漏洞数
         "Result": "Success", // 扫描结果
         "EndTime": "2024-08-08 17:53:51", // 开始时间
         "StartTime": "2024-08-08 17:53:41" // 结束时间
     }

   • 实例同步

     {
         "EventType": "SynchronizationCompleted", // 事件类型
         "SourceRegion": "b342b77ef26b11ecb0ac0242ac110002", // 源资源池编码
         "SourceInstanceId": "b030a75ec73649b8b81a4d979ee522ba", // 源实例ID
         "SourceNamespaceId": "5a10444724ef4b498653075ac3578416", // 源命名空间ID
         "SourceNamespaceName": "test", // 源命名空间名称
         "SourceRepositoryId": "75263a80e98048668b7bb56f60564129", // 源仓库ID
         "SourceRepositoryName": "nginx", // 源仓库名称
         "SourceTag": "v0.2", // 源镜像版本
         "DestinationRegion": "b342b77ef26b11ecb0ac0242ac110002", // 目标资源池编码
         "DestinationInstanceId": "b030a75ec73649b8b81a4d979ee522ba", // 目标实例ID
         "DestinationNamespaceId": "5a10444724ef4b498653075ac3578416", // 目标命名空间ID
         "DestinationNamespaceName": "sync", // 目标命名空间名称
         "DestinationRepositoryId": "75263a80e98048668b7bb56f60564129", // 目标仓库ID
         "DestinationRepositoryName": "nginx", // 目标仓库名称
         "DestinationTag": "v0.2", // 目标镜像版本
         "Result": "Success", // 同步结果
         "StartTime": "2024-03-20 11:25:10", // 开始时间
         "EndTime": "2024-03-20 11:25:06" // 结束时间
     }

5. 创建完成后，可在列表页面查看创建的事件通知规则。

   

6. 操作栏的编辑按钮可以修改事件通知规则。禁用/启用按钮可以修改事件通知规则的启用状态。删除按钮可以删除事件通知规则。

查看事件通知历史

1. 进入容器镜像服务控制台。

2. 点击已开通的企业版实例名称。

3. 左侧导航栏点击 "分发交付" - "事件通知"，点击"事件历史"标签页即可查看事件通知历史。

   

4. 事件通知历史列表页右上角可以对事件规则进行筛选。

5. 对于发送失败的事件通知记录，可以点击操作栏的重试按钮重新发送事件通知消息。