Chapter 7. API changes in Ansible Automation Platform 2.6
Ansible Automation Platform 2.5 and 2.6 include changes to API endpoints with the addition of platform gateway. Versions 2.5 and 2.6 expose API access to individual services (automation controller, private automation hub, Event-Driven Ansible) to maintain compatibility with existing REST API integrations. This access will be removed in a future release.
These changes impact your organization if you have 2.4 API calls implemented directly with automation controller or private automation hub, or if you are integrating directly with automation controller or private automation hub hosts. You can use API endpoints exposed through the platform gateway for all Ansible Automation Platform services starting with Ansible Automation Platform 2.5. Moving integrations to API endpoints exposed through the platform gateway that your integrations are not disrupted when direct service API access is removed in a future Ansible Automation Platform release.
This section highlights the changed APIs between 2.4 and 2.5 or 2.6. For detailed API reference information, see the following sources:
-
For platform gateway APIs, see the browsable API at
https://<gateway server name>/api/gateway/v1
. -
For automation controller APIs, see the browsable API at
https://<gateway server name>/api/controller/v2
. - For automation hub APIs, see Automation Hub API in API Catalog and Documentation to reference the 2.4 automation hub API.
-
For Event-Driven Ansible, see the browsable API at
https://<gateway server name>/api/eda/v1
.
7.1. General changes Copy linkLink copied to clipboard!
In Ansible Automation Platform 2.5 and later, API endpoints across components changed with the addition of platform gateway.
Component | 2.4 and earlier endpoints start with… | 2.5 and later endpoints start with… | Notes |
---|---|---|---|
Automation controller |
|
| |
Automation hub |
|
|
This is the default path, but this path can be changed. For example: |
Platform gateway | Not applicable |
| |
Event-Driven Ansible | Not applicable |
|
7.2. Specific API changes Copy linkLink copied to clipboard!
Specific API mappings for functionality that was centralized through the platform gateway are listed in the following table.
Component | 2.4 and earlier endpoints start with… | 2.5 and 2.6 API endpoints | Action needed and notes |
---|---|---|---|
Automation controller |
|
| Token authentication has moved to the platform gateway. The 2.4 API endpoint is deprecated; it still works in 2.6, but it will not work in a future release. |
Automation controller |
|
| Moved to the platform gateway. The 2.4 API endpoint is deprecated; it still works in 2.6, but it will not work in a future release. |
Automation controller |
|
| Moved to the platform gateway. The 2.4 API endpoint is deprecated; it still works in 2.6, but it will not work in a future release. |
Automation controller |
|
| Moved to the platform gateway. The 2.4 API endpoint is deprecated; it still works in 2.6, but it will not work in a future release. |
Automation controller |
|
| Moved to the platform gateway. This is a list of roles. In Ansible Automation Platform 2.6, this is a list of roles which can apply to all services, and includes custom roles. The 2.4 API endpoint is only a listing. It still works in 2.6, but it will not work in a future release. |
Automation controller |
|
| A POST request gives a user a role to a resource. This is how to give user permissions. The 2.4 API endpoint is only a listing. It still works in 2.6, but it will not work in a future release. |
Automation controller | The following roles list:
|
| List user and team permissions, and give new permissions. The 2.4 API endpoint is only a listing. It still works in 2.6, but it will not work in a future release. |
Automation controller | The following object roles list:
Example: |
Example: | List the roles that apply to a resource. |
Automation controller | The following resource access list:
Example: |
Replacement in 2.6:
Example: | List the users who have access to a resource. |
Automation hub |
|
| Moved to the platform gateway. |
Automation hub |
|
| Token authentication used for pulling collections will migrate to the platform gateway tokens. |
Event-Driven Ansible | N/A |
| No action needed, as upgrades from 2.4 are not supported. |
Event-Driven Ansible | N/A |
| No action needed, as upgrades from 2.4 are not supported. |
Event-Driven Ansible | N/A |
| No action needed, as upgrades from 2.4 are not supported. |
Event-Driven Ansible | N/A |
| New role capabilities included as part of the platform gateway API. |