注意
グループとプロジェクトは同義語です。あなたの {PROJECT-ID} は、グループ IDと同じです。既存のグループの場合、グループ/グループ ID は同じままです。このページでは、説明を参照するときに、より一般的なタームのグループ を使用します。エンドポイントとなる接続されたデバイスは、ドキュメントに記載されているままです。
ベース URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
PATCH /groups/{projectId}/backupConfigs/{clusterId}Request Parameters
リクエスト パス パラメーター
Path Parameter | タイプ | 必要性 | 説明 |
|---|---|---|---|
projectId | string | 必須 | 変更対象のバックアップ構成を持つクラスターを保持するプロジェクトを識別する、一意な 24 桁の 16 進数のstring 。 |
clusterId | string | 必須 | バックアップ構成を変更したいクラスターを識別する一意な 24 桁の 16 進数のstring 。 |
リクエスト クエリ パラメータ
次のクエリ パラメータは 任意です。
名前 | タイプ | 必要性 | 説明 | default |
|---|---|---|---|---|
pretty | ブール値 | 任意 | レスポンス本体をpretty-print形式にするかどうかを示すフラグ。 |
|
envelope | ブール値 | 任意 | 応答をエンベロープでラップするかどうかを示すフラグ。 一部の API クライアントは、HTTP レスポンス ヘッダーまたはステータス コードにアクセスできません。これを修正するには、クエリで envelope=true を設定します。 1 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。
|
|
リクエスト ボディ パラメータ
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
authMechanismName | string | 条件付き | 同期ソース データベースに接続するために必要な認証メカニズム。 MongoDB Ops Manager では、同期ストアで認証を使用する場合、このパラメータが必要です。 MongoDB Ops Managerは以下に対応しています。
|
disableCertificateRevocationCheck | ブール値 | 任意 | バックアップ構成でTLSを使用し、バックアップエージェントが証明書の検証をスキップする場合( |
encryptionEnabled | ブール値 | 任意 | バックアップ構成の暗号化が有効になっているかどうかを示すフラグ。 バックアップ構成の暗号化を有効にするときは、 syncSourceパラメーターを含める必要があります。 プロジェクト内の既存のバックアップの場合、暗号化を有効にするにはバックアップのヘッドデータベースを再作成するための最初の同期が必要です。 MongoDB Ops Manager は、バックアップカーソル を使用しています。以前使用していた ヘッドデータベース は使用していません。詳細については、「バックアップデーモン サービス」を参照してください。 バックアップの暗号化の詳細については、「暗号化されたバックアップスナップショット」を参照してください。 |
excludedNamespaces | 文字列の配列 | 条件付き | バックアップから省略するデータベースとコレクション名のリスト。各 string は 1 つの名前空間を表します。 名前空間は次のいずれかの形式を使用します。
MongoDB Ops Manager は、機能の互換性バージョン (FCV) 6.0 以降で実行されている MongoDB データベースをバックアップする際、このパラメーターを無視します。 このパラメーターは、次の条件を満たしている必要があります。
|
includeNamespaces | 文字列の配列 | 条件付き | バックアップに含めるデータベースとコレクション名のリスト。各 string は 1 つの名前空間を表します。 名前空間は次のいずれかの形式を使用します。
MongoDB Ops Manager は、機能の互換性バージョン (FCV) 6.0 以降で実行されている MongoDB データベースをバックアップする際、このパラメーターを無視します。 このパラメーターは、次の条件を満たしている必要があります。
|
パスワード | string | 条件付き | 同期ソース データベースに接続するために使用するパスワード。 MongoDB Ops Manager では、同期ストア |
preferenceメンバー | string | 任意 | ユーザーがスナップショットを作成するための優先レプリカセット ノードとして指定するクラスター ノード。 コンソールを使用して、優先ノードを設定できます。 バックアップ構成を 1 つ取得する エンドポイントを使用して、優先ノードとして機能できるレプリカセット ノードを表示します。 |
プロビジョニングされた | ブール値 | 条件付き | MongoDB Ops Managerがバックアップを保存するために必要なリソースをプロビジョニングしたかどうかを示すフラグ。 |
sslEnabled | ブール値 | 任意 | 同期ソース データベースでTLSが有効になっているかどうかを示すフラグ。 |
statusName | string | 任意 | バックアップ構成の現在の(または希望)ステータス。 MongoDB Ops Managerは以下に対応しています。
|
storageEngineName | string | 任意 | バックアップに使用されるストレージ エンジン。 MongoDB Ops Managerは以下に対応しています。
|
syncSource | string | 条件付き | バックアップ データを取得する MongoDB Ops Manager では、 "storageEngineName" : "Wired_Tiger" の場合、このパラメータが必要です。 |
username | string | 条件付き | 同期ソース データベースに接続するために使用するユーザーの名前。 MongoDB Ops Manager では、同期ストア が管理 していない レプリカセットまたはシャーディングされたクラスターのバックアップ構成を更新するときに、このパラメーターをMongoDB Ops ManagerMongoDB Ops Manager に送信します。 |
snapshotStore | オブジェクト | 任意 | 移行先の読み取りを指定するオブジェクト。このオブジェクトには、読み取りタイプと S3バケット( S3ブロックストア)のIDが含まれています。既存のスナップショットは、構成された保持ポリシーに基づいて、有効期限が切れるまで、元のストアに残ります。ジョブ ページから S3 互換のスナップショット ストア間で移行することもできます。 |
snapshotStore.snapshotStoreType | string | 条件付き | 読み取りのタイプを識別する string。 現在、S3バケット( S3ブロックストア)のみがサポートされています。値は |
snapshotStore.snapshotStoreId | string | 条件付き | 移行先のS3ブロックストアを識別するstring。新しいスナップショットは、この宛先S3ブロックストアに保存されます。既存のスナップショットは、設定された保持ポリシーに基づいて期限切れになるまで、元のストアに残ります。 |
応答
名前 | タイプ | 説明 |
|---|---|---|
authMechanismName | string | 同期ソース データベースに接続するときに使用する認証メカニズムの名前。 同期ストアが認証を使用する場合、MongoDB Ops Manager はこのパラメーターを返します。 |
clusterId | string | このバックアップ構成が適用されるクラスターの一意の識別子。 |
encryptionEnabled | ブール値 | バックアップ構成の暗号化が有効になっているかどうかを示すフラグ。 バックアップ構成の暗号化を有効にするときは、 syncSourceフィールドを含める必要があります。 プロジェクト内の既存のバックアップの場合、暗号化を有効にするにはバックアップのヘッドデータベースを再作成するための最初の同期が必要です。 MongoDB Ops Manager は、バックアップカーソル を使用しています。以前使用していた ヘッドデータベース は使用していません。詳細については、「バックアップデーモン サービス」を参照してください。 バックアップの暗号化の詳細については、「暗号化されたバックアップスナップショット」を参照してください。 |
excludedNamespaces | 文字列の配列 | バックアップから省略するデータベース名とコレクション名のリスト。 各stringは、 {database}または{database}.{collection}の形式の名前空間です。 |
includeNamespaces | 文字列の配列 | バックアップに含めるデータベース名とコレクション名のリスト。 各stringは、 {database}または{database}.{collection}の形式の名前空間です。 |
preferenceメンバー | string | ユーザーがスナップショットを作成するための優先レプリカセット ノードとして指定するクラスター ノード。 コンソールを使用して、優先ノードを設定できます。 バックアップ構成を 1 つ取得する エンドポイントを使用して、優先ノードとして機能できるレプリカセット ノードを表示します。 |
projectId | string | このバックアップ構成を所有するプロジェクトの一意の識別子。 |
プロビジョニングされた | ブール値 | MongoDB Ops Managerがバックアップを保存するために必要なリソースをプロビジョニングしたかどうかを示すフラグ。 MongoDB Ops Manager は、バックアップするデータ量が一定のしきい値を超えると、このパラメータを返します。 |
sslEnabled | ブール値 | 同期ソース データベースでTLSが有効になっているかどうかを示すフラグ。 |
statusName | string | バックアップ構成の現在のステータス。 |
storageEngineName | string | バックアップに使用されるストレージ エンジン。 |
snapshotStore | オブジェクト | 移行先の読み取りを指定するオブジェクト。このオブジェクトには、読み取りタイプと S3バケット( S3ブロックストア)のIDが含まれています。既存のスナップショットは、構成された保持ポリシーに基づいて、有効期限が切れるまで、元のストアに残ります。ジョブ ページから S3 互換のスナップショット ストア間で移行することもできます。 |
snapshotStore.snapshotStoreType | string | 読み取りのタイプを識別する string。 現在、S3バケット( S3ブロックストア)のみがサポートされています。値は |
snapshotStore.snapshotStoreId | string | 移行先のS3ブロックストアを識別するstring。新しいスナップショットは、この宛先S3ブロックストアに保存されます。既存のスナップショットは、設定された保持ポリシーに基づいて期限切れになるまで、元のストアに残ります。 |
リクエストの例
curl --user "{publicKey}:{privateKey}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include --request PATCH "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{projectId}/backupConfigs/{clusterId}" \ --data ' { "statusName": "STARTED", "storageEngineName": "WIRED_TIGER", "syncSource": "primary" }'各スナップショットが開始されると、 MongoDB Ops Managerはスナップショットを実行するためのレプリカセット メンバーを選択します。 この自動選択ノードは、レプリカセットへのパフォーマンスへの影響を最小限に抑える必要があります。 デフォルトの選択を上書きできます。
重要
可能な場合は常にdefault selectionを使用してください。 この選択により、バックアップの可用性が確保されます。
次のリクエストでは、優先ノードを設定します。
curl --user "{publicKey}:{privateKey}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include --request PATCH "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{projectId}/backupConfigs/{clusterId}" \ --data ' { "preferredMember":"{HOSTNAME}:{PORT}" }'curl --user "{publicKey}:{privateKey}" \ --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include --request PATCH "http://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{projectId}/backupConfigs/{clusterId}" \ --data ' { "snapshotStore": {"snapshotStoreId":"{snapshotStoreId}", "snapshotStoreType":"s3blockstore"} }'応答例
応答ヘッダー
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-aliveHTTP/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}レスポンス本体
{ "authMechanismName" : "NONE", "clusterId" : "{clusterId}", "encryptionEnabled" : false, "excludedNamespaces" : [ ], "groupId" : "{projectId}", "links" : [ { "href" : "http://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{projectId}/backupConfigs/{clusterId}", "rel" : "self" }, { "href" : "http://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{projectId}/clusters/{clusterId}", "rel" : "http://mms.mongodb.com/cluster" }, { "href" : "http://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{projectId}", "rel" : "http://mms.mongodb.com/group" }, { "href" : "http://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{projectId}/backupConfigs/{clusterId}/snapshotSchedule", "rel" : "http://mms.mongodb.com/snapshotSchedule" } ], "sslEnabled" : false, "statusName" : "STARTED", "storageEngineName" : "WIRED_TIGER"}各スナップショットが開始されると、 MongoDB Ops Managerはスナップショットを実行するためのレプリカセット メンバーを選択します。 この自動選択ノードは、レプリカセットへのパフォーマンスへの影響を最小限に抑える必要があります。 デフォルトの選択を上書きできます。
重要
可能な場合は常にdefault selectionを使用してください。 この選択により、バックアップの可用性が確保されます。
次の応答には優先ノードが含まれます。
{ "authMechanismName" : "NONE", "clusterId" : "{clusterId}", "encryptionEnabled" : false, "excludedNamespaces" : [ ], "groupId" : "{projectId}", "links" : [ { "href" : "http://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{projectId}/backupConfigs/{clusterId}", "rel" : "self" }, { "href" : "http://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{projectId}/clusters/{clusterId}", "rel" : "http://mms.mongodb.com/cluster" }, { "href" : "http://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{projectId}", "rel" : "http://mms.mongodb.com/group" }, { "href" : "http://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{projectId}/backupConfigs/{clusterId}/snapshotSchedule", "rel" : "http://mms.mongodb.com/snapshotSchedule" } ], "sslEnabled" : false, "statusName" : "STARTED", "storageEngineName" : "WIRED_TIGER", "preferredMember":"{HOSTNAME}:{PORT}"}{ "authMechanismName" : "NONE", "clusterId" : "{clusterId}", "encryptionEnabled" : false, "excludedNamespaces" : [ ], "groupId" : "{projectId}", "links" : [ { "href" : "http://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{projectId}/backupConfigs/{clusterId}", "rel" : "self" }, { "href" : "http://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{projectId}/clusters/{clusterId}", "rel" : "http://mms.mongodb.com/cluster" }, { "href" : "http://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{projectId}", "rel" : "http://mms.mongodb.com/group" }, { "href" : "http://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{projectId}/backupConfigs/{clusterId}/snapshotSchedule", "rel" : "http://mms.mongodb.com/snapshotSchedule" } ], "sslEnabled" : false, "statusName" : "STARTED", "storageEngineName" : "WIRED_TIGER", "snapshotStore": { "snapshotStoreType": "s3blockstore", "snapshotStoreId": "your-snapshot-store-id" }}