获取一个全局访问列表条目
MongoDB Ops Manager v6.0 将于 2025 1 月 EOL。 尽快升级到更高的MongoDB Ops Manager版本。
使用所需 IP 地址的唯一标识符返回一个全局访问列表条目。
基本 URL： https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
GET /admin/accessList/{ACCESS-LIST-ID}
所需角色
要求调用此端点的 API密钥具有 Global Read Only角色。
请求参数
请求路径参数
名称 | 类型 | 说明 |
|---|---|---|
ACCESS-LIST-ID | 字符串 | 全局访问列表条目的唯一标识符。 |
请求查询参数
以下查询参数为可选参数：
名称 | 类型 | 必要性 | 说明 | 默认 | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
pretty | 布尔 | Optional | 指示响应正文是否应采用 Prettyprint 的标志 格式。 | false | ||||||
envelope | 布尔 | Optional | 指示是否将响应包装在信封中的标志。 某些 API 客户端无法访问 HTTP 响应标头或状态代码。要解决这个问题，可在查询中设置 envelope=true。 对于返回一个结果的端点，响应体包括：
| false |
请求正文参数
此端点不使用 HTTP 请求正文参数。
响应
响应元素
名称 | 类型 | 说明 |
|---|---|---|
cidrBlock | 字符串 | 访问列表中的 IP 地址范围（采用IPv4或IPv6 CIDR表示法）。 |
created | 字符串 | 时间戳，以自 UNIX 纪元 以来经过的秒数表示 当您将此 CIDR 区块添加到全局访问列表中时。 |
description | 字符串 | 解释此全局访问列表条目的用途。 |
id | 字符串 | 此全局访问列表条目的唯一标识符。 |
type | 字符串 | 全局访问列表条目的范围。 |
updated | 字符串 | 时间戳，以自 UNIX 纪元 以来经过的秒数表示 您上次更改此全局访问列表条目的 CIDR 区块的时间。 |
请求示例
1 curl --user "{USERNAME}:{APIKEY}" --digest \ 2 --header "Accept: application/json" \ 3 --include \ 4 --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/accessList/{ACCESS-LIST-ID}?pretty=true"
响应示例
响应标头
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}
响应体
1 { 2 "cidrBlock" : "73.73.45.150", 3 "created" : "2019-09-05T04:02:46Z", 4 "description" : "Test Global Access List Entry 1", 5 "id" : "5d6fe33787d9d6689b3427ec", 6 "type" : "GLOBAL_ROLE", 7 "updated" : "2019-09-05T04:02:46Z" 8 }