Docs Menu
Docs Home
/
MongoDB Ops Manager
/
API
/
MongoDB Ops Manager Administration APIリソース
/
プロジェクトとユーザー
/
アクセス リスト

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

項目一覧

  • Resource
  • 応答
  • リクエストの例
  • 応答例

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

ベース URL: https://{OPSMANAGER-HOST}:{PORT}/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 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。

名前
説明
状態
HTTPレスポンス コード
envelope
期待される応答本体
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://{OPSMANAGER-HOST}:{PORT}/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://<ops-manager-host>/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://<ops-manager-host>/api/public/v1.0/users/{USER-ID}/accessList/192.0.2.0%2F24",
                    "rel": "self"
                }
            ]
        },
    ],
    "totalCount": 1
}

戻る

現在のユーザーのアクセス リストを取得

次へ

アクセス リストへのエントリの追加