/ /

1 つのコンフィギュレーションサーバーのすべてのスナップショットを取得

重要

MongoDB 3.4 を使用する場合は非推奨

MongoDB 3.4 以降、ミラーリングされたコンフィギュレーションサーバーの配置（SCCC とも呼ばれる）はサポートされなくなりました。次のAPIメソッドは SCCC コンフィギュレーションサーバーでのみ機能します。レプリカセットコンフィギュレーションサーバー（CSRS とも呼ばれます）は、1 つのクラスターのすべてのスナップショットを取得するメソッドを使用します。コンフィギュレーションサーバーはレプリカセットとしてデプロイする必要があります（CSRS とも呼ばれます）。詳細については、 MongoDB Serverマニュアルのレプリカセットコンフィギュレーションサーバーを参照してください。

ベース URL: https://cloud.mongodb.com/api/public/v1.0

Resource

GET /groups/{PROJECT-ID}/hosts/{HOST-ID}/snapshots

Request Parameters

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

名前	タイプ	説明
プロジェクトID	string	Unique identifier of the project that owns the snapshot.
ホスト ID	string	スナップショットが表すホストの一意の識別子。

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

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

名前	タイプ	必要性	説明	default
pageNum	数値	任意	結果のサブセクションを返す 1 から始まる整数。	`1`
itemsPerPage	数値	任意	1 ページあたりに返す項目の数は最大 500 です。	`100`
pretty	ブール値	任意	レスポンス本体を pretty-print形式にするかどうかを示すフラグ。	`false`
envelope	ブール値	任意	応答をエンベロープでラップするかどうかを示すフラグ。 Some API clients cannot access the HTTP response headers or status code. To remediate this, set `envelope : true` in the query. 結果のリストを返すエンドポイントの場合、 `content`オブジェクトはエンベロープです。 Cloud Manager は、レスポンス本体に`status`フィールドを追加します。	`false`
backupJobsEnabledOnly	ブール値	任意	データベースのバックアップ用に有効になっていないデーモンを応答から除外するかどうかを示すフラグ。これを`false`に設定し、 `backupJobsEnabled`フラグが`false`に設定されているデーモン構成を含めます。	`true`

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

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

応答

応答ドキュメント

The response JSON document includes an array of result objects, an array of link objects and a count of the total number of result objects retrieved.

名前	タイプ	説明
`results`	配列	配列には、`results` 埋め込みドキュメントセクションに詳細な項目ごとに 1 つのオブジェクトが含まれます。
`links`	配列	配列には、サブリソースや関連リソースへの 1 つ以上のリンクが含まれます。 URL 間の関係は、 Web リンク仕様で説明されています。
`totalCount`	数値	結果セット内の項目の合計数の整数。結果セット全体がページ分割される場合は、 results配列内のオブジェクト数よりも大きくなる可能性があります。

`results` embeddedDocument

各結果は 1 つのスナップショットです。

名前	タイプ	説明
clusterId	objectId	スナップショットが表すクラスターの ID。
completed	ブール値	スナップショットが作成されたことを示すインジケーター。スナップショット作成ジョブがまだ進行中の場合、これは`false`です。
作成済み	ドキュメント	The components of a timestamp.
created.date	タイムスタンプ	The exact point in time when the snapshot was taken in ISO 8601 date and time format at UTC.
created.increment	integer	このスナップショットが正確な時点で実行された操作順序。 MongoDB でタイムスタンプの仕組みについては、「タイムスタンプ」を参照してください。
doNotDelete	ブール値	スナップショットが削除できないことを示します。 `doNotDelete`が`true`に設定されている場合、 `expires`の値はすべて無視されます。
expires	タイムスタンプ	The date in ISO 8601 date and time format at UTC after which this snapshot can be deleted. `doNotDelete`が`true`に設定されている場合、 `expires`のすべての値が削除されます。 `expires`の値が現在の日時より前の場合は編集できなくなります。
グループ ID	objectId	ID of the project that owns the snapshot.
id	objectId	スナップショットの ID。
lastOplogApplyedTimestamp	ドキュメント	最後の oplog エントリのタイムスタンプのコンポーネントが適用されました。
lastOplogAppliedTimestamp.date	タイムスタンプ	The exact point in time when the last oplog was applied in ISO 8601 date and time format at UTC.
lastOplogAppliedTimestamp.increment	integer	この時点で正確なoplogが適用された操作順序。 MongoDB でタイムスタンプの仕組みについては、「タイムスタンプ」を参照してください。
Links	オブジェクト配列	サブリソースや関連リソースへの 1 つ以上のリンク。応答内のすべての `links` 配列には、`self` と呼ばれるリンクが少なくとも 1 つ含まれています。URLの関係は、Web リンク仕様で説明されています。
namespaceFilterList	オブジェクト配列	このスナップショットに含まれる、または除外される名前空間。
namespaceFilterList.filterList	string 配列	スナップショットに排他的に含まれる、またはスナップショットから明示的に除外されるデータベースまたは名前空間の任意の組み合わせのコンマ区切りリスト。デフォルト値は空の配列（ `[]` ）です。
namespaceFilterList.filterType	string	このスナップショットで名前空間をフィルタリングする方法を決定する値。この値が`denyList`に設定されている場合、 `namespaceFilterList.filterList`の名前空間はスナップショットから除外されます。この値が`accessList`に設定されている場合、 `namespaceFilterList.filterList`の名前空間のみがスナップショットに含まれます。デフォルト値は `denyList` です。
部分	オブジェクト配列	完全なスナップショットを構成する個々の部分。この配列には 1 つのドキュメントが含まれています。
operations.dataSizeBytes	数値	スナップショット内のデータの合計サイズ（バイト単位）。
operations.encryptionEnabled	ブール値	スナップショットデータの暗号化状態を示すインジケーター。
operations.fileSizeBytes	数値	データファイルの合計サイズ（バイト単位）。
operations.hostId	string	コンフィギュレーションサーバーの ID。
operations. MasterKeyUUID	objectId	The KMIP master key ID used to encrypt the snapshot data. `parts.masterKeyUUID` appears only if this snapshot has `parts.encryptionEnabled : true`.
operations.mongodVersion	string	スナップショットの作成時に実行されていた`mongod`のバージョン。
operations.storageSizeBytes	数値	ドキュメントストレージに割り当てられた領域の合計サイズ。
operations.typeName	string	部分が表すサーバーのタイプ。 `CONFIG_SERVER`

リクエストの例

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}/snapshots?pretty=true"

応答例

応答ヘッダー

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://https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}/snapshots?pretty=true&pageNum=1&itemsPerPage=100",
    "rel" : "self"
  } ],
  "results" : [ {
    "clusterId" : "{CLUSTER-ID}",
    "complete" : true,
    "created" : {
      "date" : "2016-08-21T23:47:38Z",
      "increment" : 1
    },
    "doNotDelete" : false,
    "expires" : "2017-08-20T23:47:38Z",
    "groupId" : "{PROJECT-ID}",
    "id" : "{SNAPSHOT-ID}",
    "lastOplogAppliedTimestamp" : {
      "date" : "2017-08-21T09:14:51Z",
      "increment" : 1
    },
    "links" : [ {
      "href" : "https://https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}/snapshots/{SNAPSHOT-ID}",
      "rel" : "self"
    } ],
    "namespaceFilterList" : {
      "filterList" : [ ],
      "filterType" : "denyList"
    },
    "parts" : [ {
      "clusterId" : "{CLUSTER-ID}",
      "compressionSetting" : "GZIP",
      "dataSizeBytes" : 503779557,
      "encryptionEnabled" : false,
      "fileSizeBytes" : 2855605344,
      "mongodVersion" : "4.0.9",
      "replicaSetName" : "proton",
      "storageSizeBytes" : 547516416,
      "typeName" : "REPLICA_SET"
    } ]
  }, {
  } ],
  "totalCount" : 28
}

戻る

1 つを削除

1 つの取得（コンフィギュレーションサーバー）