Updating Connections Related to the Specified Host

POST /connection/host/{host_id}/reconnect

Introduction

Adds Connections for the Host specified with host_id to the added CA Port.

Perform this operation when a CA is added after creating a Connection and you want to connect an existing Connection to that CA Port.

Caution

  • If the specified Host has more than one LUN Group set with Affinity, the RESTful API will respond with an error due to an unsupported configuration.

  • If there is no Affinity configured for the specified Host, an error is returned.

  • If there is no CA Ports in the Affinity configured for the specified Host, an error is returned.

  • You cannot specify a CA Port to connect to. The Connection setting with CA Ports that meet the following conditions is automatically established.

    • Affinity Mode is Enable.

    • Connected to the specified Host.

    • The port operation mode is CA or CARA.

    • It is not used by the Storage Cluster function.

  • There is a limit to the number of Hosts that can be connected to a CA Port. A CA Port that exceeds the limit will not be set as a Connection and will exit normally. Refer to the information in the response resource to determine which CA Ports are used for the Connection setting.

  • Connections that no longer have a connection between the specified Host and the CA Port are not deleted. If you want to delete the Connection setting, use ETERNUS Web GUI or ETERNUS CLI.

  • You cannot recreate a Connection with the Host described below. If you want to change the connection port, use ETERNUS SF Storage Cruiser.

    • Host with Storage Cluster settings

    • Host with VVOL Access Path settings

  • For tenant users, only the Connection that is related to the Host that belongs to the tenant of the current user can be configured.

Request Examples

  • This is an example of creating a Connection to the added CA Port that is related to the Host with Host ID 2.

    $ curl -i -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X POST "https://192.168.1.1:5665/api/v1/connection/host/2/reconnect"

Response Examples

{
  "job_id": 8192001,
  "job_href": "/api/v1/job/8192001"
}

Parameters

PATH PARAMETERS

host_id

(required)

integer

Host ID.

Responses

If the job registration is successful, the HTTP status code will be 202 (Accepted) and the response body will respond.

RESPONSE BODY

job_id

integer

Job ID.
job_href

string

Resource link of the job.