HP 3PAR StoreServ 7200 2-node HP 3PAR Web Service API 1.2 Developer's - Page 44

Modifying a Virtual Volume, Table 33 Base-volume and Snapshot-volume Creation Error Codes

Page 44 highlights

Table 33 Base-volume and Snapshot-volume Creation Error Codes (continued) API Error HTTP Code Description INV_INPUT_WARN_GT_LIMIT 400 Bad Request Allocation warning level is higher than the limit. INV_INPUT_USR_ALRT_NON_TPVV 400 Bad Request User space allocation alerts are valid only with TPVVs. INV_INPUT_RETAIN_GT_EXPIRE 400 Bad Request Retention time is greater than expiration time. INV_INPUT_VV_POLICY 400 Bad Request Invalid policy specification (for example, caching or system set to true). INV_INPUT_EXCEEDS_LENGTH 400 Bad Request Invalid input: string length exceeds limit. INV_INPUT_TIME 400 Bad Request Invalid time specified. EXISTENT_ID 409 Conflict ID exists. Modifying a Virtual Volume To modify or update a volume, use the HTTP PUT method in the URI: https://:8080/api/v1/volumes/ where is the name of the volume being modified. The message body is a JSON object with members. Members that can be included in a VV modification request are shown in Table 34 (page 44). Table 34 Message Body JSON Objects for Volume Modification Request Member newName JSON Type string API Type name31 Ignored Values None Description New name of the volume. (Since WSAPI 1.2) comment string print511 None Comment about the volume. (Since WSAPI 1.2) expirationHours number igint32 Zero and negative values Time in hours that the volume would expire. (Since WSAPI 1.2) retentionHours number igint32 Zero and negative values Time in hours that the volume would be retained. (Since WSAPI 1.2) policies object policies object None except caching Specify virtual volume and system, which are policies. ignored if false. (Since WSAPI 1.2) snapCPG string name31 None The snap CPG name. (Since WSAPI 1.2) ssSpcAllocWarningPct number igint32 Zero and negative values Snap space allocation warning percent. (Since WSAPI 1.2) ssSpcAllocLimitPct number igint32 Zero and negative values Snap space allocation limit percent. 44 Working with Storage Volumes

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107

Table 33 Base-volume and Snapshot-volume Creation Error Codes
(continued)
Description
HTTP Code
API Error
Allocation warning level is higher than the
limit.
400 Bad Request
INV_INPUT_WARN_GT_LIMIT
User space allocation alerts are valid only
with TPVVs.
400 Bad Request
INV_INPUT_USR_ALRT_NON_TPVV
Retention time is greater than expiration
time.
400 Bad Request
INV_INPUT_RETAIN_GT_EXPIRE
Invalid policy specification (for example,
caching or system set to true).
400 Bad Request
INV_INPUT_VV_POLICY
Invalid input: string length exceeds limit.
400 Bad Request
INV_INPUT_EXCEEDS_LENGTH
Invalid time specified.
400 Bad Request
INV_INPUT_TIME
ID exists.
409 Conflict
EXISTENT_ID
Modifying a Virtual Volume
To modify or update a volume, use the HTTP PUT method in the URI:
https://
<storage system>
:8080/api/v1/volumes/
<volume name>
where
<volume name>
is the name of the volume being modified. The message body is a JSON
object with members. Members that can be included in a VV modification request are shown in
Table 34 (page 44)
.
Table 34 Message Body JSON Objects for Volume Modification Request
Description
Ignored Values
API Type
JSON Type
Member
New name of the
volume.
None
name31
string
newName
(Since WSAPI 1.2)
Comment about the
volume.
None
print511
string
comment
(Since WSAPI 1.2)
Time in hours that the
volume would expire.
Zero and negative
values
igint32
number
expirationHours
(Since WSAPI 1.2)
Time in hours that the
volume would be
retained.
Zero and negative
values
igint32
number
retentionHours
(Since WSAPI 1.2)
Specify virtual volume
policies.
None except caching
and system, which are
ignored if false.
policies object
object
policies
(Since WSAPI 1.2)
The snap CPG name.
None
name31
string
snapCPG
(Since WSAPI 1.2)
Snap space allocation
warning percent.
Zero and negative
values
igint32
number
ssSpcAllocWarningPct
(Since WSAPI 1.2)
Snap space allocation
limit percent.
Zero and negative
values
igint32
number
ssSpcAllocLimitPct
44
Working with Storage Volumes