Querying Lite Server Instance Details

Function

This API is used to obtain the details of a specified Lite Server instance. It is used when you need to view the configuration, status, and network information of a specific Lite Server instance for fault locating, resource management, and monitoring. Before using this API, ensure that you have logged in to the system, have the permission to view the Lite Server instance, and have a valid instance ID. After the query, the system returns the details of the specified Lite Server instance, including the instance ID, name, status, configuration, and network configuration. If you do not have the required permission, the instance ID is invalid, or the instance does not exist, the API returns an error message.

Constraints

No constraints

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action

Access Level

Resource Type (*: required)

Condition Key

Alias

Dependencies

modelarts:devserver:get

Read

devserver *

-

-

-

-

g:EnterpriseProjectId

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
modelarts:devserver:get	Read	devserver *	-	-	-
-	g:EnterpriseProjectId

URI

GET /v1/{project_id}/dev-servers/{id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
id	Yes	String	Definition: Lite Server ID. For details about how to obtain the ID, see the id field returned by the API for obtaining the Lite Server list. Constraints: N/A Range: a string of 1 to 64 characters, including letters, digits, and hyphens (-). Default Value: N/A
project_id	Yes	String	Definition: Project ID. For details, see Obtaining a Project ID and Name. Constraints: N/A Range: The value can contain 1 to 64 characters. Only letters, digits, and hyphens (-) are allowed. Default Value: N/A

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
create_at	Long	Definition: Creation time, which is a Unix timestamp in milliseconds. Range: N/A
update_at	Long	Definition: Update time, which is a Unix timestamp in milliseconds. Range: N/A
charging_mode	String	Definition: Billing mode. Range COMMON: Both yearly/monthly and pay-per-use billing modes are supported. POST_PAID: pay-per-use PRE_PAID: yearly/monthly
cloud_server	CloudServer object	Definition: Cloud service information.
endpoints_response	Array of Endpoints objects	Definition: Private IP address of the instance. Each element in the list is an Endpoints object, containing information such as the supported service type and access method.
flavor	String	Definition: Instance flavor name. Range: 1 to 128 characters
id	String	Definition: Instance ID. Range: a UUID in the format of xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, where x is a hexadecimal number.
key_pair_name	String	Definition: Key pair name. Range: The value is a string of 1 to 64 characters, including letters, digits, hyphens (-), underscores (_), and periods (.).
name	String	Definition: Instance name. Range: The value is a string of 1 to 64 characters, including letters, digits, hyphens (-), underscores (_), and periods (.).
order_id	String	Definition: Order ID. Range: The value is a string of 1 to 64 characters, including letters and digits.
status	String	Definition: Instance status. Current running status of the instance, which is used to monitor the lifecycle and health status of the instance. Range: CREATE_FAILED: Creating the instance failed. CREATING: The instance is being created. DELETED: The instance has been deleted. DELETE_FAILED: Deleting the instance failed. DELETING: The instance is being deleted. ERROR: An error occurred. RUNNING: The instance is running. STARTING: The instance is being started. START_FAILED: Starting the instance failed. STOPPED: The instance has been stopped. STOPPING: The instance is being stopped. STOP_FAILED: Stopping the instance failed. REBOOTING: The instance is being restarted. REBOOT_FAILED: Restarting the instance failed. CHANGINGOS: The OS is being changed. CHANGINGOS_FAILED: Changing the OS failed. REINSTALLINGOS: The OS is being reinstalled. REINSTALLINGOS_FAILED: Reinstalling the OS failed.
vpc_id	String	Definition: ID of the VPC where the instance is located. Range: a UUID in the format of xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, where x is a hexadecimal number.
endpoints	Array of EndpointsRes objects	Definition: Private IP address of the server. Each element in the list is an EndpointsRes object, containing information such as the access method and private IP address.
volumes	Array of ServerVolume objects	Definition: Information about the attached disk. Each element in the list is a ServerVolume object, containing information such as the disk size, type, and EVS disk information.
image	ServerImageResponse object	Definition: Server image information.
category	String	Definition: Server type. Range: HPS: supernode server SPOD: full-cabinet server SERVER: single server
server_hps	ServerHpsInfo object	Definition: Information about the supernode to which the server belongs.
subnet_id	String	Description: ID of the subnet where the instance is located. Range: a UUID in the format of xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, where x is a hexadecimal number.

**Table 3** CloudServer
Parameter	Type	Description
id	String	Definition: Server resource ID or supernode's child node ID. Range: a UUID in the format of xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, where x is a hexadecimal number.
type	String	Definition: Lite Server server type. Range: BMS: Bare Metal Server ECS: Elastic Cloud Server HPS: Supernode server
hps_id	String	Definition: Server resource ID of the supernode's child node. Range: a UUID in the format of xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, where x is a hexadecimal number.
hps_ecs_id	String	Definition: Server resource ID of the supernode's child node. Range: a UUID in the format of xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, where x is a hexadecimal number.

**Table 4** Endpoints
Parameter	Type	Description
dev_service	String	Definition: Supported services. The difference between dev_service here and dev_service in EndpointsRes is as follows: dev_service here is used to specify the service type in the request, and dev_service in EndpointsRes is used to identify the access mode in the response. Range NOTEBOOK: You can access notebook instances using HTTPS. SSH: You can remotely access notebook instances through SSH.
extensions	Map<String,String>	Definition: App-specific URL for accessing the remote development mode of the app. It includes extended configurations of the application. key indicates the name of the extended configuration, and value indicates the value of the extended configuration.
ssh_keys	Array of strings	Definition: List of SSH key pair names. A maximum of 1,024 key pairs are supported. You can set multiple key pairs to access an SSH instance at the same time.

**Table 5** EndpointsRes
Parameter	Type	Description
dev_service	String	Definition: Method for accessing the notebook instance. Range: NOTEBOOK: You can access notebook instances using HTTPS. SSH: You can remotely access notebook instances through SSH.
service	String	Definition: Method for accessing the notebook instance. The difference between service and dev_service is that service is used to identify the access mode in the response, while dev_service is used to specify the service type in the request. Range NOTEBOOK: You can access notebook instances using HTTPS. SSH: You can remotely access notebook instances through SSH.
uri	String	Definition: URI for accessing the instance. The format is private IP address. Range: N/A
key_pair_names	Array of strings	Definition: List of SSH key pairs. You can set multiple key pairs to access an SSH instance at the same time. Range: N/A

**Table 6** ServerVolume
Parameter	Type	Description
size	Integer	Definition: Size of the EVS disk, in GB. It specifies the storage space allocated to the system disk. Range: 100 to 1024
type	String	Definition: Storage type, which can be a system disk or data disk. Range ROOT: System disk DATA: Data disk
evs_type	String	Definition: EVS disk type. Storage type of the EVS disk. Range ESSD: Extreme SSD GPSSD: General-purpose SSD SAS: High I/O EVS disk SATA: Common I/O EVS disk SSD: Ultra-high I/O EVS disk
evs_id	String	Definition: ID of the EVS disk. Range: a UUID in the format of xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, where x is a hexadecimal number.

**Table 7** ServerImageResponse
Parameter	Type	Description
arch	String	Definition: Architecture type of a server image. Range ARM: Arm architecture, which is applicable to mobile and embedded scenarios. X86: x86 architecture, which is applicable to general computing scenarios.
image_id	String	Definition: Server image ID. Range: a UUID in the format of xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, where x is a hexadecimal number.
name	String	Definition: Server image name. Range: 1 to 256 characters
server_type	String	Definition: Server type. Range: BMS: BMS ECS: ECS HPS: supernode server
status	String	Definition: Server image status. Range ACTIVE: The image is available. INACTIVE: The image is unavailable.

**Table 8** ServerHpsInfo
Parameter	Type	Description
id	String	Definition: Lite Server supernode instance ID. Range: a UUID in the format of xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, where x is a hexadecimal number.
name	String	Definition: Lite Server supernode name. Range: The value is a string of 1 to 64 characters, including letters, digits, hyphens (-), underscores (_), and periods (.).

Example Requests

GET https://{endpoint}/v1/{project_id}/dev-servers/{id}

Example Responses

Status code: 200

{
  "charging_mode" : "POST_PAID",
  "cloud_server" : {
    "type" : "ECS"
  },
  "create_at" : 1699348284990,
  "flavor" : "Si2.large.4",
  "id" : "62383738-e52a-450a-9f84-f9e705402be8",
  "image" : {
    "arch" : "X86",
    "image_id" : "c90fb553-2cdb-4b81-b56a-ef68812c6cf7",
    "name" : "Ubuntu18.04_x86_64_CPU",
    "server_type" : "ECS"
  },
  "name" : "EI-evs-1107",
  "status" : "STARTING",
  "update_at" : 1699348285077
}