HP OneView 1.05 User Guide

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 and backward compatibility..................................................................73
5.7 Asynchronous versus synchronous operations...................................................................73
5.8 Task resource...............................................................................................................74
5.9 Error handling.............................................................................................................74
5.10 Concurrency control using etags...................................................................................74
5.11 Querying resources and pagination using common REST API parameters............................74
5.12 State Change Message Bus..........................................................................................76
5.13 Developer tools in a web browser.................................................................................76
5.14 PowerShell and Python code sample libraries..................................................................76
6 Accessing documentation and help.........................................................79
6.1 Online help—conceptual and task information as you need it............................................79
6.2 This user guide supplements the online help.....................................................................79
6.3 Where to find HP OneView documentation......................................................................80
6.4 Enabling off-appliance browsing of UI HTML help and REST API HTML help.........................80
II Planning tasks..........................................................................................83
7 Planning your data center resources........................................................85
7.1 How many data centers?...............................................................................................85
7.2 Security planning.........................................................................................................85
7.3 Preparing your data center network switches....................................................................85
7.4 Planning your resource names........................................................................................85
7.5 Planning the appliance configuration..............................................................................87
7.5.1 Appliance VM and host requirements.......................................................................87
7.5.2 Planning for high availability..................................................................................87
7.5.3 Location of the appliance.......................................................................................87
7.5.4 Separate networks for data and management...........................................................87
7.5.5 Time clocks and NTP.............................................................................................87
7.5.6 IP addresses.........................................................................................................88
8 Planning for configuration changes.........................................................89
8.1 Configuration changes that require or result in resource outages.........................................89
8.2 Configuration changes that might require changes to multiple resources..............................90
8.2.1 Adding a network.................................................................................................90
8.2.2 Adding an enclosure............................................................................................91
III Configuration quick starts..........................................................................93
9 Quick Start: Initial Configuration.............................................................95
9.1 Process overview..........................................................................................................95
9.2 First time setup: configuration tasks.................................................................................95
Contents 5