Help Center/ TaurusDB/ API Reference/ APIs (Recommended)/ Database Proxy/ Querying Access Control Settings of a Proxy Instance

Updated on 2024-09-11 GMT+08:00

Online Debugging

CLI Examples

View PDF

Querying Access Control Settings of a Proxy Instance

Function

This API is used to query access control settings of a proxy instance. Before calling this API:

Learn how to authorize and authenticate it.
Obtain the required region and endpoint.

URI

GET /v3/{project_id}/instances/{instance_id}/proxy/{proxy_id}/ipgroup

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID of a tenant in a region. To obtain this value, see Obtaining a Project ID.
instance_id	Yes	String	Instance ID, which is compliant with the UUID format.
proxy_id	Yes	String	Proxy instance ID, which is compliant with the UUID format.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. To obtain the value, call the API for obtaining a user token. The value of X-Subject-Token in the response header is the token value.
X-Language	No	String	Request language type. The default value is en-us. Values: en-us zh-cn

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
enable_ip_group	Boolean	Whether access control is enabled. The value can be true or false.
type	String	Whitelist (white) or blacklist (black).
ip_group	ProxyIpGroupDetail object	Details about the whitelist or blacklist.

**Table 4** ProxyIpGroupDetail
Parameter	Type	Description
id	String	ID of an IP address group.
name	String	Name of an IP address group.
ip_list	Array of IpGroupItem objects	IP addresses in an IP address group.

**Table 5** IpGroupItem
Parameter	Type	Description
ip	String	IP address or CIDR block.
description	String	Description of the IP address.

Status code: 400

**Table 6** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Status code: 500

**Table 7** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Example Request

Querying access control settings of a proxy instance

GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/4785fc80386846f3ad2bf4e0cd53a4cein07/proxy/286a4a1a45e3400c907b51b0721377f9po01/ipgroup

Example Response

Status code: 200

Success.

{
  "enable_ip_group" : false,
  "type" : "black",
  "ip_group" : [ {
    "id" : "a4217ac4-12cd-4fb3-acfc-db4a4a1896ea",
    "name" : "PROXY-8c72c1b6985f414da0cfbc76ad7effc1po01_elbIpGroup",
    "ip_list" : [ {
      "ip" : "192.127.0.1",
      "description" : "proxy ipgroup"
    }, {
      "ip" : "192.127.0.2",
      "description" : "proxy ipgroup"
    } ]
  } ]
}