Actualizar los valores de una entrada global ListEntry de acceso utilizando el identificador único de la dirección IP deseada.
Para encontrar una Entrada específica de la lista de acceso global, obtén la lista de Entradas de la lista de acceso global, luego busca el {ACCESS-LIST-ID} que necesitas.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
PATCH /admin/accessList/{ACCESS-LIST-ID}Roles necesarios
Requiere que la clave de API que llama a este endpoint tenga el rol de Global Owner.
Request Parameters
Parámetros de 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 muestra si el cuerpo de la respuesta está en formato pretty-print. |
|
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
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 el número de segundos que han transcurrido desde la Unix epoch cuando añadió este CIDR bloque a la Lista de Acceso Global. |
| 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
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --request PATCH "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/accessList/{ACCESS-LIST-ID}?pretty=true"Respuesta de ejemplo
Encabezado de respuesta
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}Respuesta del cuerpo
{ "cidrBlock" : "127.0.0.1/32", "created" : "2019-09-04T17:45:33Z", "description" : "Docs Example", "expires" : null, "id" : "{ACCESS-LIST-ID}", "lastUsed" : null, "type" : "GLOBAL_ROLE", "updated" : "2019-09-04T17:45:33Z"}