A simple client for calling HyperV orchestator runbooks in python
Project description
Simple client for calling HyperV orchestrator runbooks in python.
Installation
Using pip:
$ pip install pyHyperV
Import & Initialize pyHyperV
import pyHyperV
orchestratorEndpoint = "http://hostname.local:81/Orchestrator2012/Orchestrator.svc"
username = "domain\\username"
password = "password"
o = pyHyperV.orchestrator(orchestratorEndpoint, username, password)
Execute Runbook
pyHyperV.orchestrator.Execute(runbookID, runbookParameters, dictionary=False)
You can send the parameters to orchestrator using the parameter ID or the parameter name.
Using Parameter IDs
Example of sending using the parameter ID:
runbookID = '285f017e-bc97-4b03-a999-64e08065769e'
runbookParameters = {
'f90e6468-31d3-4aa8-9d50-f8bf5bf689e2' : 'value',
'edb8d27d-38ad-4d29-a255-30d8360a3852' : 'value',
'b61abea1-4001-42fd-99b5-470acc5c1386' : 'value',
'32725695-0b25-47e0-abbe-b28e22eca8ad' : 'value',
}
o.Execute(runbookID, runbookParameters)
Using Parameter Names
To send a request using the parameter names indead of the IDs, add the dictionary=True flag. The parameter names must match the names for each parameter in orchestrator.
Example:
runbookID = '285f017e-bc97-4b03-a999-64e08065769e'
runbookParameters = {
'HDD' : '50gb',
'CPU' : '2',
'RAM' : '2048',
'OS' : 'Server2012',
}
o.Execute(runbookID, runbookParameters, dictionary=True)
Response
Successfully initiating a runbook execution will return a 201 status code, along with the orchestrator job ID. The job ID returned can be used to check the status of the job using the GetJobStatus function.
Example Response:
{
'status' : 201,
'result': {
'id' : '3c87fd6c-69f5-41c9-bd55-ec2aa6ec7c64',
'status' : 'pending',
'CreationTime' : '2014-04-02T12:11:05.617',
'LastModifiedTime' : '2014-04-02T12:19:08.963',
}
}
Get Runbooks
pyHyperV.orchestrator.GetRunbooks()
pyHyperV.orchestrator.GetRunbookID(runbookName)
Returns a list of runbooks and their IDs from orchestrator.
Example:
o.GetRunbooks()
{
'status' : 200,
'result' : {
'Runbook_1' : 'e5944fe0-b600-45d2-a872-0c256594e394'
'Runbook_2' : 'fd6d6a4b-1e57-40a3-930a-f4eb56394d3f'
'Runbook_3' : '31451e20-5829-4323-9661-603ff826c852'
}
}
It is also possible to return a single runbook ID by it’s name:
o.GetRunbookID('Runbook_1')
'e5944fe0-b600-45d2-a872-0c256594e394'
Get Runbook Parameters
pyHyperV.orchestrator.GetParameters(runbookID)
This function returns the parameter names and paramater IDs required by the runbook specified.
Example:
runbookID = '285f017e-bc97-4b03-a999-64e08065769e'
o.GetParameters(runbookID)
Example Response:
{
'status' : 200,
'result': {
'HDD' : 'f90e6468-31d3-4aa8-9d50-f8bf5bf689e2',
'CPU' : 'edb8d27d-38ad-4d29-a255-30d8360a3852',
'RAM' : 'b61abea1-4001-42fd-99b5-470acc5c1386',
'OS' : '32725695-0b25-47e0-abbe-b28e22eca8ad',
}
}
Get Job Status
pyHyperV.orchestrator.GetJobStatus(jobID)
This function allows you to check the status of an orchestrator job/task.
Example:
jobID = '285f017e-bc97-4b03-a999-64e08065769e'
o.GetParameters(jobID)
Example Response:
{
'status' : 200,
'result': {
'id' : '3c87fd6c-69f5-41c9-bd55-ec2aa6ec7c64',
'status' : 'Complete',
'CreationTime' : '2014-04-02T12:11:05.617',
'LastModifiedTime' : '2014-04-02T12:19:08.963',
}
}
Get Job Instance ID
pyHyperV.orchestrator.GetJobInstance(jobID)
Returns the job instance ID. This ID can then be used in other functions such as GetInstanceParameters.
Example:
jobID = '3c87fd6c-69f5-41c9-bd55-ec2aa6ec7c64'
o.GetJobInstance(jobID)
'f4ac97ed-495b-44ae-b547-64611b0d8075'
Get Instance Parameters
pyHyperV.orchestrator.GetInstanceParameters(instanceID)
Returns the instance parameters from orchestrator. This function can be used to get data returned from orchestrator.
Example:
instanceID = 'f4ac97ed-495b-44ae-b547-64611b0d8075'
o.GetInstanceParameters(instanceID)
{
'status' : 200,
'result' : {
'HDD' : '50gb',
'CPU' : '2',
'RAM' : '2048',
'OS' : 'Server2012',
'VM_ID' : 'edb8d27d-38ad-4d29-a255-30d8360a3852',
'VM_IP' : '127.0.0.1',
}
}
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file pyHyperV-0.0.4.tar.gz
.
File metadata
- Download URL: pyHyperV-0.0.4.tar.gz
- Upload date:
- Size: 3.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
04212bedb9665e20c61e0dae179b2718652151ed333bd99ac9ad69cf493b7463
|
|
MD5 |
bf64edf573f019439af831c2c50da6dd
|
|
BLAKE2b-256 |
3e049bb3068818e991c2ca5580508165c4d3e604b66f1e4c73c07fe1568eeebf
|
File details
Details for the file pyHyperV-0.0.4.macosx-10.8-x86_64.exe
.
File metadata
- Download URL: pyHyperV-0.0.4.macosx-10.8-x86_64.exe
- Upload date:
- Size: 71.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
0b6eb60346a64ef78ea1900618a56cad9f363277a424e9fb6dede75d25aeb644
|
|
MD5 |
8b527fbde6d47af4ddf1794dfc5f028f
|
|
BLAKE2b-256 |
c096f52d0dc40b502cf437a887a851aa5b6948f1f37548ba27c69fd5c0f7d5d8
|