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

Modifying Tracing Configuration

Function

This API is used to modify the tracing configuration of a function. You can enable or modify the AK/SK or disable the AK/SK.

URI

PUT /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

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

tracing_ak

No

String

Parameter description:

Access key for reporting data to APM.

Constraints

None

Value range:

None

Default value:

None

tracing_sk

No

String

Parameter description:

Secret key for reporting data to APM.

Constraints

None

Value range:

None

Default value:

None

Response Parameters

Status code: 400

Table 4 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 403

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

Modify the AK/SK in a function's tracing configuration.

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

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

Example Responses

Status code: 400

Bad Request

{
  "error_code" : "FSS.1128",
  "error_msg" : "function[xxx] not existed"
}

Status code: 403

FORBIDDEN

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

Status code: 500

Internal error.

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

Status Codes

Status Code

Description

200

OK

400

Bad Request

403

FORBIDDEN

500

Internal error.

Error Codes

See Error Codes.