AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

すべての機能ポリシーを取得

ベース URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

このリソースには、認証されたユーザーまたは API キーが必要です。

GET /groups/availablePolicies

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

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

名前
タイプ
説明
default

pageNum

integer

ページ番号(1 インデックス ベース)。

1

itemsPerPage

integer

1 ページあたりに返す項目の数は最大 500 です。

100

pretty

ブール値

レスポンス本体を pretty-print 形式にするかどうかを示します。

false

envelope

ブール値

応答をエンベロープでラップするかどうかを示します。

一部の API クライアントは、HTTP レスポンス ヘッダーまたはステータス コードにアクセスできません。これを修正するには、クエリで "envelope" : true を設定します。

1 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。

  • status: HTTPレスポンス コード

  • content: 期待される応答本体

結果のリストを返すエンドポイントの場合、 resultsオブジェクトはエンベロープです。 MongoDB Ops Manager は、レスポンス本体にstatusフィールドを追加します。

なし

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

名前
タイプ
説明

_id

string

このポリシーを設定するプロジェクトの一意の識別子。

created

string

この機能制御ポリシーが作成されたときの ISO8601 の日付と時刻形式の UTC のタイムスタンプ。

updated

string

ISO8601 のタイムスタンプ この機能制御ポリシーが更新されたときの日付と時刻形式( UTC)。

externalManagementSystem

オブジェクト

このMongoDB Ops Managerプロジェクトを管理する外部システムのパラメーターを識別します。

externalManagementSystem
.name

string

このMongoDB Ops Managerプロジェクトを管理する外部システムの識別ラベル。

externalManagementSystem
.systemId

string

この MongoDB Ops Manager プロジェクトを管理する外部システムの一意の識別子。

externalManagementSystem
.version

string

このMongoDB Ops Managerプロジェクトを管理する外部システムのアクティブなリリース。

policies

配列

外部システムがこのMongoDB Ops Managerプロジェクトに適用するポリシーのリスト。

policies
.policy[n]

オブジェクト

このMongoDB Ops Managerプロジェクトの 1 つのポリシー セット。 このパラメータは、 policies配列で 1 回以上設定できます。

可能な値は次のとおりです。

  • EXTERNALLY_MANAGED_LOCK: ユーザーは Ops Manager を使用して、policies.policy[n] 配列で指定されたその他の設定を管理することはできません。これらの同じユーザーは、Kubernetes 演算子などの構成された外部システムを使用して、これらの設定を管理することができます。

  • DISABLE_USER_MANAGEMENT: ユーザーはユーザーまたはロールを管理できません。

  • DISABLE_AUTHENTICATION_MECHANISMS: ユーザーは認証設定を変更できません。

  • DISABLE_SET_MONGOD_CONFIG: ユーザーは、policies[n].disabledParams 配列に記載されている mongod 設定を変更することはできません。

  • DISABLE_SET_MONGOD_VERSION: ユーザーは、mongod または mongos のバージョンを変更できません。

  • DISABLE_BACKUP_AGENT: ユーザーはバックアップエージェントを有効または無効にできません。

  • DISABLE_MONGOD_LOG_MANAGEMENT: ユーザーはログ マネジメント 設定を変更できません。

  • DISABLE_IMPORT_TO_AUTOMATION: ユーザーはオートメーションを使用して配置を管理できません。

  • DISABLE_AGENT_API_KEY_MANAGEMENT: ユーザーはエージェント API キーを作成または更新できません。

  • DISABLE_MONGOD_HOST_MANAGEMENT: ユーザーはホストのサーバーの種類を変更できません。

policies[n]
.disabledParams

配列

DISABLE_SET_MONGOD_CONFIGポリシーを適用する場合に無効にするmongod設定のリスト。 オートメーションはすべての MongoDB オプションをサポートしていないため、インポートが失敗する可能性があります。 詳しくは、「 MongoDB 設定とオートメーション サポート 」を参照してください。

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request GET "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/availablePolicies?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-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}
{ "_id": "{PROJECT-ID}", "created": "2019-08-29T15:03:24Z", "updated": "2019-08-29T15:03:24Z", "externalManagementSystem": { "name": "Operator", "systemId": "6d6c139ae5528707b6e8e3b2", "version": "0.2.1" }, "policies": [ {"policy": "ExternallyManagedLock"}, {"policy": "DisableUserManagement"}, {"policy": "DisableAuthenticationMechanisms"}, {"policy": "DisableSetMongodVersion"}, { "policy": "DisableSetMongodConfig", "disabledParams": ["net.tls.CAFile"] } ]}