4 Nov 2024

Changes are coming for Autodesk Platform Services (APS) in the Australia Region

Default blog image

Attention APS developers. Do you use or intend to use APS APIs to access data stored in Australia region? Does your application need to support Autodesk Construction Cloud (ACC) in Australia region? Do you plan to use Object Storage Service (OSS) API to create a bucket and store data in Australia region? If so, please read on. Autodesk is making changes to certain APIs that access data stored in Australia region. These changes may impact your existing application.

As you may know, earlier this year, Autodesk announced the general availability of Autodesk Docs, Autodesk Build, Autodesk BIM Collaborate/Pro, and Autodesk Takeoff for primary storage of project data in the Australia region. The ACC API, Data Management API, Model Derivative API, Webhooks API and Viewer SDK have been available in beta. 

What is changing? 

In short, the official value used to indicate the Australia region will be AUS instead of APAC moving forward. This makes the location of data stored much clearer and aligns with business units. Currently, you may see some API endpoints take APAC as the value of region field. APAC as a region value will be deprecated. 

There are a few changes you may want to be aware of regarding regional support: 

  • ACC APIs and automatic region routing -- All ACC APIs now support automatic region routing. The endpoint you use for US works for all regions.  This will make the coding for future region expansion easy. The older admin API, that has separate endpoints for the EU region, will remain functional for backward compatibility. 
     
  • Region in Request -- For APIs that require a region field to be provided, both “AUS” and “APAC” should work now, however, “APAC” is a deprecated value.  If you are using endpoints that require explicit region value, please be aware. This applies to Data Management/Model Derivative/Webhooks API and Viewer; and to ACC APIs that take an optional region header. (Note: if you use AUS in a request, the region value in the response will be AUS. If you use APAC in a request, the response will be APAC.)    
     
  • Region in Response – Response body from the API call may include either “APAC” or “AUS” while transitioning to “AUS”. If your code requires information, you may want to check against both values in your code until the transition is completed.  
     
  • Viewer – Viewer version 7.100.0 and above support automatic region routing including Australia for models in Autodesk Docs.  
     

When does the change happen?

The changes mentioned above are expected to come according to the following timeline. To avoid disruption, please make the necessary changes.

  • Current (as of November 4, 2024) – region in requests will accept both AUS and APAC. 
     
  • On March 1, 2025 – region in responses will change to AUS. e.g., GET hubs 
     

Additional information 

You can find information related to the Australia regional offering and available products and tools from the following resource:

 

If you have any questions about API changes related to the Australia regional offering, feel free to contact us

ref. FDM-5163

Related Article