HP OneView manual Using the Rest APIs and other programmatic interfaces

5 Using the REST APIs and other programmatic interfaces	71
5.1 Resource operations	71
5.2 Return codes	72
5.3 URI format	72
5.4 Resource model format	72
5.5 Log in to the appliance using REST APIs	72
5.6 REST API version	72
5.7 Asynchronous versus synchronous operations	73
5.8 Task resource	73
5.9 Error handling	73
5.10 Concurrency control using etags	73
5.11 Querying resources using common REST API parameters	74
5.12 State Change Message Bus	74
5.13 Developer tools in a web browser	74
5.14 Using Python and Windows PowerShell commands (technical preview)	74
6 Accessing documentation and help	75
6.1 Online help—conceptual and task information as you need it	75
6.2 This user guide supplements the online help	75
6.3 Where to find HP OneView documentation	76
6.4 Enabling off-appliance browsing of UI and REST API HTML help files	76
II Planning tasks	77
7 Planning your data center resources	79
7.1 How many data centers?	79
7.2 Security planning	79
7.2.1 Choosing an Administrator password	79
7.2.2 Choosing the LAN for the appliance	79
7.2.3 Choosing whether or not to enable support access	79
7.2.4 Choosing an SNMP read community string	79
7.2.5 Choosing a security certificate policy	80
7.2.6 Determining roles and restrictions for authorized users	80
7.2.7 Determining your backup policy	80
7.2.8 Choosing a policy for the audit log	80
7.2.9 Determining your vSphere client policy	80
7.2.10 Reviewing your firewall access	81
7.3 Preparing your data center network switches	81
7.4 Planning your resource names	81
7.5 Planning the appliance configuration	82
7.5.1 Appliance VM and host requirements	82
7.5.2 Planning for high availability	83
7.5.3 Location of the appliance	83
7.5.4 Separate networks for data and management	83
7.5.5 Time clocks and NTP	83
7.5.6 IP addresses	83
8 Planning for configuration changes	85
8.1 Configuration changes that require or result in resource outages	85
8.2 Configuration changes that might require changes to multiple resources	86
8.2.1 Adding a network	86
8.2.2 Adding an enclosure	87

Contents 5