Help Center/ Cloud Bastion Host/ API Reference/ API Description/ Managing CBH Instances/ Modifying CBH Instance Network Settings
Updated on 2023-05-16 GMT+08:00
View PDF

Modifying CBH Instance Network Settings

Function

This API is used to modify CBH instance network settings.

URI

POST /v1/{project_id}/cbs/{server_id}/network/change

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. You can obtain the project ID by referring to https://support.huaweicloud.com/intl/en-us/api-cbh/cbh_02_0020.html.

server_id

Yes

String

CBH instance ID, in the UUID format.

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

type

Yes

String

CBH instance status. The value can be:

  • create: The instance is being created.

  • renewals: The instance is being renewed.

  • change: The instance specifications are being upgraded.

security_groups

Yes

Array of SecurityGroup objects

New security group that the CBH instance belongs to.

nics

Yes

Array of Nics objects

New NIC that the CBH instance uses.

server_id

No

String

CBH instance ID. This parameter is mandatory when the status is renewals or change.
Table 3 SecurityGroup

Parameter

Mandatory

Type

Description

id

Yes

String

Security group ID, which consists of letters, digits, and underscores (_).
Table 4 Nics

Parameter

Mandatory

Type

Description

subnet_id

Yes

String

Subnet ID, which consists of letters, digits, and underscores (_).

ip_address

No

String

IP address. If the value of this parameter is left blank or is set to an empty string, the IP address is automatically assigned.

Response Parameters

Status code: 200

Table 5 Response body parameters

Parameter

Type

Description

status

String

Status.

security_grp_status

String

Security group.

firewall_status

Boolean

Firewall status.

public_eip_status

Boolean

EIP status.

nics

Boolean

Firewall status (compatible).

public_eip_statu

Boolean

EIP status (compatible).

Status code: 400

Table 6 Response body parameters

Parameter

Type

Description

error_code

String

Error Code

error_description

String

Incorrect request parameter.

Status code: 401

Table 7 Response body parameters

Parameter

Type

Description

error_code

String

Error Code

error_description

String

Failed to verify the token.

Status code: 403

Table 8 Response body parameters

Parameter

Type

Description

error_code

String

Error Code

error_description

String

Permissions required.

Status code: 404

Table 9 Response body parameters

Parameter

Type

Description

error_code

String

Error Code

error_description

String

CBH instances not found.

Example Requests

{
  "type" : "create",
  "security_groups" : [ {
    "id" : "02dcf62d-b84d-4a14-aad3-c310f2ceea55"
  } ],
  "nics" : [ {
    "subnet_id" : "dd08a6a9-ced7-484b-ace6-1b821854a772",
    "ip_address" : "100.93.5.36"
  } ]
}

Example Responses

Status code: 200

Cbh ChangeInstanceNetwork Success

{
  "status" : false,
  "security_grp_status" : true,
  "firewall_status" : false,
  "public_eip_status" : true
}

Status Codes

Status Code

Description

200

Cbh ChangeInstanceNetwork Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

Error Codes

See Error Codes.

Parent topic: Managing CBH Instances