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