Devuelve una entrada de la lista de acceso global utilizando el identificador único para la dirección IP deseada.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
GET /admin/accessList/{ACCESS-LIST-ID}
Roles necesarios
Requiere que el La API Key que llama a este endpoint tiene la
Global Read Only role.
Request Parameters
Parámetros de la ruta de solicitud
Nombre | Tipo | Descripción |
|---|---|---|
| string | Identificador único para la entrada de lista de acceso global. |
Parámetros de Solicitud Query
Los siguientes parámetros de query son opcionales:
Nombre | Tipo | Necesidad | Descripción | predeterminado | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
bonito | booleano | Opcional | Indicador que señala si el cuerpo de la respuesta debe estar en un pretty-print formato. |
| ||||||
envelope | booleano | Opcional | Bandera que indica si se debe o no envolver la respuesta en un sobre. Algunos clientes API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, ajusta envelope=true en la query. Para los endpoints que devuelven un resultado, el cuerpo de la respuesta incluye:
|
|
Parámetros del cuerpo de la solicitud
Este endpoint no utiliza parámetros de cuerpo de solicitud HTTP.
Respuesta
Elementos de respuesta
Nombre | Tipo | Descripción |
|---|---|---|
| string | Rango de direcciones IP en una lista de acceso en notación IPv4 o IPv6 CIDR. |
| string | Marca de tiempo, en la cantidad de segundos que han transcurrido desde la Unix epoch cuando agregaste este bloque CIDR a la Lista Global de Acceso. |
| string | Explicación del propósito de esta entrada de la lista de acceso global. |
| string | Identificador único de esta entrada de la lista de acceso global. |
| string | Alcance de la entrada de la lista de acceso global. |
| string | Marca de tiempo, en número de segundos transcurridos desde la Unix epoch cuando cambiaste por última vez el bloque CIDR de esta entrada de lista de acceso global. |
Solicitud de ejemplo
1 curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ 2 --header "Accept: application/json" \ 3 --include \ 4 --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/accessList/{ACCESS-LIST-ID}?pretty=true"
Respuesta de ejemplo
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}
Respuesta del cuerpo
1 { 2 "cidrBlock" : "73.73.45.150", 3 "created" : "2019-09-05T04:02:46Z", 4 "description" : "Test Global Access List Entry 1", 5 "id" : "5d6fe33787d9d6689b3427ec", 6 "type" : "GLOBAL_ROLE", 7 "updated" : "2019-09-05T04:02:46Z" 8 }