...
While we strive to maintain upward compatibility with functional capabilities and output (csv and other formats), there are some changes that may impact scripting that depends on other text. The following documents some of the things to watch if you have automation scripts using the CLI.
| Info | ||||
|---|---|---|---|---|
| ||||
With release 6.8, the conversion to REST APIs has been completed! Legacy SOAP support (see below) is still available for a short period of time. With this change, we have built the foundation for additional improvements and capabilities not possible before. For those who are interested in more technical details: in some cases pseudo REST APIs (like RPC) are being used to cover cases where the official Confluence REST APIs still do not cover capabilities previous available in the SOAP APIs. It is expected Confluence REST APIs will add more coverage over time. |
Potential Incompatibilities
...
- Text of error messages may be different. In some cases, the error message from the underlying API is surfaced directly and these have been changed by Atlassian. In other cases, we are issue our own messages and these may have changed. We also have made some improvements in this area.
- The class of error may have changed. If your script is sensitive to the exact return value (-1 versus 3 versus -3 exit codes for example) then your script may need to be updated. Some errors formerly resulting from Confluence errors (error code -3) may now be intercepted and sent from the client (error code -1) likely with some additional information.
- login and logout actions will switch over to REST authentication instead of SOAP authentication
- Some parameter will be deprecated. Some are no longer available with the REST APIs and others have better replacement actions based on the newer support.
- search related parameters will be removed in favor of the more modern and powerful cql parameter
- removePage and removeBlog actions will require the --continue parameter to avoid failing on not found errors
Confluence Version Support
With the completion of this migration, CLI 7.0 will support Confluence 5.10 and higher. Legacy support will be completely removed. While it has been common practice in the past to successfully use newer CLI releases against older Confluence releases (not explicitly listed as being compatible), this will more like not be possible for many case. The older Confluence release may not support the newer REST APIs, so the action will fail.
Legacy Support
For a limited time only, you can use the --options legacy parameter to continue using the older support for most migrated support.
...