Clear vManage Stuck Task with an API Call

Available Languages

Download Options

PDF (78.7 KB)
View with Adobe Reader on a variety of devices
ePub (154.3 KB)
View in various apps on iPhone, iPad, Android, Sony Reader, or Windows Phone
Mobi (Kindle) (111.4 KB)
View on Kindle device or Kindle app on multiple devices

Updated:October 18, 2019

Document ID:214660

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Introduction

Background Information

Clear vManage Stuck Task with an API Call

Introduction

This document describes how to clear a vManage task that has been stuck with the help of an API Call.

Background Information

Stuck Task is a task that was scheduled and was not completed when the action is done on vManage. If the vManage is 16.3+ and newer, you can clear a stuck task. Examples include software image push to the vEdge (software upgrade) that takes too long or also if the template push to the device does not succeed. Stuck Task(s) can be seen on the "Tasks" view on vManage Dashboard.

You need to have netadmin privilege level to be able to use the required API call. Typically default user admin is a member of this group and sufficient.

Clear vManage Stuck Task with an API Call

Here is the example of the API call that you should use to get information about currently scheduled (and probably stuck) tasks:

https://<vmanage-ip:8443>/dataservice/device/action/status/tasks

And here is the output:

When you run the command Process_ID, the value will be shown as in the "running tasks" capture. Take the value and input after clean?processId= part of the URL in this URL; https://<vmanage-ip:8443>/dataservice/device/action/status/tasks/clean?processId=<id_from_previous_call>.

The result will be as shown in the image.