Updated on 2026-01-13 GMT+08:00

Updating Device Information

Function

This API is used to update details about a specified device.

Calling Method

For details, see Calling APIs.

URI

PUT /v1/{project_id}/devices/{device_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

device_id

Yes

String

Device ID.

project_id

Yes

String

Project ID.

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

description

No

String

Description.

manage_url

No

String

Management address.

mode

Yes

String

Deployment mode.

name

Yes

String

Device name.

subnet_id

Yes

String

Subnet ID.

type

Yes

Integer

Device type, which can be 0 (application data audit), 1 (application data security gateway), 2 (database firewall), 3 (database encryption), 4 (static data masking instance), or 5 (dynamic database masking instance).

vpc_id

Yes

String

VPC ID.

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

id

String

ID

msg

String

Message.

status

String

Response code.

Status code: 201

Resource being created.

Example Requests

PUT /v1/{project_id}/devices/{device_id}

{
  "description" : "string",
  "manage_url" : "string",
  "mode" : "string",
  "name" : "string",
  "subnet_id" : "string",
  "type" : 0,
  "vpc_id" : "string"
}

Example Responses

None

Status Codes

Status Code

Description

200

Updated.

201

Resource being created.

401

Unauthorized. The user is not logged in or the token is invalid.

403

Unauthorized to access the resource.

404

The specified project or device does not exist.

Error Codes

See Error Codes.