Retrieving Migration Status

After starting a migration, you can get information on its current status by sending a request packet with the get_status operation node which should include the migration unique identifier returned by the start operation.

In this chapter:

Request Packet Structure

Response Packet Structure

Sample

 

Request Packet Structure

A request XML packet retrieving information on the migration status includes the get_status operation node:

<packet version="1.6.0.2">
<migration>
  <get_status>
  ...
  </get_status>
</migration>
</packet>

The get_status node is presented by complex type MigrationId (migration_input.xsd), and its graphical representation is as follows:

 

Response Packet Structure

The get_status node of the response packet is structured as follows:

 

The migration_status node is structure as follows:

 

The finished node is structured as follows:

MigrationFinishedType

 

Sample

This packet retrieves the status of migration with ID 12345.

<packet version="1.6.0.2">
<migration>
   <get_status>
      <migration_id>12345</migration_id>
   </get_status>
</migration>
</packet> 

Response::

<packet version="1.6.0.2">
<migration>
<get_status>
   <result>
      <status>ok</status>
      <migration_status>
         <total>33</total>
         <completed>10</completed>
      </migration_status>
   </result>
</get_status>
</migration>
</packet>

Responses received from server where migration is successfully finished look as follows:

<packet version="1.6.0.2">
<migration>
<get_status>
   <result>
      <status>ok</status>
      <finished><success/></finished>
   </result>
</get_status>
</migration>
</packet>

 

<packet version="1.6.0.2">
<migration>
<get_status>
   <result>
      <status>ok</status>
      <finished>
         <success/>
      </finished>
   </result>
</get_status>
</migration>
</packet>

 

A response received from server where migration is finished with errors can look as follows:

<packet version="1.6.0.2">
<migration>
<get_status>
   <result>
      <status>ok</status>
      <finished>
         <error>
            <object>
               <type>domain</type>
               <name>example.com</name>
            </object>
            <message>Error in physical hosting updating: permission denied</message>
         </error>
      </finished>
   </result>
</get_status>
</migration>
</packet>

This packet retrieves the status of migrations with IDs 24175 and 24176.

<packet version="1.6.0.2">
<migration>
   <get_status>
      <migration_id>24175</migration_id>
   </get_status>
   <get_status>
      <migration_id>24176</migration_id>
   </get_status>
</migration>
</packet>