Obtaining the Copy Session Information for a Volume

GET /volume/{volume_id}/copysession

Introduction

Obtains Copy Session information for the specified Volume.

Caution

The presence of the following Copy Sessions is ignored in creating the response information. For example, is_copy_destination_volume is false for Copy destination Volumes in Storage Cluster.

  • Monitor

  • ODX

  • XCOPY

  • VVOL Copy Session

  • Storage Cluster

  • Copy Range is Extent

  • Copy Session Status is Reserved

Request Examples

  • This is an example of retrieving Copy Session information that resides on the Volume ID 100001.

    $ curl -i -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X GET "https://192.168.1.1:5665/api/v1/volume/100001/copysession"

Response Examples

{
  "volume_id": 100001,
  "volume_number": 1,
  "volume_href": "/api/v1/volume/100001",
  "volume_name": "vol#01",
  "is_copy_source_volume": true,
  "is_copy_destination_volume": true,
  "backup_type": "Clone",
  "source_volume_number": 2,
  "source_volume_href": "/api/v1/volume/200001",
  "source_volume_name": "datastore#2",
  "source_boxid": "00ETERNUSDXHS3ET00000A####EI000002######",
  "copysession_href": "/api/v1/copysession/1",
  "remote_copysession_id": 2,
  "backup_time": "2020-12-01T12:30:00Z",
  "error_ocurrence_time": "2020-12-01T12:30:00Z",
  "status": "Active",
  "phase": "Equivalent",
  "is_manual_snapshot": false,
  "is_data_tracking_disabled": false,
  "backup_volume_list": [
    {
      "volume_number": 3,
      "volume_href": "/api/v1/volume/300001",
      "volume_name": "vol#03",
      "backup_type": "Remote_Mirror",
      "destination_boxid": "00ETERNUSDXHS3ET00000A####EI000001######",
      "copysession_href": "/api/v1/copysession/3",
      "remote_copysession_id": 2,
      "backup_time": "2020-12-01T12:30:00Z",
      "error_ocurrence_time": "2020-12-01T12:30:00Z",
      "status": "Active",
      "phase": "Equivalent",
      "is_manual_snapshot": false,
      "is_data_tracking_disabled": false
    }
  ]
}

Parameters

PATH PARAMETERS

volume_id

(required)

integer

Volume ID.

QUERY PARAMETERS

fields

Array of strings

Parameter to display.

Only the information of the specified Parameter name (Response Body Parameter) is extracted and obtained.

For details about the specification methods, see Property Filter.
backup_type

Array of strings

Backup Type.

Specify the Backup Volume Backup Type for which you want information.
Item Description
Clone The OPC or QuickOPC destination.
Snapshot SnapOPC or SnapOPC+ destination.
Local_Mirror EC destination.
Remote_Mirror REC destination.
Restored Destination for the Restore OPC (Except Restore OPC from OPC destination).

Input criteria:

  • You can specify up to 5 values.
is_manual_snapshot

boolean

Whether the Snapshot is managed by generation.

If specified as true, only copy session information for non-generation-managed snapshots (equivalent to SnapOPC Volumes) will be returned.
is_data_tracking_disabled

boolean

Whether the Clone's physical data can be resynchronized.

If specified as true, only the Copy Session information for Clones (equivalent to OPC Volumes) whose their physical data cannot be resynchronized will be responded to.

Responses

If successful, the HTTP status code is 200 (OK) and the response body is returned.

RESPONSE BODY

volume_id

integer

Volume ID.
volume_number

integer

Volume Number.
volume_href

string

Link to Volume Resource.
volume_name

string

A Volume Friendly Name.
is_copy_source_volume

boolean

Whether the Volume is the source Volume.

If true, Volume is the source Volume.

If false, the Volume is not the source Volume.
is_copy_destination_volume

boolean

Whether the Volume is the destination Volume.

If true, Volume is the destination Volume.

If false, the Volume is not the destination Volume.
backup_type

string

Backup Type.

Respond only if Volume is the destination.
Item Description
Clone The OPC or QuickOPC destination.
Snapshot SnapOPC or SnapOPC+ destination.
Local_Mirror EC destination.
Remote_Mirror REC destination.
Restored Destination for the Restore OPC (Except Restore OPC from OPC destination).

The Volume Backup Type during a restore responds as follows.

  • If a Volume is being restored from Snapshot or Clone (excluding Clones whose physical data cannot be resynchronized), the Backup Type will respond with "Restored".

  • If the Volume is being restored from a Clone whose physical data cannot be resynchronized, the Backup Type will respond with "Clone".

  • If a Volume is being restored from Remote Mirror or Local Mirror using the Reverse Copy Session feature, the Backup Type will respond "Remote Mirror" or "Local Mirror".
source_volume_number

integer

Number of the source Volume.

Respond only if Volume is the destination.

If the Backup Type is Restored, the Number of the Volume from which to restore is responded with.

For tenant users, a response is returned even if the copy source volume does not belong to the tenant of the current user.
source_volume_href

string

Link to copy source Volume Resource.

Respond only if Volume is the destination.

It will not respond if the Backup Type is Remote_Mirror.

If the Backup Type is Restored, a Link to the Resource in the source Volume is responded with.

For tenant users, a response is returned even if the copy source volume does not belong to the tenant of the current user.
source_volume_name

string

Friendly Name of the source Volume.

Respond only if Volume is the destination.

It will not respond if the Backup Type is Remote_Mirror.

If the Backup Type is Restored, the Friendly Name of the Volume from which to restore is responded with.

For tenant users, no response is returned if the copy source volume does not belong to the tenant of the current user.
source_boxid

string

The Box ID of the copy source device.

Respond only if Volume is the destination.

This item is returned only if Backup Type is Remote_Mirror.
copysession_href

string

Resource link of the Copy Session.

Respond only if Volume is the destination.
remote_copysession_id

integer

The Copy Session ID of the destination device.

Respond only if Volume is the destination.

This item is returned only if Backup Type is Remote_Mirror.
backup_time

string

The backup start time for the Copy Session.

Respond only if Volume is the destination.

It does not respond if the Copy Session Status is Error or Halt.

If the Backup Type is Restored, the start time of the data copy from the restore source Volume in the background is responded to.

Format is as follows:

The time zone is UTC.

YYYY-MM-DDThh:mm:ssZ
error_ocurrence_time

string

Time the Copy Session failed.

Respond only if Volume is the destination.

It responds only if the Copy Session Status is Error or Halt.

Format is as follows:

The time zone is UTC.

YYYY-MM-DDThh:mm:ssZ
status

string

Copy Session status.

Respond only if Volume is the destination.
Item Description
Active Operating normally.
Suspended Suspended.
Halt

Copying is suspended due to copy path error or depletion of REC buffer.

If the Recovery Mode is Automatic, copying resumes automatically after the Halt factor is recovered.

If the Recovery Mode is Manual, copying must be manually restarted by force Suspend/Resume after recovery.
Error

Copying was stopped due to equipment failure or insufficient capacity.

The Copy Session must be deleted and recreated after the error causes have been recovered.
phase

string

Phase of the Copy Session.

Respond only if Volume is the destination.

If Backup Type is Clone, the phases that can be responded are Copying, Tracking, Tracking_and_Copying, and Reading.

If Backup Type is Snapshot or Restored, the phases that can be responded are Copying and Reading.

If Backup Type is Local_Mirror or Remote_Mirror, the phases that can be responded are Copying and Equivalent.
Item Description
Copying

  • Indicates that a copy is being performed if the volume backup type is Snapshot, Clone (physical data cannot be resynchronized), or Restored.

  • In the case of Clone (Physical data can be resynchronized), this phase indicates the recording of the update part has been stopped and the recorded update part is being copied.

  • For Local Mirror or Remote Mirror (Transfer mode is synchronous or asynchronous Consistency), this phase indicates data integrity is not guaranteed because data copying is in progress or data copying is being forced to be suspended.

  • For Remote Mirror (Transfer mode is asynchronous Stack), this phase indicates that the destination Volume data is inconsistent with the source Volume data.
Equivalent

  • For Local Mirror or Remote Mirror (Transfer mode is synchronous or asynchronous stack), this phase indicates the data matches with the Copy Source Volume and data integrity is guaranteed.

  • For Remote Mirror (Transfer mode is asynchronous Consistency), this phase indicates that data integrity is guaranteed (if there is any untransferred data in the REC Buffer, the data does not match with the Copy Source data).
Tracking After copying is completed with Clone (Physical data can be resynchronized), only the update part is being recorded.
Tracking_and_Copying Clone (Physical data can be resynchronized) is in the process of copying and is recording updates since the start of copying.
Readying Preparing to start copy.
is_manual_snapshot

boolean

Whether the Snapshot is managed by generation.

Respond only if Volume is the destination.

If true, the Snapshot is not managed by generation (equivalent to SnapOPC Sessions).

If false, the Snapshot is managed by generation (equivalent to SnapOPC+ Sessions).

It is also false for Volumes other than Snapshot.
is_data_tracking_disabled

boolean

Whether the Clone's physical data can be resynchronized.

Respond only if Volume is the destination.

This property is returned only if backup_type is Clone.

If true, the Clone's physical data cannot be resynchronized (equivalent to OPC Session).

If false, the Clone's physical data can be resynchronized (equivalent to QuickOPC Session).
backup_volume_list

Array of objects

List of destination Volumes.

The Volumes are sorted by copysession_href in ascending order.
volume_number

integer

Volume Number.

For tenant users, a response is returned even if the copy destination volume does not belong to the tenant of the current user.
volume_href

string

Link to Volume Resource.

It will not respond if the Backup Type is Remote_Mirror.

For tenant users, a response is returned even if the copy destination volume does not belong to the tenant of the current user.
volume_name

string

A Volume Friendly Name.

It will not respond if the Backup Type is Remote_Mirror.

For tenant users, no response is returned if the copy destination volume does not belong to the tenant of the current user.
backup_type

string

Backup Type.
Item Description
Clone The OPC or QuickOPC destination.
Snapshot SnapOPC or SnapOPC+ destination.
Local_Mirror EC destination.
Remote_Mirror REC destination.
Restored Destination for the Restore OPC (Except Restore OPC from PC destination).

The Volume Backup Type during a restore responds as follows.

  • If a Volume is being restored from Snapshot or Clone (excluding Clones whose physical data cannot be resynchronized), the Backup Type will respond with "Restored".

  • If the Volume is being restored from a Clone whose physical data cannot be resynchronized, the Backup Type will respond with "Clone".

  • If a Volume is being restored from Remote Mirror or Local Mirror using the Reverse Copy Session feature, the Backup Type will respond "Remote Mirror" or "Local Mirror".
destination_boxid

string

The Box ID of the copy destination device.

This item is returned only if Backup Type is Remote_Mirror.
copysession_href

string

Resource link of the Copy Session.
remote_copysession_id

integer

The Copy Session ID of the destination device.

This item is returned only if Backup Type is Remote_Mirror.
backup_time

string

The backup start time for the Copy Session.

It does not respond if the Copy Session Status is Error or Halt.

If the Backup Type is Restored, the start time of the data copy from the restore source Volume in the background is responded to.

Format is as follows:

The time zone is UTC.

YYYY-MM-DDThh:mm:ssZ
error_ocurrence_time

string

Time the Copy Session failed.

It responds only if the Copy Session Status is Error or Halt.

Format is as follows:

The time zone is UTC.

YYYY-MM-DDThh:mm:ssZ
status

string

Copy Session status.
Item Description
Active Operating normally.
Suspended Suspended.
Halt

Copying is suspended due to copy path error or depletion of REC buffer.

If the Recovery Mode is Automatic, copying resumes automatically after the Halt factor is recovered.

If the Recovery Mode is Manual, copying must be manually restarted by force Suspend/Resume after recovery.
Error

Copying was stopped due to equipment failure or insufficient capacity.

The Copy Session must be deleted and recreated after the error causes have been recovered.
phase

string

Phase of the Copy Session.

If Backup Type is Clone, the phases that can be responded are Copying, Tracking, Tracking_and_Copying, and Reading.

If Backup Type is Snapshot or Restored, the phases that can be responded are Copying and Reading.

If Backup Type is Local_Mirror or Remote_Mirror, the phases that can be responded are Copying and Equivalent.
Item Description
Copying

  • Indicates that a copy is being performed if the volume backup type is Snapshot, Clone (physical data cannot be resynchronized), or Restored.

  • In the case of Clone (Physical data can be resynchronized), this phase indicates the recording of the update part has been stopped and the recorded update part is being copied.

  • For Local Mirror or Remote Mirror (Transfer mode is synchronous or asynchronous Consistency), this phase indicates data integrity is not guaranteed because data copying is in progress or data copying is being forced to be suspended.

  • For Remote Mirror (Transfer mode is asynchronous Stack), this phase indicates that the destination Volume data is inconsistent with the source Volume data.
Equivalent

  • For Local Mirror or Remote Mirror (Transfer mode is synchronous or asynchronous stack), this phase indicates the data matches with the Copy Source Volume and data integrity is guaranteed.

  • For Remote Mirror (Transfer mode is asynchronous Consistency), this phase indicates that data integrity is guaranteed (if there is any untransferred data in the REC Buffer, the data does not match with the Copy Source data).
Tracking After copying is completed with Clone (Physical data can be resynchronized), only the update part is being recorded.
Tracking_and_Copying Clone (Physical data can be resynchronized) is in the process of copying and is recording updates since the start of copying.
Readying Preparing to start copy.
is_manual_snapshot

boolean

Whether the Snapshot is managed by generation.

If true, the Snapshot is not managed by generation (equivalent to SnapOPC Sessions).

If false, the Snapshot is managed by generation (equivalent to SnapOPC+ Sessions).

It is also false for Volumes other than Snapshot.
is_data_tracking_disabled

boolean

Whether the Clone's physical data can be resynchronized.

This property is returned only if backup_type is Clone.

If true, the Clone's physical data cannot be resynchronized (equivalent to OPC Session).

If false, the Clone's physical data can be resynchronized (equivalent to QuickOPC Session).