HP 3PAR StoreServ 7400 2-node HP 3PAR Web Service API 1.2 Developer's - Page 40

Volume policies Configuration Object, Volume Space Objects, Table 29 Volume, JSON Objects

Page 40 highlights

Volume policies Configuration Object The policies of a volume are specified by the policies JSON object, as detailed in Table 29 (page 40). Table 29 Volume policies JSON Objects Member staleSS Value Boolean Description true: Stale snapshots. If there is no space for a copy-on-write operation, the snapshot is allowed to go stale but the host write can proceed without an error. false: No stale snapshots. If there is no space for a copy-on-write operation, the host write will fail. oneHost Boolean true: This indicates a volume is constrained to export to one host or one host cluster. false: This indicates a volume exported to multiple hosts for use by a cluster-aware application, or when "port presents" VLUNs are used zeroDetect Boolean true: This indicates that the storage system will scan for zeros in the incoming write data. false: This indicates that the storage system will not scan for zeros in the incoming write data. system Boolean true: Special volume used by the system. false: Normal user volume caching Boolean This is a read-only policy and cannot be set. true: This indicates that the storage system is enabled for write caching, read caching, and read ahead for the volume false: This indicates that the storage system is disabled for write caching, read caching, and read ahead for the volume. Volume Space Objects The volume space is specified by the following three sub-objects, each of which uses the same members: • adminSpace • snapshotSpace • userSpace The members are listed in Table 30 (page 40). Table 30 Volume Space JSON Objects Member reservedMiB rawReservedMiB usedMiB freeMiB JSON Type number number number number API Type uint32 uint32 uint32 uint32 Description Reserved space in MiB. Raw reserved space in MiB. Used space in MiB. Free space in MiB. 40 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

Volume
policies
Configuration Object
The policies of a volume are specified by the
policies
JSON object, as detailed in
Table 29 (page
40)
.
Table 29 Volume
policies
JSON Objects
Description
Value
Member
true
: Stale snapshots. If there is no space for a
copy-on-write operation, the snapshot is allowed to
Boolean
staleSS
go stale but the host write can proceed without an
error.
false
: No stale snapshots. If there is no space for
a copy-on-write operation, the host write will fail.
true
: This indicates a volume is constrained to
export to one host or one host cluster.
Boolean
oneHost
false
: This indicates a volume exported to multiple
hosts for use by a cluster-aware application, or
when "port presents" VLUNs are used
true
: This indicates that the storage system will
scan for zeros in the incoming write data.
Boolean
zeroDetect
false
: This indicates that the storage system will
not scan for zeros in the incoming write data.
true
: Special volume used by the system.
Boolean
system
false
: Normal user volume
This is a read-only policy and cannot be set.
Boolean
caching
true
: This indicates that the storage system is
enabled for write caching, read caching, and read
ahead for the volume
false
: This indicates that the storage system is
disabled for write caching, read caching, and read
ahead for the volume.
Volume Space Objects
The volume space is specified by the following three sub-objects, each of which uses the same
members:
adminSpace
snapshotSpace
userSpace
The members are listed in
Table 30 (page 40)
.
Table 30 Volume Space JSON Objects
Description
API Type
JSON Type
Member
Reserved space in MiB.
uint32
number
reservedMiB
Raw reserved space in MiB.
uint32
number
rawReservedMiB
Used space in MiB.
uint32
number
usedMiB
Free space in MiB.
uint32
number
freeMiB
40
Working with Storage Volumes