Navigation
This version of the documentation is archived and no longer supported. It will be removed on EOL_DATE. To learn how to upgrade your version of MongoDB Ops Manager, refer to the upgrade documentation.
You were redirected from a different version of the documentation. Click here to go back.
This version of the manual is no longer supported. It will be removed on EOL_DATE.

Server Pool Requests

Server Pools deprecated as of Ops Manager 4.0

As of Ops Manager 4.0, server pools are deprecated and disabled by default.

Note

Groups and projects are synonymous terms. Your {GROUP-ID} is the same as your project id. For existing groups, your group/project id remains the same. This page uses the more familiar term group when referring to descriptions. The endpoint remains as stated in the document.

The serverPool/requests resource provides access to requests for server pool’s servers. The pool provides Ops Manager users with pre-provisioned servers for deploying MongoDB.

For a list of all server pool API resources, see Server Pool. For information on the server pool, see Provision Servers for the Server Pool.

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

Endpoints

Get All Server Pool Requests

GET /serverPool/requests

To filter by request status, use the status query parameter:

GET /serverPool/requests?status=STATUS

STATUS can be one of the following values:

  • EXECUTING
  • CANCELLING
  • CANCELLED
  • FAILED
  • COMPLETED

You must have the Global Read Only role or higher to use this endpoint.

Get a Specific Server Pool Request

GET /serverPool/requests/REQUEST-ID

REQUEST-ID is the string specified in the id field of the serverPool/requests entity.

You must have the Global Read Only role or higher to use this endpoint.

Cancel a Server Pool Request

DELETE /serverPool/requests/REQUEST-ID

REQUEST-ID is the string specified in the id field of the serverPool/requests entity.

You must have the Global Owner role to use this endpoint.

Sample Entity

{
  "id" : "57e5a05b80eef542bf4af9a7",
  "numServers": 3,
  "created" : "2016-11-11T21:36:27Z",
  "expires" : "2016-11-11T23:36:27Z",
  "groupId" : "56a688e0e4b06aa2a9c3aa1b",
  "properties" : [ ... ],
  "statusName" : "EXECUTING",
  "links" : []
}

Entity Fields

Name Type Description
id string A unique identifier for the request.
numServers number The number of servers requested.
created date The date and time the request was issued.
expires date The date and time the request expires if no server is available.
completeDate date The date and time the request was completed.
cancelDate date The date and time the request was cancelled.
groupId string The project for which the server is requested.
properties object of key/value pairs The properties that identify the type of server requested.
statusName string

The status of the request. Possible values are:

EXECUTING The request is pending.
CANCELLING The request is in the process of cancelling.
CANCELLED The request is cancelled.
FAILED The request failed.
COMPLETED The request has been fulfilled.

Examples

Get All Server Pool Requests

Request

curl -i -u "username:apiKey" --digest "https://<ops-manager-host>/api/public/v1.0/serverPool/requests"

Response

Response Header

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}

Response Body

{
  "results" : [ {
    "created" : "2016-11-11T21:36:27Z",
    "expires" : "2016-11-11T23:36:27Z",
    "groupId" : "56a688e0e4b06aa2a9c3aa1b",
    "id" : "57e5a05b80eef542bf4af9a7",
    "links" : [],
    "properties" : [ {
      "region" : "central",
      "size" : "large"
    } ],
    "statusName" : "EXECUTING"
  }, ... ],
  "links" : [],
  "totalCount" : 3
}

Get a Specific Server Pool Request

Request

curl -i -u "username:apiKey" --digest "https://<ops-manager-host>/api/public/v1.0/serverPool/requests/57e5a05b80eef542bf4af9a7"

Response

Response Header

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}

Response Body

{
  "created" : "2016-11-11T21:36:27Z",
  "expires" : "2016-11-11T23:36:27Z",
  "groupId" : "56a688e0e4b06aa2a9c3aa1b",
  "id" : "57e5a05b80eef542bf4af9a7",
  "links" : [],
  "properties" : [ {
    "region" : "central",
    "size" : "large"
  } ],
  "statusName" : "EXECUTING"
}

Cancel a Server Pool Request

Request

curl -i -u "username:apiKey" --digest -X DELETE "https://<ops-manager-host>/api/public/v1.0/serverPool/requests/57e5a05b80eef542bf4af9a7"

Response

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}

This endpoint does not return a response body.