Environments

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