Skip to main content
Version: 2024.1

Sandbox Identifier

Description

Gets details and available actions for a particular sandbox.

URL

http://{CloudShell Sandbox API Gateway IP address}:{port#}/api/v1/sandboxes/{sandbox_identifier}

ParameterDescription/Comments
sandbox_identifierThe id of the sandbox (string). Can be retrieved via sandboxes, blueprint start and from the sandbox ID segment in the CloudShell Portal URL.

HTTP method

GET

Request

Headers

Example header format for the sandbox identifier method:

Authorization: Basic <authorization token returned from the login method>

Content-Type: application/json

Response

Response example

The sandbox identifier method returns details about a particular sandbox (as opposed to multiple ones). The output includes details about the sandbox ID and the actions that can be performed on the sandbox:

{
"name":"Test Blprnt 2",
"id":"994bd534-740a-45f5-851f-ff452f2a17a2",
"state":"Ready",
"setup_stage":"Provisioning""type":"Sandbox",
"components":[
{
"name":"MySwitch",
"type":"Resource",
"component_type":"Generic Switch Model",
"description":"",
"attributes":[
{
"type":"string",
"name":"vendor",
"value":" """
}
],
"connection_interfaces":[
{
"name":"Telnet",
"url":""
}
],
}
],
"apps":[
{
"name":"MyApp",
"type":"Application",
"description":""
}
],
]"permitted_users":[
{
"john.s",
"emily.b",
"lucas.w"
}
]"_links":{
"self":{
"href":"/sandboxes/994bd534-740a-45f5-851f-ff452f2a17a2",
"method":"GET",
"name":"get a sandbox' details",
"templated":true
},
"stop":{
"href":"/sandboxes/994bd534-740a-45f5-851f-ff452f2a17a2/stop",
"method":"POST",
"name":"stop a sandbox",
"templated":true
},
"all":{
"href":"/sandboxes",
"method":"GET",
"name":"get all sandboxes"

}
}
Response summary

The response output properties of the sandbox identifier method are described in the following table.

PropertySub PropertyDescription/Comments
name The name of the sandbox. (string)
id The ID of the sandbox. (string)
blueprint_id The ID of the blueprint on which the sandbox is based.
description A description of the sandbox (string)
start_time The time when the sandbox started (string)
end_time the time when the sandbox ended or is expected to end (string)
state The current state of the sandbox. Possible values: Pending, Setup, Ready, Teardown, Error, Ended. (string)
setup_stage (If the sandbox includes orchestration scripts) The current setup stage of the sandbox. Possible values: Provisioning, Connectivity, Configuration, Ended, None. (string)
type The sandbox type ("Sandbox"). (string)
components The resource model of the sandbox. (array)
 nameThe name of the component. (string)
 typeThe component ("resource", "application", or "service"). (string)
 component_typeThe resource model. (string)
 descriptionA short description of the resource.
 attributesThe attributes of the resource model. (array)
 typeThe attribute type. (string)
 nameThe attribute name. (string)
 valueThe attribute value. (string)
 connection_interfacesThe connection interfaces of the resource. (array)
 nameThe name of the connection interface. (string)
 urlThe URL of the connection interface of the resource. (string)
apps The Apps of the sandbox. (string)
 typeThe App type ("Application"). (string)
 nameThe name of the App (for example, App1). (string)
 descriptionA short description of the App. (string)
permitted_users Sandbox's permitted users list. Specify as a comma-separated list of the CloudShell user names.
_links The actions that can be performed on the sandbox in the user's domain:
 selfProvides a link to get the details for the sandbox via a GET request.
 stopProvides a link to stop the sandbox via a POST request.
 allProvides a link to get all available sandboxes according to the user's domain, via a GET request.
 blueprintProvides a link to get the details of the sandbox's blueprint via a GET request.