HP 3PAR StoreServ 7450 4-node HP 3PAR Web Service API 1.2 Developer's - Page 43
Volume Creation Success, Volume Creation Errors
View all HP 3PAR StoreServ 7450 4-node manuals
Add to My Manuals
Save this manual to your list of manuals |
Page 43 highlights
is the name of the volume being copied. Message Body Members When creating a snapshot volume, the message body is a JSON object with two members, action and parameters. The action member is a string with the value createSnapshot and the parameters member is a JSON object with members as described in Table 32 (page 43). When creating a snapshot volume, isCopy is set to true and name and copyofName are required. Table 32 Message Body parameters JSON Object Members for Snapshot-volume Creation Member name id comment readOnly JSON Type API Type string name31 number igint32 string print511 Boolean Boolean Ignored values None (Required) Negative values None None Description Specifies a snapshot VV name up to 31 characters in length. Specifies the ID of the volume. If not specified, the next available ID is chosen. Specifies any additional information up to 511 characters for the volume. true: Specifies that the copied volume is read-only. false: (default) The volume is read-write. expirationHours number igint32 retentionHours number igint32 Negative values Negative values Specifies the relative time from the current time that the volume will expire. Value is a positive integer and in the range of 1-43,800 hours, or 1825 days. Specifies the relative time from the current time that the volume will expire. Value is a positive integer and in the range of 1-43,800 hours, or 1825 days. Volume Creation Success A successful operation returns the HTTP status code 200 OK. There is no message body. Upon successful creation of the volume, the location portion of the response header contains the URI for the newly created volume in the following format: /api/v1/volumes/ Volume Creation Errors An error condition returns one of the errors in Table 33 (page 43). For generic API error codes, see Table 5 (page 17). Table 33 Base-volume and Snapshot-volume Creation Error Codes API Error INV_INPUT EXISTENT_VOL HTTP Code 400 Bad Request 409 Conflict Description Invalid parameter or JSON object. The volume already exists. TOO_LARGE NO_SPACE 400 Bad Request 400 Bad Request Volume size is above the architectural limit. Not enough space is currently available. NO_SNAP_CPG 409 Conflict No snapshot space is available. Creating a Storage Volume 43