Help Center/ DataArts Studio/ API Reference/ DataArts DataService APIs/ Cluster Management/ Enabling Log Dump to OBS for a DataArts DataService Cluster
Updated on 2025-11-28 GMT+08:00

Enabling Log Dump to OBS for a DataArts DataService Cluster

Function

This API is used to enable the logs of a DataArts DataService cluster to be dumped to OBS.

Calling Method

For details, see Calling APIs.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, no identity policy-based permission required for calling this API.

URI

PUT /v1/{project_id}/service/instances/{instance_id}/obs-log-dump

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details about how to obtain it, see Project ID and Account ID.

instance_id

Yes

String

Cluster ID

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token. This parameter is mandatory when token authentication is used. You can obtain it from the value of X-Subject-Token in the response message header returned by the "Obtaining a User Token" API of the IAM service.

workspace

Yes

String

Workspace ID. For details about how to obtain it, see Instance ID and Workspace ID.

Dlm-Type

No

String

Edition of the DataArts DataService. The value can be SHARED or EXCLUSIVE.

Content-Type

No

String

Type (format) of the message body. This parameter is mandatory when there is a body. If the request body contains Chinese characters, use charset=utf8 to specify the Chinese character set, for example, application/json;charset=utf8.

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

log_dump

No

Boolean

Whether to enable log dump to OBS. Value true indicates that it is enabled, and value false indicates that it is disabled.

Response Parameters

Status code: 204

Success

Status code: 400

Table 4 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Example Requests

Enable the logs of the cluster whose ID is 4f9366ce3e87860934c36d0ac027ad6a to be dumped to OBS.

/v1/0833a5737480d53b2f250010d01a7b88/service/instances/4f9366ce3e87860934c36d0ac027ad6a/obs-log-dump

{
  "log_dump" : true
}

Example Responses

None

Status Codes

Status Code

Description

204

Success

400

Bad request.