/instances
Get active and pending instances.
Authorizations
Response
The unique identifier for the instance. Used in the instances for the /instances/{id}/info and /instances/{id}/delete APIs.
Specifies the underlying cloud provider. See this explanation for more details.
aws
, azure
, lambdalabs
, tensordock
, runpod
, latitude
, jarvislabs
, oblivus
, paperspace
, datacrunch
, massedcompute
, vultr
Specifies the region.
The Shadeform standardized instance type. See this explanation for more details.
The instance type for the underlying cloud provider. See this explanation for more details.
The unique identifier of the instance issued by the underlying cloud provider.
Specifies if the instance is launched in Shade Cloud or in a linked cloud account.
The name of the instance
The amount of memory for the instance in gigabytes. Note that this is not VRAM which is determined by GPU type and the number of GPUs.
The amount of storage for the instance. If this storage is too low for the instance type, please email founders@shadeform.ai as the storage may be adjustable.
The number of vCPUs for the instance.
The number of GPUs for the instance.
The type of GPU for the instance.
The type of GPU interconnect.
The video memory per GPU for the instance in gigabytes.
The operating system of the instance.
The public IP address of the instance. In select cases, it may also be the DNS.
The SSH user used to SSH into the instance.
The SSH port of the instance. In most cases, this will be port 22 but for some clouds, this may be a different port.
The status of the instance.
pending
, active
, deleted
The cost incurred by the instance. This only the cost via Shadeform. If the instance is deployed in your own cloud account, then all billing is through your cloud provider.
The hourly price of the instance in cents.
Defines automatic actions after the instance becomes active.
Specifies the type of launch configuration. See Launch Configuration for more details.
docker
, script
May only be used if launch_configuration.type is 'docker'. Use docker_configuration to automatically pull and run a docker image. See this tutorial for examples.
Specifies the docker image to be pulled and run on the instance at startup.
Specifies the container arguments passed into the image at runtime.
Describes the amount of shared memory allocated for the container. Equivalent to using the --shm-size flag in the docker cli. If shared_memory_in_gb is not specified, then the container will use the host namespace which is the equivalent of --ipc=host.
List of environment variable name-value pairs that will be passed to the docker container.
Name of the environment variable
Value of the environment variable
List of port mappings between the host instance and the docker container. Equivalent of -p flag for docker run command.
Port of the host.
Port of the container.
List of volume mounts between the host instance and the docker container. Equivalent of -v flag for docker run command.
Filepath of the host.
Filepath of the container.
May only be used if launch_configuration.type is 'script'. Configures a startup script to be run automatically after the instance is active. See this tutorial for examples.
A startup script that is base64 encoded.
The timestamp of when the instance was created in UTC.
The timestamp of when the instance was deleted in UTC.