2.2. 创建和管理计数


通过 REST API 创建、删除和修改计数器。

2.2.1. 创建计数

使用在有效负载中包含配置的 POST 请求创建计数器。

POST /rest/v2/counters/{counterName}
Copy to Clipboard Toggle word wrap

Weak Counter 示例

{
    "weak-counter":{
        "initial-value":5,
        "storage":"PERSISTENT",
        "concurrency-level":1
    }
}
Copy to Clipboard Toggle word wrap

Strong Counter 示例

{
    "strong-counter":{
        "initial-value":3,
        "storage":"PERSISTENT",
        "upper-bound":5
    }
}
Copy to Clipboard Toggle word wrap

2.2.2. 删除计数

使用 DELETE 请求删除特定的计数器。

DELETE /rest/v2/counters/{counterName}
Copy to Clipboard Toggle word wrap

2.2.3. 检索计数配置

使用 GET 请求检索特定计数器的配置。

GET /rest/v2/counters/{counterName}/config
Copy to Clipboard Toggle word wrap

Data Grid 使用 JSON 格式的计数器配置响应。

2.2.4. 获取计数值

使用 GET 请求检索计数器值。

GET /rest/v2/counters/{counterName}
Copy to Clipboard Toggle word wrap
Expand
表 2.18. Headers
标头必需/可选参数

accept

OPTIONAL

返回内容所需的格式。支持的格式为 application/jsontext/plain。如果未提供标头,则会假定 JSON。

2.2.5. 重置计数

恢复没有 POST 请求和 ?action=reset 参数的初始计数器值。

POST /rest/v2/counters/{counterName}?action=reset
Copy to Clipboard Toggle word wrap

如果操作成功完成,服务会返回 204 (No Content)

2.2.6. 递增计数

使用 POST 请求'和 ?action=increment 参数递增计数器值。

POST /rest/v2/counters/{counterName}?action=increment
Copy to Clipboard Toggle word wrap
注意

WEAK 计数器不会在操作后响应并返回 204 (无内容)。

STRONG 计数器在每次操作后返回 200 (OK) 和当前值。

2.2.7. 将 Deltas 添加到 Counters

使用包含 ?action=adddelta 参数的 POST 请求向计数器添加任意值。

POST /rest/v2/counters/{counterName}?action=add&delta={delta}
Copy to Clipboard Toggle word wrap
注意

WEAK 计数器不会在操作后响应并返回 204 (无内容)。

STRONG 计数器在每次操作后返回 200 (OK) 和当前值。

2.2.8. 减少计数值

使用 POST 请求和 ?action=decrement 参数来解码计数器值。

POST /rest/v2/counters/{counterName}?action=decrement
Copy to Clipboard Toggle word wrap
注意

WEAK 计数器不会在操作后响应并返回 204 (无内容)。

STRONG 计数器在每次操作后返回 200 (OK) 和当前值。

2.2.9. 在 Strong Counters 上执行比较AndSet 操作

通过 GET 请求和 compareAndSet 参数,以原子方式设置计数器的值。

POST /rest/v2/counters/{counterName}?action=compareAndSet&expect={expect}&update={update}
Copy to Clipboard Toggle word wrap

如果当前值为 {expect},则数据网格会以原子方式将值设置为 {update}。如果操作成功,Data Grid 将返回 true

2.2.10. 在 Strong Counters 上执行比较AndSwap 操作

通过 GET 请求和 compareAndSwap 参数,以原子方式设置计数器的值。

POST /rest/v2/counters/{counterName}?action=compareAndSwap&expect={expect}&update={update}
Copy to Clipboard Toggle word wrap

如果当前值为 {expect},则数据网格会以原子方式将值设置为 {update}。如果操作成功,Data Grid 会从载荷返回先前的值。

2.2.11. 列出计数

使用 GET 请求检索 Data Grid 集群中的计数器列表。

GET /rest/v2/counters/
Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat