Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.
Red Hat Satellite engineering is moving the tracking of its product development work on Satellite to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "Satellite project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs will be migrated starting at the end of May. If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "Satellite project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/SAT-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.

Bug 2208467

Summary: [RFE] Provide list of changes in API calls between major releases
Product: Red Hat Satellite Reporter: Stefan Nemeth <snemeth>
Component: APIAssignee: Adam Lazik <alazik>
Status: CLOSED CURRENTRELEASE QA Contact: Satellite QE Team <sat-qe-bz-list>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 6.14.0CC: ahumbe, alazik, lblicha, momran, pmoravec
Target Milestone: UnspecifiedKeywords: Documentation, Triaged
Target Release: Unused   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2023-12-04 11:19:06 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Stefan Nemeth 2023-05-19 07:40:56 UTC
Document URL: 

none yet

Section Number and Name: 

Describe the issue: 

If we make change in API, even a small one like changing environment_id (in 6.7) to environment_ids (6.8+ ) for example, customers have no chance to know this, before upgrade breaks their scripts. 

Suggestions for improvement: 

Having just a list of what have changed in API calls between versions, would be sufficient, so scripts can be updated with new api calls, no extra documentation or explanation why was this done is needed.

Comment 3 Adam Lazik 2023-08-08 14:03:26 UTC
Hi!
I am currently in the process of figuring out the potential changes in number/type of some API endpoints. I will update this ticket once I have more concrete info on the subject.

Comment 5 Adam Lazik 2023-09-26 10:15:30 UTC
New API endpoints:
/api/hostgroups/:id/ansible_roles/:ansible_role_id
/api/hosts/:id/ansible_roles/:ansible_role_id
/api/organizations/:organization_id/rh_cloud/missing_hosts
/katello/api/repositories/:repository_id/sync
/api/webhooks/:id/test

Removed API endpoints:
/katello/api/package_group
/katello/api/organizations/:organization_id/products/:product_id/sync

I will now confirm the function of each added and removed endpoint and than add it to the release notes.

Comment 7 Adam Lazik 2023-10-09 01:58:01 UTC
After discussion with Marie Hornickova, we decided to have separate lists for added, fixed, and removed endpoints to preserve our release note structure. the release notes will be in sections New features, Bufixes, and Removed functionality respectively.
I will reuse https://bugzilla.redhat.com/show_bug.cgi?id=2164400 to introduce the added endpoints, since two of them are already documented there and it will avoid duplication of information. I will use this ticket for the fixed endpoint. For the removed endpoints, I have created https://issues.redhat.com/browse/SAT-20654. All three release notes are currently undergoing final writer review. The current form is in this document: https://docs.google.com/document/d/1-vxqeTHdQKxkVlW_pWhQx3kzbYBsL03wmeN2bnTZk2A/edit.

Comment 9 Adam Lazik 2023-10-10 12:55:30 UTC
For some reason, word "Jira" causes some weird stuff to happen with links on this page, thus for the fixed endpoint find "katello/api/repositories/:repository_id/sync now correctly obtains repository synchronization status" in https://dxp-docp-prod.apps.ext-waf.spoke.prod.us-west-2.aws.paas.redhat.com/documentation/en-us/red_hat_satellite/6.14/html-single/release_notes/index?lb_target=preview#bug-fixes
and for the removed endpoints find "Removed API endpoints" in https://dxp-docp-prod.apps.ext-waf.spoke.prod.us-west-2.aws.paas.redhat.com/documentation/en-us/red_hat_satellite/6.14/html-single/release_notes/index?lb_target=preview#removed-functionality