• Search by Module
• Search by Words
• Search Projects

• Java
• Python
• JavaScript
• TypeScript
• C++
• Scala
• Blog

Project: scaleio-py (GitHub Link)

• scaleio-py-master
  • Changelog.md
  • examples
    • connect-cluster.py
    • delete-volume.py
    • connect-cluster-test.py
    • check_im_status.py
    • create-volume.py
    • unmap-volume.py
    • install-cluster.py
    • unmap_delete-volume.py
    • map-volume.py
    • delete-snapshot.py
    • get-cluster-configuration.py
    • install-cluster-syslog.py
    • create-snapshot-of-volume.py
    • install-cluster-faultsets.py
    • create_mapall-volume.py
    • install-cluster-syslog_v1_32.py
  • LICENSE
  • scaleiopy
    • im.py
    • api
      • im
        • mapping
          • callhome_configuration.py
          • mdm.py
          • im_generic_object.py
          • sds_device.py
          • sdc.py
          • secondary_mdm.py
          • node.py
          • __init__.py
          • sds.py
          • tb.py
          • primary_mdm.py
          • syslog_configuration.py
        • system.py
        • __init__.py
      • scaleio
        • mapping
          • statistics.py
          • volume.py
          • protection_domain.py
          • link.py
          • sdc.py
          • faultset.py
          • __init__.py
          • vtree.py
          • storage_pool.py
          • sds.py
          • ip_list.py
          • sio_generic_object.py
          • snapshotspecification.py
        • system.py
        • common
          • connection.py
          • __init__.py
        • provisioning
          • volume.py
          • __init__.py
        • __init__.py
        • metering
          • statistics.py
          • __init__.py
        • cluster
          • protectiondomain.py
          • sdc.py
          • faultset.py
          • __init__.py
          • cluster.py
          • sds.py
          • storagepool.py
      • __init__.py
    • util
      • installerfsm.py
      • tls1adapter.py
      • __init__.py
    • scaleio.py
    • __init__.py
  • setup.py
  • install_files.txt
  • README.md
  • .gitignore
  • doc
    • minimal-cluster_notworking.json
    • minimal-cluster.json
    • minimal-cluster_working.json
    • cache.json

ScaleIO-py

A Python module for interacting with the EMC ScaleIO 1.3+ REST API.

Authors: Magnus Nilsson & Matt Cowger

Requirements:

• Python 2.7+
• Requests
• Requests-Toolbelt
• ScaleIO 1.3 or 1.31 installation with REST API Gateway configured (note, the Vagrantfile from @virtualswede works fine to deploy ScaleIO with for development and testing)

Module status

Goal is to resemble the ScaleIO API (not in detail) in a Pythonic way. Atm ScaleIO-py is in early beta stage and focus will be on getting basic features become stable (especially the to/from object mapping) before adding fancy functionality.

Update 2015-06-08: Now compatible with v1.31 and v1.32

Installation

• Use "pip install ScaleIO-py" to install v0.3beta3 which is the latest released version. Master tree is going through lots of changes atm and is not stable.

For bleeding edge users:

• git clone https://github.com/swevm/scaleio-py.git
• cd scaleio-py
• python setup.py install

Supported CRUD functionality

Retrieve methods

• Get list of SDS objects
• Get list of SDC objects
• Get list of Protection Domain objects
• Get list of Volume objects
• Get lsit of Fault Set objects
• Get list of Storage Pool objects
• Get list of System objects
• Get volume by id or name
• Get SDC by id, name or ip
• Get SDS by id, name or ip
• Get Storage Pool by id or name
• Get Protection Domain by id or name
• Get Volume by id or name
• Get list of SDC(s) mapped to Volume by volumeObject
• Get statistics (Thanks Kevin)

Create

• Create Volume by Protection Domain name [rename??] (Take PD object not PD name as argument)
• Map Volume to SDC
• Map Volume to all SDCs
• Unmap Volume from SDC
• Install new ScaleIO cluster (binaries and basic configuration using IM API)
• Create Faultset
• Create Volume snapshot

Delete

• Delete Volume
• Delete Volume snapshot (by Volume Object) [Need testing]
• Delete SDC from cluster (same as unregister SDC from cluster) [remove one of them]
• Create Volume snapshot byt System id [Need testing]

Update

• Set SDC name
• Upload binaries to be installed by IM

Code examples

Have a look in examples directory for complete code examples.

Connect to ScaleIO API

from scaleiopy.scaleio import ScaleIO
# Logging level can be change by adjusting last parameter [DEBUG, FATAL, ERROR, CRITICAL, WARNING, INFO]. If left out of class init DEBUG is assumed
sio = ScaleIO("https://192.168.50.12/api","admin","Scaleio123",False, "ERROR)

Get a list of all attributes related to each SDC known by your ScaleIO cluster

#print all the known SDCs:
pprint(sio.sdc)

Get list of attributes related to all SDS

#print all the known SDSs:
pprint(sio.sds)

Get list of attributes related to all known Volumes

#print all the known Volumes:
pprint(sio.volumes)

Get list of attributes related to each protection domain

#print all the known Protection Domains:
pprint(sio.protection_domains)

Create a new Volume in Protection Domain

#Create a new Volume (of 8192Mb, smallest possible)
sio.create_volume_by_pd_name('testvol001', 8192, sio.get_pd_by_name('default'))

#Create Volume and Map to single SDC in one operation
sio.create_volume_by_pd_name('testvol001', 8192, sio.get_pd_by_name('default'), mapToSdc=sio.get_sdc_by_id('ce4d7e2a00000001'))

#Create Volume and Map to all SDC in one operation
sio.create_volume_by_pd_name('testvol001', 8192, sio.get_pd_by_name('default'), mapAll=True)

Map existing Volume to a SDC by its ID

# method get_sdc_by_ip('ipaddr') if you want to map an Vol to SDC using its IP address
sio.map_volume_to_sdc(sio.get_volume_by_name('testvol'), sio.get_sdc_by_id('ce4d7e2a00000001'), False)

# Map Volume to all SDCs
sio.map_volume_to_sdc(sio.get_volume_by_name('testvol'), mapAll=True)

Unmap volume from SDC

#Unmap Volume from SDC
sio.unmap_volume_from_sdc(sio.get_volume_by_name('testvol'), sio.get_sdc_by_id('ce4d7e2a00000001'))

Delete a Volume from ScaleIO cluster

#Delete Volume
sio.delete_volume(sio.get_volume_by_name('testvol'), 'ONLY_ME')

Create Snapshot of Volume

snapSpec = scaleio.SnapshotSpecification()
snapSpec.addVolume(sio.get_volume_by_name('volume_name'))
sio.create_snapshot(sio.get_system_id(), snapSpec)

Delete Snapshot

# Consistency group Id can be found by parsing result from get_volume_by_name().
sio.delete_snapshot(sio.get_system_id(), 'consistency_group_id')

Install ScaleIO using IM API

#Install cluster using 'private' IM API
#Look in examples/install-cluster-mac.py for a complete example

Get statistics data from ScaleIO

#print all statistics data:
pprint(sio.statistics)