Help Center/ Application Performance Management/ API Reference(2.0)/ APIs/ Transaction Query APIs/ Querying a Region's Environments on Which URLs Are Added for Tracing (V2)
Updated on 2025-11-19 GMT+08:00

Querying a Region's Environments on Which URLs Are Added for Tracing (V2)

Function

This API is used to query a region's environments on which URLs are added for tracing.

URI

POST /v2/transaction/business-env

Request Parameters

Table 1 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token obtained from IAM.

x-business-id

Yes

Long

Application ID.

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

business_id

Yes

Long

Application ID.

region

No

String

Region name.

start_time

No

String

Start time.

end_time

No

String

End time.

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

env_entry_list

Array of EnvEntry objects

Environment list.

Table 4 EnvEntry

Parameter

Type

Description

env_id

Long

Environment ID.

env_name

String

Environment name.

Example Requests

Query the list of the region's environments on which URLs are added for tracing in the last 20 minutes. The application ID is 108903.

/v2/transaction/business-env

{
  "region" : "",
  "business_id" : 108903,
  "start_time" : "-20m",
  "end_time" : "now"
}

Example Responses

Status code: 200

OK: The request is successful.

{
  "env_entry_list" : [ {
    "env_id" : 332788,
    "env_name" : "lubanops-web:wulan"
  }, {
    "env_id" : 198496,
    "env_name" : "apm-alarm:wulan"
  }, {
    "env_id" : 140442,
    "env_name" : "apm-rum-analysis:wulan"
  }, {
    "env_id" : 140456,
    "env_name" : "config-web:wulan"
  }, {
    "env_id" : 140462,
    "env_name" : "apm-api:wulan"
  }, {
    "env_id" : 140460,
    "env_name" : "apm-access:wulan"
  } ]
}

Status Codes

Status Code

Description

200

OK: The request is successful.

400

Bad Request: Semantic or parameter error.

401

Unauthorized: No permissions.

403

Forbidden: Access forbidden.

404

Not Found: The requested resource is not found.

Error Codes

See Error Codes.