注意
グループとプロジェクトは同義語です。あなたの {PROJECT-ID} は、グループ IDと同じです。既存のグループの場合、グループ/グループ ID は同じままです。このページでは、説明を参照するときに、より一般的なタームのグループ を使用します。エンドポイントとなる接続されたデバイスは、ドキュメントに記載されているままです。
プロジェクトのすべてのインポート配置リクエストを検索します。このエンドポイントとなる接続されたデバイスは、指定されたプロジェクトに対して作成されたすべてのインポート配置リクエストの、現在のステータスや履歴を含むリストを返します。
重要
この機能は Ops Manager 8.0.13 以降で使用可能です。
必須のロール
このエンドポイントとなる接続されたデバイスにはProject Automation Adminロールが必要です。
エンドポイント
ベース URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
GET /automation/importDeployment/{PROJECT-ID}
リクエスト
path パラメータ
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
プロジェクトID | string | 必須 | プロジェクトの一意の識別子です。 |
クエリ パラメータ
次のクエリ パラメータは 任意です。
名前 | タイプ | 必要性 | 説明 | default |
|---|---|---|---|---|
pretty | ブール値 | 任意 | レスポンス本体をpretty-print形式にするかどうかを示すフラグ。 |
|
envelope | ブール値 | 任意 | 応答をエンベロープでラップするかどうかを示すフラグ。 一部のAPIクライアントは、 HTTPレスポンス ヘッダーまたはステータス コードにアクセスできません。 これを修正するには、クエリでenvelope=trueを設定します。 1 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。
|
|
ボディ パラメータ
このエンドポイントは、HTTP リクエスト本体パラメータを使用しません。
応答
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
結果 | 配列 | 常に | インポート配置リクエストオブジェクトの配列。 |
Result[n].id | string | 常に | インポート配置リクエストの一意の識別子です。 |
Result[n].groupId | string | 常に | プロジェクト識別子。 |
Result[n].userId | string | 常に | インポートリクエストを作成したユーザー。 |
Result[n]. State | string | 常に | インポートの現在の状態。可能な値は: |
Result[n].transitions履歴 | 配列 | 常に | この インポートリクエストの状態遷移の履歴。 |
Result[n].transitions履歴[n].状態 | string | 常に | 移行された状態。 |
[n].transitions履歴[n].transitionedAt | string | 常に | 移行が発生したときの ISO 8601 タイムスタンプ。 |
リクエストの例
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/automation/importDeployment/{PROJECT-ID}?pretty=true"
応答例
応答ヘッダー
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
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}
レスポンス本体
{ "results": [ { "id": "507f1f77bcf86cd799439011", "groupId": "507f1f77bcf86cd799439012", "userId": "507f1f77bcf86cd799439013", "state": "SUCCESS", "transitionsHistory": [ { "state": "PENDING", "transitionedAt": "2025-10-20T10:00:00.000Z" }, { "state": "AWAIT_SEED_HOST_CONNECTED", "transitionedAt": "2025-10-20T10:02:00.000Z" }, { "state": "SUCCESS", "transitionedAt": "2025-10-20T10:15:00.000Z" } ] } ] }