HP 3PAR Web Service API 1.3.1 Developer's Guide

Table 125 tasktypeEnum Enumeration for Single-Task Query (continued)
DescriptionValueSymbol
Track tasks that migrate data to the
local storage system.
17IMPORT_VV
Track physical copy of VV while online.18ONLINE_COPY
(createvvcopy -online command)
Track tasks that are converting a volume
from an FPVV to a TPVV and vice-versa.
19CONVERT_VV
Enumeration for the taskStatusEnum JSON object is shown in Table 126 (page 133).
Table 126 taskStatusEnum Enumeration for Physical-Copy Task Query
DescriptionValueSymbol
The task has finished.1DONE
The task is in progress.2ACTIVE
The task was canceled.3CANCELLED
The task failed.4FAILED
Single Copy Task Query Errors
Possible error codes following a single copy task query are shown in Table 127 (page 133). For
generic API error codes, see Table 5 (page 22).
Table 127 All-Tasks Status Query Error Codes
DescriptionHTTP CodeAPI Error
Task ID must be a positive value.400 Bad RequestINV_INPUT_BELOW_RANGE
Task ID is too large.400 Bad RequestINV_INPUT_EXCEEDS_RANGE
Task with the specified task ID does not
exist.
404 Not FoundNON_EXISTENT_TASK
Task ID is not an integer.400 Bad RequestINV_INPUT_WRONG_TYPE
Canceling a Task
To cancel a task, use the HTTP PUT method on the following URI:
https://<storage_system>:8080/api/v1/tasks/<task_ID>
For example, to cancel task 1, use the following URI:
PUT: https://<storage_system>:8080/api/v1/tasks/1
{"action":1}
Table 128 JSON Object Member for Canceling a Task
DescriptionIgnored ValuesAPI TypeJSON TypeMember
Specifies the action to
be performed on the
task.
Required field.taskAction Enumnumberaction
Enumeration for the taskAction Enum JSON object is defined with a single enumeration symbol,
as shown in Table 129 (page 134).
Getting Task Status 133