機械翻訳について

移動先

• リクエスト
• レスポンス

チームのプロジェクトのリスト

get

/api/v2/teams/{id}/projects/

このリソースに対してGETリクエストを行って、選択したチームに関連付けられたプロジェクトのリストを取得します。

結果のデータ構造には次が含まれます。

{
    "count": 99,
    "next": null,
    "previous": null,
    "results": [
        ...
    ]
}

countフィールドは、対象となる問合せで見つかったプロジェクトの合計数を示します。 nextフィールドとpreviousフィールドには、結果が1ページに収まらない場合に、追加の結果へのリンクが表示されます。 resultsリストには、0個以上のプロジェクト・レコードが含まれます。

結果

それぞれのプロジェクトのデータ構造には次のフィールドが含まれます。

• id: このプロジェクトのデータベースID。(整数)
• type: このプロジェクトのデータ型。(選択)
• url: このプロジェクトのURL。(文字列)
• related: 関連リソースのURLを含むデータ構造。(オブジェクト)
• summary_fields: 関連リソースの名前/説明を含むデータ構造。 一部のオブジェクトの出力は、パフォーマンス上の理由によって制限される場合があります。(オブジェクト)
• created: このプロジェクトが作成されたときのタイムスタンプ。(日時)
• modified: このプロジェクトが最後に変更されたときのタイムスタンプ。(日時)
• name: このプロジェクトの名前。(文字列)
• description: このプロジェクトのオプションの説明。(文字列)
• local_path: このプロジェクトのプレイブックおよび関連ファイルを含む(PROJECTS_ROOTに対して相対的な)ローカル・パス。(文字列)
• scm_type: プロジェクトを格納するために使用するソース・コントロール・システムを指定します。(選択)
  • "": 手動
  • git: Git
  • hg: Mercurial
  • svn: Subversion
  • insights: Red Hat Insights
  • archive: リモート・アーカイブ
• scm_url: プロジェクトが格納される場所。(文字列)
• scm_branch: チェックアウトする特定のブランチ、タグまたはコミット。(文字列)
• scm_refspec: gitプロジェクトについて、フェッチする追加のrefspec。(文字列)
• scm_clean: プロジェクトを同期化する前にローカルの変更を破棄します。(ブール)
• scm_delete_on_update: 同期化する前にプロジェクトを削除します。(ブール)
• credential: (id)
• timeout: タスクが取り消されるまでの実行時間(秒)。(整数)
• scm_revision: プロジェクト更新によってフェッチされた最後のリビジョン(文字列)
• last_job_run: (日時)
• last_job_failed: (ブール)
• next_job_run: (日時)
• status: (選択)
  • new: 新規
  • pending: 保留中
  • waiting: 待機中
  • running: 実行中
  • successful: 成功
  • failed: 失敗
  • error: エラー
  • canceled: 取消し済
  • never updated: 更新なし
  • ok: OK
  • missing: 不明
• organization: このテンプレートへのアクセス権を決定するために使用される組織。(id)
• scm_update_on_launch: プロジェクトを使用するジョブが起動されたときにプロジェクトを更新します。(ブール)
• scm_update_cache_timeout: 最後のプロジェクト更新が実行された何秒後に、新しいプロジェクト更新がジョブの依存関係として起動されるか。(整数)
• allow_override: このプロジェクトを使用するジョブ・テンプレートでSCMブランチまたはリビジョンの変更を許可します。(ブール)
• custom_virtualenv: 使用するカスタムPython virtualenvを含むローカルの絶対ファイル・パス(文字列)
• last_update_failed: (ブール)
• last_updated: (日時)

ソート

プロジェクトが特定の順序で返されるように指定するには、GETリクエストでorder_by問合せ文字列パラメータを使用します。

?order_by=name

フィールド名の先頭にダッシュ-を付けると逆の順序でソートされます。

?order_by=-name

フィールド名をカンマ,で区切ると、複数のソート・フィールドを指定できます。

?order_by=name,some_other_field

ページ区切り

リクエストごとに返される結果の数を変更するには、page_size問合せ文字列パラメータを使用します。 特定のページの結果を取得するには、page問合せ文字列パラメータを使用します。

?page_size=100&page=2

結果で返されるpreviousリンクおよびnextリンクは、これらの問合せ文字列パラメータを自動的に設定します。

検索

モデルのすべての指定テキスト・フィールド内で大/小文字を区別しない検索を実行するには、search問合せ文字列パラメータを使用します。

?search=findme

(Ansible Tower 3.1.0で追加)関連フィールド全体を検索します。

?related__search=findme

リクエスト

サポートされているメディア・タイプ

• application/json

パス・パラメータ

• id: 文字列

問合せパラメータ

• page(オプション): 整数
  ページ区切りが設定された結果セット内のページ番号。
• page_size(オプション): 整数
  ページごとに返す結果の数。
• search(オプション): 文字列
  検索条件。

先頭に戻る

レスポンス

200レスポンス

先頭に戻る