Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

第 1 章 AdministrationEventService

1.1. ListAdministrationEvents
复制链接

GET /v1/administration/events

List managingEvents 会在根据请求的字段过滤后返回事件列表。

1.1.1. 描述
复制链接

1.1.2. 参数
复制链接

1.1.2.1. 查询参数
复制链接

Expand
Name描述必填defaultpattern

pagination.limit

 

-

null

 

pagination.offset

 

-

null

 

pagination.sortOption.field

 

-

null

 

pagination.sortOption.reversed

 

-

null

 

pagination.sortOption.aggregateBy.aggrFunc

 

-

UNSET

 

pagination.sortOption.aggregateBy.distinct

 

-

null

 

filter.from

在特定时间戳后，使用 last_occurred_at 匹配事件，即较低边界。

-

null

 

filter.until

在特定时间戳前，使用 last_occurred_at 匹配事件，如上个边界。

-

null

 

filter.domain

匹配来自特定域的事件。字符串

-

null

 

filter.resourceType

匹配与特定资源类型关联的事件。字符串

-

null

 

filter.type

根据事件类型匹配事件。字符串

-

null

 

filter.level

根据事件级别匹配。字符串

-

null

 

1.1.3. 返回类型
复制链接

V1ListAdministrationEventsResponse

1.1.4. 内容类型
复制链接

  • application/json

1.1.5. 响应
复制链接

Expand
表 1.1. HTTP 响应代码
代码消息datatype

200

成功响应。

V1ListAdministrationEventsResponse

0

意外错误响应。

RuntimeError

1.1.6. Samples
复制链接

1.1.7. 常规对象参考
复制链接

1.1.7.1. ProtobufAny
复制链接

any 包含任意序列化协议缓冲区消息，以及一个描述序列化消息的类型的 URL。

protobuf 库以实用程序函数形式提供对 pack/unpack Any 值的支持，或者对 Any 类型的其他生成的方法提供其他生成的方法。

示例 1: Pack 并在 C++ 中解包信息。 

Foo foo = ...;
Any any;
any.PackFrom(foo);
...
if (any.UnpackTo(&foo)) {
  ...
}
Copy to Clipboard Toggle word wrap

示例 2：打包并解压缩 Java 消息。 

Foo foo = ...;
Any any = Any.pack(foo);
...
if (any.is(Foo.class)) {
  foo = any.unpack(Foo.class);
}
// or ...
if (any.isSameTypeAs(Foo.getDefaultInstance())) {
  foo = any.unpack(Foo.getDefaultInstance());
}
Copy to Clipboard Toggle word wrap 
Example 3: Pack and unpack a message in Python.
Copy to Clipboard Toggle word wrap 
foo = Foo(...)
any = Any()
any.Pack(foo)
...
if any.Is(Foo.DESCRIPTOR):
  any.Unpack(foo)
  ...
Copy to Clipboard Toggle word wrap 
Example 4: Pack and unpack a message in Go
Copy to Clipboard Toggle word wrap 
foo := &pb.Foo{...}
any, err := anypb.New(foo)
if err != nil {
  ...
}
...
foo := &pb.Foo{}
if err := any.UnmarshalTo(foo); err != nil {
  ...
}
Copy to Clipboard Toggle word wrap

默认情况下，protobuf 库提供的软件包方法将使用 'type.googleapis.com/full.type.name' 作为类型 URL，解包方法只使用类型 URL 中的完全限定类型名称，如 "foo.bar.com/x/x/y.z"。

1.1.7.1.1. JSON 表示
复制链接

any 值的 JSON 表示使用反序列化的、嵌入式消息的常规表示，以及包含类型 URL 的附加字段 @type。Example: 

package google.profile;
message Person {
  string first_name = 1;
  string last_name = 2;
}
Copy to Clipboard Toggle word wrap 
{
  "@type": "type.googleapis.com/google.profile.Person",
  "firstName": <string>,
  "lastName": <string>
}
Copy to Clipboard Toggle word wrap

如果嵌入式消息类型是知名且具有自定义 JSON 表示法，则该表示将被嵌入一个字段值，该值 除 @type 字段外还包含自定义 JSON。示例（用于消息 [google.protobuf.Duration][]）： 

{
  "@type": "type.googleapis.com/google.protobuf.Duration",
  "value": "1.212s"
}
Copy to Clipboard Toggle word wrap
Expand
字段名称必填nullable类型描述格式

typeUrl

  

字符串

唯一标识序列化协议缓冲消息的 URL/资源名称。此字符串必须至少包含一个 \"/\" 字符。URL 路径的最后一部分必须代表类型的完全限定名称（如 path/google.protobuf.Duration）。名称应采用规范形式（例如，未接受前面的 \".\"）。在实践中，团队通常会预编译到期望其在任意上下文中使用的所有类型的二进制代码。但是，对于使用方案 http、https 或无方案的 URL，可以选择设置一个类型服务器，将类型 URL 映射到消息定义，如下所示：* 如果没有提供方案，则假设 https。* URL 上的 HTTP GET 必须以二进制格式生成一个 [google.protobuf.Type][] 值，或者产生错误。* 应用程序允许根据 URL 缓存查找结果，或者预先编译到二进制文件以避免出现任何查找。因此，为了更改类型，二进制兼容性需要保留。（使用版本控制类型名称来管理中断的更改。）注意：这个功能目前在官方 protobuf 版本中可用，它不用于以 type.googleapis.com 开头的类型 URL。自 2023 年 5 月起，没有广泛使用的类型服务器实施，没有计划实施。http 之外的方案（或空方案）可以与实施特定语义一起使用。

 

value

  

byte[]

必须是上述指定类型的有效序列化协议缓冲。

BYTE

1.1.7.2. RuntimeError
复制链接

Expand
字段名称必填nullable类型描述格式

错误

  

字符串

  

code

  

整数

 

int32

message

  

字符串

  

详情

  

ProtobufAny列表

  

1.1.7.3. V1AdministrationEvent
复制链接

AdministrationEvents 是 Central 发出的管理事件。它们用于为用户提供异步后台任务的透明度。事件是 Central 的系统健康视图的一部分。

Expand
字段名称必填nullable类型描述格式

id

  

字符串

事件的 UUID。

 

type

  

V1AdministrationEventType

 

管理_EVENT_TYPE_UNKNOWN, MANAGEMENT_EVENT_TYPE_GENERIC, MANAGEMENT_EVENT_TYPE_LOG_MESSAGE,

level

  

V1AdministrationEventLevel

 

MANAGEMENT_EVENT_LEVEL_UNKNOWN, MANAGEMENT_EVENT_LEVEL_INFO, MANAGEMENT_EVENT_LEVEL_SUCCESS, MANAGEMENT_EVENT_LEVEL_WARNING, MANAGEMENT_EVENT_LEVEL_ERROR,

message

  

字符串

与事件关联的消息。消息可能包含此特定事件的详细信息。

 

提示

  

字符串

与事件关联的提示。hint 可根据事件类型包含不同的信息。它可以包含用于解析事件或信息提示的说明。

 

domain

  

字符串

与事件关联的域。事件的域概述了从中创建事件的功能域。例如，这可能是 \"Image Scanning\"。如果事件无法绑定到特定域，这将是 \"General\"。

 

resource

  

V1AdministrationEventResource

  

numOccurrences

  

字符串

与事件关联的发生时间。当事件可能会多次发生时，出现的事件会跟踪这个数量。

int64

lastOccurredAt

  

Date

指定事件最后一次发生的时间。

date-time

createdAt

  

Date

指定事件创建的时间。

date-time

1.1.7.4. V1AdministrationEventLevel
复制链接

AdministrationEventLevel 会公开不同级别的事件。

Expand
Enum 值

ADMINISTRATION_EVENT_LEVEL_UNKNOWN

ADMINISTRATION_EVENT_LEVEL_INFO

ADMINISTRATION_EVENT_LEVEL_SUCCESS

ADMINISTRATION_EVENT_LEVEL_WARNING

ADMINISTRATION_EVENT_LEVEL_ERROR

1.1.7.5. V1AdministrationEventResource
复制链接

资源包含有关与事件关联的所有资源的信息。

Expand
字段名称必填nullable类型描述格式

type

  

字符串

与事件关联的资源类型。事件可能会引用特定镜像等底层资源。在这种情况下，资源类型将填写在此处。

 

id

  

字符串

与事件关联的资源 ID。如果事件引用底层资源，则资源 ID 会标识底层资源。根据管理事件的上下文，无法保证设置资源 ID。

 

名称

  

字符串

与事件关联的资源名称。如果事件引用底层资源，则资源名称会标识底层资源。根据管理事件的上下文，无法保证设置资源名称。

 

1.1.7.6. V1AdministrationEventType
复制链接

AdministrationEventType 会公开不同类型的事件。

Expand
Enum 值

ADMINISTRATION_EVENT_TYPE_UNKNOWN

ADMINISTRATION_EVENT_TYPE_GENERIC

ADMINISTRATION_EVENT_TYPE_LOG_MESSAGE

1.1.7.7. V1ListAdministrationEventsResponse
复制链接

Expand
字段名称必填nullable类型描述格式

events

  

V1 managementEvent列表

  
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat