IP アドレスのアクセスリストを取得する

IP-ADDRESSの値がエンティティのipAddressフィールドの値と等しい場合にアクセスリストエンティティを取得します。これでは、 IP-ADDRESSの値がcidrBlockフィールドで許可された値内に含まれるオブジェクトは取得されません。

ベース URL: https://cloud.mongodb.com/api/public/v1.0

Resource

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

リクエストパスパラメーター

Parameter	タイプ	説明
ユーザー ID	string	（必須。）現在のユーザーの一意の識別子。現在のユーザーの ID を取得するには、「 1 つのプロジェクトのすべてのユーザーを取得」を参照してください。
`ACCESS-LIST-ENTRY`	string	IP または CIDR アドレス。エントリにサブネットマスク（例：`192.0.2.0/24`）が含まれている場合、フォワードスラッシュ `/` には URL エンコード値 `%2F` を使用します。

リクエストクエリパラメータ

次のクエリパラメータは任意です。

名前	タイプ	必要性	説明	default
pretty	ブール値	任意	レスポンス本体をpretty-print形式にするかどうかを示すフラグ。	`false`
envelope	ブール値	任意	応答をエンベロープでラップするかどうかを示すフラグ。一部の API クライアントは、HTTP レスポンスヘッダーまたはステータスコードにアクセスできません。これを修正するには、クエリで envelope=true を設定します。 1 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。 `status`: HTTPレスポンスコード `content`: 期待される応答本体	`false`

リクエストボディパラメータ

このエンドポイントは、HTTP リクエスト本体パラメータを使用しません。

応答

名前	タイプ	説明
`cidrBlock`	string	CIDR 表記の IP アドレス範囲。
`created`	date	この IP アドレスがアクセスリストに追加された日付。
`ipAddress`	string	アクセスリスト内の IP アドレス。
`lastUsed`	date	この IP アドレスから送信された最新のリクエストの日付。このフィールドは、アクセスリストで保護されているリソースがアクセスされたときにのみ更新されることに注意してください。
`lastUsedAddress`	string	API への最後の呼び出しが発行されたアドレス。
`count`	数値	この IP アドレスから送信されたリクエストの合計数。このフィールドは、アクセスリストで保護されているリソースがアクセスされたときにのみ更新されることに注意してください。
`links`	配列	関連するサブリソースへのリンク。応答内のすべてのリンク配列には、`self` と呼ばれるリンクが少なくとも 1 つ含まれています。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 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}