Skip to main content

HPE Alletra 9000 and HPE Primera and HPE 3PAR HTTP REST Client

Project description

Latest Version Downloads

HPE Alletra 9000 and HPE Primera and HPE 3PAR REST Client

This is a Client library that can talk to the HPE Alletra 9000 and Primera and 3PAR Storage array. The HPE Alletra 9000 and Primera and 3PAR storage array has a REST web service interface and a command line interface. This client library implements a simple interface for talking with either interface, as needed. The python Requests library is used to communicate with the REST interface. The python paramiko library is used to communicate with the command line interface over an SSH connection.

This is the new location for the rebranded HP 3PAR Rest Client and will be where all future releases are made. It was previously located on PyPi at:

The GitHub repository for the old HP 3PAR Rest Client is located at:

The HP 3PAR Rest Client (hp3parclient) is now considered deprecated.


This branch requires 3.1.3 version MU1 or later of the HPE 3PAR firmware. This branch requires 4.3.1 version of the HPE Primera firmware. This branch requires 9.3.0 version of the HPE Alletra 9000 firmware. File Persona capabilities require HPE 3PAR firmware 3.2.1 Build 46 or later.


  • Create Volume

  • Delete Volume

  • Get all Volumes

  • Get a Volume

  • Modify a Volume

  • Copy a Volume

  • Create a Volume Snapshot

  • Create CPG

  • Delete CPG

  • Get all CPGs

  • Get a CPG

  • Get a CPG’s Available Space

  • Create a VLUN

  • Delete a VLUN

  • Get all VLUNs

  • Get a VLUN

  • Create a Host

  • Delete a Host

  • Get all Hosts

  • Get a Host

  • Get VLUNs for a Host

  • Find a Host

  • Find a Host Set for a Host

  • Get all Host Sets

  • Get a Host Set

  • Create a Host Set

  • Delete a Host Set

  • Modify a Host Set

  • Get all Ports

  • Get iSCSI Ports

  • Get FC Ports

  • Get IP Ports

  • Set Volume Metadata

  • Get Volume Metadata

  • Get All Volume Metadata

  • Find Volume Metadata

  • Remove Volume Metadata

  • Create a Volume Set

  • Delete a Volume Set

  • Modify a Volume Set

  • Get a Volume Set

  • Get all Volume Sets

  • Find one Volume Set containing a specified Volume

  • Find all Volume Sets containing a specified Volume

  • Create a QOS Rule

  • Modify a QOS Rule

  • Delete a QOS Rule

  • Set a QOS Rule

  • Query a QOS Rule

  • Query all QOS Rules

  • Get a Task

  • Get all Tasks

  • Get a Patch

  • Get all Patches

  • Get WSAPI Version

  • Get WSAPI Configuration Info

  • Get Storage System Info

  • Get Overall System Capacity

  • Stop Online Physical Copy

  • Query Online Physical Copy Status

  • Stop Offline Physical Copy

  • Resync Physical Copy

  • Query Remote Copy Info

  • Query a Remote Copy Group

  • Query all Remote Copy Groups

  • Create a Remote Copy Group

  • Delete a Remote Copy Group

  • Modify a Remote Copy Group

  • Add a Volume to a Remote Copy Group

  • Remove a Volume from a Remote Copy Group

  • Start Remote Copy on a Remote Copy Group

  • Stop Remote Copy on a Remote Copy Group

  • Synchronize a Remote Copy Group

  • Recover a Remote Copy Group from a Disaster

  • Enable/Disable Config Mirroring on a Remote Copy Target

  • Get Remote Copy Group Volumes

  • Get Remote Copy Group Volume

  • Admit Remote Copy Link

  • Dismiss Remote Copy Link

  • Start Remote Copy

  • Remote Copy Service Exists Check

  • Get Remote Copy Link

  • Remote Copy Link Exists Check

  • Admit Remote Copy Target

  • Dismiss Remote Copy Target

  • Target In Remote Copy Group Exists Check

  • Remote Copy Group Status Check

  • Remote Copy Group Status Started Check

  • Remote Copy Group Status Stopped Check

  • Create Schedule

  • Delete Schedule

  • Get Schedule

  • Modify Schedule

  • Suspend Schedule

  • Resume Schedule

  • Get Schedule Status

  • Promote Virtual Copy

  • Get a Flash Cache

  • Create a Flash Cache

  • Delete a Flash Cache

File Persona Capabilities

  • Get File Services Info

  • Create a File Provisioning Group

  • Grow a File Provisioning Group

  • Get File Provisioning Group Info

  • Modify a File Provisioning Group

  • Remove a File Provisioning Group

  • Create a Virtual File Server

  • Get Virtual File Server Info

  • Modify a Virtual File Server

  • Remove a Virtual File Server

  • Assign an IP Address to a Virtual File Server

  • Get the Network Config of a Virtual File Server

  • Modify the Network Config of a Virtual File Server

  • Remove the Network Config of a Virtual File Server

  • Create a File Services User Group

  • Modify a File Services User Group

  • Remove a File Services User Group

  • Create a File Services User

  • Modify a File Services User

  • Remove a File Services User

  • Create a File Store

  • Get File Store Info

  • Modify a File Store

  • Remove a File Store

  • Create a File Share

  • Get File Share Info

  • Modify a File Share

  • Remove a File Share

  • Create a File Store Snapshot

  • Get File Store Snapshot Info

  • Remove a File Store Snapshot

  • Reclaim Space from Deleted File Store Snapshots

  • Get File Store Snapshot Reclamation Info

  • Stop or Pause a File Store Snapshot Reclamation Task

  • Set File Services Quotas

  • Get Files Services Quota Info


To install from source:

$ sudo pip install .

To install from

$ sudo pip install python-3parclient

Unit Tests

To run all unit tests:

$ tox -e py27

To run a specific test:

$ tox -e py27 -- test/

To run all unit tests with code coverage:

$ tox -e cover

The output of the coverage tests will be placed into the coverage dir.


  • docs – contains the documentation.

  • hpe3parclient – the actual library

  • test – unit tests

  • samples – some sample uses


To build the documentation:

$ tox -e docs

To view the built documentation point your browser to:


Running Simulators

The unit tests should automatically start/stop the simulators. To start them manually use the following commands. To stop them, use ‘kill’. Starting them manually before running unit tests also allows you to watch the debug output.

  • WSAPI:

    $ python test/ -port 5001 -user <USERNAME> -password <PASSWORD> -debug
  • SSH:

    $ python test/ [port]

Building wheel dist

This client now supports building via the new python WHEELS standard. Take a look at

  • building:

    $ python bdist_wheel
  • building and uploading:

    $ python sdist bdist_wheel upload

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-3parclient-4.2.12.tar.gz (128.0 kB view hashes)

Uploaded source

Built Distribution

python_3parclient-4.2.12-py2.py3-none-any.whl (144.1 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page