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

クラスターのオンデマンド スナップショットを作成する

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

POST /groups/{groupId}/clusters/{clusterId}/snapshots/onDemandSnapshot

オンデマンドスナップショットを取得するには、Global Backup Admin が必要です。

名前
タイプ
説明

グループ ID

string

プロジェクト設定からのプロジェクトの一意の識別子。

CLUSTER-ID

string

スナップショットが表すクラスターの一意の識別子。

名前
タイプ
必要性
説明
例

retentionDays

数値

必須

オンデマンド スナップショットが保持される日数を示す数値。0 より大きくする必要があります。

15

envelope

ブール値

任意

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

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

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

false

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

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --include \ --request POST "https://{opsManagerHost}:{port}/api/public/v1.0/groups/{groupId}/clusters/{clusterId}/snapshots/onDemandSnapshot?retentionDays=15"
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}
{ "clusterName": "myCluster", "description": "On demand snapshot request complete .", "timestamp": { "increment": 1, "time": 1719518976, "date": "2024-06-27T20:09:36Z" }}