7.24. trigger

7.24.1. activateBuildTrigger
リンクのコピー

指定したビルドトリガーをアクティブにします。

POST /api/v1/repository/{repository}/trigger/{trigger_uuid}/activate

認可: oauth2_implicit(repo:admin)

パスパラメーター

Expand

タイプ	名前	説明	スキーマ
path	trigger_uuid 必須	ビルドトリガーの UUID	string
path	repository 必須	リポジトリーの完全パス (例: namespace/name)	string

要求の body スキーマ (application/json)

Expand

名前	説明	スキーマ
config 必須	任意の json	object
pull_robot 任意	イメージのプルに使用するロボットの名前	string

レスポンス

Expand

HTTP コード	説明	スキーマ
201	作成に成功
400	Bad Request (不適切な要求)	ApiError
401	セッションが必要	ApiError
403	不正アクセス	ApiError
404	結果が見つからない	ApiError

コマンドの例

curl -X POST "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid/activate" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "config": {
      "branch": "main"
    },
    "pull_robot": "example+robot"
  }'

$ curl -X POST "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid/activate" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "config": {
      "branch": "main"
    },
    "pull_robot": "example+robot"
  }'

Copy to Clipboard

Toggle word wrap

7.24.2. listTriggerRecentBuilds
リンクのコピー

指定したトリガーで開始するビルドをリスト表示します。

GET /api/v1/repository/{repository}/trigger/{trigger_uuid}/builds

認可: oauth2_implicit(repo:admin)

パスパラメーター

Expand

タイプ	名前	説明	スキーマ
path	trigger_uuid 必須	ビルドトリガーの UUID	string
path	repository 必須	リポジトリーの完全パス (例: namespace/name)	string

クエリーパラメーター

Expand

タイプ	名前	説明	スキーマ
query	limit 任意	返すビルドの最大数	integer

レスポンス

Expand

HTTP コード	説明	スキーマ
200	正常な呼び出し
400	Bad Request (不適切な要求)	ApiError
401	セッションが必要	ApiError
403	不正アクセス	ApiError
404	結果が見つからない	ApiError

コマンドの例

curl -X GET "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid/builds?limit=10" \
  -H "Authorization: Bearer <your_access_token>"

$ curl -X GET "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid/builds?limit=10" \
  -H "Authorization: Bearer <your_access_token>"

Copy to Clipboard

Toggle word wrap

7.24.3. manuallyStartBuildTrigger
リンクのコピー

指定したトリガーからビルドを手動で開始します。

POST /api/v1/repository/{repository}/trigger/{trigger_uuid}/start

認可: oauth2_implicit(repo:admin)

パスパラメーター

Expand

タイプ	名前	説明	スキーマ
path	trigger_uuid 必須	ビルドトリガーの UUID	string
path	repository 必須	リポジトリーの完全パス (例: namespace/name)	string

要求の body スキーマ (application/json)

ビルドトリガーをアクティベートするための実行パラメーター (任意)

Expand

名前	説明	スキーマ
branch_name 任意	(SCM のみ) 指定した場合のビルドするブランチの名前。	string
commit_sha 任意	(カスタムのみ) 指定されている場合は、git リポジトリーのチェックアウトに使用する ref/SHA1。	string
refs 任意	(SCM のみ) 指定されている場合のビルドの ref。

レスポンス

Expand

HTTP コード	説明	スキーマ
201	作成に成功
400	Bad Request (不適切な要求)	ApiError
401	セッションが必要	ApiError
403	不正アクセス	ApiError
404	結果が見つからない	ApiError

コマンドの例

curl -X POST "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid/start" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "branch_name": "main",
    "commit_sha": "abcdef1234567890",
    "refs": "refs/heads/main"
  }'

$ curl -X POST "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid/start" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "branch_name": "main",
    "commit_sha": "abcdef1234567890",
    "refs": "refs/heads/main"
  }'

Copy to Clipboard

Toggle word wrap

7.24.4. getBuildTrigger
リンクのコピー

指定したビルドトリガーの情報を取得します。

GET /api/v1/repository/{repository}/trigger/{trigger_uuid}

認可: oauth2_implicit(repo:admin)

パスパラメーター

Expand

タイプ	名前	説明	スキーマ
path	trigger_uuid 必須	ビルドトリガーの UUID	string
path	repository 必須	リポジトリーの完全パス (例: namespace/name)	string

レスポンス

Expand

HTTP コード	説明	スキーマ
200	正常な呼び出し
400	Bad Request (不適切な要求)	ApiError
401	セッションが必要	ApiError
403	不正アクセス	ApiError
404	結果が見つからない	ApiError

コマンドの例

curl -X GET "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid" \
  -H "Authorization: Bearer <your_access_token>"

$ curl -X GET "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid" \
  -H "Authorization: Bearer <your_access_token>"

Copy to Clipboard

Toggle word wrap

7.24.5. updateBuildTrigger
リンクのコピー

指定したビルドトリガーを更新します。

PUT /api/v1/repository/{repository}/trigger/{trigger_uuid}

認可: oauth2_implicit(repo:admin)

パスパラメーター

Expand

タイプ	名前	説明	スキーマ
path	trigger_uuid 必須	ビルドトリガーの UUID	string
path	repository 必須	リポジトリーの完全パス (例: namespace/name)	string

要求の body スキーマ (application/json)

ビルドトリガーを更新するオプション

Expand

名前	説明	スキーマ
enabled 必須	ビルドトリガーが有効かどうか。	boolean

レスポンス

Expand

HTTP コード	説明	スキーマ
200	正常な呼び出し
400	Bad Request (不適切な要求)	ApiError
401	セッションが必要	ApiError
403	不正アクセス	ApiError
404	結果が見つからない	ApiError

コマンドの例

curl -X PUT "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}'

$ curl -X PUT "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}'

Copy to Clipboard

Toggle word wrap

7.24.6. deleteBuildTrigger
リンクのコピー

指定したビルドトリガーを削除します。

DELETE /api/v1/repository/{repository}/trigger/{trigger_uuid}

認可: oauth2_implicit(repo:admin)

パスパラメーター

Expand

タイプ	名前	説明	スキーマ
path	trigger_uuid 必須	ビルドトリガーの UUID	string
path	repository 必須	リポジトリーの完全パス (例: namespace/name)	string

レスポンス

Expand

HTTP コード	説明	スキーマ
204	削除済み
400	Bad Request (不適切な要求)	ApiError
401	セッションが必要	ApiError
403	不正アクセス	ApiError
404	結果が見つからない	ApiError

コマンドの例

curl -X DELETE "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid" \
  -H "Authorization: Bearer <your_access_token>"

$ curl -X DELETE "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/example-trigger-uuid" \
  -H "Authorization: Bearer <your_access_token>"

Copy to Clipboard

Toggle word wrap

7.24.7. listBuildTriggers
リンクのコピー

指定したリポジトリーのトリガーをリスト表示します。

GET /api/v1/repository/{repository}/trigger/

認可: oauth2_implicit(repo:admin)

パスパラメーター

Expand

タイプ	名前	説明	スキーマ
path	repository 必須	リポジトリーの完全パス (例: namespace/name)	string

レスポンス

Expand

HTTP コード	説明	スキーマ
200	正常な呼び出し
400	Bad Request (不適切な要求)	ApiError
401	セッションが必要	ApiError
403	不正アクセス	ApiError
404	結果が見つからない	ApiError

コマンドの例

curl -X GET "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/" \
  -H "Authorization: Bearer <your_access_token>"

$ curl -X GET "https://quay-server.example.com/api/v1/repository/example_namespace/example_repo/trigger/" \
  -H "Authorization: Bearer <your_access_token>"

Copy to Clipboard

Toggle word wrap

7.24.1. activateBuildTriggerリンクのコピーリンクがクリップボードにコピーされました!

POST /api/v1/repository/{repository}/trigger/{trigger_uuid}/activate

パスパラメーター

要求の body スキーマ (application/json)

レスポンス

コマンドの例

7.24.2. listTriggerRecentBuildsリンクのコピーリンクがクリップボードにコピーされました!

GET /api/v1/repository/{repository}/trigger/{trigger_uuid}/builds

パスパラメーター

クエリーパラメーター

レスポンス

コマンドの例

7.24.3. manuallyStartBuildTriggerリンクのコピーリンクがクリップボードにコピーされました!

POST /api/v1/repository/{repository}/trigger/{trigger_uuid}/start

パスパラメーター

要求の body スキーマ (application/json)

レスポンス

コマンドの例

7.24.4. getBuildTriggerリンクのコピーリンクがクリップボードにコピーされました!

GET /api/v1/repository/{repository}/trigger/{trigger_uuid}

パスパラメーター

レスポンス

コマンドの例

7.24.5. updateBuildTriggerリンクのコピーリンクがクリップボードにコピーされました!

PUT /api/v1/repository/{repository}/trigger/{trigger_uuid}

パスパラメーター

要求の body スキーマ (application/json)

レスポンス

コマンドの例

7.24.6. deleteBuildTriggerリンクのコピーリンクがクリップボードにコピーされました!

DELETE /api/v1/repository/{repository}/trigger/{trigger_uuid}

パスパラメーター

レスポンス

コマンドの例

7.24.7. listBuildTriggersリンクのコピーリンクがクリップボードにコピーされました!

GET /api/v1/repository/{repository}/trigger/

パスパラメーター

レスポンス

コマンドの例

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

7.24.1. activateBuildTrigger
リンクのコピー

7.24.2. listTriggerRecentBuilds
リンクのコピー

7.24.3. manuallyStartBuildTrigger
リンクのコピー

7.24.4. getBuildTrigger
リンクのコピー

7.24.5. updateBuildTrigger
リンクのコピー

7.24.6. deleteBuildTrigger
リンクのコピー

7.24.7. listBuildTriggers
リンクのコピー