注意
注意：群组和项目是同义词。您的 {PROJECT-ID} 与您的项目 ID 相同。对于现有群组，群组/项目 ID 保持不变。当引用说明时，此页面将使用“群组”这个更为人熟知的术语。终结点仍如文档中所述。
使用此端点检索特定副本集的每个重选作业。
基本 URL： https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
GET /groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobs
所需角色
发出此请求的API密钥必须具有 Project Automation Admin角色。
请求路径参数
名称 | 类型 | 必要性 | 说明 |
|---|---|---|---|
群组 ID（group ID） | 字符串 | 必需 | 标识项目的唯一 24 位十六进制数字字符串。 |
RS- ID | 字符串 | 必需 | 要列出其重选作业的副本集的名称。 |
请求查询参数
名称 | 类型 | 说明 | 默认 |
|---|---|---|---|
pageNum | 整型 | 页码（从 1 开始）。 |
|
itemsPerPage | 整型 | 每页要返回的项目数，最多 500 个。 |
|
pretty | 布尔 | 指示显示正文是否应采用 prettyprint 格式。 |
|
envelope | 布尔 | 指示是否要将响应封装在信封中。 某些API客户端无法访问权限HTTP响应标头或状态代码。要修复此问题，请在查询中设立 对于返回一个结果的终结点，响应体包括：
对于返回结果列表的端点， | 无 |
请求正文参数
此端点不使用 HTTP 请求正文参数。
响应
响应包括重选作业对象大量和检索到的作业对象总数。
名称 | 类型 | 说明 |
|---|---|---|
结果 | 阵列 | 连任作业数组，按从最近创建到最近创建的顺序排序。请参阅 |
总计数 | 数字 | 结果设立的项目总数。当响应分页时，这可能会超过 |
results 嵌入式文档
results 的每个元素代表一个重选作业。
名称 | 类型 | 说明 |
|---|---|---|
id | 字符串 | 唯一的 24-十六进制数字字符串，用于标识重选作业。 |
groupId | 字符串 | 用于标识项目的唯一的 24 位十六进制数字字符串。 |
操作 | 字符串 | 此作业执行的操作。返回以下值之一： |
ReplicaSetName | 字符串 | 目标副本集的名称。 |
主机名 | 字符串 | 目标进程的主机名。 |
端口 | 整型 | 目标进程的端口。 |
状态 | 字符串 | 作业状态。返回以下值之一： |
noOp | 布尔 | 指示操作是否作为无操作完成的标志。 |
message | 字符串 | 有关作业的人类可读详细信息。 Ops Manager在代理报告结果后填充此字段。 |
已创建 | 字符串 | Ops Manager创建作业的时间戳，采用 ISO 8601 UTC 格式。 |
lastUpdated | 字符串 | Ops Manager上次更新作业的时间戳，采用 ISO 8601 UTC 格式。 |
expires | 字符串 | 时间戳，采用 ISO 8601 UTC 格式，超过该时间后自动化代理将不再接收此作业。 |
请求示例
1 curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ 2 --header "Accept: application/json" \ 3 --include \ 4 --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobs?pretty=true"
响应示例
响应标头
401 Unauthorized Content-Type: application/json;charset=ISO-8859-1 Date: {dateInUnixFormat} WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false Content-Length: {requestLengthInBytes} Connection: keep-alive
200 OK Vary: Accept-Encoding Content-Type: application/json Strict-Transport-Security: max-age=300 Date: {dateInUnixFormat} Connection: keep-alive Content-Length: {requestLengthInBytes} X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
响应体
1 { 2 "results": [ 3 { 4 "id": "665a1234567890abcdef5678", 5 "groupId": "5c8100bcf2a30b12ff88258f", 6 "action": "STEP_UP", 7 "replicaSetName": "rs0", 8 "hostname": "node2.example.com", 9 "port": 27017, 10 "status": "COMPLETED", 11 "noOp": false, 12 "message": null, 13 "created": "2026-08-11T05:40:00Z", 14 "lastUpdated": "2026-08-11T05:41:15Z", 15 "expires": "2026-08-11T05:45:00Z" 16 }, 17 { 18 "id": "665a1234567890abcdef1234", 19 "groupId": "5c8100bcf2a30b12ff88258f", 20 "action": "STEP_DOWN", 21 "replicaSetName": "rs0", 22 "hostname": "node1.example.com", 23 "port": 27017, 24 "status": "COMPLETED", 25 "noOp": false, 26 "message": null, 27 "created": "2026-08-11T05:37:59Z", 28 "lastUpdated": "2026-08-11T05:38:30Z", 29 "expires": "2026-08-11T05:42:59Z" 30 } 31 ], 32 "totalCount": 2 33 }
响应代码
HTTP Status | 错误代码 | 说明 |
|---|---|---|
200 | -- | 返回重新选举作业的大量。 |
401 | USER_UNAUTHORIZED | API密钥没有 |