获取一个副本集重选作业

注意

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

使用此端点可通过其唯一标识符检索单个重选作业。轮询此端点，直到作业达到最终状态。

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

Resource

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

所需角色

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

请求路径参数

名称	类型	必要性	说明
群组 ID（group ID）	字符串	必需	标识项目的唯一 24 位十六进制数字字符串。
RS- ID	字符串	必需	包含重选作业的副本集名称。
REELECTION-JOB- ID	字符串	必需	唯一的 24-十六进制数字字符串，用于标识重新选举作业，由降级或升级端点返回。

请求查询参数

以下查询参数为可选参数：

名称	类型	必要性	说明	默认
pretty	布尔	Optional	指示响应正文是否采用美观打印格式的标志。	`false`
envelope	布尔	Optional	指示是否将响应包装在信封中的标志。某些 API 客户端无法访问 HTTP 响应标头或状态代码。要解决这个问题，可在查询中设置 envelope=true。对于返回一个结果的端点，响应体包括： `status`： HTTP响应代码 `content`：预期响应正文	`false`

请求正文参数

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

响应

响应返回单个重选作业。

名称	类型	说明
id	字符串	唯一的 24-十六进制数字字符串，用于标识重选作业。
groupId	字符串	用于标识项目的唯一的 24 位十六进制数字字符串。
操作	字符串	此作业执行的操作。返回以下值之一：`STEP_DOWN` 或 `STEP_UP`。
ReplicaSetName	字符串	目标副本集的名称。
主机名	字符串	目标进程的主机名。
端口	整型	目标进程的端口。
状态	字符串	作业状态。返回以下值之一：`QUEUED`、`RUNNING`、`COMPLETED`、`FAILED` 或 `EXPIRED`。
noOp	布尔	指示操作是否作为无操作完成的标志。
message	字符串	有关作业的人类可读详细信息。 Ops Manager在代理报告结果后填充此字段。
已创建	字符串	Ops Manager创建作业的时间戳，采用 ISO 8601 UTC 格式。
lastUpdated	字符串	Ops Manager上次更新作业的时间戳，采用 ISO 8601 UTC 格式。
expires	字符串	时间戳，采用 ISO 8601 UTC 格式，超过该时间后自动化代理将不再接收此作业。

作业状态值

状态	终端	含义
QUEUED	No	Ops Manager创建了作业。它正在等待目标主机的自动化代理将其接收。
RUNNING	No	代理正在运行作业。
已完成	是	操作完成。检查 `noOp` 以确定操作是否进行了更改。
已失败	是	无法完成操作。请参阅 `message` 以了解原因。
已过期	是	在 `expiresAfterSeconds` 过去之前，没有代理接手作业。

请求示例

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/{REELECTION-JOB-ID}?pretty=true"

响应示例

响应标头

HTTP/1.1 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

HTTP/1.1 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   "id": "665a1234567890abcdef1234",
3   "groupId": "5c8100bcf2a30b12ff88258f",
4   "action": "STEP_UP",
5   "replicaSetName": "rs0",
6   "hostname": "node2.example.com",
7   "port": 27017,
8   "status": "COMPLETED",
9   "noOp": false,
10   "message": null,
11   "created": "2026-08-11T05:37:59Z",
12   "lastUpdated": "2026-08-11T05:38:45Z",
13   "expires": "2026-08-11T05:39:59Z"
14 }

响应代码

HTTP Status	错误代码	说明
200	--	返回重选作业文档。
401	USER_UNAUTHORIZED	API密钥没有 `Project Automation Admin`角色。
404	REELECTION_JOB_NOT_FOUND	`REELECTION-JOB-ID` 未知或格式错误，或者作业不属于 `RS-ID` 中命名的副本集。

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/{REELECTION-JOB-ID}?pretty=true"

1	{
2	"id": "665a1234567890abcdef1234",
3	"groupId": "5c8100bcf2a30b12ff88258f",
4	"action": "STEP_UP",
5	"replicaSetName": "rs0",
6	"hostname": "node2.example.com",
7	"port": 27017,
8	"status": "COMPLETED",
9	"noOp": false,
10	"message": null,
11	"created": "2026-08-11T05:37:59Z",
12	"lastUpdated": "2026-08-11T05:38:45Z",
13	"expires": "2026-08-11T05:39:59Z"
14	}