Help Center/ FunctionGraph/ API Reference/ APIs/ Function Tracing/ Querying Tracing Configuration
Updated on 2026-04-17 GMT+08:00

Querying Tracing Configuration

Function

This API is used to query the tracing configuration of a function.

URI

GET /v2/{project_id}/fgs/functions/{function_urn}/tracing

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Parameter description:

Project ID. For details, see Obtaining a Project ID.

Constraints:

None

Value range:

32 characters, including letters and digits.

Default value:

None

function_urn

Yes

String

Parameter description:

URN of the function. For details, see Function Model.

Constraints:

None

Value range:

Only letters, digits, underscores (_), hyphens (-), and colons (:) are allowed.

Default value:

None

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Parameter description:

User token.

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

Constraints:

None

Value range:

None

Default value:

None

Content-Type

Yes

String

Parameter description:

Specifies the type (or format) of the message body.

Constraints:

None

Value range:

Only application/json is supported.

Default value:

application/json

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

tracing_ak

String

Parameter description:

Access key for reporting data to APM.

Value range:

None

tracing_sk

String

Parameter description:

Secret key for reporting data to APM.

Value range:

None

Status code: 403

Table 4 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 404

Table 5 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 500

Table 6 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Example Requests

Query the tracing configuration of a function.

GET /v2/{project_id}/fgs/functions/{function_urn}/tracing

Example Responses

Status code: 200

ok

{
  "tracing_ak" : "xxx",
  "tracing_sk" : "******"
}

Status code: 403

FORBIDDEN

{
  "error_code" : "FSS.0403",
  "error_msg" : "invalid token"
}

Status code: 404

Not Found

{
  "error_code" : "FSS.0404",
  "error_msg" : "can not find tracing aksk"
}

Status code: 500

Internal error.

{
  "error_code" : "FSS.0500",
  "error_msg" : "xxx"
}

Status Codes

Status Code

Description

200

ok

403

FORBIDDEN

404

Not Found

500

Internal error.

Error Codes

See Error Codes.