Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

CloudStack has the concept of executing certain API calls asynchronously when they take a long period of time to complete. They will immediately return a job id of the job that will be responsible for executing the command. This job id can be used to query the status of the job by using the queryAsyncJobResult application programming interface (API) call.
Among other fields, the result of this API query returns the 'created' field, which is the timestamp of when an asynchronous job started. There is currently Before this feature, there was no functional mechanism that captures or persists captured and persisted the end time of when the an asynchronous job has finished. As a result, the "queryAsyncJobResult" API does did not return an 'end_timeendtime' field.

API

  • Cloudstack now captures the job end timestamp of when the asynchronous job has finished and populates this into the existing database field called 'removed' in the async_job table. 
  • Please note the 'removed' field is not currently being used anywhere else in the CloudStack code, and the 'removed' database column is also not currently being populated by any other processes. 
  • A new response tag is added to the queryAsyncJobResult API called 'endtime'. 
  • When making a queryAsyncJobResult API request, the value of the database column 'removed' is now mapped to this 'end_time' response tag. 
  • The queryAsyncJobResult API field is called 'endtime' instead of 'removed' because it will be more descriptive to an API user.

...