1 つの配置リージョンを取得する

項目一覧

Resource

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

注意

グループとプロジェクトは同義語です。あなたの {PROJECT-ID}はプロジェクト ID と同じです。既存のグループの場合、グループ/プロジェクト ID は同じままです。このページでは、説明を参照するときに、より一般的な用語のグループを使用します。エンドポイントはドキュメントに記載されているままです。

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

Resource

GET /admin/backup/backupDeployments/{DEPLOYMENT-ID}

Request Parameters

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

Parameter	タイプ	必要性	説明
配置 ID	string	必須	構成内の配置リージョンを参照する一意の識別子です。

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

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

名前	タイプ	必要性	説明	default
pageNum	数値	任意	結果のサブセクションを返す 1 から始まる整数。	`1`
itemsPerPage	数値	任意	1 ページあたりに返す項目の数は最大 500 です。	`100`
pretty	ブール値	任意	レスポンス本体を pretty-print に含めるかどうかを示すフラグ形式。	`false`
envelope	ブール値	任意	応答をエンベロープでラップするかどうかを示すフラグ。一部の APIクライアントは、 HTTPレスポンスヘッダーまたはステータスコードにアクセスできません。これを修正するには、クエリで`envelope : true`を設定します。結果のリストを返すエンドポイントの場合、 `content`オブジェクトはエンベロープです。 MongoDB Ops Manager は、レスポンス本体に`status`フィールドを追加します。	`false`

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

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

応答

名前	タイプ	説明
`assignmentEnabled`	ブール値	バックアップリソースに配置リージョンを割り当てられるかどうかを示すフラグ。
`bqProxyEndpoint`	string	MongoDB Ops Managerクエリ可能なバックアップリクエストを提供するのインスタンス。値の形式は次のとおりです: `domain:port` 。たとえば、 `localhost:8080` 。
`deploymentDescription`	string	配置リージョンの目的を説明するstring 。
`id`	string	構成内のこの配置リージョンを参照する一意の識別子。
`ingestionEndpoint`	string	MongoDB Ops Managerバックアップエージェントがスナップショットまたはoplog データを書き込むインスタンス。値は、 `http://www.mongodb.com`などの有効なURLです。 HTTPとHTTPSの両方をサポートします。
`links`	オブジェクト配列	サブリソースや関連リソースへの 1 つ以上のリンク。応答内のすべての`links`配列には、 `self`と呼ばれるリンクが少なくとも 1 つ含まれています。 URL の関係は、 Web リンク仕様で説明されています。
`restoreEndpoint`	string	復元リクエストを提供する MongoDB Ops Manager インスタンス

リクエストの例

curl --user "{publicKey}:{privateKey}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET "https://{opsManagerHost}:{port}/api/public/v1.0/admin/backup/backupDeployments/NY_NJ?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}

レスポンス本体

1 {
2    "assignmentEnabled" : true,
3    "bqProxyEndpoint" : "queryable-backup.mongodb.com:27217",
4    "deploymentDescription" : "Eastern US",
5    "id" : "NY_NJ",
6    "ingestionEndpoint" : "https://api-backup.mongodb.com",
7    "links" : [ ],
8    "restoreEndpoint" : "https://api-backup.mongodb.com"
9 }

戻る

すべての配置リージョンを取得する

1 つの配置リージョンを作成

1	{
2	"assignmentEnabled" : true,
3	"bqProxyEndpoint" : "queryable-backup.mongodb.com:27217",
4	"deploymentDescription" : "Eastern US",
5	"id" : "NY_NJ",
6	"ingestionEndpoint" : "https://api-backup.mongodb.com",
7	"links" : [ ],
8	"restoreEndpoint" : "https://api-backup.mongodb.com"
9	}

注意