Details
| ID | CloudShare |
|---|---|
| Provider | Bow River Capital |
| Category | Utilities |
| From Version | 6.0.0 |
| Docker Image | demisto/py3-tools:1.0.0.5984007 |
| Supported Modules | Agentix XSIAM |
README
CloudShare
This integration is a BETA that covers the API commands from CloudShare.
Commands
You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.
cloudshare-get-envs
Retrieves environments
Base Command
cloudshare-get-envs
Input
| Argument Name | Description | Required |
|---|---|---|
| owned | Returns only environments owned by the user. Possible values are: true, false. Default is false. | Optional |
| visible | Returns all environments visible to the user. Possible values are: true, false. Default is false. | Optional |
| ownerEmail | Optional. Filters results by the environment owner’s email address, where {ownerEmail} is the environment owner’s email address. | Optional |
| classId | Optional. Filters results to include only environments created for a specified class, including instructor and student environments, where {classId} is the ID of the class. | Optional |
| brief | Optional. Whether to return a less detailed or more detailed response. {brief_value} can be: true (default) - Returns less detail. false - Returns more detail. Possible values are: true, false. Default is true. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Environments.projectId | string | Project ID |
| CloudShare.Environments.policyId | string | Policy ID |
| CloudShare.Environments.blueprintId | string | Blueprint ID |
| CloudShare.Environments.description | string | Description |
| CloudShare.Environments.ownerEmail | string | Owner email |
| CloudShare.Environments.regionId | string | Region ID |
| CloudShare.Environments.name | string | Name |
| CloudShare.Environments.id | string | ID |
| CloudShare.Environments.status | string | Status |
| CloudShare.Environments.teamId | string | Team ID |
cloudshare-get-projects
Retrieves all available projects
Base Command
cloudshare-get-projects
Input
| Argument Name | Description | Required |
|---|---|---|
| WhereUserIsProjectManager | Returns only projects in which the user is a project manager. Possible values are: tru, false. Default is false. | Optional |
| WhereUserIsProjectMember | Returns only projects in which the user is a project member. Possible values are: true, false. Default is false. | Optional |
| WhereUserCanCreateClass | Returns only projects in which the user is allowed to create a class. The minimum user level allowed to create classes is set per project and can be changed by project manager users. Possible values are: true, false. Default is false. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Projects.name | string | Name |
| CloudShare.Projects.isActive | boolean | Is Active |
| CloudShare.Projects.id | string | ID |
cloudshare-get-project
Retrieves a specified project’s details
Base Command
cloudshare-get-project
Input
| Argument Name | Description | Required |
|---|---|---|
| projectId | The ID of a specific project. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Projects.id | string | ID |
| CloudShare.Projects.name | string | Name |
| CloudShare.Projects.hasNonGenericPolicy | boolean | Has non-generic policy |
| CloudShare.Projects.canAddPolicy | boolean | Can add policy |
| CloudShare.Projects.awsEnabled | boolean | AWS enabled |
| CloudShare.Projects.environmentResourceQuota.cpuCount | number | CPU count |
| CloudShare.Projects.environmentResourceQuota.diskSizeMB | number | Disk size(MB) |
| CloudShare.Projects.environmentResourceQuota.memorySizeMB | number | Memory size(MB) |
| CloudShare.Projects.projectResourceQuota.cpuCount | number | CPU count |
| CloudShare.Projects.projectResourceQuota.diskSizeMB | number | Disk size(MB) |
| CloudShare.Projects.projectResourceQuota.memorySizeMB | number | Memory size(MB) |
| CloudShare.Projects.subscriptionResourceQuota.cpuCount | number | CPU count |
| CloudShare.Projects.subscriptionResourceQuota.diskSizeMB | number | Disk size(MB) |
| CloudShare.Projects.subscriptionResourceQuota.memorySizeMB | number | Memory size(MB) |
| CloudShare.Projects.canCreateFromScratch | boolean | Can create from scratch |
| CloudShare.Projects.defaultPolicyForEnvCreation | string | Default policy for env creation |
| CloudShare.Projects.isActive | boolean | Is active |
cloudshare-get-project-policies
Retrieves all environment policies available in a specified project. Environment policies define how long an environment will run, when it will be deleted, and what happens to it when it has been idle for a certain length of time.
Base Command
cloudshare-get-project-policies
Input
| Argument Name | Description | Required |
|---|---|---|
| projectId | The ID of the project. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Project.Policies.allowEnvironmentCreation | boolean | Allow environment creation |
| CloudShare.Project.Policies.id | string | ID |
| CloudShare.Project.Policies.name | string | Name |
| CloudShare.Project.Policies.projectId | string | Project ID |
cloudshare-get-project-blueprints
Retrieves all blueprints available in a specified project
Base Command
cloudshare-get-project-blueprints
Input
| Argument Name | Description | Required |
|---|---|---|
| projectId | The Id of the project. | Required |
| regionId | The ID of a region. Returns all blueprints that have default snapshots on the specified region. If unspecified, returns all blueprints in the project on all regions. | Optional |
| defaultSnapshot | If set to true - get the default snapshot for every blueprint. The returned JSON will contain a property ‘CreateFromVersions’, which is an array of one element - the default snapshot. If unspecified, default is false (don’t return the default snapshot). Possible values are: true, false. Default is false. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Projects.Blueprints.id | string | ID |
| CloudShare.Projects.Blueprints.name | string | Name |
| CloudShare.Projects.Blueprints.description | string | Description |
| CloudShare.Projects.Blueprints.isEnvironmentTemplate | boolean | Is template |
| CloudShare.Projects.Blueprints.type | number | Type |
| CloudShare.Projects.Blueprints.imageUrl | string | Image URL |
| CloudShare.Projects.Blueprints.tags | unknown | Tags |
| CloudShare.Projects.Blueprints.categories | unknown | Categories |
| CloudShare.Projects.Blueprints.resources.cpuCount | number | CPU count |
| CloudShare.Projects.Blueprints.resources.diskSizeMB | number | Disk size(MB) |
| CloudShare.Projects.Blueprints.resources.memorySizeMB | number | Memory size(MB) |
| CloudShare.Projects.Blueprints.numberOfMachines | number | Number of machines |
| CloudShare.Projects.Blueprints.hasMultipleVersions | boolean | Has multiple versions |
| CloudShare.Projects.Blueprints.hasDefaultVersion | boolean | Has default version |
| CloudShare.Projects.Blueprints.disabledForRegularEnvironmentCreation | boolean | Disabled for regular environment creation |
| CloudShare.Projects.Blueprints.disabledForTrainingEnvironmentCreation | boolean | Disabled for training environment creation |
| CloudShare.Projects.Blueprints.canAddMultipleInstances | boolean | Can add multiple instances |
| CloudShare.Projects.Blueprints.envTemplateScope | unknown | Environment template scope |
| CloudShare.Projects.Blueprints.creationDate | string | Creation date |
| CloudShare.Projects.Blueprints.CreateFromVersions.Machines | unknown | Machines |
| CloudShare.Projects.Blueprints.CreateFromVersions.AuthorName | string | Author name |
| CloudShare.Projects.Blueprints.CreateFromVersions.Comment | string | Comment |
| CloudShare.Projects.Blueprints.CreateFromVersions.Type | number | Type |
| CloudShare.Projects.Blueprints.CreateFromVersions.Name | string | Name |
| CloudShare.Projects.Blueprints.CreateFromVersions.IsDefault | boolean | Is default |
| CloudShare.Projects.Blueprints.CreateFromVersions.IsLatest | boolean | Is latest |
| CloudShare.Projects.Blueprints.CreateFromVersions.Number | number | Number |
| CloudShare.Projects.Blueprints.CreateFromVersions.Resources.CpuCount | number | CPU count |
| CloudShare.Projects.Blueprints.CreateFromVersions.Resources.DiskSizeMB | number | Disk size(MB) |
| CloudShare.Projects.Blueprints.CreateFromVersions.Resources.MemorySizeMB | number | Memory size(MB) |
| CloudShare.Projects.Blueprints.CreateFromVersions.CreateTime | string | Create time |
| CloudShare.Projects.Blueprints.CreateFromVersions.Description | string | Description |
| CloudShare.Projects.Blueprints.CreateFromVersions.ImageUrl | string | Image URL |
| CloudShare.Projects.Blueprints.CreateFromVersions.Regions | unknown | Regions |
| CloudShare.Projects.Blueprints.CreateFromVersions.Id | string | ID |
cloudshare-get-project-blueprint
Retrieves details of a specified blueprint, including snapshots.
Base Command
cloudshare-get-project-blueprint
Input
| Argument Name | Description | Required |
|---|---|---|
| projectId | The ID of the project in which the blueprint resides. | Required |
| blueprintId | The ID of the blueprint. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Projects.Blueprints.id | string | ID |
| CloudShare.Projects.Blueprints.name | string | Name |
| CloudShare.Projects.Blueprints.description | string | Description |
| CloudShare.Projects.Blueprints.isEnvironmentTemplate | boolean | Is template |
| CloudShare.Projects.Blueprints.type | number | Type |
| CloudShare.Projects.Blueprints.imageUrl | string | Image URL |
| CloudShare.Projects.Blueprints.tags | unknown | Tags |
| CloudShare.Projects.Blueprints.categories | unknown | Categories |
| CloudShare.Projects.Blueprints.resources.cpuCount | number | CPU count |
| CloudShare.Projects.Blueprints.resources.diskSizeMB | number | Disk size(MB) |
| CloudShare.Projects.Blueprints.resources.memorySizeMB | number | Memory size(MB) |
| CloudShare.Projects.Blueprints.numberOfMachines | number | Number of machines |
| CloudShare.Projects.Blueprints.hasMultipleVersions | boolean | Has multiple versions |
| CloudShare.Projects.Blueprints.hasDefaultVersion | boolean | Has default version |
| CloudShare.Projects.Blueprints.disabledForRegularEnvironmentCreation | boolean | Disabled for regular environment creation |
| CloudShare.Projects.Blueprints.disabledForTrainingEnvironmentCreation | boolean | Disabled for training environment creation |
| CloudShare.Projects.Blueprints.canAddMultipleInstances | boolean | Can add multiple instances |
| CloudShare.Projects.Blueprints.envTemplateScope | unknown | Environment template scope |
| CloudShare.Projects.Blueprints.creationDate | string | Creation date |
| CloudShare.Projects.Blueprints.CreateFromVersions.Machines | unknown | Machines |
| CloudShare.Projects.Blueprints.CreateFromVersions.AuthorName | string | Author name |
| CloudShare.Projects.Blueprints.CreateFromVersions.Comment | string | Comment |
| CloudShare.Projects.Blueprints.CreateFromVersions.Type | number | Type |
| CloudShare.Projects.Blueprints.CreateFromVersions.Name | string | Name |
| CloudShare.Projects.Blueprints.CreateFromVersions.IsDefault | boolean | Is default |
| CloudShare.Projects.Blueprints.CreateFromVersions.IsLatest | boolean | Is latest |
| CloudShare.Projects.Blueprints.CreateFromVersions.Number | number | Number |
| CloudShare.Projects.Blueprints.CreateFromVersions.Resources.CpuCount | number | CPU count |
| CloudShare.Projects.Blueprints.CreateFromVersions.Resources.DiskSizeMB | number | Disk size(MB) |
| CloudShare.Projects.Blueprints.CreateFromVersions.Resources.MemorySizeMB | number | Memory size(MB) |
| CloudShare.Projects.Blueprints.CreateFromVersions.CreateTime | string | Create time |
| CloudShare.Projects.Blueprints.CreateFromVersions.Description | string | Description |
| CloudShare.Projects.Blueprints.CreateFromVersions.ImageUrl | string | Image URL |
| CloudShare.Projects.Blueprints.CreateFromVersions.Regions | unknown | Regions |
| CloudShare.Projects.Blueprints.CreateFromVersions.Id | string | ID |
cloudshare-get-classes
Retrieves all classes visible to the user
Base Command
cloudshare-get-classes
Input
| Argument Name | Description | Required |
| — | — | — |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Classes.instructorEmail | string | Instructor email |
| CloudShare.Classes.timeZoneName | string | Timezone name |
| CloudShare.Classes.startDate | string | Start date |
| CloudShare.Classes.endDate | string | End date |
| CloudShare.Classes.status | string | Status |
| CloudShare.Classes.name | unknown | Name |
| CloudShare.Classes.shortId | string | Short ID |
| CloudShare.Classes.id | string | ID |
| CloudShare.Classes.regionId | string | Region ID |
cloudshare-get-class
Retrieves details of a specified class
Base Command
cloudshare-get-class
Input
| Argument Name | Description | Required |
|---|---|---|
| classId | The id of the class. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Classes.id | string | ID |
| CloudShare.Classes.name | string | Name |
| CloudShare.Classes.shortId | string | Short ID |
| CloudShare.Classes.policyId | string | Policy ID |
| CloudShare.Classes.policyName | string | Policy name |
| CloudShare.Classes.isUsingClassTypes | boolean | Is issuing class types |
| CloudShare.Classes.blueprintId | string | Blueprint ID |
| CloudShare.Classes.blueprintName | string | Blueprint name |
| CloudShare.Classes.blueprintToken | string | Blueprint token |
| CloudShare.Classes.cloudName | string | Cloud name |
| CloudShare.Classes.timeZoneId | string | Timezone ID |
| CloudShare.Classes.projectId | string | Project ID |
| CloudShare.Classes.projectName | string | Project name |
| CloudShare.Classes.creatorName | string | Creator name |
| CloudShare.Classes.creatorEmail | string | Creator email |
| CloudShare.Classes.instructorVupId | string | Instructor VUP ID |
| CloudShare.Classes.instructorName | string | Instructor name |
| CloudShare.Classes.defaultDurationInMinutes | number | Default duration (mins) |
| CloudShare.Classes.allowStartDateEditing | boolean | Allow start date editing |
| CloudShare.Classes.limitEarlyAccess | number | Limit early access |
| CloudShare.Classes.studentPassphrase | string | Student passphrase |
| CloudShare.Classes.useCustomInvitationEmail | boolean | Use custom invitation email |
| CloudShare.Classes.showCourseAddressField | boolean | Show course address field |
| CloudShare.Classes.address | string | Address |
| CloudShare.Classes.customInvitationEmailSubject | string | Custom invitation email subject |
| CloudShare.Classes.customInvitationEmailBody | string | Custom invitation email body |
| CloudShare.Classes.defaultInvitationEmailSubject | string | Default invitation email subject |
| CloudShare.Classes.defaultInvitationEmailBody | string | Default invitation email subject |
| CloudShare.Classes.showPermitAccessToNonRegisteredStudent | boolean | Show permit access to non-registered student |
| CloudShare.Classes.allowEditDefaultsWhenPermitAccessToNonRegistered | boolean | Allow edit defaults when permit access to non registered |
| CloudShare.Classes.permitAccessToNonRegisteredStudent | boolean | Permit access to non registered student |
| CloudShare.Classes.showMaxStudentsField | boolean | Show max students field |
| CloudShare.Classes.maxStudents | number | Max students |
| CloudShare.Classes.maxLimitOnMaxStudentField | number | Max kimit on max student field |
| CloudShare.Classes.customFieldsValues.id | string | ID |
| CloudShare.Classes.customFieldsValues.order | number | Order |
| CloudShare.Classes.customFieldsValues.name | string | Name |
| CloudShare.Classes.customFieldsValues.type | number | Type |
| CloudShare.Classes.customFieldsValues.isRequired | boolean | Is required |
| CloudShare.Classes.customFieldsValues.regex | string | Regex |
| CloudShare.Classes.customFieldsValues.defaultValue | unknown | Default value |
| CloudShare.Classes.customFieldsValues.value | unknown | Value |
| CloudShare.Classes.instructorEmail | string | Instructor email |
| CloudShare.Classes.timeZoneName | string | Timezone name |
| CloudShare.Classes.startDate | string | Start date |
| CloudShare.Classes.endDate | string | End date |
| CloudShare.Classes.status | string | Status |
cloudshare-delete-class
Deletes a class
Base Command
cloudshare-delete-class
Input
| Argument Name | Description | Required |
|---|---|---|
| classId | The id of the class. | Required |
Context Output
There is no context output for this command.
cloudshare-delete-class-environments
Deletes all active student environments in a class
Base Command
cloudshare-delete-class-environments
Input
| Argument Name | Description | Required |
|---|---|---|
| classId | The ID of the class. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| cloudshare.Classes.Actions.Delete.failed | unknown | Failed deletions |
| cloudshare.Classes.Actions.Delete.succeed | unknown | Succeeded deletions |
| cloudshare.Classes.Actions.Delete.succeed.id | string | ID |
| cloudshare.Classes.Actions.Delete.succeed.email | string | |
| cloudshare.Classes.Actions.Delete.succeed.fullName | string | Full name |
| cloudshare.Classes.Actions.Delete.succeed.envId | string | Environment ID |
cloudshare-get-classes-countries
Retrieves all countries that can be set as class locations
Base Command
cloudshare-get-classes-countries
Input
| Argument Name | Description | Required |
| — | — | — |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Classes.Countries.code | string | Code |
| CloudShare.Classes.Countries.englishName | string | English name |
| CloudShare.Classes.Countries.states | unknown | States |
cloudshare-get-classes-customfields
Retrieves any custom class creation fields defined in a specified project.
Base Command
cloudshare-get-classes-customfields
Input
| Argument Name | Description | Required |
|---|---|---|
| projectId | The id of the project. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Classes.CustomFields.id | string | ID |
| CloudShare.Classes.CustomFields.order | number | Order |
| CloudShare.Classes.CustomFields.name | string | Name |
| CloudShare.Classes.CustomFields.type | number | Type |
| CloudShare.Classes.CustomFields.isRequired | boolean | Is required |
| CloudShare.Classes.CustomFields.regex | string | Regex |
| CloudShare.Classes.CustomFields.defaultValue | unknown | Default value |
| CloudShare.Classes.CustomFields.value | unknown | Value |
cloudshare-get-classes-detailed
Retrieves all the details of a specified class, including full student data.
Base Command
cloudshare-get-classes-detailed
Input
| Argument Name | Description | Required |
|---|---|---|
| classId | The id of the class. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Classes.Class.id | string | ID |
| CloudShare.Classes.Class.name | string | Name |
| CloudShare.Classes.Class.shortId | string | Short ID |
| CloudShare.Classes.Class.policyId | string | Policy ID |
| CloudShare.Classes.Class.policyName | string | Policy name |
| CloudShare.Classes.Class.isUsingClassTypes | boolean | Is issuing class types |
| CloudShare.Classes.Class.blueprintId | string | Blueprint ID |
| CloudShare.Classes.Class.blueprintName | string | Blueprint name |
| CloudShare.Classes.Class.blueprintToken | string | Blueprint token |
| CloudShare.Classes.Class.cloudName | string | Cloud name |
| CloudShare.Classes.Class.timeZoneId | string | Timezone ID |
| CloudShare.Classes.Class.projectId | string | Project ID |
| CloudShare.Classes.Class.projectName | string | Project name |
| CloudShare.Classes.Class.creatorName | string | Creator name |
| CloudShare.Classes.Class.creatorEmail | string | Creator email |
| CloudShare.Classes.Class.instructorVupId | string | Instructor VUP ID |
| CloudShare.Classes.Class.instructorName | string | Instructor name |
| CloudShare.Classes.Class.defaultDurationInMinutes | number | Default duration (mins) |
| CloudShare.Classes.Class.allowStartDateEditing | boolean | Allow start date editing |
| CloudShare.Classes.Class.limitEarlyAccess | number | Limit early access |
| CloudShare.Classes.Class.studentPassphrase | string | Student passphrase |
| CloudShare.Classes.Class.useCustomInvitationEmail | boolean | Use custom invitation email |
| CloudShare.Classes.Class.showCourseAddressField | boolean | Show course address field |
| CloudShare.Classes.Class.address | string | Address |
| CloudShare.Classes.Class.customInvitationEmailSubject | string | Custom invitation email subject |
| CloudShare.Classes.Class.customInvitationEmailBody | string | Custom invitation email body |
| CloudShare.Classes.Class.defaultInvitationEmailSubject | string | Default invitation email subject |
| CloudShare.Classes.Class.defaultInvitationEmailBody | string | Default invitation email subject |
| CloudShare.Classes.Class.showPermitAccessToNonRegisteredStudent | boolean | Show permit access to non-registered student |
| CloudShare.Classes.Class.allowEditDefaultsWhenPermitAccessToNonRegistered | boolean | Allow edit defaults when permit access to non registered |
| CloudShare.Classes.Class.permitAccessToNonRegisteredStudent | boolean | Permit access to non registered student |
| CloudShare.Classes.Class.showMaxStudentsField | boolean | Show max students field |
| CloudShare.Classes.Class.maxStudents | number | Max students |
| CloudShare.Classes.Class.maxLimitOnMaxStudentField | number | Max kimit on max student field |
| CloudShare.Classes.Class.customFieldsValues.id | string | ID |
| CloudShare.Classes.Class.customFieldsValues.order | number | Order |
| CloudShare.Classes.Class.customFieldsValues.name | string | Name |
| CloudShare.Classes.Class.customFieldsValues.type | number | Type |
| CloudShare.Classes.Class.customFieldsValues.isRequired | boolean | Is required |
| CloudShare.Classes.Class.customFieldsValues.regex | string | Regex |
| CloudShare.Classes.Class.customFieldsValues.defaultValue | unknown | Default value |
| CloudShare.Classes.Class.customFieldsValues.value | unknown | Value |
| CloudShare.Classes.Class.instructorEmail | string | Instructor email |
| CloudShare.Classes.Class.timeZoneName | string | Timezone name |
| CloudShare.Classes.Class.startDate | string | Start date |
| CloudShare.Classes.Class.endDate | string | End date |
| CloudShare.Classes.Class.status | string | Status |
| CloudShare.Classes.Students.firstName | string | First name |
| CloudShare.Classes.Students.lastName | string | Last name |
| CloudShare.Classes.Students.email | string | |
| CloudShare.Classes.Students.company | string | Company |
| CloudShare.Classes.Students.jobLevel | string | Job level |
| CloudShare.Classes.Students.address1 | string | Address 1 |
| CloudShare.Classes.Students.address2 | string | Address 2 |
| CloudShare.Classes.Students.city | string | City |
| CloudShare.Classes.Students.state | string | State |
| CloudShare.Classes.Students.zipCode | string | Zip code |
| CloudShare.Classes.Students.country | string | Country |
| CloudShare.Classes.Students.phone | string | Phone |
| CloudShare.Classes.Students.regCode | string | Reg code |
| CloudShare.Classes.Students.id | string | ID |
cloudshare-get-classes-instructors
Retrieves project member users who can be assigned to classes as instructors
Base Command
cloudshare-get-classes-instructors
Input
| Argument Name | Description | Required |
|---|---|---|
| policyId | The ID of a policy. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Classes.Instructors.id | string | ID |
| CloudShare.Classes.Instructors.name | string | Name |
| CloudShare.Classes.Instructors.email | string |
cloudshare-create-class
Creates a class
Base Command
cloudshare-create-class
Input
| Argument Name | Description | Required |
|---|---|---|
| PolicyId | The ID of the policy to apply to the class. The policy will control the runtime and storage time of each student’s environment and what will happen to the environment when it is inactive. | Required |
| BlueprintId | The ID of the blueprint to base the class on. Students who attend the class will be served environments based on this blueprint. | Required |
| ProjectId | The ID of the project in which the class will be created. The specified blueprint and instructor must be from the same project. | Required |
| InstructorVupId | The ID of the project member user to assign to the class as the instructor. | Required |
| RegionId | The ID of the region the class should be created in. | Optional |
| StartDate | The date and time at which to start the class, in MM/DD/YYYY HH:MM AM/PM format. | Required |
| TimeZoneId | The ID of the timezone for the startDate. | Required |
| StudentPassphrase | The passphrase that students will need to enter in order to attend the class. | Required |
| UseCustomInvitationEmail | Whether or not the student invitation email is customized. Possible values are: false, true. Default is false. | Optional |
| LimitEarlyAccess | This option controls access by students and instructor to a lab before scheduled class time. Possible values: 0 - Allow lab access before class (default). 1 - Allow lab access before class for instructor only. 2 - No early access allowed. Possible values are: 0, 1, 2. Default is 0. | Required |
| CustomInvitationEmailSubject | The subject line of the custom student invitation email. Used if UseCustomInvitationEmail is set to true. | Optional |
| CustomInvitationEmailBody | The body of the custom student invitation email. Used if UseCustomInvitationEmail is set to true. | Optional |
| PermitAccessToNonRegisteredStudent | Whether to permit users to self register as students for the class. Possible values are: false, true. Default is false. | Optional |
| MaxStudents | Numeric. The maximum number of students allowed in the class (can be null). Maximum value: 60. | Optional |
| address | The location of the class (JSON dictionary) including keys: state, address1, address2, zipCode, city, country (To retrieve valid values for country, use cloudshare-get-classes-countries). | Optional |
| CustomFieldsValues | Specifies input values for custom fields defined for class creation in the project. Mandatory if project forces validation of custom fields. Fields and valid values depend on custom fields structure for the project. To retrieve custom fields structure for the project, use cloudshare-get-classes-customfields. | Optional |
| enableSteps | Enables the class to have multiple steps. Possible values are: false, true. Default is false. | Optional |
| StudentsCanSwitchStep | Whether students can change steps independently. Applies when enableSteps is set to true. Possible values are: false, true. Default is false. | Optional |
| steps | A list of class steps (JSON dictionaries) for a multi-step class. Must be provided if enableSteps is set to true. | Optional |
| selfPaced | Creates a Self-Paced Class that allows a student to enter class at a time convenient to them. Possible values are: false, true. Default is false. | Optional |
| allowMultipleStudentLogin | When set to true, allows for more than one environment activation per student. Possible values are: false, true. Default is false. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Classes.id | string | ID |
cloudshare-send-class-invitations
Sends invitations to students to attend a class
Base Command
cloudshare-send-class-invitations
Input
| Argument Name | Description | Required |
|---|---|---|
| classId | The ID of the class. | Required |
| studentIds | A list (CSV) of IDs of students to send invite invitations to. | Required |
Context Output
There is no context output for this command.
cloudshare-suspend-class-environments
Suspends all running student environments in a specified class
Base Command
cloudshare-suspend-class-environments
Input
| Argument Name | Description | Required |
|---|---|---|
| classId | The ID of the class. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Classes.Suspended.failed.id | string | ID |
| CloudShare.Classes.Suspended.succeed.id | string | ID |
| CloudShare.Classes.Suspended.succeed.email | string | |
| CloudShare.Classes.Suspended.succeed.fullName | string | Full name |
| CloudShare.Classes.Suspended.succeed.envId | string | Environment ID |
cloudshare-modify-class
Modifies a class
Base Command
cloudshare-modify-class
Input
| Argument Name | Description | Required |
|---|---|---|
| instructorVupId | The ID of the project member user to assign to the class as the instructor. | Optional |
| startDate | The date and time at which to start the class, in MM/DD/YYYY HH:MM AM/PM format. | Optional |
| timeZoneId | The ID of the timezone for the startDate. | Optional |
| studentPassphrase | The passphrase that students will need to enter in order to attend the class. | Optional |
| useCustomInvitationEmail | Whether or not the student invitation email is customized. Possible values are: false, true. Default is false. | Optional |
| limitEarlyAccess | This option controls access by students and instructor to a lab before scheduled class time. Possible values: 0 - Allow lab access before class (default). 1 - Allow lab access before class for instructor only. 2 - No early access allowed. Possible values are: 0, 1, 2. Default is 0. | Optional |
| customInvitationEmailSubject | The subject line of the custom student invitation email. Used if UseCustomInvitationEmail is set to true. | Optional |
| customInvitationEmailBody | The body of the custom student invitation email. Used if UseCustomInvitationEmail is set to true. | Optional |
| permitAccessToNonRegisteredStudent | Whether to permit users to self register as students for the class. Possible values are: false, true. Default is false. | Optional |
| maxStudents | Numeric. The maximum number of students allowed in the class (can be null). Maximum value: 60. | Optional |
| address | The location of the class (JSON dictionary) including keys: state, address1, address2, zipCode, city, country (To retrieve valid values for country, use cloudshare-get-classes-countries). | Optional |
| customFieldsValues | Specifies input values for custom fields defined for class creation in the project. Mandatory if project forces validation of custom fields. Fields and valid values depend on custom fields structure for the project. To retrieve custom fields structure for the project, use cloudshare-get-classes-customfields. | Optional |
| selfPaced | Creates a Self-Paced Class that allows a student to enter class at a time convenient to them. Possible values are: false, true. Default is false. | Optional |
| allowMultipleStudentLogin | When set to true, allows for more than one environment activation per student. Possible values are: false, true. Default is false. | Optional |
| classId | The ID of the class. | Required |
| name | The name of the class. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Classes.id | string | ID |
| CloudShare.Classes.name | string | Name |
| CloudShare.Classes.shortId | string | Short ID |
| CloudShare.Classes.policyId | string | Policy ID |
| CloudShare.Classes.policyName | string | Policy name |
| CloudShare.Classes.isUsingClassTypes | boolean | Is issuing class types |
| CloudShare.Classes.blueprintId | string | Blueprint ID |
| CloudShare.Classes.blueprintName | string | Blueprint name |
| CloudShare.Classes.blueprintToken | string | Blueprint token |
| CloudShare.Classes.cloudName | string | Cloud name |
| CloudShare.Classes.timeZoneId | string | Timezone ID |
| CloudShare.Classes.projectId | string | Project ID |
| CloudShare.Classes.projectName | string | Project name |
| CloudShare.Classes.creatorName | string | Creator name |
| CloudShare.Classes.creatorEmail | string | Creator email |
| CloudShare.Classes.instructorVupId | string | Instructor VUP ID |
| CloudShare.Classes.instructorName | string | Instructor name |
| CloudShare.Classes.defaultDurationInMinutes | number | Default duration (mins) |
| CloudShare.Classes.allowStartDateEditing | boolean | Allow start date editing |
| CloudShare.Classes.limitEarlyAccess | number | Limit early access |
| CloudShare.Classes.studentPassphrase | string | Student passphrase |
| CloudShare.Classes.useCustomInvitationEmail | boolean | Use custom invitation email |
| CloudShare.Classes.showCourseAddressField | boolean | Show course address field |
| CloudShare.Classes.address | string | Address |
| CloudShare.Classes.customInvitationEmailSubject | string | Custom invitation email subject |
| CloudShare.Classes.customInvitationEmailBody | string | Custom invitation email body |
| CloudShare.Classes.defaultInvitationEmailSubject | string | Default invitation email subject |
| CloudShare.Classes.defaultInvitationEmailBody | string | Default invitation email subject |
| CloudShare.Classes.showPermitAccessToNonRegisteredStudent | boolean | Show permit access to non-registered student |
| CloudShare.Classes.allowEditDefaultsWhenPermitAccessToNonRegistered | boolean | Allow edit defaults when permit access to non registered |
| CloudShare.Classes.permitAccessToNonRegisteredStudent | boolean | Permit access to non registered student |
| CloudShare.Classes.showMaxStudentsField | boolean | Show max students field |
| CloudShare.Classes.maxStudents | number | Max students |
| CloudShare.Classes.maxLimitOnMaxStudentField | number | Max kimit on max student field |
| CloudShare.Classes.customFieldsValues.id | string | ID |
| CloudShare.Classes.customFieldsValues.order | number | Order |
| CloudShare.Classes.customFieldsValues.name | string | Name |
| CloudShare.Classes.customFieldsValues.type | number | Type |
| CloudShare.Classes.customFieldsValues.isRequired | boolean | Is required |
| CloudShare.Classes.customFieldsValues.regex | string | Regex |
| CloudShare.Classes.customFieldsValues.defaultValue | unknown | Default value |
| CloudShare.Classes.customFieldsValues.value | unknown | Value |
| CloudShare.Classes.instructorEmail | string | Instructor email |
| CloudShare.Classes.timeZoneName | string | Timezone name |
| CloudShare.Classes.startDate | string | Start date |
| CloudShare.Classes.endDate | string | End date |
| CloudShare.Classes.status | string | Status |
cloudshare-get-students
Retrieves information about the students in a class
Base Command
cloudshare-get-students
Input
| Argument Name | Description | Required |
|---|---|---|
| classId | The ID of the class. | Required |
| isFull | Whether to return the details of the VMs in each student’s environment as well as other details. Possible values are: false, true. Default is false. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Students.status | number | Status |
| CloudShare.Students.envStatus | number | Environemtn Status |
| CloudShare.Students.envCommands | unknown | Environment commands |
| CloudShare.Students.envId | string | Environment ID |
| CloudShare.Students.firstName | string | First name |
| CloudShare.Students.lastName | string | Last name |
| CloudShare.Students.email | string | |
| CloudShare.Students.id | string | ID |
| CloudShare.Students.VMs.id | string | ID |
| CloudShare.Students.VMs.name | string | Name |
cloudshare-get-student
Retrieves information about a student in a class, including the student’s environment and VMs
Base Command
cloudshare-get-student
Input
| Argument Name | Description | Required |
|---|---|---|
| classId | The ID of the class. | Required |
| studentId | The ID of the student in the class. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Students.status | number | Status |
| CloudShare.Students.envStatus | number | Environemtn Status |
| CloudShare.Students.envCommands | unknown | Environment commands |
| CloudShare.Students.envId | string | Environment ID |
| CloudShare.Students.firstName | string | First name |
| CloudShare.Students.lastName | string | Last name |
| CloudShare.Students.email | string | |
| CloudShare.Students.id | string | ID |
| CloudShare.Students.VMs.id | string | ID |
| CloudShare.Students.VMs.name | string | Name |
cloudshare-delete-student
Removes a student from a class
Base Command
cloudshare-delete-student
Input
| Argument Name | Description | Required |
|---|---|---|
| classId | The ID of the class. | Required |
| studentId | The ID of the student. | Required |
Context Output
There is no context output for this command.
cloudshare-register-student
Registers a student for a class
Base Command
cloudshare-register-student
Input
| Argument Name | Description | Required |
|---|---|---|
| classID | The ID of the class. | Required |
| The student’s email address. | Required | |
| firstName | The student’s first name. | Required |
| lastName | The student’s last name. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Students.id | string | ID |
cloudshare-modify-student
Modifies a student’s registration details
Base Command
cloudshare-modify-student
Input
| Argument Name | Description | Required |
|---|---|---|
| classId | The ID of the class for which the student is registered. | Required |
| studentId | The ID of the student. | Required |
| The student’s email address. This can be changed as long as the student did not yet log in. | Optional | |
| firstName | The student’s first name. | Optional |
| lastName | The student’s last name. | Optional |
Context Output
There is no context output for this command.
cloudshare-get-regions
Retrieves available regions
Base Command
cloudshare-get-regions
Input
| Argument Name | Description | Required |
| — | — | — |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Regions.id | string | ID |
| CloudShare.Regions.name | string | Name |
| CloudShare.Regions.cloudName | string | Cloud name |
| CloudShare.Regions.friendlyName | string | Friendly name |
cloudshare-get-timezones
Retrieves available time zones
Base Command
cloudshare-get-timezones
Input
| Argument Name | Description | Required |
| — | — | — |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Timezones.id | string | ID |
| CloudShare.Timezones.displayName | string | Display name |
cloudshare-get-env-resource
Retrieves the total resources that have been used by an environment
Base Command
cloudshare-get-env-resource
Input
| Argument Name | Description | Required |
|---|---|---|
| envId | The environment ID. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.EnvironmentResources.totalRuntimeHours | number | Total run time |
| CloudShare.EnvironmentResources.totalGbh | number | Total GB / hour |
| CloudShare.EnvironmentResources.maxDiskGb | number | Max disk space(GB) |
| CloudShare.EnvironmentResources.lastUpdateTime | string | Last update time |
| CloudShare.EnvironmentResources.name | string | Name |
| CloudShare.EnvironmentResources.id | string | ID |
cloudshare-get-env-extended
Retrieves details of an environment along with VM information
Base Command
cloudshare-get-env-extended
Input
| Argument Name | Description | Required |
|---|---|---|
| envId | The ID of the environment. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Environments.projectId | string | Project ID |
| CloudShare.Environments.policyId | string | Policy ID |
| CloudShare.Environments.blueprintId | string | Blueprint ID |
| CloudShare.Environments.description | string | Description |
| CloudShare.Environments.ownerEmail | string | Owner email |
| CloudShare.Environments.regionId | string | Region ID |
| CloudShare.Environments.name | string | Name |
| CloudShare.Environments.id | string | ID |
| CloudShare.Environments.status | string | Status |
| CloudShare.Environments.teamId | string | Team ID |
| CloudShare.Environments.VMs.id | string | ID |
| CloudShare.Environments.VMs.name | string | Name |
| CloudShare.Environments.VMs.description | string | Description |
| CloudShare.Environments.VMs.statusText | string | Status text |
| CloudShare.Environments.VMs.progress | number | Progress |
| CloudShare.Environments.VMs.imageId | string | Image ID |
| CloudShare.Environments.VMs.os | string | OS |
| CloudShare.Environments.VMs.webAccessUrl | string | Web access URL |
| CloudShare.Environments.VMs.fqdn | string | FQDN |
| CloudShare.Environments.VMs.externalAddress | string | External address |
| CloudShare.Environments.VMs.internalAddresses | unknown | Internal addresses |
| CloudShare.Environments.VMs.cpuCount | number | CPU count |
| CloudShare.Environments.VMs.diskSizeGb | number | Disk size(GB) |
| CloudShare.Environments.VMs.memorySizeMb | number | Memory size(MB) |
| CloudShare.Environments.VMs.username | string | Username |
| CloudShare.Environments.VMs.password | string | Password |
| CloudShare.Environments.VMs.consoleToken | string | Console token |
cloudshare-get-env-extended-vanity
Uses the vanity name or FQDN of a VM to retrieve details of an environment and its VMs
Base Command
cloudshare-get-env-extended-vanity
Input
| Argument Name | Description | Required |
|---|---|---|
| machineVanity | Specifies the vanity name or FQDN of a machine. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Environments.projectId | string | Project ID |
| CloudShare.Environments.policyId | string | Policy ID |
| CloudShare.Environments.blueprintId | string | Blueprint ID |
| CloudShare.Environments.description | string | Description |
| CloudShare.Environments.ownerEmail | string | Owner email |
| CloudShare.Environments.regionId | string | Region ID |
| CloudShare.Environments.name | string | Name |
| CloudShare.Environments.id | string | ID |
| CloudShare.Environments.status | string | Status |
| CloudShare.Environments.teamId | string | Team ID |
| CloudShare.Environments.VMs.id | string | ID |
| CloudShare.Environments.VMs.name | string | Name |
| CloudShare.Environments.VMs.description | string | Description |
| CloudShare.Environments.VMs.statusText | string | Status text |
| CloudShare.Environments.VMs.progress | number | Progress |
| CloudShare.Environments.VMs.imageId | string | Image ID |
| CloudShare.Environments.VMs.os | string | OS |
| CloudShare.Environments.VMs.webAccessUrl | string | Web access URL |
| CloudShare.Environments.VMs.fqdn | string | FQDN |
| CloudShare.Environments.VMs.externalAddress | string | External address |
| CloudShare.Environments.VMs.internalAddresses | unknown | Internal addresses |
| CloudShare.Environments.VMs.cpuCount | number | CPU count |
| CloudShare.Environments.VMs.diskSizeGb | number | Disk size(GB) |
| CloudShare.Environments.VMs.memorySizeMb | number | Memory size(MB) |
| CloudShare.Environments.VMs.username | string | Username |
| CloudShare.Environments.VMs.password | string | Password |
| CloudShare.Environments.VMs.consoleToken | string | Console token |
cloudshare-get-env-extended-token
Uses a sponsored login token to retrieve details of an environment along with VM information
Base Command
cloudshare-get-env-extended-token
Input
| Argument Name | Description | Required |
|---|---|---|
| sponsoredLoginToken | Specifies the token. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Environments.projectId | string | Project ID |
| CloudShare.Environments.policyId | string | Policy ID |
| CloudShare.Environments.blueprintId | string | Blueprint ID |
| CloudShare.Environments.description | string | Description |
| CloudShare.Environments.ownerEmail | string | Owner email |
| CloudShare.Environments.regionId | string | Region ID |
| CloudShare.Environments.name | string | Name |
| CloudShare.Environments.id | string | ID |
| CloudShare.Environments.status | string | Status |
| CloudShare.Environments.teamId | string | Team ID |
| CloudShare.Environments.VMs.id | string | ID |
| CloudShare.Environments.VMs.name | string | Name |
| CloudShare.Environments.VMs.description | string | Description |
| CloudShare.Environments.VMs.statusText | string | Status text |
| CloudShare.Environments.VMs.progress | number | Progress |
| CloudShare.Environments.VMs.imageId | string | Image ID |
| CloudShare.Environments.VMs.os | string | OS |
| CloudShare.Environments.VMs.webAccessUrl | string | Web access URL |
| CloudShare.Environments.VMs.fqdn | string | FQDN |
| CloudShare.Environments.VMs.externalAddress | string | External address |
| CloudShare.Environments.VMs.internalAddresses | unknown | Internal addresses |
| CloudShare.Environments.VMs.cpuCount | number | CPU count |
| CloudShare.Environments.VMs.diskSizeGb | number | Disk size(GB) |
| CloudShare.Environments.VMs.memorySizeMb | number | Memory size(MB) |
| CloudShare.Environments.VMs.username | string | Username |
| CloudShare.Environments.VMs.password | string | Password |
| CloudShare.Environments.VMs.consoleToken | string | Console token |
cloudshare-get-env-multiple-resources
Retrieves all environments that were active in a specified time range, and their resource usage. Each environment record includes total run time, total RAM-GB Hours, max disk usage and the sponsored token that was used to create the environment, if applicable.
Base Command
cloudshare-get-env-multiple-resources
Input
| Argument Name | Description | Required |
|---|---|---|
| subscriptionId | Specifies a user subscription, where {subscriptionID} is the ID of the subscription. Provide the subscription if the user is a member of multiple subscriptions. | Optional |
| starttime | Specifies the start of the time range, where {starttime_value} is the start of the time range in the format ISO 8601. For example, “2017-01-01”. | Required |
| endtime | Specifies the end of the time range, where {endtime_value} is the end of the time range in the format ISO 8601. For example, ‘2017-02-01’. | Required |
| skip | Optional. Specifies to skip the first {skip_value} records, where {skip_value} is an integer (default: 0). Can be used iteratively in conjunction with take to view distinct sets of environment records. | Optional |
| take | Optional. Limits the number of records returned, where {take_value} is the maximum number of records to return. Integer (default: 1000, maximum: 1000). | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.EnvironmentResources.sponsoredLoginToken | string | Sponsored login token |
| CloudShare.EnvironmentResources.totalRuntimeHours | number | Total run time (hours) |
| CloudShare.EnvironmentResources.totalGbh | number | Total GB / hour |
| CloudShare.EnvironmentResources.maxDiskGb | number | Max disk(GB) |
| CloudShare.EnvironmentResources.lastUpdateTime | string | Last update time |
| CloudShare.EnvironmentResources.name | string | Name |
| CloudShare.EnvironmentResources.id | string | ID |
cloudshare-extend-env
Extends the lifetime of an environment
Base Command
cloudshare-extend-env
Input
| Argument Name | Description | Required |
|---|---|---|
| envId | Specifies the environment, where {envId} is the environment’s ID. | Required |
Context Output
There is no context output for this command.
cloudshare-postpone-env-suspend
Postpones an environment’s suspended state Request Path
Base Command
cloudshare-postpone-env-suspend
Input
| Argument Name | Description | Required |
|---|---|---|
| envId | Specifies the environment, where {envId} is the environment’s ID. | Required |
Context Output
There is no context output for this command.
cloudshare-resume-env
Resumes an environment that was previously suspended, returning it to active running state
Base Command
cloudshare-resume-env
Input
| Argument Name | Description | Required |
|---|---|---|
| envId | Specifies the environment, where {envId} is the environment’s ID. | Required |
Context Output
There is no context output for this command.
cloudshare-revert-env
Reverts an environment to a specified snapshot
Base Command
cloudshare-revert-env
Input
| Argument Name | Description | Required |
|---|---|---|
| envId | Specifies the environment, where {envId} is the environment’s ID. | Required |
| snapshotId | Specifies the snapshot to which to revert the environment, where {snapshotId} is the snapshot’s ID. | Required |
Context Output
There is no context output for this command.
cloudshare-suspend-env
Suspends an environment
Base Command
cloudshare-suspend-env
Input
| Argument Name | Description | Required |
|---|---|---|
| envId | Specifies the environment, where {envId} is the environment’s ID. | Required |
Context Output
There is no context output for this command.
cloudshare-get-env
Retrieves properties of an environment and enables verification of the requesting user’s permissions to the environment
Base Command
cloudshare-get-env
Input
| Argument Name | Description | Required |
|---|---|---|
| envID | The environment’s ID. | Required |
| permission | Specifies a type of permission to access the environment. Returns an error (status code 500) if the requesting user does not have the specified permission level. Otherwise, returns the environment properties. Possible values are: view, edit, owner. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Environments.projectId | string | Project ID |
| CloudShare.Environments.policyId | string | Policy ID |
| CloudShare.Environments.description | string | Description |
| CloudShare.Environments.ownerEmail | string | Owner email |
| CloudShare.Environments.regionId | string | Region ID |
| CloudShare.Environments.name | string | Name |
| CloudShare.Environments.id | string | ID |
| CloudShare.Environments.status | string | Status |
| CloudShare.Environments.teamId | string | Team ID |
cloudshare-delete-env
Deletes an environment
Base Command
cloudshare-delete-env
Input
| Argument Name | Description | Required |
|---|---|---|
| envID | The Id of the environment. | Required |
Context Output
There is no context output for this command.
cloudshare-create-env
Creates an environment from a snapshot or from one or more VM templates
Base Command
cloudshare-create-env
Input
| Argument Name | Description | Required |
|---|---|---|
| environment | Specifies details (JSON) of the environment to create. Please refer to https://docs.cloudshare.com/rest-api/v3/environments/envs/post-envs/ for the format. | Required |
| itemsCart | Specifies templates (JSON array) from which to build the environment. Please refer to https://docs.cloudshare.com/rest-api/v3/environments/envs/post-envs/ for the format. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Environments.resources.cpuCount | number | CPU count |
| CloudShare.Environments.resources.diskSizeMB | number | Disk size(MB) |
| CloudShare.Environments.resources.memorySizeMB | number | Memory size(MB) |
| CloudShare.Environments.VMs.name | string | Name |
| CloudShare.Environments.VMs.description | string | Description |
| CloudShare.Environments.VMs.osTypeName | string | OS type name |
| CloudShare.Environments.VMs.imageUrl | string | Image URL |
| CloudShare.Environments.VMs.resources.cpuCount | number | CPU count |
| CloudShare.Environments.VMs.resources.diskSizeMB | number | Disk size(MB) |
| CloudShare.Environments.VMs.resources.memorySizeMB | number | Memory size(MB) |
| CloudShare.Environments.VMs.domainName | string | Domain name |
| CloudShare.Environments.VMs.internalIPs | unknown | Internal IPs |
| CloudShare.Environments.VMs.macAddresses | unknown | MAC addresses |
| CloudShare.Environments.VMs.canAddMultipleInstances | boolean | Can add multiple instances |
| CloudShare.Environments.VMs.hostName | string | Hostname |
| CloudShare.Environments.VMs.vanityName | string | Vanity name |
| CloudShare.Environments.VMs.httpAccessEnabled | boolean | HTTP access enabled |
| CloudShare.Environments.VMs.startWithHttps | boolean | Start with HTTPS |
| CloudShare.Environments.VMs.user | string | User |
| CloudShare.Environments.VMs.password | string | Password |
| CloudShare.Environments.VMs.id | string | ID |
| CloudShare.Environments.environmentId | string | Environment ID |
| CloudShare.Environments.id | string | ID |
cloudshare-modify-env
Adds one or more VMs to an existing environment
Base Command
cloudshare-modify-env
Input
| Argument Name | Description | Required |
|---|---|---|
| envId | The ID of the environment. | Required |
| itemsCart | Specifies templates (JSON array) of VMs to add to the environment. Please refer to https://docs.cloudshare.com/rest-api/v3/environments/envs/post-envs/ for the format. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Environments.resources.cpuCount | number | CPU count |
| CloudShare.Environments.resources.diskSizeMB | number | Disk size(MB) |
| CloudShare.Environments.resources.memorySizeMB | number | Memory size(MB) |
| CloudShare.Environments.VMs.name | string | Name |
| CloudShare.Environments.VMs.description | string | Description |
| CloudShare.Environments.VMs.osTypeName | string | OS type name |
| CloudShare.Environments.VMs.imageUrl | string | Image URL |
| CloudShare.Environments.VMs.resources.cpuCount | number | CPU count |
| CloudShare.Environments.VMs.resources.diskSizeMB | number | Disk size(MB) |
| CloudShare.Environments.VMs.resources.memorySizeMB | number | Memory size(MB) |
| CloudShare.Environments.VMs.domainName | string | Domain name |
| CloudShare.Environments.VMs.internalIPs | unknown | Internal IPs |
| CloudShare.Environments.VMs.macAddresses | unknown | MAC addresses |
| CloudShare.Environments.VMs.canAddMultipleInstances | boolean | Can add multiple instances |
| CloudShare.Environments.VMs.hostName | string | Hostname |
| CloudShare.Environments.VMs.vanityName | string | Vanity name |
| CloudShare.Environments.VMs.httpAccessEnabled | boolean | HTTP access enabled |
| CloudShare.Environments.VMs.startWithHttps | boolean | Start with HTTPS |
| CloudShare.Environments.VMs.user | string | User |
| CloudShare.Environments.VMs.password | string | Password |
| CloudShare.Environments.VMs.id | string | ID |
| CloudShare.Environments.environmentId | string | Environment ID |
| CloudShare.Environments.id | string | ID |
cloudshare-delete-vm
Deletes a VM
Base Command
cloudshare-delete-vm
Input
| Argument Name | Description | Required |
|---|---|---|
| VmID | The ID of the VM. | Optional |
Context Output
There is no context output for this command.
cloudshare-check-vm-execution-status
Checks the status of a previously executed command line script
Base Command
cloudshare-check-vm-execution-status
Input
| Argument Name | Description | Required |
|---|---|---|
| vmID | The ID of the VM on which the script was executed. | Required |
| executionId | The ID returned by the execution request. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.VM.Executions.id | string | ID |
| CloudShare.VM.Executions.exitCode | number | Exit code |
| CloudShare.VM.Executions.success | boolean | Success |
| CloudShare.VM.Executions.standardOutput | string | Standard output |
| CloudShare.VM.Executions.standardError | string | Standard error |
| CloudShare.VM.Executions.executedPath | string | Executed path |
cloudshare-get-vm-remote-access-file
Retrieves the content of a .rdp file that provides remote desktop access to the specified VM. An .rdp file comprising the returned content opens a remote desktop session to the VM from a Windows machine. It can also be used on Linux with FreeRDP or on Mac with Microsoft Remote Access.
Base Command
cloudshare-get-vm-remote-access-file
Input
| Argument Name | Description | Required |
|---|---|---|
| VmID | The ID of the VM. | Optional |
| desktopHeight | The height resolution of the remote access session, in pixels. | Required |
| desktopWidth | The width resolution of the remote access session, in pixels. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.VM.Remote.VmID | string | VM ID |
| CloudShare.VM.Remote.rdpFileContent | string | RDP file content |
| CloudShare.VM.Remote.clearTextPassword | string | Clear text password |
cloudshare-execute-vm-command
Executes a command line script on a VM
Base Command
cloudshare-execute-vm-command
Input
| Argument Name | Description | Required |
|---|---|---|
| vmId | The ID of the VM. | Required |
| path | Path in VM. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.VM.Execute.executionId | string | Execution ID |
cloudshare-modify-vm-hardware
Adjusts a VM’s CPU count, disk size, and RAM
Base Command
cloudshare-modify-vm-hardware
Input
| Argument Name | Description | Required |
|---|---|---|
| vmID | The ID of the VM. | Required |
| numCpus | Number of CPUs. | Required |
| memorySizeMBs | RAM size, in megabytes. | Required |
| diskSizeGBs | Disk size, in gigabytes. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.VM.Modify.vmID | string | VM ID |
| CloudShare.VM.Modify.conflictsFound | boolean | Conflicts found |
| CloudShare.VM.Modify.conflicts | string | Conflicts |
cloudshare-reboot-vm
Reboots a VM
Base Command
cloudshare-reboot-vm
Input
| Argument Name | Description | Required |
|---|---|---|
| VmID | The ID of the VM. | Required |
Context Output
There is no context output for this command.
cloudshare-revert-vm
Reverts a VM
Base Command
cloudshare-revert-vm
Input
| Argument Name | Description | Required |
|---|---|---|
| VmID | The ID of the VM. | Required |
Context Output
There is no context output for this command.
cloudshare-get-cloud-folders
Retrieves the user’s cloud folder and the user’s projects’ project folder(s)
Base Command
cloudshare-get-cloud-folders
Input
| Argument Name | Description | Required |
| — | — | — |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Folders.host | string | Host |
| CloudShare.Folders.path | string | Path |
| CloudShare.Folders.userName | string | Username |
| CloudShare.Folders.password | string | Password |
| CloudShare.Folders.userFolder.name | string | Name |
| CloudShare.Folders.userFolder.quotaSizeGB | string | Quota size(GB) |
| CloudShare.Folders.userFolder.quotaSizeInUseGB | string | Quota size in use(GB) |
| CloudShare.Folders.userFolder.usagePercentage | string | Usage percentage |
| CloudShare.Folders.projectFolders.name | string | Name |
| CloudShare.Folders.projectFolders.quotaSizeGB | string | Quota size(GB) |
| CloudShare.Folders.projectFolders.quotaSizeInUseGB | string | Quota size in use(GB) |
| CloudShare.Folders.projectFolders.usagePercentage | string | Usage percentage |
cloudshare-get-env-cloud-folders
Shows the cloud folder on all of the environment’s machines
Base Command
cloudshare-get-env-cloud-folders
Input
| Argument Name | Description | Required |
|---|---|---|
| EnvId | The ID of the environment. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.EnvFolders.name | string | Name |
| CloudShare.EnvFolders.sanitizedName | string | Santized name |
| CloudShare.EnvFolders.windowsFolder | string | Windows folder |
| CloudShare.EnvFolders.linuxFolder | string | Linux folder |
| CloudShare.EnvFolders.token | string | Token |
cloudshare-generate-cloud-folder-password
Generates a new FTP password for accessing the user’s cloud folders.
Base Command
cloudshare-generate-cloud-folder-password
Input
| Argument Name | Description | Required |
| — | — | — |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.FoldersPassword.newPassword | string | New password |
| CloudShare.FoldersPassword.newFtpUri | string | New FTP URI |
cloudshare-unmount-env-folders
Hides the cloud folder on all of the environment’s machines
Base Command
cloudshare-unmount-env-folders
Input
| Argument Name | Description | Required |
|---|---|---|
| EnvId | The ID of the environment. | Required |
Context Output
There is no context output for this command.
cloudshare-get-templates
Retrieves VM templates and blueprints
Base Command
cloudshare-get-templates
Input
| Argument Name | Description | Required |
|---|---|---|
| templateType | Filters the results by type of template. Possible values: 0 - Returns blueprints only. 1 - Returns VM templates only. Possible values are: 0, 1. | Optional |
| projectId | Filters the results to include only blueprints that belong to a specific project. | Optional |
| regionId | Filters the results to include only templates that belong to a specific region. | Optional |
| skip | Specifies to skip the first {skip} records, where {skip} is an integer. | Optional |
| take | Limits the number of records returned, where {take_value} is the maximum number of records to return. Integer (default: 1000, maximum: 1000). | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Templates.name | string | Name |
| CloudShare.Templates.description | string | Description |
| CloudShare.Templates.isEnvironmentTemplate | boolean | Is environment template |
| CloudShare.Templates.type | number | Type |
| CloudShare.Templates.imageUrl | string | Image URL |
| CloudShare.Templates.regionId | string | Region ID |
| CloudShare.Templates.tags | unknown | Tags |
| CloudShare.Templates.categories | unknown | Categories |
| CloudShare.Templates.resources.cpuCount | number | CPU count |
| CloudShare.Templates.resources.diskSizeMB | number | Disk size(MB) |
| CloudShare.Templates.resources.memorySizeMB | number | Memory size(MB) |
| CloudShare.Templates.numberOfMachines | number | Number of mahcines |
| CloudShare.Templates.hasMultipleVersions | boolean | Has multiple versions |
| CloudShare.Templates.hasDefaultVersion | boolean | Has default version |
| CloudShare.Templates.disabledForRegularEnvironmentCreation | boolean | Disabled for regular environment creation |
| CloudShare.Templates.disabledForTrainingEnvironmentCreation | boolean | Disabled for training environment creation |
| CloudShare.Templates.canAddMultipleInstances | boolean | Can add multiple instances |
| CloudShare.Templates.envTemplateScope | unknown | Env template scopt |
| CloudShare.Templates.creationDate | string | Creation date |
| CloudShare.Templates.id | string | ID |
cloudshare-get-snapshot
Retrieves details of a snapshot
Base Command
cloudshare-get-snapshot
Input
| Argument Name | Description | Required |
|---|---|---|
| snapshotID | The ID of the snapshot. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Snapshots.authorName | string | Author name |
| CloudShare.Snapshots.comment | string | Comment |
| CloudShare.Snapshots.createTime | string | Create time |
| CloudShare.Snapshots.description | string | Description |
| CloudShare.Snapshots.id | string | ID |
| CloudShare.Snapshots.imageUrl | string | Image URL |
| CloudShare.Snapshots.isDefault | boolean | Is default |
| CloudShare.Snapshots.isLatest | boolean | Is latest |
| CloudShare.Snapshots.machines.canAddMultipleInstances | boolean | Can add multiple instances |
| CloudShare.Snapshots.machines.description | string | Description |
| CloudShare.Snapshots.machines.domainName | string | Domain name |
| CloudShare.Snapshots.machines.hostName | string | Hostname |
| CloudShare.Snapshots.machines.httpAccessEnabled | boolean | HTTP access enabled |
| CloudShare.Snapshots.machines.id | string | ID |
| CloudShare.Snapshots.machines.id | string | Image URL |
| CloudShare.Snapshots.machines.internalIPs | unknown | Internal IPs |
| CloudShare.Snapshots.machines.macAddresses | unknown | MAC addresses |
| CloudShare.Snapshots.machines.name | string | Name |
| CloudShare.Snapshots.machines.osTypeName | string | OS type name |
| CloudShare.Snapshots.machines.password | string | Password |
| CloudShare.Snapshots.machines.resources.cpuCount | number | CPU count |
| CloudShare.Snapshots.machines.resources.diskSizeMB | number | Disk size(MB) |
| CloudShare.Snapshots.machines.resources.memorySizeMB | number | Memory size(MB) |
| CloudShare.Snapshots.machines.startWithHttps | boolean | Start with HTTPS |
| CloudShare.Snapshots.machines.user | string | User |
| CloudShare.Snapshots.machines.vanityName | string | Vanity name |
| CloudShare.Snapshots.name | string | Name |
| CloudShare.Snapshots.number | number | Number |
| CloudShare.Snapshots.resources.cpuCount | number | CPU count |
| CloudShare.Snapshots.resources.diskSizeMB | number | Disk size(MB) |
| CloudShare.Snapshots.resources.memorySizeMB | number | Memory size(MB) |
| CloudShare.Snapshots.type | number | Type |
| CloudShare.Snapshots.regions | unknown | Regions |
cloudshare-get-env-snapshots
Retrieves all snapshots contained in a specified environment’s blueprint. A blueprint can contain up to five snapshots, with newer snapshots displacing the oldest snapshots in the blueprint.
Base Command
cloudshare-get-env-snapshots
Input
| Argument Name | Description | Required |
|---|---|---|
| envId | The ID of the environment. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Snapshots.authorName | string | Author name |
| CloudShare.Snapshots.comment | string | Comment |
| CloudShare.Snapshots.createTime | string | Create time |
| CloudShare.Snapshots.description | string | Description |
| CloudShare.Snapshots.id | string | ID |
| CloudShare.Snapshots.imageUrl | string | Image URL |
| CloudShare.Snapshots.isDefault | boolean | Is default |
| CloudShare.Snapshots.isLatest | boolean | Is latest |
| CloudShare.Snapshots.machines.canAddMultipleInstances | boolean | Can add multiple instances |
| CloudShare.Snapshots.machines.description | string | Description |
| CloudShare.Snapshots.machines.domainName | string | Domain name |
| CloudShare.Snapshots.machines.hostName | string | Hostname |
| CloudShare.Snapshots.machines.httpAccessEnabled | boolean | HTTP access enabled |
| CloudShare.Snapshots.machines.id | string | ID |
| CloudShare.Snapshots.machines.id | string | Image URL |
| CloudShare.Snapshots.machines.internalIPs | unknown | Internal IPs |
| CloudShare.Snapshots.machines.macAddresses | unknown | MAC addresses |
| CloudShare.Snapshots.machines.name | string | Name |
| CloudShare.Snapshots.machines.osTypeName | string | OS type name |
| CloudShare.Snapshots.machines.password | string | Password |
| CloudShare.Snapshots.machines.resources.cpuCount | number | CPU count |
| CloudShare.Snapshots.machines.resources.diskSizeMB | number | Disk size(MB) |
| CloudShare.Snapshots.machines.resources.memorySizeMB | number | Memory size(MB) |
| CloudShare.Snapshots.machines.startWithHttps | boolean | Start with HTTPS |
| CloudShare.Snapshots.machines.user | string | User |
| CloudShare.Snapshots.machines.vanityName | string | Vanity name |
| CloudShare.Snapshots.name | string | Name |
| CloudShare.Snapshots.number | number | Number |
| CloudShare.Snapshots.resources.cpuCount | number | CPU count |
| CloudShare.Snapshots.resources.diskSizeMB | number | Disk size(MB) |
| CloudShare.Snapshots.resources.memorySizeMB | number | Memory size(MB) |
| CloudShare.Snapshots.type | number | Type |
| CloudShare.Snapshots.regions | unknown | Regions |
cloudshare-mark-default-snapshot
Marks a specified snapshot as the default snapshot in its containing blueprint. New environments created from a blueprint are based on the default snapshot in the blueprint. This request enables you to change which snapshot is the default snapshot in a given blueprint so that new environments will be based on the snapshot of your choice.
Base Command
cloudshare-mark-default-snapshot
Input
| Argument Name | Description | Required |
|---|---|---|
| snapshotID | The ID of the snapshot that you want to mark as default. | Required |
Context Output
There is no context output for this command.
cloudshare-take-snapshot-env
Takes a snapshot of an environment
Base Command
cloudshare-take-snapshot-env
Input
| Argument Name | Description | Required |
|---|---|---|
| envId | The ID of the environment of which to take the snapshot. | Required |
| name | A name for the new snapshot. Should not exceed 32 characters. | Required |
| description | A description for the new snapshot. | Optional |
| newBlueprintName | A name to assign to a new blueprint. If specified, the snapshot is created in a new blueprint with the specified name, rather than in the default environment blueprint. Must be null if there is not yet at least one snapshot in the default environment blueprint. If specified, otherBlueprintId must be null. If both newBlueprintName and otherBlueprintId are null, the snapshot is created in the default environment blueprint. | Optional |
| otherBlueprintId | The ID of an existing blueprint. If specified, the snapshot is created in the specified blueprint rather than in the default environment blueprint. Must be null if there is not yet at least one snapshot in the default environment blueprint. If specified, newBlueprintName must be null. If both newBlueprintName and otherBlueprintId are null, the snapshot is created in the default environment blueprint. | Optional |
| setAsDefault | Defaults to true. If true, the new snapshot is marked as the default snapshot in the containing blueprint. Possible values are: true, false. Default is true. | Optional |
Context Output
There is no context output for this command.
cloudshare-get-teams
Retrieves all available teams in all available projects
Base Command
cloudshare-get-teams
Input
| Argument Name | Description | Required |
| — | — | — |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Teams.Name | string | Name |
| CloudShare.Teams.Id | string | ID |
cloudshare-invite-user-poc
Invite an end user to a POC, based on a specified blueprint, and assigns a specific project member user to be the owning project member for the end user. A policy ID, blueprint ID and owning project member ID must be specified.
Base Command
cloudshare-invite-user-poc
Input
| Argument Name | Description | Required |
|---|---|---|
| policyId | The ID of the environment policy to assign to the environment created for the end user as part of the POC. The policy will govern the life cycle of the end user’s environment. | Optional |
| blueprintId | The ID of the blueprint based on which the end user’s environment will be created (this is the POC’s blueprint). | Required |
| OwningProjectMemberId | The ID of the project member user to whom the end user will be assigned. | Required |
| opportunity | The name of the business opportunity to be associated with the end user. | Required |
| validForDays | The number of days to keep the invitation valid for. | Required |
| The recipient’s email. The invitation will be sent to the specified email. | Required | |
| firstName | The recipient’s first name. | Required |
| LastName | The recipient’s last name. | Required |
| regionId | The region in which to create the POC’s environment. | Optional |
| InviteeCanSetEmail | Indicates whether an end user can set email when accepting the invitation. Default is true. Possible values are: true, false. Default is true. | Optional |
| customEmailSubject | The subject of the email. The invitation will be sent with the specified custom email subject. This value will override the custom email subject in the UI. | Optional |
| customEmailBody | The body of the email. The invitation will be sent with the specified custom email body. This value will override the custom email body in the UI. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.Invites.invitationDetailsUrl | string | Invitation details URL |
| CloudShare.Invites.acceptInvitationUrl | string | Accept invitation URL |
| CloudShare.Invites.message | string | Message |
cloudshare-get-poc-invitations
Retrieves POC invitations sent.
Base Command
cloudshare-get-poc-invitations
Input
| Argument Name | Description | Required |
|---|---|---|
| from | Retrieve invites from a particular time (Example: “last 7 days”). | Optional |
| sentBy | Filter based on who sent the invite (default is anyone). | Optional |
| skip | Specifies to skip the first {skip} records, where {skip} is an integer (default: 0). Can be used iteratively in conjunction with take to view distinct sets of template records. | Optional |
| sortBy | The filed to sort by. | Optional |
| statusCategory | The status categoey to filter by. | Optional |
| take | Limits the number of records returned, where {take} is the maximum number of records to return. Integer (default: 1000, maximum: 1000). | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| CloudShare.POCInvites.blueprintShortId | string | Blueprint short ID |
| CloudShare.POCInvites.projectName | string | Project name |
| CloudShare.POCInvites.createdOn | string | Created on |
| CloudShare.POCInvites.owningSe | string | Owning SE |
| CloudShare.POCInvites.environmentId | string | Environment ID |
| CloudShare.POCInvites.pocUser | string | POC user |
| CloudShare.POCInvites.startDate | string | Start date |
| CloudShare.POCInvites.status | number | Status |
| CloudShare.POCInvites.opportunity | string | Opportunity |
| CloudShare.POCInvites.owningSeUserId | string | Owning SE user ID |
| CloudShare.POCInvites.projectId | string | Project ID |
| CloudShare.POCInvites.randomToken | string | Random token |
| CloudShare.POCInvites.id | string | ID |
| CloudShare.POCInvites.expirationDate | string | Expiration date |
| CloudShare.POCInvites.blueprintName | string | Blueprint name |
Configuration parameters
hostname— Hostname (required)api_id— API ID (required)api_key— API Key (required)insecure— Trust any certificate (not secure)proxy— Use system proxy settings
Commands (58)
-
cloudshare-check-vm-execution-statusChecks the status of a previously executed command line script.
-
cloudshare-create-classCreates a class.
-
cloudshare-create-envCreates an environment from a snapshot or from one or more VM templates.
-
cloudshare-delete-classDeletes a class.
-
cloudshare-delete-class-environmentsDeletes all active student environments in a class.
-
cloudshare-delete-envDeletes an environment.
-
cloudshare-delete-studentRemoves a student from a class.
-
cloudshare-delete-vmDeletes a VM.
-
cloudshare-execute-vm-commandExecutes a command line script on a VM.
-
cloudshare-extend-envExtends the lifetime of an environment.
-
cloudshare-generate-cloud-folder-passwordGenerates a new FTP password for accessing the user's cloud folders.
-
cloudshare-get-classRetrieves details of a specified class.
-
cloudshare-get-classesRetrieves all classes visible to the user.
-
cloudshare-get-classes-countriesRetrieves all countries that can be set as class locations.
-
cloudshare-get-classes-customfieldsRetrieves any custom class creation fields defined in a specified project.
-
cloudshare-get-classes-detailedRetrieves all the details of a specified class, including full student data.
-
cloudshare-get-classes-instructorsRetrieves project member users who can be assigned to classes as instructors.
-
cloudshare-get-cloud-foldersRetrieves the user's cloud folder and the user's projects' project folder(s).
-
cloudshare-get-envRetrieves properties of an environment and enables verification of the requesting user's permissions to the environment.
-
cloudshare-get-env-cloud-foldersShows the cloud folder on all of the environment's machines.
-
cloudshare-get-env-extendedRetrieves details of an environment along with VM information.
-
cloudshare-get-env-extended-tokenUses a sponsored login token to retrieve details of an environment along with VM information.
-
cloudshare-get-env-extended-vanityUses the vanity name or FQDN of a VM to retrieve details of an environment and its VMs.
-
cloudshare-get-env-multiple-resourcesRetrieves all environments that were active in a specified time range, and their resource usage. Each environment record includes total run time, total RAM-GB Hours, max disk usage and the sponsored token that was used to create the environment, if applicable.
-
cloudshare-get-env-resourceRetrieves the total resources that have been used by an environment.
-
cloudshare-get-env-snapshotsRetrieves all snapshots contained in a specified environment's blueprint. A blueprint can contain up to five snapshots, with newer snapshots displacing the oldest snapshots in the blueprint.
-
cloudshare-get-envsRetrieves environments.
-
cloudshare-get-poc-invitationsRetrieves POC invitations sent.
-
cloudshare-get-projectRetrieves a specified project's details.
-
cloudshare-get-project-blueprintRetrieves details of a specified blueprint, including snapshots.
-
cloudshare-get-project-blueprintsRetrieves all blueprints available in a specified project.
-
cloudshare-get-project-policiesRetrieves all environment policies available in a specified project. Environment policies define how long an environment will run, when it will be deleted, and what happens to it when it has been idle for a certain length of time.
-
cloudshare-get-projectsRetrieves all available projects.
-
cloudshare-get-regionsRetrieves available regions.
-
cloudshare-get-snapshotRetrieves details of a snapshot.
-
cloudshare-get-studentRetrieves information about a student in a class, including the student's environment and VMs.
-
cloudshare-get-studentsRetrieves information about the students in a class.
-
cloudshare-get-teamsRetrieves all available teams in all available projects.
-
cloudshare-get-templatesRetrieves VM templates and blueprints.
-
cloudshare-get-timezonesRetrieves available time zones.
-
cloudshare-get-vm-remote-access-fileRetrieves the content of a .rdp file that provides remote desktop access to the specified VM. An .rdp file comprising the returned content opens a remote desktop session to the VM from a Windows machine. It can also be used on Linux with FreeRDP or on Mac with Microsoft Remote Access.
-
cloudshare-invite-user-pocInvite an end user to a POC, based on a specified blueprint, and assigns a specific project member user to be the owning project member for the end user. A policy ID, blueprint ID and owning project member ID must be specified.
-
cloudshare-mark-default-snapshotMarks a specified snapshot as the default snapshot in its containing blueprint. New environments created from a blueprint are based on the default snapshot in the blueprint. This request enables you to change which snapshot is the default snapshot in a given blueprint so that new environments will be based on the snapshot of your choice.
-
cloudshare-modify-classModifies a class.
-
cloudshare-modify-envAdds one or more VMs to an existing environment.
-
cloudshare-modify-studentModifies a student's registration details.
-
cloudshare-modify-vm-hardwareAdjusts a VM's CPU count, disk size, and RAM.
-
cloudshare-postpone-env-suspendPostpones an environment's suspended state Request Path.
-
cloudshare-reboot-vmReboots a VM.
-
cloudshare-register-studentRegisters a student for a class.
-
cloudshare-resume-envResumes an environment that was previously suspended, returning it to active running state.
-
cloudshare-revert-envReverts an environment to a specified snapshot.
-
cloudshare-revert-vmReverts a VM.
-
cloudshare-send-class-invitationsSends invitations to students to attend a class.
-
cloudshare-suspend-class-environmentsSuspends all running student environments in a specified class.
-
cloudshare-suspend-envSuspends an environment.
-
cloudshare-take-snapshot-envTakes a snapshot of an environment.
-
cloudshare-unmount-env-foldersHides the cloud folder on all of the environment's machines.
commonfields: id: CloudShare version: -1 name: CloudShare display: CloudShare (Beta) category: Utilities provider: Bow River Capital description: Cloudshare integration. configuration: - display: Hostname name: hostname defaultvalue: use.cloudshare.com type: 0 required: true additionalinfo: This is usually use.cloudshare.com unless your using some mock or proxy section: Connect - display: API ID name: api_id type: 4 required: true additionalinfo: Valid CloudShare API ID section: Connect - display: API Key name: api_key type: 4 required: true additionalinfo: Valid CloudShare API ID section: Connect - display: Trust any certificate (not secure) name: insecure type: 8 required: false section: Connect - display: Use system proxy settings name: proxy type: 8 required: false section: Connect script: script: '' type: python commands: - name: cloudshare-get-envs arguments: - name: owned auto: PREDEFINED predefined: - 'true' - 'false' description: Returns only environments owned by the user. defaultValue: 'false' - name: visible auto: PREDEFINED predefined: - 'true' - 'false' description: Returns all environments visible to the user. defaultValue: 'false' - name: ownerEmail description: Optional. Filters results by the environment owner's email address, where {ownerEmail} is the environment owner's email address. - name: classId description: Optional. Filters results to include only environments created for a specified class, including instructor and student environments, where {classId} is the ID of the class. - name: brief auto: PREDEFINED predefined: - 'true' - 'false' description: 'Optional. Whether to return a less detailed or more detailed response. {brief_value} can be: true (default) - Returns less detail. false - Returns more detail.' defaultValue: 'true' outputs: - contextPath: CloudShare.Environments.projectId description: Project ID. type: string - contextPath: CloudShare.Environments.policyId description: Policy ID. type: string - contextPath: CloudShare.Environments.blueprintId description: Blueprint ID. type: string - contextPath: CloudShare.Environments.description description: Description. type: string - contextPath: CloudShare.Environments.ownerEmail description: Owner email. type: string - contextPath: CloudShare.Environments.regionId description: Region ID. type: string - contextPath: CloudShare.Environments.name description: Name. type: string - contextPath: CloudShare.Environments.id description: ID. type: string - contextPath: CloudShare.Environments.status description: Status. type: string - contextPath: CloudShare.Environments.teamId description: Team ID. type: string description: Retrieves environments. - name: cloudshare-get-projects arguments: - name: WhereUserIsProjectManager auto: PREDEFINED predefined: - tru - 'false' description: Returns only projects in which the user is a project manager. defaultValue: 'false' - name: WhereUserIsProjectMember auto: PREDEFINED predefined: - 'true' - 'false' description: Returns only projects in which the user is a project member. defaultValue: 'false' - name: WhereUserCanCreateClass auto: PREDEFINED predefined: - 'true' - 'false' description: Returns only projects in which the user is allowed to create a class. The minimum user level allowed to create classes is set per project and can be changed by project manager users. defaultValue: 'false' outputs: - contextPath: CloudShare.Projects.name description: Name. type: string - contextPath: CloudShare.Projects.isActive description: Is Active. type: boolean - contextPath: CloudShare.Projects.id description: ID. type: string description: Retrieves all available projects. - name: cloudshare-get-project arguments: - name: projectId required: true description: The ID of a specific project. outputs: - contextPath: CloudShare.Projects.id description: ID. type: string - contextPath: CloudShare.Projects.name description: Name. type: string - contextPath: CloudShare.Projects.hasNonGenericPolicy description: Has non-generic policy. type: boolean - contextPath: CloudShare.Projects.canAddPolicy description: Can add policy. type: boolean - contextPath: CloudShare.Projects.awsEnabled description: AWS enabled. type: boolean - contextPath: CloudShare.Projects.environmentResourceQuota.cpuCount description: CPU count. type: number - contextPath: CloudShare.Projects.environmentResourceQuota.diskSizeMB description: Disk size(MB). type: number - contextPath: CloudShare.Projects.environmentResourceQuota.memorySizeMB description: Memory size(MB). type: number - contextPath: CloudShare.Projects.projectResourceQuota.cpuCount description: CPU count. type: number - contextPath: CloudShare.Projects.projectResourceQuota.diskSizeMB description: Disk size(MB). type: number - contextPath: CloudShare.Projects.projectResourceQuota.memorySizeMB description: Memory size(MB). type: number - contextPath: CloudShare.Projects.subscriptionResourceQuota.cpuCount description: CPU count. type: number - contextPath: CloudShare.Projects.subscriptionResourceQuota.diskSizeMB description: Disk size(MB). type: number - contextPath: CloudShare.Projects.subscriptionResourceQuota.memorySizeMB description: Memory size(MB). type: number - contextPath: CloudShare.Projects.canCreateFromScratch description: Can create from scratch. type: boolean - contextPath: CloudShare.Projects.defaultPolicyForEnvCreation description: Default policy for env creation. type: string - contextPath: CloudShare.Projects.isActive description: Is active. type: boolean description: "Retrieves a specified project's details." - name: cloudshare-get-project-policies arguments: - name: projectId required: true description: The ID of the project. outputs: - contextPath: CloudShare.Project.Policies.allowEnvironmentCreation description: Allow environment creation. type: boolean - contextPath: CloudShare.Project.Policies.id description: ID. type: string - contextPath: CloudShare.Project.Policies.name description: Name. type: string - contextPath: CloudShare.Project.Policies.projectId description: Project ID. type: string description: Retrieves all environment policies available in a specified project. Environment policies define how long an environment will run, when it will be deleted, and what happens to it when it has been idle for a certain length of time. - name: cloudshare-get-project-blueprints arguments: - name: projectId required: true description: The Id of the project. - name: regionId description: The ID of a region. Returns all blueprints that have default snapshots on the specified region. If unspecified, returns all blueprints in the project on all regions. - name: defaultSnapshot auto: PREDEFINED predefined: - 'true' - 'false' description: " If set to true - get the default snapshot for every blueprint. The returned JSON will contain a property 'CreateFromVersions', which is an array of one element - the default snapshot. If unspecified, default is false (don't return the default snapshot)." defaultValue: 'false' outputs: - contextPath: CloudShare.Projects.Blueprints.id description: ID. type: string - contextPath: CloudShare.Projects.Blueprints.name description: Name. type: string - contextPath: CloudShare.Projects.Blueprints.description description: Description. type: string - contextPath: CloudShare.Projects.Blueprints.isEnvironmentTemplate description: Is template. type: boolean - contextPath: CloudShare.Projects.Blueprints.type description: Type. type: number - contextPath: CloudShare.Projects.Blueprints.imageUrl description: Image URL. type: string - contextPath: CloudShare.Projects.Blueprints.tags description: Tags. type: unknown - contextPath: CloudShare.Projects.Blueprints.categories description: Categories. type: unknown - contextPath: CloudShare.Projects.Blueprints.resources.cpuCount description: CPU count. type: number - contextPath: CloudShare.Projects.Blueprints.resources.diskSizeMB description: Disk size(MB). type: number - contextPath: CloudShare.Projects.Blueprints.resources.memorySizeMB description: Memory size(MB). type: number - contextPath: CloudShare.Projects.Blueprints.numberOfMachines description: Number of machines. type: number - contextPath: CloudShare.Projects.Blueprints.hasMultipleVersions description: Has multiple versions. type: boolean - contextPath: CloudShare.Projects.Blueprints.hasDefaultVersion description: Has default version. type: boolean - contextPath: CloudShare.Projects.Blueprints.disabledForRegularEnvironmentCreation description: Disabled for regular environment creation. type: boolean - contextPath: CloudShare.Projects.Blueprints.disabledForTrainingEnvironmentCreation description: Disabled for training environment creation. type: boolean - contextPath: CloudShare.Projects.Blueprints.canAddMultipleInstances description: Can add multiple instances. type: boolean - contextPath: CloudShare.Projects.Blueprints.envTemplateScope description: Environment template scope. type: unknown - contextPath: CloudShare.Projects.Blueprints.creationDate description: Creation date. type: string - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Machines description: Machines. - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.AuthorName description: Author name. type: string - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Comment description: Comment. type: string - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Type description: Type. type: number - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Name description: Name. type: string - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.IsDefault description: Is default. type: boolean - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.IsLatest description: Is latest. type: boolean - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Number description: Number. type: number - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Resources.CpuCount description: CPU count. type: number - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Resources.DiskSizeMB description: Disk size(MB). type: number - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Resources.MemorySizeMB description: Memory size(MB). type: number - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.CreateTime description: Create time. type: string - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Description description: Description. type: string - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.ImageUrl description: Image URL. type: string - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Regions description: Regions. - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Id description: ID. type: string description: Retrieves all blueprints available in a specified project. - name: cloudshare-get-project-blueprint arguments: - name: projectId required: true description: The ID of the project in which the blueprint resides. - name: blueprintId required: true description: The ID of the blueprint. outputs: - contextPath: CloudShare.Projects.Blueprints.id description: ID. type: string - contextPath: CloudShare.Projects.Blueprints.name description: Name. type: string - contextPath: CloudShare.Projects.Blueprints.description description: Description. type: string - contextPath: CloudShare.Projects.Blueprints.isEnvironmentTemplate description: Is template. type: boolean - contextPath: CloudShare.Projects.Blueprints.type description: Type. type: number - contextPath: CloudShare.Projects.Blueprints.imageUrl description: Image URL. type: string - contextPath: CloudShare.Projects.Blueprints.tags description: Tags. type: unknown - contextPath: CloudShare.Projects.Blueprints.categories description: Categories. type: unknown - contextPath: CloudShare.Projects.Blueprints.resources.cpuCount description: CPU count. type: number - contextPath: CloudShare.Projects.Blueprints.resources.diskSizeMB description: Disk size(MB). type: number - contextPath: CloudShare.Projects.Blueprints.resources.memorySizeMB description: Memory size(MB). type: number - contextPath: CloudShare.Projects.Blueprints.numberOfMachines description: Number of machines. type: number - contextPath: CloudShare.Projects.Blueprints.hasMultipleVersions description: Has multiple versions. type: boolean - contextPath: CloudShare.Projects.Blueprints.hasDefaultVersion description: Has default version. type: boolean - contextPath: CloudShare.Projects.Blueprints.disabledForRegularEnvironmentCreation description: Disabled for regular environment creation. type: boolean - contextPath: CloudShare.Projects.Blueprints.disabledForTrainingEnvironmentCreation description: Disabled for training environment creation. type: boolean - contextPath: CloudShare.Projects.Blueprints.canAddMultipleInstances description: Can add multiple instances. type: boolean - contextPath: CloudShare.Projects.Blueprints.envTemplateScope description: Environment template scope. type: unknown - contextPath: CloudShare.Projects.Blueprints.creationDate description: Creation date. type: string - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Machines description: Machines. - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.AuthorName description: Author name. type: string - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Comment description: Comment. type: string - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Type description: Type. type: number - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Name description: Name. type: string - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.IsDefault description: Is default. type: boolean - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.IsLatest description: Is latest. type: boolean - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Number description: Number. type: number - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Resources.CpuCount description: CPU count. type: number - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Resources.DiskSizeMB description: Disk size(MB). type: number - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Resources.MemorySizeMB description: Memory size(MB). type: number - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.CreateTime description: Create time. type: string - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Description description: Description. type: string - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.ImageUrl description: Image URL. type: string - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Regions description: Regions. - contextPath: CloudShare.Projects.Blueprints.CreateFromVersions.Id description: ID. type: string description: Retrieves details of a specified blueprint, including snapshots. - name: cloudshare-get-classes arguments: [] outputs: - contextPath: CloudShare.Classes.instructorEmail description: Instructor email. type: string - contextPath: CloudShare.Classes.timeZoneName description: Timezone name. type: string - contextPath: CloudShare.Classes.startDate description: Start date. type: string - contextPath: CloudShare.Classes.endDate description: End date. type: string - contextPath: CloudShare.Classes.status description: Status. type: string - contextPath: CloudShare.Classes.name description: Name. type: unknown - contextPath: CloudShare.Classes.shortId description: Short ID. type: string - contextPath: CloudShare.Classes.id description: ID. type: string - contextPath: CloudShare.Classes.regionId description: Region ID. type: string description: Retrieves all classes visible to the user. - name: cloudshare-get-class arguments: - name: classId required: true description: The id of the class. outputs: - contextPath: CloudShare.Classes.id description: ID. type: string - contextPath: CloudShare.Classes.name description: Name. type: string - contextPath: CloudShare.Classes.shortId description: Short ID. type: string - contextPath: CloudShare.Classes.policyId description: Policy ID. type: string - contextPath: CloudShare.Classes.policyName description: Policy name. type: string - contextPath: CloudShare.Classes.isUsingClassTypes description: Is issuing class types. type: boolean - contextPath: CloudShare.Classes.blueprintId description: Blueprint ID. type: string - contextPath: CloudShare.Classes.blueprintName description: Blueprint name. type: string - contextPath: CloudShare.Classes.blueprintToken description: Blueprint token. type: string - contextPath: CloudShare.Classes.cloudName description: Cloud name. type: string - contextPath: CloudShare.Classes.timeZoneId description: Timezone ID. type: string - contextPath: CloudShare.Classes.projectId description: Project ID. type: string - contextPath: CloudShare.Classes.projectName description: Project name. type: string - contextPath: CloudShare.Classes.creatorName description: Creator name. type: string - contextPath: CloudShare.Classes.creatorEmail description: Creator email. type: string - contextPath: CloudShare.Classes.instructorVupId description: Instructor VUP ID. type: string - contextPath: CloudShare.Classes.instructorName description: Instructor name. type: string - contextPath: CloudShare.Classes.defaultDurationInMinutes description: Default duration (mins). type: number - contextPath: CloudShare.Classes.allowStartDateEditing description: Allow start date editing. type: boolean - contextPath: CloudShare.Classes.limitEarlyAccess description: Limit early access. type: number - contextPath: CloudShare.Classes.studentPassphrase description: Student passphrase. type: string - contextPath: CloudShare.Classes.useCustomInvitationEmail description: Use custom invitation email. type: boolean - contextPath: CloudShare.Classes.showCourseAddressField description: Show course address field. type: boolean - contextPath: CloudShare.Classes.address description: Address. type: string - contextPath: CloudShare.Classes.customInvitationEmailSubject description: Custom invitation email subject. type: string - contextPath: CloudShare.Classes.customInvitationEmailBody description: Custom invitation email body. type: string - contextPath: CloudShare.Classes.defaultInvitationEmailSubject description: Default invitation email subject. type: string - contextPath: CloudShare.Classes.defaultInvitationEmailBody description: Default invitation email subject. type: string - contextPath: CloudShare.Classes.showPermitAccessToNonRegisteredStudent description: Show permit access to non-registered student. type: boolean - contextPath: CloudShare.Classes.allowEditDefaultsWhenPermitAccessToNonRegistered description: Allow edit defaults when permit access to non registered. type: boolean - contextPath: CloudShare.Classes.permitAccessToNonRegisteredStudent description: Permit access to non registered student. type: boolean - contextPath: CloudShare.Classes.showMaxStudentsField description: Show max students field. type: boolean - contextPath: CloudShare.Classes.maxStudents description: Max students. type: number - contextPath: CloudShare.Classes.maxLimitOnMaxStudentField description: Max kimit on max student field. type: number - contextPath: CloudShare.Classes.customFieldsValues.id description: ID. type: string - contextPath: CloudShare.Classes.customFieldsValues.order description: Order. type: number - contextPath: CloudShare.Classes.customFieldsValues.name description: Name. type: string - contextPath: CloudShare.Classes.customFieldsValues.type description: Type. type: number - contextPath: CloudShare.Classes.customFieldsValues.isRequired description: Is required. type: boolean - contextPath: CloudShare.Classes.customFieldsValues.regex description: Regex. type: string - contextPath: CloudShare.Classes.customFieldsValues.defaultValue description: Default value. type: unknown - contextPath: CloudShare.Classes.customFieldsValues.value description: Value. - contextPath: CloudShare.Classes.instructorEmail description: Instructor email. type: string - contextPath: CloudShare.Classes.timeZoneName description: Timezone name. type: string - contextPath: CloudShare.Classes.startDate description: Start date. type: string - contextPath: CloudShare.Classes.endDate description: End date. type: string - contextPath: CloudShare.Classes.status description: Status. type: string description: Retrieves details of a specified class. - name: cloudshare-delete-class arguments: - name: classId required: true description: The id of the class. description: Deletes a class. - name: cloudshare-delete-class-environments arguments: - name: classId description: The ID of the class. outputs: - contextPath: cloudshare.Classes.Actions.Delete.failed description: Failed deletions. type: unknown - contextPath: cloudshare.Classes.Actions.Delete.succeed description: Succeeded deletions. - contextPath: cloudshare.Classes.Actions.Delete.succeed.id description: ID. type: string - contextPath: cloudshare.Classes.Actions.Delete.succeed.email description: Email. type: string - contextPath: cloudshare.Classes.Actions.Delete.succeed.fullName description: Full name. type: string - contextPath: cloudshare.Classes.Actions.Delete.succeed.envId description: Environment ID. type: string description: Deletes all active student environments in a class. - name: cloudshare-get-classes-countries arguments: [] outputs: - contextPath: CloudShare.Classes.Countries.code description: Code. type: string - contextPath: CloudShare.Classes.Countries.englishName description: English name. type: string - contextPath: CloudShare.Classes.Countries.states description: States. description: Retrieves all countries that can be set as class locations. - name: cloudshare-get-classes-customfields arguments: - name: projectId required: true description: The id of the project. outputs: - contextPath: CloudShare.Classes.CustomFields.id description: ID. type: string - contextPath: CloudShare.Classes.CustomFields.order description: Order. type: number - contextPath: CloudShare.Classes.CustomFields.name description: Name. type: string - contextPath: CloudShare.Classes.CustomFields.type description: Type. type: number - contextPath: CloudShare.Classes.CustomFields.isRequired description: Is required. type: boolean - contextPath: CloudShare.Classes.CustomFields.regex description: Regex. type: string - contextPath: CloudShare.Classes.CustomFields.defaultValue description: Default value. type: unknown - contextPath: CloudShare.Classes.CustomFields.value description: Value. type: unknown description: Retrieves any custom class creation fields defined in a specified project. - name: cloudshare-get-classes-detailed arguments: - name: classId required: true description: The id of the class. outputs: - contextPath: CloudShare.Classes.Class.id description: ID. type: string - contextPath: CloudShare.Classes.Class.name description: Name. type: string - contextPath: CloudShare.Classes.Class.shortId description: Short ID. type: string - contextPath: CloudShare.Classes.Class.policyId description: Policy ID. type: string - contextPath: CloudShare.Classes.Class.policyName description: Policy name. type: string - contextPath: CloudShare.Classes.Class.isUsingClassTypes description: Is issuing class types. type: boolean - contextPath: CloudShare.Classes.Class.blueprintId description: Blueprint ID. type: string - contextPath: CloudShare.Classes.Class.blueprintName description: Blueprint name. type: string - contextPath: CloudShare.Classes.Class.blueprintToken description: Blueprint token. type: string - contextPath: CloudShare.Classes.Class.cloudName description: Cloud name. type: string - contextPath: CloudShare.Classes.Class.timeZoneId description: Timezone ID. type: string - contextPath: CloudShare.Classes.Class.projectId description: Project ID. type: string - contextPath: CloudShare.Classes.Class.projectName description: Project name. type: string - contextPath: CloudShare.Classes.Class.creatorName description: Creator name. type: string - contextPath: CloudShare.Classes.Class.creatorEmail description: Creator email. type: string - contextPath: CloudShare.Classes.Class.instructorVupId description: Instructor VUP ID. type: string - contextPath: CloudShare.Classes.Class.instructorName description: Instructor name. type: string - contextPath: CloudShare.Classes.Class.defaultDurationInMinutes description: Default duration (mins). type: number - contextPath: CloudShare.Classes.Class.allowStartDateEditing description: Allow start date editing. type: boolean - contextPath: CloudShare.Classes.Class.limitEarlyAccess description: Limit early access. type: number - contextPath: CloudShare.Classes.Class.studentPassphrase description: Student passphrase. type: string - contextPath: CloudShare.Classes.Class.useCustomInvitationEmail description: Use custom invitation email. type: boolean - contextPath: CloudShare.Classes.Class.showCourseAddressField description: Show course address field. type: boolean - contextPath: CloudShare.Classes.Class.address description: Address. type: string - contextPath: CloudShare.Classes.Class.customInvitationEmailSubject description: Custom invitation email subject. type: string - contextPath: CloudShare.Classes.Class.customInvitationEmailBody description: Custom invitation email body. type: string - contextPath: CloudShare.Classes.Class.defaultInvitationEmailSubject description: Default invitation email subject. type: string - contextPath: CloudShare.Classes.Class.defaultInvitationEmailBody description: Default invitation email subject. type: string - contextPath: CloudShare.Classes.Class.showPermitAccessToNonRegisteredStudent description: Show permit access to non-registered student. type: boolean - contextPath: CloudShare.Classes.Class.allowEditDefaultsWhenPermitAccessToNonRegistered description: Allow edit defaults when permit access to non registered. type: boolean - contextPath: CloudShare.Classes.Class.permitAccessToNonRegisteredStudent description: Permit access to non registered student. type: boolean - contextPath: CloudShare.Classes.Class.showMaxStudentsField description: Show max students field. type: boolean - contextPath: CloudShare.Classes.Class.maxStudents description: Max students. type: number - contextPath: CloudShare.Classes.Class.maxLimitOnMaxStudentField description: Max kimit on max student field. type: number - contextPath: CloudShare.Classes.Class.customFieldsValues.id description: ID. type: string - contextPath: CloudShare.Classes.Class.customFieldsValues.order description: Order. type: number - contextPath: CloudShare.Classes.Class.customFieldsValues.name description: Name. type: string - contextPath: CloudShare.Classes.Class.customFieldsValues.type description: Type. type: number - contextPath: CloudShare.Classes.Class.customFieldsValues.isRequired description: Is required. type: boolean - contextPath: CloudShare.Classes.Class.customFieldsValues.regex description: Regex. type: string - contextPath: CloudShare.Classes.Class.customFieldsValues.defaultValue description: Default value. type: unknown - contextPath: CloudShare.Classes.Class.customFieldsValues.value description: Value. - contextPath: CloudShare.Classes.Class.instructorEmail description: Instructor email. type: string - contextPath: CloudShare.Classes.Class.timeZoneName description: Timezone name. type: string - contextPath: CloudShare.Classes.Class.startDate description: Start date. type: string - contextPath: CloudShare.Classes.Class.endDate description: End date. type: string - contextPath: CloudShare.Classes.Class.status description: Status. type: string - contextPath: CloudShare.Classes.Students.firstName description: First name. type: string - contextPath: CloudShare.Classes.Students.lastName description: Last name. type: string - contextPath: CloudShare.Classes.Students.email description: Email. type: string - contextPath: CloudShare.Classes.Students.company description: Company. type: string - contextPath: CloudShare.Classes.Students.jobLevel description: Job level. type: string - contextPath: CloudShare.Classes.Students.address1 description: Address 1. type: string - contextPath: CloudShare.Classes.Students.address2 description: Address 2. type: string - contextPath: CloudShare.Classes.Students.city description: City. type: string - contextPath: CloudShare.Classes.Students.state description: State. type: string - contextPath: CloudShare.Classes.Students.zipCode description: Zip code. type: string - contextPath: CloudShare.Classes.Students.country description: Country. type: string - contextPath: CloudShare.Classes.Students.phone description: Phone. type: string - contextPath: CloudShare.Classes.Students.regCode description: Reg code. type: string - contextPath: CloudShare.Classes.Students.id description: ID. type: string description: Retrieves all the details of a specified class, including full student data. - name: cloudshare-get-classes-instructors arguments: - name: policyId required: true description: The ID of a policy. outputs: - contextPath: CloudShare.Classes.Instructors.id description: ID. type: string - contextPath: CloudShare.Classes.Instructors.name description: Name. type: string - contextPath: CloudShare.Classes.Instructors.email description: Email. type: string description: Retrieves project member users who can be assigned to classes as instructors. - name: cloudshare-create-class arguments: - name: PolicyId required: true description: "The ID of the policy to apply to the class. The policy will control the runtime and storage time of each student's environment and what will happen to the environment when it is inactive." - name: BlueprintId required: true description: The ID of the blueprint to base the class on. Students who attend the class will be served environments based on this blueprint. - name: ProjectId required: true description: The ID of the project in which the class will be created. The specified blueprint and instructor must be from the same project. - name: InstructorVupId required: true description: The ID of the project member user to assign to the class as the instructor. - name: RegionId description: The ID of the region the class should be created in. - name: StartDate required: true description: The date and time at which to start the class, in MM/DD/YYYY HH:MM AM/PM format. - name: TimeZoneId required: true description: The ID of the timezone for the startDate. - name: StudentPassphrase required: true description: The passphrase that students will need to enter in order to attend the class. - name: UseCustomInvitationEmail auto: PREDEFINED predefined: - 'false' - 'true' description: Whether or not the student invitation email is customized. defaultValue: 'false' - name: LimitEarlyAccess required: true auto: PREDEFINED predefined: - '0' - '1' - '2' description: 'This option controls access by students and instructor to a lab before scheduled class time. Possible values: 0 - Allow lab access before class (default). 1 - Allow lab access before class for instructor only. 2 - No early access allowed.' defaultValue: '0' - name: CustomInvitationEmailSubject description: The subject line of the custom student invitation email. Used if UseCustomInvitationEmail is set to true. - name: CustomInvitationEmailBody description: The body of the custom student invitation email. Used if UseCustomInvitationEmail is set to true. - name: PermitAccessToNonRegisteredStudent auto: PREDEFINED predefined: - 'false' - 'true' description: Whether to permit users to self register as students for the class. defaultValue: 'false' - name: MaxStudents description: 'Numeric. The maximum number of students allowed in the class (can be null). Maximum value: 60.' - name: address description: 'The location of the class (JSON dictionary) including keys: state, address1, address2, zipCode, city, country (To retrieve valid values for country, use cloudshare-get-classes-countries).' - name: CustomFieldsValues description: Specifies input values for custom fields defined for class creation in the project. Mandatory if project forces validation of custom fields. Fields and valid values depend on custom fields structure for the project. To retrieve custom fields structure for the project, use cloudshare-get-classes-customfields. - name: enableSteps auto: PREDEFINED predefined: - 'false' - 'true' description: Enables the class to have multiple steps. defaultValue: 'false' - name: StudentsCanSwitchStep auto: PREDEFINED predefined: - 'false' - 'true' description: Whether students can change steps independently. Applies when enableSteps is set to true. defaultValue: 'false' - name: steps description: A list of class steps (JSON dictionaries) for a multi-step class. Must be provided if enableSteps is set to true. - name: selfPaced auto: PREDEFINED predefined: - 'false' - 'true' description: Creates a Self-Paced Class that allows a student to enter class at a time convenient to them. defaultValue: 'false' - name: allowMultipleStudentLogin auto: PREDEFINED predefined: - 'false' - 'true' description: When set to true, allows for more than one environment activation per student. defaultValue: 'false' outputs: - contextPath: CloudShare.Classes.id description: ID. type: string description: Creates a class. - name: cloudshare-send-class-invitations arguments: - name: classId required: true description: The ID of the class. - name: studentIds required: true description: A list (CSV) of IDs of students to send invite invitations to. description: Sends invitations to students to attend a class. - name: cloudshare-suspend-class-environments arguments: - name: classId required: true description: The ID of the class. outputs: - contextPath: CloudShare.Classes.Suspended.failed.id description: ID. type: string - contextPath: CloudShare.Classes.Suspended.succeed.id description: ID. type: string - contextPath: CloudShare.Classes.Suspended.succeed.email description: Email. type: string - contextPath: CloudShare.Classes.Suspended.succeed.fullName description: Full name. type: string - contextPath: CloudShare.Classes.Suspended.succeed.envId description: Environment ID. type: string description: Suspends all running student environments in a specified class. - name: cloudshare-modify-class arguments: - name: instructorVupId description: The ID of the project member user to assign to the class as the instructor. - name: startDate description: The date and time at which to start the class, in MM/DD/YYYY HH:MM AM/PM format. - name: timeZoneId description: The ID of the timezone for the startDate. - name: studentPassphrase description: The passphrase that students will need to enter in order to attend the class. - name: useCustomInvitationEmail auto: PREDEFINED predefined: - 'false' - 'true' description: Whether or not the student invitation email is customized. defaultValue: 'false' - name: limitEarlyAccess auto: PREDEFINED predefined: - '0' - '1' - '2' description: 'This option controls access by students and instructor to a lab before scheduled class time. Possible values: 0 - Allow lab access before class (default). 1 - Allow lab access before class for instructor only. 2 - No early access allowed.' defaultValue: '0' - name: customInvitationEmailSubject description: The subject line of the custom student invitation email. Used if UseCustomInvitationEmail is set to true. - name: customInvitationEmailBody description: The body of the custom student invitation email. Used if UseCustomInvitationEmail is set to true. - name: permitAccessToNonRegisteredStudent auto: PREDEFINED predefined: - 'false' - 'true' description: Whether to permit users to self register as students for the class. defaultValue: 'false' - name: maxStudents description: 'Numeric. The maximum number of students allowed in the class (can be null). Maximum value: 60.' - name: address description: 'The location of the class (JSON dictionary) including keys: state, address1, address2, zipCode, city, country (To retrieve valid values for country, use cloudshare-get-classes-countries).' - name: customFieldsValues description: Specifies input values for custom fields defined for class creation in the project. Mandatory if project forces validation of custom fields. Fields and valid values depend on custom fields structure for the project. To retrieve custom fields structure for the project, use cloudshare-get-classes-customfields. - name: selfPaced auto: PREDEFINED predefined: - 'false' - 'true' description: Creates a Self-Paced Class that allows a student to enter class at a time convenient to them. defaultValue: 'false' - name: allowMultipleStudentLogin auto: PREDEFINED predefined: - 'false' - 'true' description: When set to true, allows for more than one environment activation per student. defaultValue: 'false' - name: classId required: true description: The ID of the class. - name: name description: The name of the class. outputs: - contextPath: CloudShare.Classes.id description: ID. type: string - contextPath: CloudShare.Classes.name description: Name. type: string - contextPath: CloudShare.Classes.shortId description: Short ID. type: string - contextPath: CloudShare.Classes.policyId description: Policy ID. type: string - contextPath: CloudShare.Classes.policyName description: Policy name. type: string - contextPath: CloudShare.Classes.isUsingClassTypes description: Is issuing class types. type: boolean - contextPath: CloudShare.Classes.blueprintId description: Blueprint ID. type: string - contextPath: CloudShare.Classes.blueprintName description: Blueprint name. type: string - contextPath: CloudShare.Classes.blueprintToken description: Blueprint token. type: string - contextPath: CloudShare.Classes.cloudName description: Cloud name. type: string - contextPath: CloudShare.Classes.timeZoneId description: Timezone ID. type: string - contextPath: CloudShare.Classes.projectId description: Project ID. type: string - contextPath: CloudShare.Classes.projectName description: Project name. type: string - contextPath: CloudShare.Classes.creatorName description: Creator name. type: string - contextPath: CloudShare.Classes.creatorEmail description: Creator email. type: string - contextPath: CloudShare.Classes.instructorVupId description: Instructor VUP ID. type: string - contextPath: CloudShare.Classes.instructorName description: Instructor name. type: string - contextPath: CloudShare.Classes.defaultDurationInMinutes description: Default duration (mins). type: number - contextPath: CloudShare.Classes.allowStartDateEditing description: Allow start date editing. type: boolean - contextPath: CloudShare.Classes.limitEarlyAccess description: Limit early access. type: number - contextPath: CloudShare.Classes.studentPassphrase description: Student passphrase. type: string - contextPath: CloudShare.Classes.useCustomInvitationEmail description: Use custom invitation email. type: boolean - contextPath: CloudShare.Classes.showCourseAddressField description: Show course address field. type: boolean - contextPath: CloudShare.Classes.address description: Address. type: string - contextPath: CloudShare.Classes.customInvitationEmailSubject description: Custom invitation email subject. type: string - contextPath: CloudShare.Classes.customInvitationEmailBody description: Custom invitation email body. type: string - contextPath: CloudShare.Classes.defaultInvitationEmailSubject description: Default invitation email subject. type: string - contextPath: CloudShare.Classes.defaultInvitationEmailBody description: Default invitation email subject. type: string - contextPath: CloudShare.Classes.showPermitAccessToNonRegisteredStudent description: Show permit access to non-registered student. type: boolean - contextPath: CloudShare.Classes.allowEditDefaultsWhenPermitAccessToNonRegistered description: Allow edit defaults when permit access to non registered. type: boolean - contextPath: CloudShare.Classes.permitAccessToNonRegisteredStudent description: Permit access to non registered student. type: boolean - contextPath: CloudShare.Classes.showMaxStudentsField description: Show max students field. type: boolean - contextPath: CloudShare.Classes.maxStudents description: Max students. type: number - contextPath: CloudShare.Classes.maxLimitOnMaxStudentField description: Max kimit on max student field. type: number - contextPath: CloudShare.Classes.customFieldsValues.id description: ID. type: string - contextPath: CloudShare.Classes.customFieldsValues.order description: Order. type: number - contextPath: CloudShare.Classes.customFieldsValues.name description: Name. type: string - contextPath: CloudShare.Classes.customFieldsValues.type description: Type. type: number - contextPath: CloudShare.Classes.customFieldsValues.isRequired description: Is required. type: boolean - contextPath: CloudShare.Classes.customFieldsValues.regex description: Regex. type: string - contextPath: CloudShare.Classes.customFieldsValues.defaultValue description: Default value. type: unknown - contextPath: CloudShare.Classes.customFieldsValues.value description: Value. - contextPath: CloudShare.Classes.instructorEmail description: Instructor email. type: string - contextPath: CloudShare.Classes.timeZoneName description: Timezone name. type: string - contextPath: CloudShare.Classes.startDate description: Start date. type: string - contextPath: CloudShare.Classes.endDate description: End date. type: string - contextPath: CloudShare.Classes.status description: Status. type: string description: Modifies a class. - name: cloudshare-get-students arguments: - name: classId required: true description: The ID of the class. - name: isFull auto: PREDEFINED predefined: - 'false' - 'true' description: "Whether to return the details of the VMs in each student's environment as well as other details." defaultValue: 'false' outputs: - contextPath: CloudShare.Students.status description: Status. type: number - contextPath: CloudShare.Students.envStatus description: Environemtn Status. type: number - contextPath: CloudShare.Students.envCommands description: Environment commands. type: unknown - contextPath: CloudShare.Students.envId description: Environment ID. type: string - contextPath: CloudShare.Students.firstName description: First name. type: string - contextPath: CloudShare.Students.lastName description: Last name. type: string - contextPath: CloudShare.Students.email description: Email. type: string - contextPath: CloudShare.Students.id description: ID. type: string - contextPath: CloudShare.Students.VMs.id description: ID. type: string - contextPath: CloudShare.Students.VMs.name description: Name. type: string description: Retrieves information about the students in a class. - name: cloudshare-get-student arguments: - name: classId required: true description: The ID of the class. - name: studentId required: true description: The ID of the student in the class. outputs: - contextPath: CloudShare.Students.status description: Status. type: number - contextPath: CloudShare.Students.envStatus description: Environemtn Status. type: number - contextPath: CloudShare.Students.envCommands description: Environment commands. type: unknown - contextPath: CloudShare.Students.envId description: Environment ID. type: string - contextPath: CloudShare.Students.firstName description: First name. type: string - contextPath: CloudShare.Students.lastName description: Last name. type: string - contextPath: CloudShare.Students.email description: Email. type: string - contextPath: CloudShare.Students.id description: ID. type: string - contextPath: CloudShare.Students.VMs.id description: ID. type: string - contextPath: CloudShare.Students.VMs.name description: Name. type: string description: "Retrieves information about a student in a class, including the student's environment and VMs." - name: cloudshare-delete-student arguments: - name: classId required: true description: The ID of the class. - name: studentId required: true description: The ID of the student. description: Removes a student from a class. - name: cloudshare-register-student arguments: - name: classID required: true description: The ID of the class. - name: email required: true description: "The student's email address." - name: firstName required: true description: "The student's first name." - name: lastName required: true description: "The student's last name." outputs: - contextPath: CloudShare.Students.id description: ID. type: string description: Registers a student for a class. - name: cloudshare-modify-student arguments: - name: classId required: true description: The ID of the class for which the student is registered. - name: studentId required: true description: The ID of the student. - name: email description: "The student's email address. This can be changed as long as the student did not yet log in." - name: firstName description: "The student's first name." - name: lastName description: "The student's last name." description: "Modifies a student's registration details." - name: cloudshare-get-regions arguments: [] outputs: - contextPath: CloudShare.Regions.id description: ID. type: string - contextPath: CloudShare.Regions.name description: Name. type: string - contextPath: CloudShare.Regions.cloudName description: Cloud name. type: string - contextPath: CloudShare.Regions.friendlyName description: Friendly name. type: string description: Retrieves available regions. - name: cloudshare-get-timezones arguments: [] outputs: - contextPath: CloudShare.Timezones.id description: ID. type: string - contextPath: CloudShare.Timezones.displayName description: Display name. type: string description: Retrieves available time zones. - name: cloudshare-get-env-resource arguments: - name: envId required: true description: The environment ID. outputs: - contextPath: CloudShare.EnvironmentResources.totalRuntimeHours description: Total run time. type: number - contextPath: CloudShare.EnvironmentResources.totalGbh description: Total GB / hour. type: number - contextPath: CloudShare.EnvironmentResources.maxDiskGb description: Max disk space(GB). type: number - contextPath: CloudShare.EnvironmentResources.lastUpdateTime description: Last update time. type: string - contextPath: CloudShare.EnvironmentResources.name description: Name. type: string - contextPath: CloudShare.EnvironmentResources.id description: ID. type: string description: Retrieves the total resources that have been used by an environment. - name: cloudshare-get-env-extended arguments: - name: envId required: true description: The ID of the environment. outputs: - contextPath: CloudShare.Environments.projectId description: Project ID. type: string - contextPath: CloudShare.Environments.policyId description: Policy ID. type: string - contextPath: CloudShare.Environments.blueprintId description: Blueprint ID. type: string - contextPath: CloudShare.Environments.description description: Description. type: string - contextPath: CloudShare.Environments.ownerEmail description: Owner email. type: string - contextPath: CloudShare.Environments.regionId description: Region ID. type: string - contextPath: CloudShare.Environments.name description: Name. type: string - contextPath: CloudShare.Environments.id description: ID. type: string - contextPath: CloudShare.Environments.status description: Status. type: string - contextPath: CloudShare.Environments.teamId description: Team ID. type: string - contextPath: CloudShare.Environments.VMs.id description: ID. type: string - contextPath: CloudShare.Environments.VMs.name description: Name. type: string - contextPath: CloudShare.Environments.VMs.description description: Description. type: string - contextPath: CloudShare.Environments.VMs.statusText description: Status text. type: string - contextPath: CloudShare.Environments.VMs.progress description: Progress. type: number - contextPath: CloudShare.Environments.VMs.imageId description: Image ID. type: string - contextPath: CloudShare.Environments.VMs.os description: OS. type: string - contextPath: CloudShare.Environments.VMs.webAccessUrl description: Web access URL. type: string - contextPath: CloudShare.Environments.VMs.fqdn description: FQDN. type: string - contextPath: CloudShare.Environments.VMs.externalAddress description: External address. type: string - contextPath: CloudShare.Environments.VMs.internalAddresses description: Internal addresses. type: unknown - contextPath: CloudShare.Environments.VMs.cpuCount description: CPU count. type: number - contextPath: CloudShare.Environments.VMs.diskSizeGb description: Disk size(GB). type: number - contextPath: CloudShare.Environments.VMs.memorySizeMb description: Memory size(MB). type: number - contextPath: CloudShare.Environments.VMs.username description: Username. type: string - contextPath: CloudShare.Environments.VMs.password description: Password. type: string - contextPath: CloudShare.Environments.VMs.consoleToken description: Console token. type: string description: Retrieves details of an environment along with VM information. - name: cloudshare-get-env-extended-vanity arguments: - name: machineVanity required: true description: Specifies the vanity name or FQDN of a machine. outputs: - contextPath: CloudShare.Environments.projectId description: Project ID. type: string - contextPath: CloudShare.Environments.policyId description: Policy ID. type: string - contextPath: CloudShare.Environments.blueprintId description: Blueprint ID. type: string - contextPath: CloudShare.Environments.description description: Description. type: string - contextPath: CloudShare.Environments.ownerEmail description: Owner email. type: string - contextPath: CloudShare.Environments.regionId description: Region ID. type: string - contextPath: CloudShare.Environments.name description: Name. type: string - contextPath: CloudShare.Environments.id description: ID. type: string - contextPath: CloudShare.Environments.status description: Status. type: string - contextPath: CloudShare.Environments.teamId description: Team ID. type: string - contextPath: CloudShare.Environments.VMs.id description: ID. type: string - contextPath: CloudShare.Environments.VMs.name description: Name. type: string - contextPath: CloudShare.Environments.VMs.description description: Description. type: string - contextPath: CloudShare.Environments.VMs.statusText description: Status text. type: string - contextPath: CloudShare.Environments.VMs.progress description: Progress. type: number - contextPath: CloudShare.Environments.VMs.imageId description: Image ID. type: string - contextPath: CloudShare.Environments.VMs.os description: OS. type: string - contextPath: CloudShare.Environments.VMs.webAccessUrl description: Web access URL. type: string - contextPath: CloudShare.Environments.VMs.fqdn description: FQDN. type: string - contextPath: CloudShare.Environments.VMs.externalAddress description: External address. type: string - contextPath: CloudShare.Environments.VMs.internalAddresses description: Internal addresses. type: unknown - contextPath: CloudShare.Environments.VMs.cpuCount description: CPU count. type: number - contextPath: CloudShare.Environments.VMs.diskSizeGb description: Disk size(GB). type: number - contextPath: CloudShare.Environments.VMs.memorySizeMb description: Memory size(MB). type: number - contextPath: CloudShare.Environments.VMs.username description: Username. type: string - contextPath: CloudShare.Environments.VMs.password description: Password. type: string - contextPath: CloudShare.Environments.VMs.consoleToken description: Console token. type: string description: Uses the vanity name or FQDN of a VM to retrieve details of an environment and its VMs. - name: cloudshare-get-env-extended-token arguments: - name: sponsoredLoginToken required: true description: Specifies the token. outputs: - contextPath: CloudShare.Environments.projectId description: Project ID. type: string - contextPath: CloudShare.Environments.policyId description: Policy ID. type: string - contextPath: CloudShare.Environments.blueprintId description: Blueprint ID. type: string - contextPath: CloudShare.Environments.description description: Description. type: string - contextPath: CloudShare.Environments.ownerEmail description: Owner email. type: string - contextPath: CloudShare.Environments.regionId description: Region ID. type: string - contextPath: CloudShare.Environments.name description: Name. type: string - contextPath: CloudShare.Environments.id description: ID. type: string - contextPath: CloudShare.Environments.status description: Status. type: string - contextPath: CloudShare.Environments.teamId description: Team ID. type: string - contextPath: CloudShare.Environments.VMs.id description: ID. type: string - contextPath: CloudShare.Environments.VMs.name description: Name. type: string - contextPath: CloudShare.Environments.VMs.description description: Description. type: string - contextPath: CloudShare.Environments.VMs.statusText description: Status text. type: string - contextPath: CloudShare.Environments.VMs.progress description: Progress. type: number - contextPath: CloudShare.Environments.VMs.imageId description: Image ID. type: string - contextPath: CloudShare.Environments.VMs.os description: OS. type: string - contextPath: CloudShare.Environments.VMs.webAccessUrl description: Web access URL. type: string - contextPath: CloudShare.Environments.VMs.fqdn description: FQDN. type: string - contextPath: CloudShare.Environments.VMs.externalAddress description: External address. type: string - contextPath: CloudShare.Environments.VMs.internalAddresses description: Internal addresses. type: unknown - contextPath: CloudShare.Environments.VMs.cpuCount description: CPU count. type: number - contextPath: CloudShare.Environments.VMs.diskSizeGb description: Disk size(GB). type: number - contextPath: CloudShare.Environments.VMs.memorySizeMb description: Memory size(MB). type: number - contextPath: CloudShare.Environments.VMs.username description: Username. type: string - contextPath: CloudShare.Environments.VMs.password description: Password. type: string - contextPath: CloudShare.Environments.VMs.consoleToken description: Console token. type: string description: Uses a sponsored login token to retrieve details of an environment along with VM information. - name: cloudshare-get-env-multiple-resources arguments: - name: subscriptionId description: Specifies a user subscription, where {subscriptionID} is the ID of the subscription. Provide the subscription if the user is a member of multiple subscriptions. - name: starttime required: true description: Specifies the start of the time range, where {starttime_value} is the start of the time range in the format ISO 8601. For example, "2017-01-01". - name: endtime required: true description: "Specifies the end of the time range, where {endtime_value} is the end of the time range in the format ISO 8601. For example, '2017-02-01'." - name: skip description: 'Optional. Specifies to skip the first {skip_value} records, where {skip_value} is an integer (default: 0). Can be used iteratively in conjunction with take to view distinct sets of environment records.' - name: take description: 'Optional. Limits the number of records returned, where {take_value} is the maximum number of records to return. Integer (default: 1000, maximum: 1000).' outputs: - contextPath: CloudShare.EnvironmentResources.sponsoredLoginToken description: Sponsored login token. type: string - contextPath: CloudShare.EnvironmentResources.totalRuntimeHours description: Total run time (hours). type: number - contextPath: CloudShare.EnvironmentResources.totalGbh description: Total GB / hour. type: number - contextPath: CloudShare.EnvironmentResources.maxDiskGb description: Max disk(GB). type: number - contextPath: CloudShare.EnvironmentResources.lastUpdateTime description: Last update time. type: string - contextPath: CloudShare.EnvironmentResources.name description: Name. type: string - contextPath: CloudShare.EnvironmentResources.id description: ID. type: string description: Retrieves all environments that were active in a specified time range, and their resource usage. Each environment record includes total run time, total RAM-GB Hours, max disk usage and the sponsored token that was used to create the environment, if applicable. - name: cloudshare-extend-env arguments: - name: envId required: true description: "Specifies the environment, where {envId} is the environment's ID." description: Extends the lifetime of an environment. - name: cloudshare-postpone-env-suspend arguments: - name: envId required: true description: "Specifies the environment, where {envId} is the environment's ID." description: "Postpones an environment's suspended state Request Path." - name: cloudshare-resume-env arguments: - name: envId required: true description: "Specifies the environment, where {envId} is the environment's ID." description: Resumes an environment that was previously suspended, returning it to active running state. - name: cloudshare-revert-env arguments: - name: envId required: true description: "Specifies the environment, where {envId} is the environment's ID." - name: snapshotId required: true description: "Specifies the snapshot to which to revert the environment, where {snapshotId} is the snapshot's ID." description: Reverts an environment to a specified snapshot. - name: cloudshare-suspend-env arguments: - name: envId required: true description: "Specifies the environment, where {envId} is the environment's ID." description: Suspends an environment. - name: cloudshare-get-env arguments: - name: envID required: true description: "The environment's ID." - name: permission auto: PREDEFINED predefined: - view - edit - owner description: Specifies a type of permission to access the environment. Returns an error (status code 500) if the requesting user does not have the specified permission level. Otherwise, returns the environment properties. outputs: - contextPath: CloudShare.Environments.projectId description: Project ID. type: string - contextPath: CloudShare.Environments.policyId description: Policy ID. type: string - contextPath: CloudShare.Environments.description description: Description. type: string - contextPath: CloudShare.Environments.ownerEmail description: Owner email. type: string - contextPath: CloudShare.Environments.regionId description: Region ID. type: string - contextPath: CloudShare.Environments.name description: Name. type: string - contextPath: CloudShare.Environments.id description: ID. type: string - contextPath: CloudShare.Environments.status description: Status. type: string - contextPath: CloudShare.Environments.teamId description: Team ID. type: string description: "Retrieves properties of an environment and enables verification of the requesting user's permissions to the environment." - name: cloudshare-delete-env arguments: - name: envID required: true description: The Id of the environment. description: Deletes an environment. - name: cloudshare-create-env arguments: - name: environment required: true description: Specifies details (JSON) of the environment to create. Please refer to https://docs.cloudshare.com/rest-api/v3/environments/envs/post-envs/ for the format. - name: itemsCart required: true description: Specifies templates (JSON array) from which to build the environment. Please refer to https://docs.cloudshare.com/rest-api/v3/environments/envs/post-envs/ for the format. outputs: - contextPath: CloudShare.Environments.resources.cpuCount description: CPU count. type: number - contextPath: CloudShare.Environments.resources.diskSizeMB description: Disk size(MB). type: number - contextPath: CloudShare.Environments.resources.memorySizeMB description: Memory size(MB). type: number - contextPath: CloudShare.Environments.VMs.name description: Name. type: string - contextPath: CloudShare.Environments.VMs.description description: Description. type: string - contextPath: CloudShare.Environments.VMs.osTypeName description: OS type name. type: string - contextPath: CloudShare.Environments.VMs.imageUrl description: Image URL. type: string - contextPath: CloudShare.Environments.VMs.resources.cpuCount description: CPU count. type: number - contextPath: CloudShare.Environments.VMs.resources.diskSizeMB description: Disk size(MB). type: number - contextPath: CloudShare.Environments.VMs.resources.memorySizeMB description: Memory size(MB). type: number - contextPath: CloudShare.Environments.VMs.domainName description: Domain name. type: string - contextPath: CloudShare.Environments.VMs.internalIPs description: Internal IPs. type: unknown - contextPath: CloudShare.Environments.VMs.macAddresses description: MAC addresses. type: unknown - contextPath: CloudShare.Environments.VMs.canAddMultipleInstances description: Can add multiple instances. type: boolean - contextPath: CloudShare.Environments.VMs.hostName description: Hostname. type: string - contextPath: CloudShare.Environments.VMs.vanityName description: Vanity name. type: string - contextPath: CloudShare.Environments.VMs.httpAccessEnabled description: HTTP access enabled. type: boolean - contextPath: CloudShare.Environments.VMs.startWithHttps description: Start with HTTPS. type: boolean - contextPath: CloudShare.Environments.VMs.user description: User. type: string - contextPath: CloudShare.Environments.VMs.password description: Password. type: string - contextPath: CloudShare.Environments.VMs.id description: ID. type: string - contextPath: CloudShare.Environments.environmentId description: Environment ID. type: string - contextPath: CloudShare.Environments.id description: ID. type: string description: Creates an environment from a snapshot or from one or more VM templates. - name: cloudshare-modify-env arguments: - name: envId required: true description: The ID of the environment. - name: itemsCart required: true description: Specifies templates (JSON array) of VMs to add to the environment. Please refer to https://docs.cloudshare.com/rest-api/v3/environments/envs/post-envs/ for the format. outputs: - contextPath: CloudShare.Environments.resources.cpuCount description: CPU count. type: number - contextPath: CloudShare.Environments.resources.diskSizeMB description: Disk size(MB). type: number - contextPath: CloudShare.Environments.resources.memorySizeMB description: Memory size(MB). type: number - contextPath: CloudShare.Environments.VMs.name description: Name. type: string - contextPath: CloudShare.Environments.VMs.description description: Description. type: string - contextPath: CloudShare.Environments.VMs.osTypeName description: OS type name. type: string - contextPath: CloudShare.Environments.VMs.imageUrl description: Image URL. type: string - contextPath: CloudShare.Environments.VMs.resources.cpuCount description: CPU count. type: number - contextPath: CloudShare.Environments.VMs.resources.diskSizeMB description: Disk size(MB). type: number - contextPath: CloudShare.Environments.VMs.resources.memorySizeMB description: Memory size(MB). type: number - contextPath: CloudShare.Environments.VMs.domainName description: Domain name. type: string - contextPath: CloudShare.Environments.VMs.internalIPs description: Internal IPs. type: unknown - contextPath: CloudShare.Environments.VMs.macAddresses description: MAC addresses. type: unknown - contextPath: CloudShare.Environments.VMs.canAddMultipleInstances description: Can add multiple instances. type: boolean - contextPath: CloudShare.Environments.VMs.hostName description: Hostname. type: string - contextPath: CloudShare.Environments.VMs.vanityName description: Vanity name. type: string - contextPath: CloudShare.Environments.VMs.httpAccessEnabled description: HTTP access enabled. type: boolean - contextPath: CloudShare.Environments.VMs.startWithHttps description: Start with HTTPS. type: boolean - contextPath: CloudShare.Environments.VMs.user description: User. type: string - contextPath: CloudShare.Environments.VMs.password description: Password. type: string - contextPath: CloudShare.Environments.VMs.id description: ID. type: string - contextPath: CloudShare.Environments.environmentId description: Environment ID. type: string - contextPath: CloudShare.Environments.id description: ID. type: string description: Adds one or more VMs to an existing environment. - name: cloudshare-delete-vm arguments: - name: VmID description: The ID of the VM. description: Deletes a VM. - name: cloudshare-check-vm-execution-status arguments: - name: vmID required: true description: The ID of the VM on which the script was executed. - name: executionId required: true description: The ID returned by the execution request. outputs: - contextPath: CloudShare.VM.Executions.id description: ID. type: string - contextPath: CloudShare.VM.Executions.exitCode description: Exit code. type: number - contextPath: CloudShare.VM.Executions.success description: Success. type: boolean - contextPath: CloudShare.VM.Executions.standardOutput description: Standard output. type: string - contextPath: CloudShare.VM.Executions.standardError description: Standard error. type: string - contextPath: CloudShare.VM.Executions.executedPath description: Executed path. type: string description: Checks the status of a previously executed command line script. - name: cloudshare-get-vm-remote-access-file arguments: - name: VmID description: The ID of the VM. - name: desktopHeight required: true description: The height resolution of the remote access session, in pixels. - name: desktopWidth required: true description: The width resolution of the remote access session, in pixels. outputs: - contextPath: CloudShare.VM.Remote.VmID description: VM ID. type: string - contextPath: CloudShare.VM.Remote.rdpFileContent description: RDP file content. type: string - contextPath: CloudShare.VM.Remote.clearTextPassword description: Clear text password. type: string description: Retrieves the content of a .rdp file that provides remote desktop access to the specified VM. An .rdp file comprising the returned content opens a remote desktop session to the VM from a Windows machine. It can also be used on Linux with FreeRDP or on Mac with Microsoft Remote Access. - name: cloudshare-execute-vm-command arguments: - name: vmId required: true description: The ID of the VM. - name: path required: true description: Path in VM. outputs: - contextPath: CloudShare.VM.Execute.executionId description: Execution ID. type: string description: Executes a command line script on a VM. - name: cloudshare-modify-vm-hardware arguments: - name: vmID required: true description: The ID of the VM. - name: numCpus required: true description: Number of CPUs. - name: memorySizeMBs required: true description: RAM size, in megabytes. - name: diskSizeGBs required: true description: Disk size, in gigabytes. outputs: - contextPath: CloudShare.VM.Modify.vmID description: VM ID. type: string - contextPath: CloudShare.VM.Modify.conflictsFound description: Conflicts found. type: boolean - contextPath: CloudShare.VM.Modify.conflicts description: Conflicts. type: string description: "Adjusts a VM's CPU count, disk size, and RAM." - name: cloudshare-reboot-vm arguments: - name: VmID required: true description: The ID of the VM. description: Reboots a VM. - name: cloudshare-revert-vm arguments: - name: VmID required: true description: The ID of the VM. description: Reverts a VM. - name: cloudshare-get-cloud-folders arguments: [] outputs: - contextPath: CloudShare.Folders.host description: Host. type: string - contextPath: CloudShare.Folders.path description: Path. type: string - contextPath: CloudShare.Folders.userName description: Username. type: string - contextPath: CloudShare.Folders.password description: Password. type: string - contextPath: CloudShare.Folders.userFolder.name description: Name. type: string - contextPath: CloudShare.Folders.userFolder.quotaSizeGB description: Quota size(GB). type: string - contextPath: CloudShare.Folders.userFolder.quotaSizeInUseGB description: Quota size in use(GB). type: string - contextPath: CloudShare.Folders.userFolder.usagePercentage description: Usage percentage. type: string - contextPath: CloudShare.Folders.projectFolders.name description: Name. type: string - contextPath: CloudShare.Folders.projectFolders.quotaSizeGB description: Quota size(GB). type: string - contextPath: CloudShare.Folders.projectFolders.quotaSizeInUseGB description: Quota size in use(GB). type: string - contextPath: CloudShare.Folders.projectFolders.usagePercentage description: Usage percentage. type: string description: "Retrieves the user's cloud folder and the user's projects' project folder(s)." - name: cloudshare-get-env-cloud-folders arguments: - name: EnvId required: true description: The ID of the environment. outputs: - contextPath: CloudShare.EnvFolders.name description: Name. type: string - contextPath: CloudShare.EnvFolders.sanitizedName description: Santized name. type: string - contextPath: CloudShare.EnvFolders.windowsFolder description: Windows folder. type: string - contextPath: CloudShare.EnvFolders.linuxFolder description: Linux folder. type: string - contextPath: CloudShare.EnvFolders.token description: Token. type: string description: "Shows the cloud folder on all of the environment's machines." - name: cloudshare-generate-cloud-folder-password arguments: [] outputs: - contextPath: CloudShare.FoldersPassword.newPassword description: New password. type: string - contextPath: CloudShare.FoldersPassword.newFtpUri description: New FTP URI. type: string description: "Generates a new FTP password for accessing the user's cloud folders." - name: cloudshare-unmount-env-folders arguments: - name: EnvId required: true description: The ID of the environment. description: "Hides the cloud folder on all of the environment's machines." - name: cloudshare-get-templates arguments: - name: templateType auto: PREDEFINED predefined: - '0' - '1' description: 'Filters the results by type of template. Possible values: 0 - Returns blueprints only. 1 - Returns VM templates only.' - name: projectId description: Filters the results to include only blueprints that belong to a specific project. - name: regionId description: Filters the results to include only templates that belong to a specific region. - name: skip description: Specifies to skip the first {skip} records, where {skip} is an integer. - name: take description: 'Limits the number of records returned, where {take_value} is the maximum number of records to return. Integer (default: 1000, maximum: 1000).' outputs: - contextPath: CloudShare.Templates.name description: Name. type: string - contextPath: CloudShare.Templates.description description: Description. type: string - contextPath: CloudShare.Templates.isEnvironmentTemplate description: Is environment template. type: boolean - contextPath: CloudShare.Templates.type description: Type. type: number - contextPath: CloudShare.Templates.imageUrl description: Image URL. type: string - contextPath: CloudShare.Templates.regionId description: Region ID. type: string - contextPath: CloudShare.Templates.tags description: Tags. type: unknown - contextPath: CloudShare.Templates.categories description: Categories. type: unknown - contextPath: CloudShare.Templates.resources.cpuCount description: CPU count. type: number - contextPath: CloudShare.Templates.resources.diskSizeMB description: Disk size(MB). type: number - contextPath: CloudShare.Templates.resources.memorySizeMB description: Memory size(MB). type: number - contextPath: CloudShare.Templates.numberOfMachines description: Number of mahcines. type: number - contextPath: CloudShare.Templates.hasMultipleVersions description: Has multiple versions. type: boolean - contextPath: CloudShare.Templates.hasDefaultVersion description: Has default version. type: boolean - contextPath: CloudShare.Templates.disabledForRegularEnvironmentCreation description: Disabled for regular environment creation. type: boolean - contextPath: CloudShare.Templates.disabledForTrainingEnvironmentCreation description: Disabled for training environment creation. type: boolean - contextPath: CloudShare.Templates.canAddMultipleInstances description: Can add multiple instances. type: boolean - contextPath: CloudShare.Templates.envTemplateScope description: Env template scopt. type: unknown - contextPath: CloudShare.Templates.creationDate description: Creation date. type: string - contextPath: CloudShare.Templates.id description: ID. type: string description: Retrieves VM templates and blueprints. - name: cloudshare-get-snapshot arguments: - name: snapshotID required: true description: The ID of the snapshot. outputs: - contextPath: CloudShare.Snapshots.authorName description: Author name. type: string - contextPath: CloudShare.Snapshots.comment description: Comment. type: string - contextPath: CloudShare.Snapshots.createTime description: Create time. type: string - contextPath: CloudShare.Snapshots.description description: Description. type: string - contextPath: CloudShare.Snapshots.id description: ID. type: string - contextPath: CloudShare.Snapshots.imageUrl description: Image URL. type: string - contextPath: CloudShare.Snapshots.isDefault description: Is default. type: boolean - contextPath: CloudShare.Snapshots.isLatest description: Is latest. type: boolean - contextPath: CloudShare.Snapshots.machines.canAddMultipleInstances description: Can add multiple instances. type: boolean - contextPath: CloudShare.Snapshots.machines.description description: Description. type: string - contextPath: CloudShare.Snapshots.machines.domainName description: Domain name. type: string - contextPath: CloudShare.Snapshots.machines.hostName description: Hostname. type: string - contextPath: CloudShare.Snapshots.machines.httpAccessEnabled description: HTTP access enabled. type: boolean - contextPath: CloudShare.Snapshots.machines.id description: ID. type: string - contextPath: CloudShare.Snapshots.machines.id description: Image URL. type: string - contextPath: CloudShare.Snapshots.machines.internalIPs description: Internal IPs. type: unknown - contextPath: CloudShare.Snapshots.machines.macAddresses description: MAC addresses. type: unknown - contextPath: CloudShare.Snapshots.machines.name description: Name. type: string - contextPath: CloudShare.Snapshots.machines.osTypeName description: OS type name. type: string - contextPath: CloudShare.Snapshots.machines.password description: Password. type: string - contextPath: CloudShare.Snapshots.machines.resources.cpuCount description: CPU count. type: number - contextPath: CloudShare.Snapshots.machines.resources.diskSizeMB description: Disk size(MB). type: number - contextPath: CloudShare.Snapshots.machines.resources.memorySizeMB description: Memory size(MB). type: number - contextPath: CloudShare.Snapshots.machines.startWithHttps description: Start with HTTPS. type: boolean - contextPath: CloudShare.Snapshots.machines.user description: User. type: string - contextPath: CloudShare.Snapshots.machines.vanityName description: Vanity name. type: string - contextPath: CloudShare.Snapshots.name description: Name. type: string - contextPath: CloudShare.Snapshots.number description: Number. type: number - contextPath: CloudShare.Snapshots.resources.cpuCount description: CPU count. type: number - contextPath: CloudShare.Snapshots.resources.diskSizeMB description: Disk size(MB). type: number - contextPath: CloudShare.Snapshots.resources.memorySizeMB description: Memory size(MB). type: number - contextPath: CloudShare.Snapshots.type description: Type. type: number - contextPath: CloudShare.Snapshots.regions description: Regions. description: Retrieves details of a snapshot. - name: cloudshare-get-env-snapshots arguments: - name: envId required: true description: The ID of the environment. outputs: - contextPath: CloudShare.Snapshots.authorName description: Author name. type: string - contextPath: CloudShare.Snapshots.comment description: Comment. type: string - contextPath: CloudShare.Snapshots.createTime description: Create time. type: string - contextPath: CloudShare.Snapshots.description description: Description. type: string - contextPath: CloudShare.Snapshots.id description: ID. type: string - contextPath: CloudShare.Snapshots.imageUrl description: Image URL. type: string - contextPath: CloudShare.Snapshots.isDefault description: Is default. type: boolean - contextPath: CloudShare.Snapshots.isLatest description: Is latest. type: boolean - contextPath: CloudShare.Snapshots.machines.canAddMultipleInstances description: Can add multiple instances. type: boolean - contextPath: CloudShare.Snapshots.machines.description description: Description. type: string - contextPath: CloudShare.Snapshots.machines.domainName description: Domain name. type: string - contextPath: CloudShare.Snapshots.machines.hostName description: Hostname. type: string - contextPath: CloudShare.Snapshots.machines.httpAccessEnabled description: HTTP access enabled. type: boolean - contextPath: CloudShare.Snapshots.machines.id description: ID. type: string - contextPath: CloudShare.Snapshots.machines.id description: Image URL. type: string - contextPath: CloudShare.Snapshots.machines.internalIPs description: Internal IPs. type: unknown - contextPath: CloudShare.Snapshots.machines.macAddresses description: MAC addresses. type: unknown - contextPath: CloudShare.Snapshots.machines.name description: Name. type: string - contextPath: CloudShare.Snapshots.machines.osTypeName description: OS type name. type: string - contextPath: CloudShare.Snapshots.machines.password description: Password. type: string - contextPath: CloudShare.Snapshots.machines.resources.cpuCount description: CPU count. type: number - contextPath: CloudShare.Snapshots.machines.resources.diskSizeMB description: Disk size(MB). type: number - contextPath: CloudShare.Snapshots.machines.resources.memorySizeMB description: Memory size(MB). type: number - contextPath: CloudShare.Snapshots.machines.startWithHttps description: Start with HTTPS. type: boolean - contextPath: CloudShare.Snapshots.machines.user description: User. type: string - contextPath: CloudShare.Snapshots.machines.vanityName description: Vanity name. type: string - contextPath: CloudShare.Snapshots.name description: Name. type: string - contextPath: CloudShare.Snapshots.number description: Number. type: number - contextPath: CloudShare.Snapshots.resources.cpuCount description: CPU count. type: number - contextPath: CloudShare.Snapshots.resources.diskSizeMB description: Disk size(MB). type: number - contextPath: CloudShare.Snapshots.resources.memorySizeMB description: Memory size(MB). type: number - contextPath: CloudShare.Snapshots.type description: Type. type: number - contextPath: CloudShare.Snapshots.regions description: Regions. description: "Retrieves all snapshots contained in a specified environment's blueprint. A blueprint can contain up to five snapshots, with newer snapshots displacing the oldest snapshots in the blueprint." - name: cloudshare-mark-default-snapshot arguments: - name: snapshotID required: true description: The ID of the snapshot that you want to mark as default. description: Marks a specified snapshot as the default snapshot in its containing blueprint. New environments created from a blueprint are based on the default snapshot in the blueprint. This request enables you to change which snapshot is the default snapshot in a given blueprint so that new environments will be based on the snapshot of your choice. - name: cloudshare-take-snapshot-env arguments: - name: envId required: true description: The ID of the environment of which to take the snapshot. - name: name required: true description: A name for the new snapshot. Should not exceed 32 characters. - name: description description: A description for the new snapshot. - name: newBlueprintName description: A name to assign to a new blueprint. If specified, the snapshot is created in a new blueprint with the specified name, rather than in the default environment blueprint. Must be null if there is not yet at least one snapshot in the default environment blueprint. If specified, otherBlueprintId must be null. If both newBlueprintName and otherBlueprintId are null, the snapshot is created in the default environment blueprint. - name: otherBlueprintId description: The ID of an existing blueprint. If specified, the snapshot is created in the specified blueprint rather than in the default environment blueprint. Must be null if there is not yet at least one snapshot in the default environment blueprint. If specified, newBlueprintName must be null. If both newBlueprintName and otherBlueprintId are null, the snapshot is created in the default environment blueprint. - name: setAsDefault auto: PREDEFINED predefined: - 'true' - 'false' description: Defaults to true. If true, the new snapshot is marked as the default snapshot in the containing blueprint. defaultValue: 'true' description: Takes a snapshot of an environment. - name: cloudshare-get-teams arguments: [] outputs: - contextPath: CloudShare.Teams.Name description: Name. type: string - contextPath: CloudShare.Teams.Id description: ID. type: string description: Retrieves all available teams in all available projects. - name: cloudshare-invite-user-poc arguments: - name: policyId description: "The ID of the environment policy to assign to the environment created for the end user as part of the POC. The policy will govern the life cycle of the end user's environment." - name: blueprintId required: true description: "The ID of the blueprint based on which the end user's environment will be created (this is the POC's blueprint)." - name: OwningProjectMemberId required: true description: The ID of the project member user to whom the end user will be assigned. - name: opportunity required: true description: The name of the business opportunity to be associated with the end user. - name: validForDays required: true description: The number of days to keep the invitation valid for. - name: email required: true description: "The recipient's email. The invitation will be sent to the specified email." - name: firstName required: true description: "The recipient's first name." - name: LastName required: true description: "The recipient's last name." - name: regionId description: "The region in which to create the POC's environment." - name: InviteeCanSetEmail auto: PREDEFINED predefined: - 'true' - 'false' description: Indicates whether an end user can set email when accepting the invitation. Default is true. defaultValue: 'true' - name: customEmailSubject description: The subject of the email. The invitation will be sent with the specified custom email subject. This value will override the custom email subject in the UI. - name: customEmailBody description: The body of the email. The invitation will be sent with the specified custom email body. This value will override the custom email body in the UI. outputs: - contextPath: CloudShare.Invites.invitationDetailsUrl description: Invitation details URL. type: string - contextPath: CloudShare.Invites.acceptInvitationUrl description: Accept invitation URL. type: string - contextPath: CloudShare.Invites.message description: Message. type: string description: Invite an end user to a POC, based on a specified blueprint, and assigns a specific project member user to be the owning project member for the end user. A policy ID, blueprint ID and owning project member ID must be specified. - name: cloudshare-get-poc-invitations arguments: - name: from description: 'Retrieve invites from a particular time (Example: "last 7 days").' - name: sentBy description: Filter based on who sent the invite (default is anyone). - name: skip description: 'Specifies to skip the first {skip} records, where {skip} is an integer (default: 0). Can be used iteratively in conjunction with take to view distinct sets of template records.' - name: sortBy description: The filed to sort by. - name: statusCategory description: The status categoey to filter by. - name: take description: 'Limits the number of records returned, where {take} is the maximum number of records to return. Integer (default: 1000, maximum: 1000).' outputs: - contextPath: CloudShare.POCInvites.blueprintShortId description: Blueprint short ID. type: string - contextPath: CloudShare.POCInvites.projectName description: Project name. type: string - contextPath: CloudShare.POCInvites.createdOn description: Created on. type: string - contextPath: CloudShare.POCInvites.owningSe description: Owning SE. type: string - contextPath: CloudShare.POCInvites.environmentId description: Environment ID. type: string - contextPath: CloudShare.POCInvites.pocUser description: POC user. type: string - contextPath: CloudShare.POCInvites.startDate description: Start date. type: string - contextPath: CloudShare.POCInvites.status description: Status. type: number - contextPath: CloudShare.POCInvites.opportunity description: Opportunity. type: string - contextPath: CloudShare.POCInvites.owningSeUserId description: Owning SE user ID. type: string - contextPath: CloudShare.POCInvites.projectId description: Project ID. type: string - contextPath: CloudShare.POCInvites.randomToken description: Random token. type: string - contextPath: CloudShare.POCInvites.id description: ID. type: string - contextPath: CloudShare.POCInvites.expirationDate description: Expiration date. type: string - contextPath: CloudShare.POCInvites.blueprintName description: Blueprint name. type: string description: Retrieves POC invitations sent. dockerimage: demisto/py3-tools:1.0.0.5984007 subtype: python3 beta: true fromversion: 6.0.0 tests: - No tests (auto formatted) sectionorder: - Connect - Collect