Home » HP Manuals » Storage Devices » HP 3PAR StoreServ 7450 4-node » Manual Viewer

HP 3PAR StoreServ 7450 4-node HP 3PAR Web Service API 1.2 Developer's - Page 34

CPG Creation Errors, Modifying a CPG

View all HP 3PAR StoreServ 7450 4-node manuals

Add to My Manuals
Save this manual to your list of manuals

Page 34 highlights

CPG Creation Errors If an error occurs, the system returns one of the error codes shown in Table 19 (page 34), or a general error code listed in "Generic WSAPI code Member Status and Error Codes" (page 17): Table 19 CPG Creation and Modification Error Codes API Error BAD_CPG_PATTERN CPG_NOT_IN_SAME_DOMAIN HTTP Code 400 Bad Request 403 Forbidden Description A pattern in a CPG LDLayout specifies illegal values. Snap CPG is not in the same domain as the user CPG. (Since WSAPI 1.2) EXISTENT_CPG IN_USE 409 Conflict 409 Conflict INV_INPUT INV_INPUT_EXCEEDS_LENGTH 400 Bad Request 400 Bad Request INV_INPUT_EXCEEDS_RANGE 400 Bad Request INV_OPERATION_GROW_SIZE_TOO_SMALL 400 Bad Request CPG already exists. The CPG cannot be removed because it is in use by a volume. Missing CPG name. Invalid input: string length exceeds limit. Invalid input: number exceeds expected range. CPG grow size is too small (Since WSAPI 1.2) INV_INPUT_ILLEGAL_CHAR 400 Bad Request INV_INPUT_MISSING_REQUIRED 400 Bad Request INV_INPUT_WARN_GT_LIMIT 400 Bad Request INV_OPERATION_CPG_RAID0_DISABLED 403 Forbidden Input contains one or more illegal characters. No valid CPG update operation found. The allocation warning level is higher than the allocation limit. Invalid operation. RAID-0 must be enabled. (Since WSAPI 1.2) INV_OPERATION_CPG_RAID5_NL_DISABLED 403 Forbidden Invalid operation. RAID-5 on NL drives must be enabled. (Since WSAPI 1.2) INV_SET_SIZE NO_SPACE NON_EXISTENT_CPG 400 Bad Request 400 Bad Request 404 Not Found The set size is invalid for the selected RAID type. Insufficient space for requested operation. The CPG does not exist. This error applies only to CPG modification, not creation. NON_EXISTENT_DOMAIN 404 Not Found Domain does not exist. Modifying a CPG To modify a CPG, use the HTTP PUT method in the URI: https://:8080/api/v1/cpgs/ with message body members as shown in Table 18 (page 33) and Table 20 (page 35). 34 Working with Common Provisioning Groups

Section	Page
HP 3PAR Web Services API 1.2 Developer's Guide	1
Contents	3
1 Introduction	9
About the WSAPI	9
Getting Started	9
Starting and Configuring the Server	9
About the SDK	9
Java SDK	10
Perl SDK	10
2 Accessing the WSAPI	11
Overview	11
Protocol and Message Format	12
Client HTTP Headers	12
Server HTTP Headers	13
Supported HTTP Methods	14
General URI Format	14
System Access	14
Creating Credentials	14
About Multiple Session Keys	14
About Session Key Security	15
Creating a Session Key	15
Using a Session Key	15
Deleting a Session Key	16
Session Key Deletion Success	16
Session Key Deletion Errors	16
HTTP Status and Error Codes	16
The code Member	16
The desc Member	24
The ref Member	25
HTTP Error Codes	25
Request Input and Optional Members	25
Null Members	26
Enumerations	26
JSON Types and API Types	27
3 Working with Common Provisioning Groups	29
CPG Enumeration and Configuration Objects	29
CPG LDLayout JSON Objects	29
CPG RAIDType Enumeration	29
CPG HA Enumeration	30
CPG chunkletPosPref Enumeration	30
CPG diskPatterns JSON Object	30
CPG diskType Enumeration	31
CPG Space Usage Objects	32
Growth Objects	32
CPG state Enumeration	32
CPG detailedState Enumeration	32
Creating a CPG	33
CPG Creation Success	33
CPG Creation Errors	34
Modifying a CPG	34
CPG Modification Success	35
CPG Modification Errors	35
Removing a CPG	35
CPG Removal Success	35
CPG Removal Errors	35
Querying CPG Information	36
Querying All CPGs	36
CPG Query Success	37
CPG Query Errors	37
Querying a Single CPG	37
Single-CPG Query Success	37
Single-CPG Query Errors	37
4 Working with Storage Volumes	38
Volume Enumeration and Configuration Objects	38
Volume provisioningType Enumeration Types	38
Volume CopyType Enumeration Types	38
Volume state Enumeration Types	38
Volume DetailedState Enumeration Types	39
Volume policies Configuration Object	40
Volume Space Objects	40
Creating a Storage Volume	41
Creating Base Volumes	41
Creating Snapshot Volumes	42
Volume Creation Success	43
Volume Creation Errors	43
Modifying a Virtual Volume	44
Volume Modification Success	46
Volume Modification Errors	46
Removing a Storage Volume	48
Storage Volume Removal Success	48
Storage Volume Removal Errors	48
Querying Volume Information	48
Querying All Volumes	48
All-Volumes Query Success	48
All-volumes Query Errors	50
Querying a Single Volume	50
Single-volume Query Success	50
Single-volume Query Errors	50
5 Working with Hosts	52
Creating a Host	52
Host Creation Success	52
Host Creation Errors	53
Modifying a Host	54
Host Modification Success	56
Host Modification Errors	56
Removing a Host	58
Host Removal Success	58
Host Removal Errors	58
Querying Hosts	58
Host Query Success	58
Host Query Errors	62
6 Working with Ports	63
Port Configuration and Enumeration Objects	63
Querying All Ports	65
All-ports Query Success	65
All-ports Query Errors	67
Querying A Single Port	67
Single-port Query Success	67
Single-port Query Errors	67
7 Working with Virtual LUNs	68
VLUN Configuration and Enumeration Objects	68
VLUN portPos Configuration Object	68
VLUNtype Enumeration	68
VLUN multipathing Enumeration	68
VLUN failedPathPol Enumeration	69
Creating a VLUN	69
VLUN Creation Success	70
VLUN Creation Errors	70
VLUN Creation Example	71
HTTP Request	71
HTTP Response	72
Removing a VLUN	72
VLUN Removal Success	72
VLUN Removal Errors	72
VLUN Removal Example	73
HTTP Request	73
HTTP Response	73
Querying VLUNs	73
Querying All VLUNs	73
All-VLUNs Query Success	73
All-VLUNs Query Example	75
All-VLUNs Query Errors	75
Querying a Single VLUN	76
Single-VLUN Query Success	76
Single-VLUN Query Errors	77
8 Getting Storage System and Version Information	79
Getting Storage System Information	79
Storage-system Query Success	79
Storage-system Query Errors	80
Getting Version Information	80
Version Information Query Success	80
Version Information Query Errors	80
9 Querying Available Space	81
Querying Overall System Capacity	81
Overall System Capacity Success	81
Overall Available Space Query Errors	84
Querying Available Space for a CPG or LDLayout Object	84
CPG Space Query Members	84
LDLayout Object Space Query Members	84
Space Query Success	84
Space Query Errors	85
10 Support and Other Resources	86
Contacting HP	86
HP 3PAR documentation	86
Typographic conventions	89
HP 3PAR branding information	89
11 Documentation feedback	90

Match case Limit results 1 per page

CPG Creation Errors

If an error occurs, the system returns one of the error codes shown in

Table 19 (page 34)

, or a

general error code listed in

“Generic WSAPI

code

Member Status and Error Codes” (page 17)

Table 19 CPG Creation and Modification Error Codes

Description

HTTP Code

API Error

A pattern in a CPG LDLayout specifies

illegal values.

400 Bad Request

BAD_CPG_PATTERN

Snap CPG is not in the same domain

as the user CPG.

403 Forbidden

CPG_NOT_IN_SAME_DOMAIN

(Since WSAPI 1.2)

CPG already exists.

409 Conflict

EXISTENT_CPG

The CPG cannot be removed because

it is in use by a volume.

409 Conflict

IN_USE

Missing CPG name.

400 Bad Request

INV_INPUT

Invalid input: string length exceeds

limit.

400 Bad Request

INV_INPUT_EXCEEDS_LENGTH

Invalid input: number exceeds

expected range.

400 Bad Request

INV_INPUT_EXCEEDS_RANGE

CPG grow size is too small

400 Bad Request

INV_OPERATION_GROW_SIZE_TOO_SMALL

(Since WSAPI 1.2)

Input contains one or more illegal

characters.

400 Bad Request

INV_INPUT_ILLEGAL_CHAR

No valid CPG update operation

found.

400 Bad Request

INV_INPUT_MISSING_REQUIRED

The allocation warning level is higher

than the allocation limit.

400 Bad Request

INV_INPUT_WARN_GT_LIMIT

Invalid operation. RAID-0 must be

enabled.

403 Forbidden

INV_OPERATION_CPG_RAID0_DISABLED

(Since WSAPI 1.2)

Invalid operation. RAID-5 on NL drives

must be enabled.

403 Forbidden

INV_OPERATION_CPG_RAID5_NL_DISABLED

(Since WSAPI 1.2)

The set size is invalid for the selected

RAID type.

400 Bad Request

INV_SET_SIZE

Insufficient space for requested

operation.

400 Bad Request

NO_SPACE

The CPG does not exist.

404 Not Found

NON_EXISTENT_CPG

This error applies only to CPG

modification, not creation.

Domain does not exist.

404 Not Found

NON_EXISTENT_DOMAIN

Modifying a CPG

To modify a CPG, use the HTTP PUT method in the URI:

https://

:8080/api/v1/cpgs/

with message body members as shown in

Table 18 (page 33)

and

Table 20 (page 35)

Working with Common Provisioning Groups

HP 3PAR StoreServ 7450 4-node HP 3PAR Web Service API 1.2 Developer&#039;s - Page 34

CPG Creation Errors, Modifying a CPG

Page 34 highlights

HP 3PAR StoreServ 7450 4-node HP 3PAR Web Service API 1.2 Developer's - Page 34