Volume:Get Mirror

Search (SHIFT+S)



Get Mirror

GET /block/volumes/{id}/protection/continuous-copies/{mid}

Show details for a specific continuous copy

idthe URN of a ViPR Source volume
midContinuous copy URI

Required Roles

Requires one of the following roles:

  • SYSTEM_MONITOR
  • TENANT_ADMIN

Response Body

BlockMirrorRestRep

Field Description Type Notes
<block_mirror>
<source>    
<name> The name of the resource String
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</source>      
<syncState> Synchronization state. String Valid Values:
  •  UNKNOWN
  •  RESYNCHRONIZING
  •  SYNCHRONIZED
  •  FRACTURED
<syncType> Synchronization type. String
<allocated_capacity_gb> The total amount of space allocated from the volume's storage pool (GB) String
<pre_allocation_size_gb> The amount of space that was initially allocated when the volume was created (GB) String
<auto_tier_policy>     Valid Values:
  •  DEFAULT_NO_MOVEMENT = Data is never relocated from the disks it is originally written to
  •  DEFAULT_AUTOTIER = Data is relocated based on its activity level
  •  DEFAULT_HIGHEST_AVAILABLE = Data is kept on the fastest disks available
  •  DEFAULT_LOWEST_AVAILABLE = Data is kept on the slowest disks available
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</auto_tier_policy>      
<requested_capacity_gb> This volume's total capacity in Gb (Gigabytes). String
<vpool>    
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</vpool>      
<is_composite> Specifies whether this is a composite (meta) volume. Boolean Valid Values:
  •  true
  •  false
<project>    
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</project>      
<provisioned_capacity_gb> This volume's logical capacity in Gb (Gigabytes). String
<tenant>    
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</tenant>      
<thinly_provisioned> Whether or not this volume is thinly provisioned. A thin volume initially allocates a portion of its assigned capacity when it is created and then grows as needed. Boolean Valid Values:
  •  true
  •  false
<high_availability_backing_volumes>
<high_availability_backing_volume>     0-* Elements
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</high_availability_backing_volume>      
</high_availability_backing_volumes>
<protection>    
<mirrors>    
<native_mirrors>
<native_mirror>     0-* Elements
<varray>    
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</varray>      
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</native_mirror>      
</native_mirrors>
</mirrors>      
<recoverpoint>    
<targets> This volume's RecoverPoint (RP) target copies
<target>     0-* Elements
<varray>    
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</varray>      
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</target>      
</targets>
<protection_set>    
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</protection_set>      
<protection_system>    
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</protection_system>      
<site_name> A label that can be used to denote the physical location of the volume String
<copy_name> The volume's RecoverPoint (RP) copy name. In this context, a production volume is a copy that is used as a source for replication. String
<replicationset_name> The name of this volume's RecoverPoint (RP) replication set. A replication set consists of a production volume and that volume's target copies. String
<personality> How this volume is used with respect to replication String Valid Values:
  •  SOURCE = A production volume
  •  TARGET = A copy of a production volume
  •  METADATA = A volume that stores meta-data for replication. Example: A RecoverPoint journal volume
</recoverpoint>      
<full_copies>    
<associated_source_volume>    
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</associated_source_volume>      
<volumes>
<volume>     0-* Elements
<varray>    
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</varray>      
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</volume>      
</volumes>
<is_sync_active> Boolean
<percent_synced> Integer
</full_copies>      
<srdf>    
<associated_source_volume>    
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</associated_source_volume>      
<volumes>
<volume>     0-* Elements
<varray>    
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</varray>      
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</volume>      
</volumes>
<personality> How this volume is used with respect to replication String Valid Values:
  •  SOURCE = A production volume
  •  TARGET = A copy of a production volume
  •  METADATA = A volume that stores meta-data for replication. Example: A RecoverPoint journal volume
</srdf>      
</protection>      
<access_state> The volume's access state String
<link_status> The volume's link status String
<storage_pool>    
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</storage_pool>      
<device_label> Label assigned to the Block object. An example of a block object is a volume. String
<native_id> Native ID for this Block object. String
<varray>    
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</varray>      
<protocols>
<protocol> String 0-* Elements
</protocols>
<storage_controller> Storage controller where this Block object is located. URI
<wwn> World Wide name of this Block object. String
<consistency_group>    
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</consistency_group>      
<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 Valid Values:
  •  urn:storageos:resource-type:UUID:
<link> A hyperlink to the details for this resource
<creation_time> A timestamp that shows when this resource was created in ViPR DateTime Valid Values:
  •  YYYY-MM-DDTHH:mm:ssZ
<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 Valid Values:
  •  true
  •  false
<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 Valid Values:
  •  true
  •  false
</block_mirror>

Examples

Request
GET https://localhost:4443/block/volumes/urn:storageos:Volume:f85fb21a-ffc2-4fb4-9868-3b7fcc8c0bcf:/protection/continuous-copies/urn:storageos:BlockMirror:11c7bae2-60d5-469a-a9d1-e2358d6e6822: HTTP/1.1

Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
Response
HTTP/1.1 200 OK
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<block_mirror>
   <creation_time>1380817815585</creation_time>
   <device_label>mirror</device_label>
   <id>urn:storageos:BlockMirror:11c7bae2-60d5-469a-a9d1-e2358d6e6822:</id>
   <inactive>false</inactive>
   <is_composite>false</is_composite>
   <link>
      <href>/block/volumes/urn:storageos:Volume:f85fb21a-ffc2-4fb4-9868-3b7fcc8c0bcf:/protection/continuous-copies/urn:storageos:BlockMirror:11c7bae2-60d5-469a-a9d1-e2358d6e6822:</href>
      <rel>self</rel>
   </link>
   <name>mirror</name>
   <native_id>010EC</native_id>
   <protection null="true" />
   <protocols>
      <element>FC</element>
   </protocols>
   <source>
      <id>urn:storageos:Volume:f85fb21a-ffc2-4fb4-9868-3b7fcc8c0bcf:</id>
      <link>
         <href>/block/volumes/urn:storageos:Volume:f85fb21a-ffc2-4fb4-9868-3b7fcc8c0bcf:</href>
         <rel>self</rel>
      </link>
      <name>volume</name>
   </source>
   <storage_controller>urn:storageos:StorageSystem:81426202-3380-4dd0-8517-b71d335d3768:</storage_controller>
   <syncState>6</syncState>
   <syncType>6</syncType>
   <tags />
   <varray>
      <id>urn:storageos:VirtualArray:e428d5d6-bab0-4708-a63b-bbf79d45c86b:</id>
      <link>
         <href>/vdc/varrays/urn:storageos:VirtualArray:e428d5d6-bab0-4708-a63b-bbf79d45c86b:</href>
         <rel>self</rel>
      </link>
   </varray>
   <vpool>
      <id>urn:storageos:VirtualPool:b28bc64e-969a-43fe-8cd2-37b8ce49cb9f:</id>
      <link>
         <href>/block/vpools/urn:storageos:VirtualPool:b28bc64e-969a-43fe-8cd2-37b8ce49cb9f:</href>
         <rel>self</rel>
      </link>
   </vpool>
   <wwn>60000970000198700406533031304543</wwn>
</block_mirror>
Notes: