Cloud Management API 1.5
Instance
Instances represent an entity that is runnable in the cloud.
An instance of type "next" is a container of information that expresses how to configure a future instance when we decide to launch or start it. A "next" instance generally only exists in the RightScale realm, and usually doesn't have any corresponding representation existing in the cloud. However, if an instance is not of type "next", it will generally represent an existing running (or provisioned) virtual machine existing in the cloud.
Content-Types
- Content type
- application/vnd.rightscale.instance
Relationships
- alert_specs
- Associated alert specs
- alerts
- Associated alerts
- cloud
- Associated Cloud
- datacenter
- Associated datacenter
- deployment
- Associated Deployment
- image
- Associated image
- inputs
- List of configuration inputs
- instance_type
- Associated instance type
- kernel_image
- Associated kernel image
- lock_user
- Href of the user who has locked this instance
- monitoring_metrics
- Associated monitoring metrics
- multi_cloud_image
- Associated multi cloud image
- parent
- Parent Object (Server/ServerArray)
- placement_group
- Associated placement group
- ramdisk_image
- Associated ramdisk image
- self
- Href of itself
- server_template
- Associated ServerTemplate
- ssh_key
- Associated ssh key
- volume_attachments
- Associated volume attachments
Actions
- launch
- Launches this instance with the current configuration
- lock
- Locks a running instance
- reboot
- Reboots a running instance
- run_executable
- Runs a script or recipe on the instance
- start
- Starts an instance that has been stopped, resuming it to its previously saved volume state.
- stop
- Stores the instance's current volume state to resume later using the 'start' action.
- terminate
- Terminates the instance
- unlock
- Unlocks a running instance
Attributes
- actions
- admin_password
- associate_public_ip_address
- cloud_specific_attributes
- created_at
- description
- inherited_sources
- inputs
- ip_forwarding_enabled
- links
- locked
- monitoring_collector_http
- The hostname used to GET from or POST to the monitoring system.
- monitoring_collector_udp
- The hostname used to push the data to the monitoring system i.e. collectd udp protocol.
- monitoring_id
- monitoring_server
- The name of the monitoring server
- name
- os_platform
- pricing_type
- private_dns_names
- private_ip_addresses
- public_dns_names
- public_ip_addresses
- resource_uid
- rs_provisioned
- security_groups
- state
- subnets
- terminated_at
- updated_at
- user_data