Crea una entrada única en la Lista Global de acceso para Ops Manager.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
POST /admin/accessList
Roles necesarios
Requiere que el La API Key que llama a este endpoint tiene la
Global Owner role.
Request Parameters
Parámetros de la ruta de solicitud
Este endpoint no utiliza parámetros de ruta de solicitud HTTP.
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
Especifica un documento que represente una entrada de lista de acceso que desees agregar.
Cuando envías una solicitud POST que contiene un valor cidrBlock que aún no está presente en la lista de acceso, el Ops Manager agrega esas entradas a la lista de entradas existentes en la lista de acceso. Ops Manager no establece la lista de acceso para contener solo las entradas especificadas en la solicitud.
Nombre | Tipo | Necesidad | Descripción |
|---|---|---|---|
| string | Requerido | Descripción de la entrada a la lista de acceso global. Debe tener entre 1 y 250 caracteres de longitud. |
| string | Requerido | Se agregará una entrada de lista de acceso en notación IPv4 o IPv6 CIDR. |
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 '{USER-ID}:{API-KEY}' --digest \ 2 --header 'Accept: application/json' \ 3 --header 'Content-Type: application/json' \ 4 --include \ 5 --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/accessList?pretty=true" \ 6 --data ' 7 { 8 "cidrBlock" : "127.0.0.1/32", 9 "description" : "Docs Example" 10 }'
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" : "127.0.0.1/32", 3 "created" : "2019-09-04T17:45:33Z", 4 "description" : "Docs Example", 5 "expires" : null, 6 "id" : "5d6ff83dff4ab7133648b584", 7 "lastUsed" : null, 8 "type" : "GLOBAL_ROLE", 9 "updated" : "2019-09-04T17:45:33Z" 10 }