Modifying REC Session Configuration

PATCH /copysession/{copysession_id}

Introduction

Modifies the specified REC Session settings.

Caution

  • Suspend the REC Session before changing its configuration.

  • When you change the transfer mode of a REC Session from synchronous to asynchronous, the split mode changes to the manual split mode.

    If you temporarily change to asynchronous transfer mode and return to synchronous transfer mode in an environment operating in automatic split mode, specify split mode again. The split mode remains in manual split mode unless you specify split mode.

  • For tenant users, the REC Session settings cannot be changed if the volume in the local storage system does not belong to the tenant of the current user.

Request Examples

  • This is an example of changing the transfer mode to synchronous mode for a REC Session whose Copy Session ID is 1.
    $ curl -i -H "Content-Type:application/json" -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X PATCH "https://192.168.1.1:5665/api/v1/copysession/1" -d 
'{
"transfer_mode": "Synchronous"
}'

Response Examples

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

Parameters

PATH PARAMETERS

copysession_id

(required)

integer

Copy Session ID.

REQUEST BODY

transfer_mode

string

Copy Session transfer mode.
Items Description
Synchronous Synchronous Mode
Stack Asynchronous Stack Mode
Consistency Asynchronous Consistency Mode
split_mode

string

Copy Session Split Mode.
Items Description
Automatic Auto Split Mode
Manual Manual Split Mode

Input criteria:

  • This setting item is for synchronous transfer mode only.

    If the transfer mode of the Copy Session becomes asynchronous mode after the setting is changed, this parameter cannot be specified.
recovery_mode

string

Copy Session recovery mode.
Items Description
Automatic Automatic recovery mode
Manual Manual recovery mode

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.