第3章 API の使用規則
Automation Controller は、サーバー上の /api/ をルートとする標準の REST API を使用します。
互換性の理由から、API はバージョン管理されています。/api/ をクエリーすると、利用可能な API バージョンを確認できます。
POST または PUT 要求でコンテンツまたはタイプを指定する必要がある場合があります。
-
PUT: 特定のリソース (識別子によって) またはリソースのコレクションを更新します。事前にリソース識別子がわかっている場合は、PUTを使用して特定のリソースを作成することもできます。 -
POST: 新しいリソースを作成します。また、他のカテゴリーに該当しない演算用の汎用動詞としても機能します。
"/" で終わらない URI はすべて 301 リダイレクトを返します。
注記
ジョブテンプレートレコードに割り当てられる extra_vars のフォーマットが保持されます。YAML は YAML として返され、フォーマットとコメントが保持され、JSON は JSON として返されます。