Initiator:Update Initiator

Search (SHIFT+S)

API Reference


Update Initiator

PUT /compute/initiators/{id}

Update a host initiator.

idthe URN of a ViPR initiator

Required Roles

  • TENANT_ADMIN

Request Payload

All parameters are required unless otherwise stated.

Field Description Type Notes
<initiator_update>
<protocol> The protocols supported by the initiator which should be FC or iSCSI Valid values: FC iSCSI String
<initiator_node> The FC (Fibre Channel) initiator WWN (World Wide Name) of the initiator node String
<initiator_port> The initiator port which can be the WWN of an FC port or the IQN or EUI of an iSCSI port String
<name> The label of the initiator String
</initiator_update>

Response Body

The details of the updated host initiator.

Field Description Type Notes
<initiator>
<hostname> The host name for the initiator. String
<clustername> The name of the cluster for the initiator. String
<initiator_node> The initiator node. String
<initiator_port> The port for the initiator. String
<label> The label for the initiator. String
<host>    
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</host>      
<protocol> The host interface protocol. String
<registration_status> The host interface registration status. Only registered hosts can be used for provisioning operations. Valid values: UNREGISTERED REGISTERED String
<name> The name assigned to this resource in ViPR. The resource name is set by a user and can be changed at any time. It is not a unique identifier. String
<id> An identifier that is generated by ViPR when the resource is created. The resource ID is guaranteed to be unique and immutable across all virtual data centers for all time. URI
<link> A hyperlink to the details for this resource
<creation_time> A timestamp that shows when this resource was created in ViPR DateTime
<tags> Keywords and labels that can be added by a user to a resource to make it easy to find when doing a search.
<tag> String 0-* Elements
</tags>
<inactive> Whether or not the resource is inactive. When a user removes a resource, the resource is put in this state before it is removed from the ViPR database. Boolean
<global> Boolean
<remote> Boolean
<vdc>    
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</vdc>      
<internal> Whether or not the resource is an internal resource. Boolean
</initiator>

Examples

Request
PUT https://192.168.0.0:4443/compute/initiators/urn:storageos:Initiator:6f67a31e-db04-4cd1-bd06-15a2f0acebb9: HTTP/1.1

Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

<initiator_update>
     <protocol>iSCSI</protocol>
     <initiator_port>iqn.2002-20.com.emc.lss.host3</initiator_port>
</initiator_update>
Response
HTTP/1.1 200 OK
Content-Type: application/xml

<initiator>
       <creation_time>1380656352646</creation_time>
       <id>urn:storageos:Initiator:6f67a31e-db04-4cd1-bd06-15a2f0acebb9:</id>
       <inactive>false</inactive>
       <link
              href="/compute/initiators/urn:storageos:Initiator:6f67a31e-db04-4cd1-bd06-15a2f0acebb9:"
              rel="self" />
       <tags />
       <host>
              <id>urn:storageos:Host:2df35fce-e946-4b5f-8598-676a94f29a59:</id>
              <link
                     href="/compute/hosts/urn:storageos:Host:2df35fce-e946-4b5f-8598-676a94f29a59:"
                     rel="self" />
       </host>
       <protocol>iSCSI</protocol>
       <hostname>halahost1.lss.emc.com</hostname>
       <initiator_port>iqn.2002-20.com.emc.lss.host3</initiator_port>
</initiator>
Notes: