Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Obter lista de acesso para um endereço IP

Recupera uma entidade da lista de acesso se o valor de IP-ADDRESS for igual ao valor do campo ipAddress da entidade. Isso não recupera um objeto em que o valor de IP-ADDRESS esteja contido dentro dos valores permitidos pelo campo cidrBlock .

URL base: https://cloud.mongodb.com/api/public/v1.0

GET /users/{USER-ID}/accessList/{ACCESS-LIST-ENTRY}
Parâmetro
Tipo
Descrição

ID DE USUÁRIO

string

(Obrigatório.) Identificador único do usuário atual. Para recuperar o ID do usuário atual, consulte Obter todos os usuários em um projeto.

ACCESS-LIST-ENTRY

string

O IP ou endereço CIDR. Se a entrada incluir uma máscara de sub-rede, como 192.0.2.0/24, use o valor codificado em URL %2F para a barra /.

Os seguintes parâmetros de query são opcionais:

Nome
Tipo
necessidade
Descrição
Default

pretty

booleano

Opcional

Sinalizador que indica se o corpo da resposta deve estar em um formato prettyprint.

false

envelope

booleano

Opcional

Sinalizador que indica se deve envolver a resposta em um envelope.

Alguns clientes de API não podem acessar os cabeçalhos de resposta HTTP ou o código de status. Para corrigir isso, defina envelope=true na query.

Para endpoints que retornam um resultado, o corpo da resposta inclui:

  • status: Código de resposta HTTP

  • content: Corpo de resposta esperado

false

Este endpoint não usa parâmetros do corpo da solicitação HTTP.

Nome
Tipo
Descrição

cidrBlock

string

Uma faixa de endereços IP com notação CIDR.

created

data

A data em que esse endereço IP foi adicionado à lista de acesso.

ipAddress

string

Um endereço IP na lista de acesso.

lastUsed

data

A data da solicitação mais recente originada desse endereço IP. Observe que esse campo só é atualizado quando um recurso protegido pela lista de acesso é acessado.

lastUsedAddress

string

O endereço do qual foi emitida a última chamada para a API.

count

número

O número total de solicitações originadas deste endereço IP. Observe que esse campo só é atualizado quando um recurso protegido pela lista de acesso é acessado.

links

array

Links para sub-recursos relacionados. Todas as arrays de links em respostas contêm pelo menos um link chamado self. As relações entre URLs são explicadas na Especificação de links da web.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request GET "https://cloud.mongodb.com/api/public/v1.0/users/{USER-ID}/accessList/192.0.2.0%2F24"
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-alive
HTTP/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}
{ "links": [ { "href": "https://cloud.mongodb.com/api/public/v1.0/users/{USER-ID}/accessList/?pageNum=1&itemsPerPage=100", "rel": "self" } ], "results": [ { "cidrBlock": "192.0.2.0/24", "count": 0, "created": "2019-11-01T15:18:12Z", "links": [ { "href": "https://cloud.mongodb.com/api/public/v1.0/users/{USER-ID}/accessList/192.0.2.0%2F24", "rel": "self" } ] }, ], "totalCount": 1}