Roles necesarios
Este recurso requiere el
Clave API para tener la Global Owner role.
Resource
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
GET /usage/groups/{physicalHostId}
Parámetros de la ruta de solicitud
Ops Manager requiere todos los parámetros de la ruta de solicitud:
Path Parameter | Tipo | Descripción |
|---|---|---|
ID de host físico | string | Identificador único del host físico que se recuperará. |
Parámetros de consulta de solicitud
Los siguientes parámetros de consulta son opcionales:
Nombre | Tipo | Descripción | predeterminado | ||||
|---|---|---|---|---|---|---|---|
número de página | entero | Número de página (basado en el índice 1). |
| ||||
artículos por página | entero | Número de artículos a devolver por página, hasta un máximo de 500. |
| ||||
bonita | booleano | Indica si el cuerpo de la respuesta debe estar en formato prettyprint. formato. |
| ||||
envolvente | booleano | Indica si se debe envolver o no la respuesta en un sobre. Algunos Los clientes de laAPI no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, configure Para los puntos finales que devuelven un resultado, el cuerpo de la respuesta incluye:
Para los puntos finales que devuelven una lista de resultados, el objeto | Ninguno |
Parámetros del cuerpo de la solicitud
Este punto final no utiliza parámetros del cuerpo de la solicitud HTTP.
Respuesta
Elemento de respuesta | Tipo | Descripción |
|---|---|---|
Hospedadores | matriz de objetos | Lista de hosts virtuales vinculados al host físico proporcionado. |
hosts .[n].groupId | string | Identificador único del proyecto en el que Ops Manager coloca este host virtual. |
hosts .[n].hostname | string | FQDN del host virtual vinculado al host físico. |
ID. | string | Identificador único del host físico al que Ops Manager vinculó los hosts virtuales. |
Nombre | string | Etiqueta que le diste al host físico. |
tipo de servidor | string | Tipo de servidor del host físico. Ops Manager devuelve uno de los siguientes valores:
Para obtener más información, consulte Uso de MongoDB. |
Ejemplo de solicitud
1 curl --user "{publicApiKey}:{privateApiKey}" --digest \ 2 --header "Accept: application/json" \ 3 --include \ 4 --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/usage/groups/{physicalHostId}?pretty=true"
Ejemplo de respuesta
Encabezado de respuesta
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}
Cuerpo de respuesta
1 { 2 "hosts": [ 3 { 4 "groupId": "{PROJECT-ID}", 5 "hostname": "virtual.host.lqhfcxlgzqtimcxf.internal.mongodb-2" 6 }, 7 { 8 "groupId": "{PROJECT-ID}", 9 "hostname": "virtual.host.lqhfcxlgzqtimcxf.internal.mongodb-3" 10 }, 11 { 12 "groupId": "{PROJECT-ID}", 13 "hostname": "virtual.host.lqhfcxlgzqtimcxf.internal.mongodb-4" 14 }, 15 { 16 "groupId": "{PROJECT-ID}", 17 "hostname": "virtual.host.lqhfcxlgzqtimcxf.internal.mongodb-5" 18 }, 19 { 20 "groupId": "{PROJECT-ID}", 21 "hostname": "virtual.host.lqhfcxlgzqtimcxf.internal.mongodb-6" 22 }, 23 { 24 "groupId": "{PROJECT-ID}", 25 "hostname": "virtual.host.lqhfcxlgzqtimcxf.internal.mongodb-7" 26 }, 27 { 28 "groupId": "{PROJECT-ID}", 29 "hostname": "virtual.host.lqhfcxlgzqtimcxf.internal.mongodb-8" 30 }, 31 { 32 "groupId": "{PROJECT-ID}", 33 "hostname": "virtual.host.lqhfcxlgzqtimcxf.internal.mongodb-9" 34 } 35 ], 36 "id": "{PHYSICAL-HOST-ID}", 37 "name": "physicalDevHostA", 38 "serverType": "DEV_SERVER" 39 }