Querying Environment Details

Function

This API is used to query environment details.

Calling Method

For details, see Calling APIs.

URI

GET /v1/applications/{application_id}/environments/{environment_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
application_id	Yes	String	Definition: Application ID. Constraints: N/A. Value range: 32 characters, including letters and digits. Default value: N/A.
environment_id	Yes	String	Definition: Environment ID. Constraints: N/A. Value range: 32 characters, including letters and digits. Default value: N/A.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition: User token. Obtain a token (the value of the X-Subject-Token response header) by calling the IAM API used for. Constraints: N/A. Value range: String. Max. 20,000 characters. Default value: N/A.

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
status	String	Definition: Request status (successful or failed). Value range: success: Successful. failed: Failed.
result	EnvironmentDetailResponse object	Definition: Environment details.

**Table 4** EnvironmentDetailResponse
Parameter	Type	Description
id	String	Definition: Environment ID. Value range: 32 characters, including letters and digits.
name	String	Definition: Environment name. Value range: N/A.
description	String	Definition: Environment description. Value range: N/A.
os	String	Definition: OS of environments. Value range: window: Windows OS. linux: Linux OS.
project_id	String	Definition: Project ID. Range: N/A
nick_name	String	Definition: Nickname of the environment creator. Value range: N/A.
deploy_type	Integer	Definition: Deployment type. Value range: 0: Host type. 1: Kubernetes type.
instance_count	Integer	Definition: Number of host instances in the environment. Range: N/A
created_time	String	Definition: Environment creation time. Format: yyyy-MM-dd HH:mm:ss. Value range: N/A.
created_by	UserInfo object	Definition: Information about the environment creator, including the user ID and username.
permission	EnvironmentPermissionDetail object	Definition: Environment operation permission matrix of the current user.

**Table 5** UserInfo
Parameter	Type	Description
user_id	String	Parameter description: User ID. Value range: The value consists of 32 characters. Only letters and digits are allowed.
user_name	String	Parameter description: Username. Value range: The value consists of 1-255 characters. Only letters and digits are allowed.

**Table 6** EnvironmentPermissionDetail
Parameter	Type	Description
can_delete	Boolean	Definition: Whether you have the permission to delete environments. Value range: true: Yes. false: No.
can_deploy	Boolean	Definition: Whether you have the permission to deploy environments. Value range: true: Yes. false: No.
can_edit	Boolean	Definition: Whether you have permission to edit environments. Value range: true: Yes. false: No.
can_manage	Boolean	Definition: Whether you have permission to edit the environment permission matrix. Value range: true: Yes. false: No.
can_view	Boolean	Definition: Whether you have permission to view environments. Value range: true: Yes. false: No.

Example Requests

https://{endpoint}/v1/applications/43943381f7764c52baae8e697720873f/environments/140ca97e701d4c4c93c5932d5bdb32ec

Example Responses

Status code: 200

OK: The request is successful.

{
  "status" : "success",
  "result" : {
    "created_by" : {
      "user_id" : "6baa7454109d47c192f22078fe6cda20",
      "user_name" : "devcloud_devcloud_l00490255_01"
    },
    "created_time" : "2023-06-20 16:53:29.0",
    "deploy_type" : 0,
    "description" : "",
    "id" : "140ca97e701d4c4c93c5932d5bdb32ec",
    "name" : "casdasd",
    "nick_name" : "A/B Side Account",
    "os" : "linux",
    "permission" : {
      "can_delete" : true,
      "can_deploy" : true,
      "can_edit" : true,
      "can_manage" : true,
      "can_view" : true
    }
  }
}