Docs 菜单
Docs 主页
/
MongoDB Cloud Manager
/
API
/
资源
/
项目和用户
/
访问列表

获取 IP 地址的访问列表

在此页面上

  • Resource
  • 响应
  • 请求示例
  • 响应示例

如果 IP-ADDRESS的值等于实体的ipAddress字段的值，则检索访问列表实体。 这不会检索IP-ADDRESS值包含在cidrBlock字段允许的值范围内的对象。

基本 URL： https://cloud.mongodb.com/api/public/v 1.0

Resource

GET /users/{USER-ID}/accessList/{ACCESS-LIST-ENTRY}

请求路径参数

Parameter
类型
说明

用户 ID

字符串

（必需。） 当前用户的唯一标识符。 要检索当前用户的 ID，请参阅获取一个项目中的所有用户。

ACCESS-LIST-ENTRY

字符串

IP 或 CIDR地址。 如果条目包含子网掩码，例如192.0.2.0/24 ，则使用 URL 编码值%2F作为正斜杠/ 。

请求查询参数

以下查询参数为可选参数：

名称
类型
必要性
说明
默认

pretty

布尔

Optional

指示响应正文是否应采用 美观打印 的标志 格式。

false

envelope

布尔

Optional

指示是否将响应包装在信封中的标志。

某些 API 客户端无法访问 HTTP 响应标头或状态代码。要解决这个问题，可在查询中设置 envelope=true。

对于返回一个结果的端点，响应体包括：

名称
说明

status

HTTP 响应代码

content

预期响应正文

false

请求正文参数

此端点不使用 HTTP 请求正文参数。

响应

名称
类型
说明

cidrBlock

字符串

以 CIDR 表示的 IP 地址范围。

created

日期

将此 IP 地址添加到访问列表的日期。

ipAddress

字符串

访问列表中的 IP 地址。

lastUsed

日期

The date of the most recent request that originated from this IP address. 请注意，仅当访问受访问列表保护的资源时，才会更新此字段。

lastUsedAddress

字符串

上次调用 API 的地址。

count

数字

源自此 IP 地址的请求总数。 请注意，仅当访问受访问列表保护的资源时，才会更新此字段。

links

阵列

相关子资源链接。 响应中的所有链接数组至少包含一个名为self的链接。 URL 之间的关系在 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 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
HTTP/1.1 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}

响应体

{
  "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
}

后退

获取当前用户

来年

添加条目