对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

获取所有副本集重新选举作业

注意

注意:群组和项目是同义词。您的 {PROJECT-ID} 与您的项目 ID 相同。对于现有群组,群组/项目 ID 保持不变。当引用说明时,此页面将使用“群组”这个更为人熟知的术语。终结点仍如文档中所述。

使用此终结点检索特定副本集的所有重新选举作业。

基本 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

GET /groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobs

发出此请求的 API 密钥必须具有 Project Automation Admin 角色。

名称
类型
必要性
说明

群组 ID(group ID)

字符串

必需

标识项目的唯一 24 位十六进制数字字符串。

RS-ID

字符串

必需

要列出其重新选举作业的副本集的名称。

名称
类型
说明
默认

pageNum

整型

页码(从 1 开始)。

1

itemsPerPage

整型

每页要返回的项目数,最多 500 个。

100

pretty

布尔

指示显示正文是否应采用 prettyprint 格式。

false

envelope

布尔

指示是否要将响应封装在信封中。

某些 API 客户端无法访问 HTTP 响应标头或状态代码。要修复此问题,在查询中设置 "envelope" : true。

对于返回一个结果的终结点,响应体包括:

  • status: HTTP 响应代码

  • content:预期响应正文

对于返回结果列表的端点, results对象是一个信封。 Ops Manager 将status字段添加到响应正文。

无

此端点不使用 HTTP 请求正文参数。

响应包括一个重新选举作业对象数组和检索到的作业对象总数。

名称
类型
说明

结果

阵列

重新选举作业的数组,按创建时间从新到旧排序。请参阅 results 嵌入式文档。

总计数

数字

结果集中的项目总数。当响应进行分页时,这可能会超过 results 中的项目数。

results 的每个元素代表一个重新选举作业。

名称
类型
说明

id

字符串

用于标识重新选举作业的唯一 24 位十六进制数字 string。

groupId

字符串

用于标识项目的唯一的 24 位十六进制数字字符串。

操作

字符串

此作业执行的操作。返回以下值之一:STEP_DOWN 或 STEP_UP。

ReplicaSetName

字符串

目标副本集的名称。

主机名

字符串

目标进程的主机名。

端口

整型

目标进程的端口。

状态

字符串

作业的状态。返回以下值之一:QUEUED、RUNNING、COMPLETED、FAILED 或 EXPIRED。

noop

布尔

指示操作是否作为无操作 (no-op) 完成的标志。

message

字符串

关于该作业的人类可读详细信息。代理报告结果后,MongoDB Ops Manager 会填充此字段。

已创建

字符串

Ops Manager创建作业的时间戳,采用 ISO 8601 UTC 格式。

最后更新

字符串

MongoDB Ops Manager 最后更新作业的时间戳(ISO 8601 UTC 格式)。

expires

字符串

ISO 8601 UTC 格式的时间戳,在此时间之后,自动化代理将不再执行此作业。

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobs?pretty=true"
HTTP/1.1 401 UnauthorizedContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=falseContent-Length: {requestLengthInBytes}Connection: keep-alive
HTTP/1.1 200 OKVary: Accept-EncodingContent-Type: application/jsonStrict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
{ "results": [ { "id": "665a1234567890abcdef5678", "groupId": "5c8100bcf2a30b12ff88258f", "action": "STEP_UP", "replicaSetName": "rs0", "hostname": "node2.example.com", "port": 27017, "status": "COMPLETED", "noOp": false, "message": null, "created": "2026-08-11T05:40:00Z", "lastUpdated": "2026-08-11T05:41:15Z", "expires": "2026-08-11T05:45:00Z" }, { "id": "665a1234567890abcdef1234", "groupId": "5c8100bcf2a30b12ff88258f", "action": "STEP_DOWN", "replicaSetName": "rs0", "hostname": "node1.example.com", "port": 27017, "status": "COMPLETED", "noOp": false, "message": null, "created": "2026-08-11T05:37:59Z", "lastUpdated": "2026-08-11T05:38:30Z", "expires": "2026-08-11T05:42:59Z" } ], "totalCount": 2}
HTTP Status
错误代码
说明

200

--

返回重新选举作业的数组。

401

用户未授权

该 API 密钥没有 Project Automation Admin 角色。