Docs Menu
Docs Home
/
MongoDB Ops Manager
/
API
/
MongoDB Ops Manager Administration APIリソース
/
バックアップ管理
/
oplogストアの構成

1 つの oplog 構成を作成する

項目一覧

  • Resource
  • リクエスト パス パラメーター
  • リクエスト クエリ パラメータ
  • リクエスト ボディ パラメータ
  • 応答
  • リクエストの例
  • 応答例
  • 応答ヘッダー
  • レスポンス本体

新しい oplog ストアを 1 つ構成します。

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

Resource

POST /oplog/mongoConfigs

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

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

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

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

名前
タイプ
必要性
説明
default
pretty
ブール値
任意
レスポンス本体を pretty-print に含めるかどうかを示すフラグ 形式。
false
envelope
ブール値
任意

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

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

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

名前
説明
status
HTTPレスポンス コード
content
期待される応答本体
false

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

名前
タイプ
説明
割り当てEnabled
ブール値
任意。 このoplog ストアにバックアップジョブを割り当てることができるかどうかを示すフラグ。
encryptionCredentials
ブール値
任意。 この oplog ストアのユーザー名とパスワードが認証情報ツールを使用して暗号化されているかどうかを示すフラグ。
id
string
labels
文字列の配列

任意。 がどの ストア MongoDB Ops Managerに割り当てることができるoplog バックアップ ジョブ を管理するためのタグの配列。

これらのタグを設定すると、この oplog ストアが処理できるバックアップジョブが制限されます。 省略した場合、この oplog ストアは、ジョブをフィルタリングするためにラベルを使用しないプロジェクトのバックアップ ジョブのみを処理できます。

maxCapacityGB
数値
任意。 このoplog ストアが保存できるデータの最大量（GB 単位）。
uri
string
このoplog ストアにアクセスするために使用できる<hostname:port>形式のホストのカンマ区切りリスト。
ssl
ブール値
任意。 この oplog ストアがTLSを使用して暗号化された接続のみを受け入れるかどうかを示すフラグ。
writeConcern
string

任意。 このoplog ストアに使用される書込み保証 (write concern) です。

このオプションに指定できる値は以下のとおりです。

  • ACKNOWLEDGED

  • W2

  • JOURNALED

  • MAJORITY

MongoDB の書込み (write) 確認応答レベルの詳細については、「 書込み保証 (write concern) 」を参照してください。

応答

名前
タイプ
説明
割り当てEnabled
ブール値
このoplog ストアにバックアップジョブを割り当てることができるかどうかを示すフラグ。
encryptionCredentials
ブール値
この oplog ストアのユーザー名とパスワードがcredentialstool で暗号化されているかどうかを示すフラグ。
id
string
labels
文字列の配列
がどの ストア MongoDB Ops Managerに割り当てることができるoplog バックアップ ジョブ を管理するためのタグの配列。
Links
オブジェクト配列

サブリソースや関連リソースへの 1 つ以上のリンク。 応答内のすべてのlinks配列には、 selfと呼ばれるリンクが少なくとも 1 つ含まれています。 URL の関係は、 Web リンク仕様 で説明されています。

maxCapacityGB
数値
このoplog ストアが保存できるデータの最大量（GB 単位）。
uri
string
このoplog ストアにアクセスするために使用できる<hostname:port>形式のホストのカンマ区切りリスト。
ssl
ブール値
この oplog ストアがTLSを使用して暗号化された接続のみを受け入れるかどうかを示すフラグ。
usedSize
数値
既存のバックアップが消費するバックアップ容量の量（ MB単位）。
writeConcern
string

このoplog ストアに使用される書込み保証 (write concern) です。

このオプションに指定できる値は以下のとおりです。

  • ACKNOWLEDGED

  • W2

  • JOURNALED

  • MAJORITY

MongoDB の書込み (write) 確認応答レベルの詳細については、「 書込み保証 (write concern) 」を参照してください。

リクエストの例

1curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \
2     --header 'Accept: application/json' \
3     --header 'Content-Type: application/json' \
4     --include \
5     --request POST 'https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup/oplog/mongoConfigs?pretty=true' \
6     --data '{
7       "assignmentEnabled" : true,
8       "encryptedCredentials" : false,
9       "id" : "{OPLOG-CONFIG-ID}",
10       "labels" : [ "l1", "l2" ],
11       "maxCapacityGB" : 8,
12       "uri" : "mongodb://localhost:27017",
13       "ssl" : true,
14       "writeConcern" : "W2"
15     }'

応答例

応答ヘッダー

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}

レスポンス本体

1{
2  "assignmentEnabled" : true,
3  "encryptedCredentials" : false,
4  "id" : "{OPLOG-CONFIG-ID}",
5  "labels" : [ "l1", "l2" ],
6  "links" : [ {
7    "href" : "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup/oplog/mongoConfigs",
8    "rel" : "self"
9  }],
10  "maxCapacityGB" : 8,
11  "uri" : "mongodb://localhost:27017",
12  "ssl" : true,
13  "usedSize" : 222,
14  "writeConcern" : "W2"
15}

戻る

すべての oplog 構成を取得する

次へ

1 つの oplog 構成の更新