Funções obrigatórias
Este recurso exige que a chave API tenha o papel Global Owner .
Resource
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
GET /usage/groups
Parâmetros do caminho da solicitação
Este endpoint não usa parâmetros de caminho de solicitação HTTP.
Solicitar parâmetros de query
Os seguintes parâmetros de query são opcionais:
Nome | Tipo | Descrição | Default | ||||||
|---|---|---|---|---|---|---|---|---|---|
pageNum | inteiro | Número da página (com base em índice 1). |
| ||||||
itemsPerPage | inteiro | Número de itens a serem devolvidos por página, até um máximo de 500. |
| ||||||
pretty | booleano | Indica se o corpo da resposta deve estar em formato prettyprint. |
| ||||||
envelope | booleano | Indica se deseja ou não 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, configure Para endpoints que retornam um resultado, o corpo da resposta inclui:
Para endpoints que retornam uma lista de resultados, o objeto | none |
Parâmetros do corpo da solicitação
Este endpoint não usa parâmetros do corpo da solicitação HTTP.
Resposta
documento de resposta
O documento JSON de resposta inclui uma array de result objetos , uma array de link objetos e uma contagem do número total de result objetos recuperados.
Nome | Tipo | Descrição |
|---|---|---|
| array | A array inclui um objeto para cada item detalhado na seção |
| array | A array 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. |
| número | Contagem de números inteiros do número total de itens no conjunto de resultados. Pode ser maior que o número de objetos na array results se todo o conjunto de resultados for paginado. |
results documento incorporado
Cada elemento na array de resultados é um host físico.
Elemento de resposta | Tipo | Descrição |
|---|---|---|
hosts | Array de objetos | Lista de hosts virtuais vinculados ao host físico fornecido. |
| string | Identificador único do projeto no qual o Ops Manager coloca esse host virtual. |
| string | FQDN do host virtual vinculado ao host físico. |
id | string | Identificador único do host físico ao qual o Ops Manager vinculou os hosts virtuais. |
name | string | Etiqueta que você deu ao host físico. |
serverType | string | Tipo de servidor do host físico. O Ops Manager retorna um dos seguintes valores:
Para saber mais, consulte a página de uso do MongoDB. |
Exemplo de solicitação
1 curl --user "{publicApiKey}:{privateApiKey}" --digest \ 2 --header "Accept: application/json" \ 3 --header "Content-Type: application/json" \ 4 --include \ 5 --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/usage/groups?pretty=true"
Exemplo de resposta
Cabeçalho de resposta
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}
Corpo de resposta
1 { 2 "links": [ 3 { 4 "href": "http://<OpsManagerHost>:<Port>/api/public/v1.0/usage/groups?pageNum=1&itemsPerPage=100", 5 "rel": "self" 6 } 7 ], 8 "results": [ 9 { 10 "hosts": [ 11 { 12 "groupId": "{projectId1}", 13 "hostname": "virtual.host.niivowqqlyjpkakk.internal.mongodb-7" 14 }, 15 { 16 "groupId": "{projectId1}", 17 "hostname": "virtual.host.niivowqqlyjpkakk.internal.mongodb-8" 18 } 19 ], 20 "id": "{physicalHostId1}", 21 "name": "physicalHostA", 22 "serverType": "DEV_SERVER" 23 }, 24 { 25 "hosts": [ 26 { 27 "groupId": "{projectId2}", 28 "hostname": "virtual.host.lqhfcxlgzqtimcxf.internal.mongodb-0" 29 }, 30 { 31 "groupId": "{projectId2}", 32 "hostname": "virtual.host.lqhfcxlgzqtimcxf.internal.mongodb-1" 33 } 34 ], 35 "id": "{physicalHostId2}", 36 "name": "physicalHostB", 37 "serverType": "DEV_SERVER" 38 }, 39 ], 40 "totalCount": 2 41 }