3. 表記規則¶

Ansible Automation Platform コントローラーでは標準 REST API を使用し、サーバー上の /api/ をルートとします。API は互換性の目的でバージョンが分けられており、api/v2/ が最新版です。/api/ にクエリーを実行すると、利用可能な API バージョンの情報が確認できます。

/api/v1/ は、automation controller バージョン 3.6 の時点で廃止になりました。v1 の詳細は、以前の API バージョンを参照してください。

バージョンに合わせて、POST または PUT 要求でのコンテンツ/タイプを指定する必要がある場合があります。

• PUT: Update a specific resource (by an identifier) or a collection of resources. PUT can also be used to create a specific resource if the resource identifier is known before-hand.

• POST: 新しいリソースを作成します。他のカテゴリーに該当しない演算用の汎用動詞としても機能します。

"/" で終わらない URI はすべて 301 リダイレクトを返します。