This scenario will take a snapshot of an environment, create a new environment with a new prototype and start it with the image from the snapshot.
|
List all environments The linux environment is suspended (inactive). |
Requesthttps://use.cloudshare.com/API/v1/Env/ListEnvironments?timestamp=1354447587&UserApiId=VWRWJ4550LB086FG&HMAC=c019be8a9240ebd6165897007c1a2b7e9a29e7c7 Response{
"envsList": [
{
"apiId": "V0MDPUQHHN1A",
"campaign": "N/A",
"description": " CloudShare Pro environment",
"expirationTime": "Wed, 18 Dec 2013 22:00:00 GMT",
"invitationAllowed": true,
"licenseValid": "Valid",
"name": "A linux environment",
"organization": "N/A",
"owner": "*****@*****.com",
"package": "N/A",
"prototype": "A linux environment",
"snapshot": "snap1",
"status": "Suspended"
},
{
"apiId": "4Z0ZAVFCHTYA",
"campaign": "N/A",
"description": " CloudShare Pro environment",
"expirationTime": "Mon, 03 Dec 2012 12:14:30 GMT",
"invitationAllowed": false,
"licenseValid": "Valid",
"name": "My environment one - sharepoint",
"organization": "N/A",
"owner": "*****@*****.com",
"package": "N/A",
"prototype": "My environment one - sharepoint",
"snapshot": "N/A",
"status": "Suspended"
},
{
"apiId": "2G5ZZQT0Q4PA",
"campaign": "API Documentation Campaign",
"description": "",
"expirationTime": "Sat, 22 Dec 2012 08:06:38 GMT",
"invitationAllowed": true,
"licenseValid": "Not relevant",
"name": "linux environment",
"organization": "CloudShare",
"owner": "*****@*****.com",
"package": "CloudShare/PoC (10 days)",
"prototype": "linux environment",
"snapshot": "newsnapshot",
"status": "Suspended"
}
]
}
StatusHTTP/1.1 200 OK |
| Resume suspended environment |
Requesthttps://use.cloudshare.com/API/v1/Env/ResumeEnvironment?envApiId=2G5ZZQT0Q4PA×tamp=1354448705&UserApiId=VWRWJ4550LB086FG&HMAC=86b29a2a2495c5a8b6b07b3d407e3895716178d0 Response{
"apiId": "2G5ZZQT0Q4PA"
}
StatusHTTP/1.1 200 OK |
|
Take a snapshot of one environment, to a new prototype.
Label the snapshot snap2, and the new prototype newProto. |
Requesthttps://use.cloudshare.com/API/v1/Env/EntAppTakeSnapshotToNewPrototype?envApiId=2G5ZZQT0Q4PA&newPrototypeName=newProto&snapshotName=snap2×tamp=1354449059&UserApiId=VWRWJ4550LB086FG&HMAC=8fc561db6c06c6b6ca013f1715ab6254d413d154 Response{
"envApiId": "2G5ZZQT0Q4PA"
}
StatusHTTP/1.1 200 OK |
|
Check create environment options.
Look for the new prototype, newProto. |
Requesthttps://use.cloudshare.com/API/v1/Env/CreateEntAppEnvOptions?timestamp=1354449403&UserApiId=VWRWJ4550LB086FG&HMAC=824e7b42cea759e6d1060f5156a59ab3d5f3f6d9 Response{
"json": {
"UsagePackagesList": [
{
"Campaign": "API Documentation Campaign",
"Organizations": [
"CloudShare"
],
"Prototype": "CloudShare API Documentation linux
proto",
"ResourcePackage": "PoC (10 days)",
"Snapshots": [
{
"Author": "******",
"Comment": "",
"CreationTime": "11/29/2012 5:54 PM",
"IsDefault": true,
"IsLatest": true,
"Name": "snap1",
"SnapshotId": "CBEQ10MT1YBB"
}
],
"UsagePackageId": "T0JCP2VQ1XHA"
},
{
"Campaign": "API Documentation Campaign",
"Organizations": [
"CloudShare"
],
"Prototype": "linux environment",
"ResourcePackage": "PoC (10 days)",
"Snapshots": [
{
"Author": "*******",
"Comment": null,
"CreationTime": "12/2/2012 8:09 AM",
"IsDefault": true,
"IsLatest": true,
"Name": "newsnapshot",
"SnapshotId": "Q4VCZH0U2SGA"
}
],
"UsagePackageId": "GSMKV44JETNA"
},
{
"Campaign": "API Documentation Campaign",
"Organizations": [
"CloudShare"
],
"Prototype": "newProto",
"ResourcePackage": "PoC (10 days)",
"Snapshots": [
{
"Author": "*****",
"Comment": null,
"CreationTime": "12/2/2012 11:51 AM",
"IsDefault": true,
"IsLatest": true,
"Name": "snap2",
"SnapshotId": "4T4UJZBDC1QB"
}
],
"UsagePackageId": "SY1FYBBEUMGB"
}
]
}
}
StatusHTTP/1.1 200 OK |
|
Create a new environment with the new prototype.
Apply the Usage Package and Snapshot from the previous request. |
Requesthttps://use.cloudshare.com/API/v1/Env/CreateEntAppEnv?environmentNewName=newLinux&snapshotApiId=4T4UJZBDC1QB×tamp=1354449606&usagePackageApiId=SY1FYBBEUMGB&UserApiId=VWRWJ4550LB086FG&HMAC=6ec2865efed9c0cf0b179659d5cfcb6d3941c0bf Response{
"usagePackageApiId": "SY1FYBBEUMGB"
}
StatusHTTP/1.1 200 OK |
|
Get list of all environments.
Check for a new environment, identified by the prototype, newProto. |
Requesthttps://use.cloudshare.com/API/v1/Env/ListEnvironments?timestamp=1354449802&UserApiId=VWRWJ4550LB086FG&HMAC=19508a67368715f172875646e10c952c87e88744 Response{
"envsList": [
{
"apiId": "V0MDPUQHHN1A",
"campaign": "N/A",
"description": " CloudShare Pro environment",
"expirationTime": "Wed, 18 Dec 2013 22:00:00 GMT",
"invitationAllowed": true,
"licenseValid": "Valid",
"name": "A linux environment",
"organization": "N/A",
"owner": "*****@*****.com",
"package": "N/A",
"prototype": "A linux environment",
"snapshot": "snap1",
"status": "Suspended"
},
{
"apiId": "Q5BICUFX1N5B",
"campaign": "API Documentation Campaign",
"description": "",
"expirationTime": "Sat, 22 Dec 2012 12:00:27 GMT",
"invitationAllowed": true,
"licenseValid": "Not relevant",
"name": "newLinux",
"organization": "CloudShare",
"owner": "*****@*****.com",
"package": "CloudShare/PoC (10 days)",
"prototype": "newProto",
"snapshot": "snap2",
"status": "Running"
},
{
"apiId": "4Z0ZAVFCHTYA",
"campaign": "N/A",
"description": "CloudShare Pro environment",
"expirationTime": "Mon, 03 Dec 2012 12:14:30 GMT",
"invitationAllowed": false,
"licenseValid": "Valid",
"name": "My environment one - sharepoint",
"organization": "N/A",
"owner": "*****@*****.com",
"package": "N/A",
"prototype": "My environment one - sharepoint",
"snapshot": "N/A",
"status": "Suspended"
},
{
"apiId": "2G5ZZQT0Q4PA",
"campaign": "API Documentation Campaign",
"description": "",
"expirationTime": "Sat, 22 Dec 2012 08:06:38 GMT",
"invitationAllowed": true,
"licenseValid": "Not relevant",
"name": "linux environment",
"organization": "CloudShare",
"owner": "*****@*****.com",
"package": "CloudShare/PoC (10 days)",
"prototype": "linux environment",
"snapshot": "newsnapshot",
"status": "Running"
}
]
}
StatusHTTP/1.1 200 OK |
|
Check running status of the new environment
The new environment id is Q5BICUFX1N5B. The status for the environment is ‘running’. |
Requesthttps://use.cloudshare.com/API/v1/Env/GetEnvironmentSTate?EnvApiId=Q5BICUFX1N5B×tamp=1354449886&UserApiId=VWRWJ4550LB086FG&HMAC=97daa329283dcc6502ed98124cad0f19bb2b8529 Response{
"apiId": "Q5BICUFX1N5B",
"campaign": "API Documentation Campaign",
"description": "",
"expirationTime": "Sat, 22 Dec 2012 12:00:27 GMT",
"invitationAllowed": true,
"licenseValid": "Not relevant",
"machines": [
{
"apiId": "GYVX5XCKSSGA",
"description": "OS: Ubuntu 10.04 Server
Spec: 16 GB HD / 0.5 GB RAM",
"ip": "pub*-***.env.cloudshare.com",
"name": "Ubuntu 10.04 Server",
"password": null,
"progress": -1,
"status": "Running",
"username": null,
"webAccessUrl": null
}
],
"name": "newLinux",
"organization": "CloudShare",
"owner": "*****@*****.com",
"package": "CloudShare/PoC (10 days)",
"prototype": "newProto",
"snapshot": "snap2",
"status": "Running"
}
StatusHTTP/1.1 200 OK |
| Revert the snapshot to the new environment. |
Requesthttps://use.cloudshare.com/API/v1/Env/RevertEnvironment?EnvApiId=Q5BICUFX1N5B×tamp=1354449991&UserApiId=VWRWJ4550LB086FG&HMAC=71d2581135fe60dddeb1f169b467e6b1249c26e2 Response{
"apiId": "Q5BICUFX1N5B"
}
StatusHTTP/1.1 200 OK |
|
Check new environment running state after reverting to the snapshot image.
The status indicates the environment is being readied, with progress on the machine 34%. |
Requesthttps://use.cloudshare.com/API/v1/Env/GetEnvironmentSTate?EnvApiId=Q5BICUFX1N5B×tamp=1354450035&UserApiId=VWRWJ4550LB086FG&HMAC=fb6d2d8302fb6b0f3f10306bfd9cb0cb59095f0e Response{
"apiId": "Q5BICUFX1N5B",
"campaign": "API Documentation Campaign",
"description": "",
"expirationTime": "Sat, 22 Dec 2012 12:00:27 GMT",
"invitationAllowed": true,
"licenseValid": "Not relevant",
"machines": [
{
"apiId": "GYVX5XCKSSGA",
"description": "OS: Ubuntu 10.04 Server
Spec: 16 GB HD / 0.5 GB RAM",
"ip": "pub*-***.env.cloudshare.com",
"name": "Ubuntu 10.04 Server",
"password": null,
"progress": 34,
"status": "Loading from snapshot",
"username": null,
"webAccessUrl": null
}
],
"name": "linux environment",
"organization": "CloudShare",
"owner": "*****@*****.com",
"package": "CloudShare/PoC (10 days)",
"prototype": "newProto",
"snapshot": "snap2",
"status": "Preparing"
}
StatusHTTP/1.1 200 OK |
|
Check the environment status again, after a few minutes.
The environment is now running. |
Requesthttps://use.cloudshare.com/API/v1/Env/GetEnvironmentSTate?EnvApiId=Q5BICUFX1N5B×tamp=1354450132&UserApiId=VWRWJ4550LB086FG&HMAC=c873fb5e344143d29c771d8b0dde97f0f0104c02 Response{
"apiId": "Q5BICUFX1N5B",
"campaign": "API Documentation Campaign",
"description": "",
"expirationTime": "Sat, 22 Dec 2012 12:00:27 GMT",
"invitationAllowed": true,
"licenseValid": "Not relevant",
"machines": [
{
"apiId": "GYVX5XCKSSGA",
"description": "OS: Ubuntu 10.04 Server
Spec: 16 GB HD / 0.5 GB RAM",
"ip": "pub*-***.env.cloudshare.com",
"name": "Ubuntu 10.04 Server",
"password": null,
"progress": -1,
"status": "Running",
"username": null,
"webAccessUrl": null
}
],
"name": "linux environment",
"organization": "CloudShare",
"owner": "*****@*****.com",
"package": "CloudShare/PoC (10 days)",
"prototype": "newProto",
"snapshot": "snap2",
"status": "Running"
}
|