Devolución de una entrada de la lista de acceso para una clave API de organización
Retorna una entrada de la lista de acceso para la clave API de la organización especificada. Los recursos requieren que todas las solicitudes API se originen en direcciones IP incluidas en la lista de acceso a la API. Para usar este recurso, la Cuenta de servicio solicitante o la clave de API deben tener el rol de Miembro de la organización.
Parámetros de path
-
string única de 24dígitos hexadecimales que identifica la organización que contiene su proyectos. Utilice el
/orgsendpoint para recuperar todas las organizaciones a las que el usuario autenticado tiene acceso.El formato debe coincidir con el siguiente patrón:
^([a-f0-9]{24})$. -
Una dirección IP o varias direcciones IP representadas como un bloque CIDR para limitar las solicitudes a los recursos API en la organización especificada. Cuando añadas un bloque CIDR con una máscara de subred, como 192.0.2.0/24, usa el valor codificado en URL %2F para la barra diagonal /.
El formato debe coincidir con el siguiente patrón:
^([0-9]{1,3}\.){3}[0-9]{1,3}(%2[fF][0-9]{1,3})?|([0-9a-f]{1,4}\:){7}[0-9a-f]{1,4}(%2[fF][0-9]{1,3})?|([0-9a-f]{1,4}\:){1,6}\:(%2[fF][0-9]{1,3})?$. -
string única de 24 dígitos hexadecimales que identifica la clave API de esta organización para la cual deseas devolver las entradas de la lista de acceso.
El formato debe coincidir con el siguiente patrón:
^([a-f0-9]{24})$.
Parámetros de query
-
Bandera que indica si la aplicación envuelve la respuesta en un objeto JSON
envelope. Algunos clientes de la API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para remediar esto, establece envelope=true en la query. Los endpoints que devuelven una lista de resultados utilizan el objeto de resultados como un sobre. La aplicación agrega el parámetro de estado al cuerpo de la respuesta.El valor por defecto es
false. -
Bandera que indica si el cuerpo de la respuesta debe estar en el formato prettyprint.
El valor por defecto es
false.Impresión bonita
curl \
--request GET 'https://cloud.mongodb.com/api/atlas/v1.0/orgs/4888442a3354817a7320eb61/apiKeys/{apiUserId}/accessList/192.0.2.0%2F24' \
--header "Authorization: Bearer $ACCESS_TOKEN"{
"cidrBlock": "203.0.113.0/24",
"count": 42,
"created": "2026-05-04T09:42:00Z",
"ipAddress": "203.0.113.10",
"lastUsed": "2026-05-04T09:42:00Z",
"lastUsedAddress": "203.0.113.10",
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
]
}{
"error": 401,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Unauthorized",
"errorCode": "NOT_ORG_GROUP_CREATOR"
}{
"error": 403,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Forbidden",
"errorCode": "CANNOT_CHANGE_GROUP_NAME"
}{
"error": 404,
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
"reason": "Not Found",
"errorCode": "RESOURCE_NOT_FOUND"
}{
"error": 500,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Internal Server Error",
"errorCode": "UNEXPECTED_ERROR"
}