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.
Retorna um host pelo seu identificador único, incluindo o estado de replicação do membro do conjunto de réplicas do host.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v2.0
Resource
GET /groups/{PROJECT-ID}/hosts/{HOST-ID}Funções obrigatórias
The API key that makes this request must have the Project Read Only role.
Parâmetros do caminho da solicitação
Nome | Tipo | necessidade | Descrição |
|---|---|---|---|
ID do projeto | string | Obrigatório | String única de 24 dígitos hexadecimais que identifica seu projeto. |
ID DE HOST | string | Obrigatório | Identificador único do host. |
Solicitar parâmetros de query
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
The response contains the same fields as the v1.0 endpoint.
Nome | Tipo | Descrição |
|---|---|---|
Aliases | array de strings | array de combinações alternativas de nome de host e porta que o Ops Manager descobriu para o processo do MongoDB. Essas combinações podem incluir nomes de host, FQDNs, endereços IPv4 e endereços IPv6. |
alertsEnabled | booleano |
|
authMechanismName | string | mecanismo de autenticação usado para se conectar a esse processo do MongoDB. Isso exibe apenas um dos seguintes valores:
|
clusterId | string | Identificador único do cluster ao qual pertence o processo MongoDB. |
Criado | data | Data em que o Ops Manager criou ou encontrou pela primeira vez esse processo do MongoDB. |
groupId | string | Identificador exclusivo do grupo que possui este host. |
hasStartupWarlings | booleano |
|
escondida | booleano |
|
ocultadoSecundário | booleano |
|
hostEnabled | booleano |
|
nome do host | string | Nome do host primário conforme o MongoDB Ops Manager pode determinar melhor. Isso pode ser um nome de host, um FQDN, um endereço IPv4 ou um endereço IPv6. |
id | string | Identificador único. |
ipAddress | string | IPv4 ou IPv6 endereço associado ao |
journalingEnabled | booleano |
|
lastDataSizeBytes | número | Tamanho não compactado dos bancos de dados do host no disco em bytes , excluindo índices. |
lastIndexSizeBytes | número | Tamanho não compactado dos índices do banco de dados do host no disco em bytes. Esse número não inclui o tamanho do índice do banco de dados local . |
lastPing | data | Registro de data/hora no formato de data e hora ISO 8601 em UTC quando o último ping desse processo do MongoDB foi recebido. |
lastRestart | data | Registro de data/hora no formato de data e hora ISO 8601 em UTC quando esse processo foi reiniciado pela última vez. Se o processo MongoDB nunca tiver sido reiniciado, o campo |
links | array | Array que inclui um ou mais links para sub-recursos e/ou recursos relacionados. As relações entre URLs são explicadas na Especificação de links da web. No mínimo, uma array |
logsEnabled | booleano |
|
limite baixo | booleano |
|
Porta | número | Porta na qual o processo do MongoDB escuta. |
profilerEnabled | booleano |
|
ReplicaSetName | string | Nome do conjunto de réplicas ao qual este processo pertence. Somente presente se este processo fizer parte de um conjunto de réplicas. |
replicationStateName | string | Estado atual deste processo MongoDB dentro de um conjunto de réplicas. Somente presente se esse processo fizer parte de um conjunto de réplicas. Consulte Estados do membro do conjunto de réplicas para obter os valores possíveis. |
shardName | string | Nome do fragmento ao qual pertence este processo. Presente somente se o processo fizer parte de um cluster fragmentado. |
secondaryDelaySecs | número | Número de segundos que os dados deste membro do conjunto de réplicas rastreiam o primário. Se esse valor estiver definido como |
sslEnabled | booleano |
|
systemInfo | objeto | Objeto que contém informações de RAM e CPU para esse servidor de processos do MongoDB, conforme relatado pelo sistema operacional ou container. |
systemInfo.memSizeMB | número | Quantidade de RAM em megabytes. |
systemInfo.numCores | número | Número de núcleos de CPU. |
typeName | string | Type for this MongoDB process. Os valores possíveis são:
O tipo para novos hosts adicionados ao Ops Manager será |
tempo de atividadeMsec | número | Número de milissegundos desde a última vez que este processo foi reiniciado. |
Versão | string | Versão do MongoDB em execução para este processo. |
The v2.0 endpoint also returns the following fields.
Nome | Tipo | Descrição |
|---|---|---|
muito antigo | booleano |
|
último erro de repetição | string | The member's last replication error, from the |
Both fields describe this host's own member entry in its replica set. Ops Manager omits them for hosts that aren't replica set members, and omits lastReplError when the member reports no error.
Exemplo de solicitação
O exemplo a seguir recupera o host com o ID de host especificado.
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request GET "https://<OpsManagerHost>:<Port>/api/public/v2.0/groups/{PROJECT-ID}/hosts/{HOST-ID}?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
O documento foi truncado para maior brevidade. O Ops Manager retorna o documento completo do host.
{ "id": "5f5f8e2b1c9d440b8c1a2b3c", "groupId": "5c8100bcf2a30b12ff88258f", "clusterId": "5e84bd8c87d9d6044a1d76c5", "hostname": "node1.example.com", "port": 27017, "replicaSetName": "rs0", "replicaStateName": "RECOVERING", "tooStale": true, "lastReplError": "error RS102 too stale to catch up", "links": [ { "href": "https://<OpsManagerHost>:<Port>/api/public/v2.0/groups/5c8100bcf2a30b12ff88258f/hosts/5f5f8e2b1c9d440b8c1a2b3c", "rel": "self" }, { "href": "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/5c8100bcf2a30b12ff88258f", "rel": "http://mms.mongodb.com/group" } ]}Códigos de resposta
HTTP Status | Código de erro | Descrição |
|---|---|---|
200 | -- | Retorna o documento hospedeiro. |
404 | HOST_NÃO_ENCONTRADO |
|
Other response codes match the v1.0 endpoint.