What is the difference between Atomic and Subatomic API calls?

Reply
L4 Transporter

What is the difference between Atomic and Subatomic API calls?

What is the difference between Atomic and Subatomic API calls?


Thanks!

L1 Bithead

Re: What is the difference between Atomic and Subatomic API calls?

When you generate API calls to push migrated objects or policies in Migration Tool 3 you have two options: Subatomic and Atomic.  Subatomic means you will generate API calls for each migrated object or policy individually, allowing you to pick and choose exactly which ones you would like to push.  This is helpful if there is an error with a particular API call and you want to ignore it and continue pushing the rest of your migrated objects or policies, or if you want to have more granularity in choosing what to push.  Atomic creates a single API call containing all of a particular object or policy.  For instance, if you have 100 address objects, with Subatomic, you will create 100 API calls, one for each.  With Atomic, you will create a single API call that includes all 100 objects.  This is more useful when migrating lots of policies or objects because it's more streamlined; you may run into trouble in the Migration Tool if you tell it to push hundreds of Subatomic objects at the same time.

Examples:

Subatomic:

SET          /config/devices/entry[@name='localhost.localdomain']/device-group/entry[@name='Test-Devicegroup']/address

API Call 1: <entry name="Test-Object1"><ip-netmask>1.1.1.1/32</ip-netmask></entry>

API Call 2: <entry name="Test-Object2"><ip-netmask>2.2.2.2/32</ip-netmask></entry>

API Call 3: <entry name="Test-Object3"><ip-netmask>3.3.3.3/32</ip-netmask></entry>

Each address object is a separate API call.

Atomic:

SET          /config/devices/entry[@name='localhost.localdomain']/device-group/entry[@name='Test-Devicegroup']/address

API Call 1: <entry name="Test-Object1"><ip-netmask>1.1.1.1/32</ip-netmask></entry><entry name="Test-Object2"><ip-netmask>2.2.2.2/32</ip-netmask></entry><entry name="Test-Object3"><ip-netmask>3.3.3.3/32</ip-netmask></entry>

The address objects are summarized into a single API call.

Like what you see?

Show your appreciation!

Click Like if a post is helpful to you or if you just want to show your support.

Click Accept as Solution to acknowledge that the answer to your question has been provided.

The button appears next to the replies on topics you’ve started. The member who gave the solution and all future visitors to this topic will appreciate it!

These simple actions take just seconds of your time, but go a long way in showing appreciation for community members and the Live Community as a whole!

The Live Community thanks you for your participation!