Retornar todas as entradas da lista de acesso global para o Ops Manager.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
GET /admin/accessList
Funções obrigatórias
Exige que a chave de API que chama esse endpoint tenha a função Global Read Only.
Parâmetros da solicitação
Parâmetros do caminho da solicitação
Este endpoint não usa parâmetros de caminho de solicitação HTTP.
Solicitar parâmetros de query
Os seguintes parâmetros de query são opcionais:
Nome | Tipo | necessidade | Descrição | Default |
|---|---|---|---|---|
pageNum | número | Opcional | Um inteiro baseado que retorna uma subseção de resultados. |
|
itemsPerPage | número | Opcional | Número de itens a serem devolvidos por página, até um máximo de 500. |
|
pretty | booleano | Opcional | Sinalizador que indica se o corpo da resposta deve estar em um formato de impressão bonita. |
|
envelope | booleano | Opcional | Sinalizador que indica se deseja ou não 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 Para endpoints que retornam uma lista de resultados, o objeto |
|
Parâmetros do corpo da solicitação
Este endpoint não usa parâmetros do corpo da solicitação HTTP.
Resposta
documento de resposta
O documento JSON de resposta inclui uma array de objetos result, uma array de objetos link e uma contagem do número total de objetos result recuperados.
Nome | Tipo | Descrição |
|---|---|---|
| array | A array inclui um objeto para cada item detalhado na seção |
| array | A array inclui um ou mais links para sub-recursos e/ou recursos relacionados. As relações entre URLs são explicadas na Especificação de links da web. |
| número | Contagem de números inteiros do número total de itens no conjunto de resultados. Pode ser maior que o número de objetos na array results se todo o conjunto de resultados for paginado. |
results documento incorporado
Cada resultado é uma entrada da lista de acesso global.
Nome | Tipo | Descrição |
|---|---|---|
| string | Faixa de endereços IP em uma lista de acesso em notação CIDR IPv4 ou IPv6. |
| string | Registro de data/hora, no número de segundos decorridos desde a época do UNIX em que você adicionou esse bloco CIDR à Global Access List. |
| string | Explicação do propósito desta entrada da lista de acesso global. |
| string | Identificador exclusivo para esta entrada da lista de acesso global. |
| string | Escopo da entrada da lista de acesso global. |
| string | Registro de data/hora, no número de segundos decorridos desde a época do UNIX em que você alterou pela última vez o bloco CIDR desta entrada da lista de acesso global. |
Exemplo de solicitação
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/accessList?pretty=true"
Exemplo de resposta
Cabeçalho de resposta
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}
Corpo de resposta
{ "results" : [ { "cidrBlock" : "251.207.34.78/32", "created" : "2019-09-05T04:02:46Z", "description" : "Test Global Access List Entry 1", "id" : "5d4d7b9cf20ce440466a30bd", "type" : "GLOBAL_ROLE", "updated" : "2019-09-05T04:02:46Z" }, { "cidrBlock" : "2001:db8::/48", "created" : "2019-09-05T04:02:46Z", "description" : "Test Global Access List Entry 2", "id" : "5d6fe33787d9d6689b3427ec", "type" : "GLOBAL_ROLE", "updated" : "2019-09-05T04:02:46Z" } ] "totalCount" : 2 }