Help Center/ CodeArts Repo/ API Reference/ APIs/ V4/ Tenant/ Modifying the IP Address Whitelist of a Tenant
Updated on 2026-04-28 GMT+08:00
View PDF

Modifying the IP Address Whitelist of a Tenant

Function

This API is used to modify a tenant IP address whitelist.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

URI

PUT https://{hostURL}/v4/tenant/trusted-ip-addresses/{ip_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

ip_id

Yes

Integer

Definition

IP address whitelist ID.

Value range:

1~2147483647

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Definition

User token. Obtain a token by calling the IAM API for obtaining a user token. The value of X-Subject-Token in the response header is the user token.

Constraints

Mandatory.

Range

1–100,000 characters.

Default Value

N/A.
Table 3 Request body parameters

Parameter

Mandatory

Type

Description

ip_type

No

Integer

Definition

Format type.

  • 0: indicates a specified IP address.

  • 1: indicates the IP address range.

  • 2: indicates CIDR.

Default value:

0

Enumeration values:

  • 0

  • 1

  • 2

ip_start

No

String

Definition

Start IP address.

ip_end

No

String

Definition

End IP address.

view_flag

No

Integer

Definition

Whether to allow access to the repository.

  • 0: indicates that the access is forbidden.

  • 1: indicates that the access is allowed.

Default value:

0

Enumeration values:

  • 0

  • 1

download_flag

No

Integer

Definition

Whether to allow code download.

  • 0: indicates that the download is forbidden.

  • 1: indicates that the download is allowed.

Default value:

0

Enumeration values:

  • 0

  • 1

upload_flag

No

Integer

Definition

Whether to allow code commit.

  • 0: indicates that the commit is forbidden.

  • 1: indicates that the commit is allowed.

Default value:

0

Enumeration values:

  • 0

  • 1

remark

No

String

Definition

Remarks.

Range

Mandatory. Max. 200 characters.

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

id

String

Definition

IP address whitelist ID.

user_id

Integer

Definition

User ID.

Value range:

0~2147483647

domain_id

String

Definition

Tenant ID.

ip_range

String

Definition

IP address range.

ip_type

Integer

Definition

Format type.

  • 0: indicates a specified IP address.

  • 1: indicates the IP address range.

  • 2: indicates CIDR.

Default value:

0

Enumeration values:

  • 0

  • 1

  • 2

ip_start

String

Definition

Start IP address.

ip_end

String

Definition

End IP address.

view_flag

Integer

Definition

Whether to allow access to the repository.

  • 0: indicates that the access is forbidden.

  • 1: indicates that the access is allowed.

Default value:

0

Enumeration values:

  • 0

  • 1

download_flag

Integer

Definition

Whether to allow code download.

  • 0: indicates that the download is forbidden.

  • 1: indicates that the download is allowed.

Default value:

0

Enumeration values:

  • 0

  • 1

upload_flag

Integer

Definition

Whether to allow code commit.

  • 0: indicates that the commit is forbidden.

  • 1: indicates that the commit is allowed.

Default value:

0

Enumeration values:

  • 0

  • 1

remark

String

Definition

Remarks.

Range

Mandatory. Max. 200 characters.

created_at

String

Definition

Creation time.

Definition

MMM dd, yyyy hh:mm:ss a

updated_at

String

Definition

Update time.

Definition

MMM dd, yyyy hh:mm:ss a

order_flag

Integer

Definition

Sorting.

  • 0: indicates the default rule.

  • 1: indicates the custom rule.

Enumeration values:

  • 0

  • 1

Status code: 401

Table 5 Response body parameters

Parameter

Type

Description

error_code

String

Definition

Error code.

error_msg

String

Definition

Error message.

Example Requests

PUT https://{endpoint}/v4/tenant/trusted-ip-addresses/1

{
  "ip_type" : 0,
  "ip_start" : "1.1.1.1",
  "ip_end" : "1.1.1.1",
  "view_flag" : 1,
  "download_flag" : 1,
  "upload_flag" : 1,
  "remark" : "xxx office network"
}

Example Responses

Status code: 200

OK

{
  "id" : 19326,
  "user_id" : 7574,
  "ip_range" : "1.1.1.1",
  "ip_start" : "1.1.1.1",
  "ip_end" : "1.1.1.1",
  "ip_type" : 0,
  "view_flag" : 1,
  "download_flag" : 1,
  "upload_flag" : 1,
  "order_flag" : 1,
  "domain_id" : "159b65b41ead484d8ddff250a4731781",
  "remark" : ""
}

Status code: 401

Unauthorized

{
  "error_code" : "DEV.00000003",
  "error_msg" : "Authentication information expired."
}

Status Codes

Status Code

Description

200

OK

401

Unauthorized

Error Codes

See Error Codes.

Parent topic: Tenant