Observação
Grupos e projetos são termos sinônimos. Seu {PROJECT-ID} é igual ao ID do seu projeto. Para grupos existentes, o ID do grupo/projeto permanece o mesmo. Esta página usa o termo grupo, que é mais familiar, ao se referir a descrições. O ponto de extremidade permanece conforme indicado no documento.
Use this endpoint to gracefully restart a running process. Ops Manager sets lastRestart for the process in the automation configuration and publishes the change. If the process is the current primary, the Automation Agent steps it down before it restarts the process.
The request is asynchronous: 200 OK means Ops Manager published the change, not that the process has restarted. Poll the automation status resource until the plan completes.
The restart endpoint returns 400 PROCESS_DISABLED_CANNOT_RESTART for a process that is shut down. To start it, use Start a Process instead.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
POST /groups/{GROUP-ID}/process/{HOST-PORT}:restartFunções obrigatórias
The API key that makes this request must have the Project Automation Admin role.
Parâmetros do caminho da solicitação
Nome | Tipo | necessidade | Descrição |
|---|---|---|---|
ID do grupo | string | Obrigatório | String única de 24 dígitos hexadecimais que identifica seu projeto. |
hospedar-PORTA | string | Obrigatório | Target process, as |
Solicitar parâmetros de query
Nome | Tipo | necessidade | Descrição | Default |
|---|---|---|---|---|
execução seca | booleano | Opcional | If |
|
Os seguintes parâmetros de query são opcionais:
Nome | Tipo | necessidade | Descrição | Default |
|---|---|---|---|---|
pretty | booleano | Opcional | Sinalizador que indica se o corpo da resposta está em um formato pretty-print. |
|
envelope | booleano | Opcional | Sinalizador que indica se deve envolver a resposta em um envelope. Alguns clientes de API não podem acessar os cabeçalhos de resposta HTTP ou o código de status. Para corrigir isso, defina envelope=true na query. Para endpoints que retornam um resultado, o corpo da resposta inclui:
|
|
Parâmetros do corpo da solicitação
Este endpoint não usa parâmetros do corpo da solicitação HTTP.
Resposta
Ops Manager returns 200 OK and the target process as it appears in the automation configuration, with the change applied. lastRestart is set. The body is the same whether you set dryRun or not.
Nome | Tipo | Descrição |
|---|---|---|
name | string | Nome do processo na configuração de automação. |
nome do host | string | Nome do host do processo. |
tipoDeProcesso | string | Type of process, for example |
Versão | string | Versão do processo em MongoDB. |
desabilitado | booleano |
|
lastRestart | string | Timestamp, in ISO 8601 UTC format, of the last requested restart. |
lastResync | string | Timestamp, in ISO 8601 UTC format, of the last requested resync. |
The document also contains the rest of the process's automation configuration, such as args2_6, featureCompatibilityVersion, and authSchemaVersion. See the Automation Configuration reference.
Exemplo de solicitação
The following example restarts the process running on node1.example.com:27017.
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/process/node1.example.com:27017:restart?pretty=true"Exemplo de resposta
Cabeçalho de resposta
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-aliveHTTP/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}Corpo de resposta
{ "name": "rs0_1", "processType": "mongod", "version": "8.0.4", "hostname": "node1.example.com", "disabled": false, "lastRestart": "2026-10-06T09:15:20Z", "authSchemaVersion": 5, "featureCompatibilityVersion": "8.0", "args2_6": { "net": { "port": 27017 }, "replication": { "replSetName": "rs0" }, "storage": { "dbPath": "/data/rs0_1" }, "systemLog": { "destination": "file", "path": "/data/rs0_1/mongodb.log" } }}Códigos de resposta
HTTP Status | Código de erro | Descrição |
|---|---|---|
200 | -- | The change was published, or computed with |
400 | PROCESSO_DESATIVADO_NÃO_PODE_REINICIAR | O processo foi encerrado. Inicie-o em vez disso. |
409 | AGENTE_DO_PROCESSO_NÃO_REPORTA | O Agente de Automação do host de destino nunca reportou ao Gerenciador de Operações. |
409 | GRUPO_EM_MODO_DE_RESTAURAÇÃO | O projeto está se reconciliando após uma restauração. |
403 | PROCESS_EXTERNALLY_GERAGED | Os processos do projeto são gerenciados por um sistema externo. |
409 | AUTOMATION_CONFIG_DRAFT_ALREADY_EXISTS | Você tem um rascunho de configuração de automação não publicado no projeto. |
404 | PROCESSO NÃO ENCONTRADO |
|
400 | PARÂMETRO_DE_CONSULTA_INVÁLIDO |
|
409 | AUTOMATION_CONFIG_CONCURRENT_MODIFICATION | Alguém publicou uma alteração enquanto esta solicitação estava em andamento. O Ops Manager retorna este código apenas para uma solicitação real. |
O Ops Manager verifica os erros compartilhados na ordem listada. Consulte o Ciclo de Vida do Processo para obter informações sobre pré-requisitos e limitações.