A CloudShare environment is an entity consisting of a group of machines (VMs), storage, networking, and infrastructure software (such as OS, DB)
Action | Description |
GET /api/v3/envs | Retrieves environments |
GET /api/v3/envs/ID | Retrieves properties of an environment and enables verification of the requesting user’s permissions to the environment |
GET /api/v3/envs/actions/getenvresources | Retrieves the total resources that have been used by an environment |
GET /api/v3/envs/actions/getmultipleenvsresources | Retrieves all environments that were active in a specified time range, and their resource usage |
GET /api/v3/envs/actions/getextended | Retrieves details of an environment along with VM information |
GET /api/v3/envs/actions/getextendedbytoken | Uses a sponsored login token to retrieve details of an environment along with VM information |
GET /api/v3/envs/actions/getextendedbymachinevanity | Uses the vanity name or FQDN of a VM to retrieve details of an environment and its VMs |
DELETE /api/v3/envs/ID | Deletes an environment |
POST /api/v3/envs | Creates an environment from a snapshot or from one or more VM templates |
PUT /api/v3/envs | Adds one or more VMs to an existing environment |
PUT /api/v3/envs/actions/suspend | Suspends an environment |
PUT /api/v3/envs/actions/resume | Resumes an environment that was previously suspended, returning it to active running state |
PUT /api/v3/envs/actions/extend | Extends the lifetime of an environment |
PUT /api/v3/envs/actions/revert | Reverts an environment to a specified snapshot |
PUT /api/v3/envs/actions/postponeinactivity | Postpones an environment’s suspend time |