Help Center> CodeArts Deploy> API Reference> APIs> Environment Management> Querying the Details of an Environment
Updated on 2023-11-28 GMT+08:00

Querying the Details of an Environment

Function

This API is used to query the details of an environment.

URI

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

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

application_id

Yes

String

Application ID.

Minimum: 32

Maximum: 32

environment_id

Yes

String

Environment ID.

Minimum: 32

Maximum: 32

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token. It can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token.

Minimum: 0

Maximum: 20000

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

status

String

Response status.

result

EnvironmentDetail object

Environment details.

Table 4 EnvironmentDetail

Parameter

Type

Description

id

String

Environment ID.

name

String

Environment name.

description

String

Environment description.

os

String

OS.

nick_name

String

User alias.

deploy_type

Integer

Deployment type. 0: host; 1: kubernetes.

created_time

String

Creation time.

instance_count

Integer

Number of host instances in the environment.

created_by

UserInfo object

User information.

permission

EnvironmentPermissionDetail object

Environment permission details.

Table 5 UserInfo

Parameter

Type

Description

user_id

String

User ID.

user_name

String

Username.

Table 6 EnvironmentPermissionDetail

Parameter

Type

Description

can_delete

Boolean

Whether you have the permission to delete the environment.

can_deploy

Boolean

Whether you have the deployment permission.

can_edit

Boolean

Whether you have the permission to edit the environment.

can_manage

Boolean

Whether you have permission to edit the environment permission matrix.

can_view

Boolean

Whether you have the permission to view the environment.

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" : "a0a2274acc4f482bb2ecf49f865879fa",
    "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
    }
  }
}

Status Codes

Status Code

Description

200

OK: The request is successful.

Error Codes

See Error Codes.