Updated on 2025-10-29 GMT+08:00

Creating a Configuration Application

Function

This API is used to create a configuration application.

Calling Method

For details, see Calling APIs.

URI

POST /v1/{project_id}/workspaces/{workspace_id}/components/{component_id}/configurations/application

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition

Project ID, which is used to specify the project that a resource belongs to. You can query the resources of a project by project ID. You can obtain the project ID from the API or console. Obtaining the Project ID

Constraints

N/A

Range

N/A

Default Value

N/A

workspace_id

Yes

String

Workspace ID.

component_id

Yes

String

Component ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Definition

User token. You can obtain it by calling the IAM API for obtaining a user token. The user token is the value of X-Subject-Token in the response header. Obtaining a User Token

Constraints

N/A

Range

N/A

Default Value

N/A

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

configuration

Yes

Array of ConfigurationDetail objects

Configuration list.

Table 4 ConfigurationDetail

Parameter

Mandatory

Type

Description

node_id

No

String

Node ID.

node_name

No

String

Node name.

specification

No

String

Specifications.

config_status

No

String

Definition

Node deployment status.

  • UN_SAVED: to be saved

  • SAVE_AND_UN_APPLY: to be applied

  • MOVE_AND_UN_APPLY: to be removed

  • APPLYING: being applied

  • FAIL_APPLY: failed to be applied

  • APPLIED: applied

Constraints

N/A

Range

  • UN_SAVED

  • SAVE_AND_UN_APPLY

  • MOVE_AND_UN_APPLY

  • APPLYING

  • FAIL_APPLY

  • APPLIED

Default Value

N/A

list

Yes

Array of FileConfiguration objects

File configuration list.

Table 5 FileConfiguration

Parameter

Mandatory

Type

Description

file_type

Yes

String

Definition

File type.

  • JVM JVM configuration file type.

  • LOG4J2: Log4j2 log configuration file type

  • YML: YAML configuration file type

Constraints

N/A

Range

  • JVM

  • LOG4J2

  • YML

Default Value

N/A

file_name

No

String

File name.

type

No

String

Definition

Configuration type.

  • HISTORY: historical versions

  • CURRENT_SAVE: currently saved

  • CURRENT_APPLY: currently applied

Constraints

N/A

Range

  • HISTORY

  • CURRENT_SAVE

  • CURRENT_APPLY

Default Value

N/A

node_id

No

String

Node ID.

param

Yes

Map<String,String>

Parameter.

Response Parameters

Status code: 200

Table 6 Response body parameters

Parameter

Type

Description

apply_success_list

Array of ComponentConfiguration objects

List of instances that are successfully created.

apply_fail_list

Array of ComponentConfiguration objects

List of instances that fail to be created.

Table 7 ComponentConfiguration

Parameter

Type

Description

component_id

String

component id.

component_name

String

Component name.

node_id

String

Node ID.

create_time

Integer

Millisecond timestamp.

node_name

String

Node name.

specification

String

Specifications.

config_status

String

Definition

Node configuration status.

  • UN_SAVED: to be saved

  • SAVE_AND_UN_APPLY: to be applied

  • MOVE_AND_UN_APPLY: to be removed

  • APPLYING: being applied

  • FAIL_APPLY: failed to be applied

  • APPLIED: applied

Constraints

N/A

Range

  • UN_SAVED

  • SAVE_AND_UN_APPLY

  • MOVE_AND_UN_APPLY

  • APPLYING

  • FAIL_APPLY

  • APPLIED

Default Value

N/A

fail_deploy_message

String

Deployment failure message.

ip_address

String

IP address.

private_ip_address

String

IP address.

region

String

Region.

vpc_endpoint_id

String

VPC endpoint ID.

vpc_endpoint_address

String

VPC endpoint address.

monitor

Monitor object

Monitor.

node_expansion

IsapNodeExpansion object

Node extension information.

node_apply_fail_enum

String

Definition

Node application status and reason.

  • COLLECTOR_USE: The collector is in use and cannot be removed.

  • NODE_OFFLINE: The node is disconnected and cannot be applied.

Constraints

N/A

Range

  • COLLECTOR_USE

  • NODE_OFFLINE

Default Value

N/A

list

Array of ComponentConfigurationParam objects

Component configuration parameters.

Table 8 ComponentConfigurationParam

Parameter

Type

Description

configuration_id

String

Configuration ID.

component_id

String

component id.

node_id

String

Node ID.

file_name

String

File name.

file_path

String

File path.

file_type

String

Definition

File type.

  • JVM JVM configuration file type.

  • LOG4J2: Log4j2 log configuration file type

  • YML: YAML configuration file type

Constraints

N/A

Range

  • JVM

  • LOG4J2

  • YML

Default Value

N/A

param

String

Parameter.

version

Integer

Version.

type

String

Definition

Configuration type.

  • HISTORY: historical versions

  • CURRENT_SAVE: currently saved

  • CURRENT_APPLY: currently applied

Constraints

N/A

Range

  • HISTORY

  • CURRENT_SAVE

  • CURRENT_APPLY

Default Value

N/A

Table 9 Monitor

Parameter

Type

Description

mini_on_online

String

Online or not.

memory_count

String

Number of physical memory modules.

memory_usage

String

Used physical memory.

memory_free

String

Current free physical memory.

memory_shared

String

Total memory shared by multiple processes.

memory_cache

String

Memory size of cached data.

cpu_usage

String

Current CPU usage.

cpu_idle

String

Percentage of CPU idle time.

up_pps

String

Number of uploaded data packets per second.

down_pps

String

Number of downloaded data packets per second.

write_rate

String

Disk write rate.

read_rate

String

Disk read rate.

disk_count

String

Number of disk devices in the system.

disk_usage

String

Current disk space usage.

heart_beat_time

Long

Time when the last heartbeat signal was received.

health_status

String

Definition

Health status of nodes.

NORMAL: normal

  • ANOMALIES: abnormal

  • FAULTS: faulty

  • LOST_CONTACT: disconnected

Constraints

N/A

Range

  • NORMAL

  • ANOMALIES

  • FAULTS

  • LOST_CONTACT

Default Value

N/A

heart_beat

String

Definition

Whether the node can successfully receive the heartbeat signal.

  • ONLINE: It is online.

  • OFFLINE: It is offline.

Constraints

N/A

Range

  • ONLINE

  • OFFLINE

Default Value

N/A

Table 10 IsapNodeExpansion

Parameter

Type

Description

node_id

String

UUID

data_center

String

Data center.

custom_label

String

Custom tag.

network_plane

String

Network plane.

description

String

Description.

maintainer

String

Maintenance engineer.

Status code: 400

Table 11 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Example Requests

None

Example Responses

None

Status Codes

Status Code

Description

200

Response of list component configuration

400

Error response

Error Codes

See Error Codes.