HP 3PAR Web Service API 1.3.1 Developer's Guide

5 Working with Hosts
This chapter describes how to manage hosts. The sections apply to creation, modification, removal,
and query operations on hosts.
Creating a Host
Create a host using the HTTP POST method. Use the following URI:
https://<storage_system>:8080/api/v1/hosts
Table 51 (page 73) shows the members that the message body can include.
NOTE: Any user with Super or Edit role, or any role granted the host_create right, can perform
this operation. Access to all domains is required for this operation.
Table 51 Message Body JSON Objects for Host Creation
DescriptionIgnored ValuesMandatoryValue RangeJSON TypeMember
Specifies the name
of the host.
Null
(Required)
Yesname31stringname
(Since WSAPI 1.2)
ID of the persona
to assign to the
host.
Zero and negative
values
NoHostPersona Enumnumberpersona
If you do not
specify the host
persona, the
default persona is
used For HP 3PAR
OS 3.1.3 and
later, the default
persona is
Generic-ALUA.
For HP OS 3.1.2
and earlier, the
default persona is
General.
(Since WSAPI 1.2)
One or more
WWN to set for
the host.
NullNoWWNarray of stringFCWWNs
(Since WSAPI 1.2)
One or more iSCSI
names to set for
the host.
NullNoName223array of stringiSCSINames
(Since WSAPI 1.2)
Create the host in
the specified
NullNoname31stringdomain
domain, or default
domain if
unspecified.
(Since WSAPI 1.2)
If True, force to
tear down
NoneNoBooleanforceTearDown
low-priority VLUN
exports.
Creating a Host 73