You can call this operation to obtain a list of security protection agents.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ListProxies

The operation that you want to perform. Set the value to ListProxies.

Tid Long No 1

The ID of the tenant. You can call the GetUserActiveTenant or ListUserTenants operation to obtain this parameter.

RegionId String No cn-hangzhou

Select the service region of DMS. This operation is used to call this operation. For more information, see RegionID parameter description.

Note Set this parameter to the ID of the region that is in proximity to your applications.

Response parameters

Parameter Type Sample response Description
RequestId String 0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931

The ID of the request.

Success Boolean true

Indicates whether the call was successful.

ErrorMessage String UnknownError

The error message that is returned.

ErrorCode String 200

The error code returned to the query task.

ProxyList Array of ProxyList

The list of security protection agents.

ProxyId Long 1

The ID of the security protection agent.

CreatorId Long 1

The user ID of the security protection agent creator.

CreatorName String xxx

The user nickname of the creator of the security protection agent.

InstanceId Long 1

The ID of the instance.

PrivateEnable Boolean true

Specifies whether to enable the internal network.

PrivateHost String xxx.dms.aliyuncs.com

The internal IP address.

PublicEnable Boolean true

Specifies whether to enable the Internet.

PublicHost String xxx.dms.aliyuncs.com

Public endpoint.

MysqlPort Integer 3306

The port number of the MySQL protocol.

HttpsPort Integer 443

The port number of the Https protocol.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ListProxies
&Tid=1
&<Common request parameters>

Sample responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ListProxiesResponse>
    <ProxyList>
        <PublicHost>dxxxxy-qxxxxxkxxxxxxxxc-pub.proxy.dms.aliyuncs.com</PublicHost>
        <PrivateHost>dxxxxy-qxxxxxkxxxxxxxxc.proxy.dms.aliyuncs.com</PrivateHost>
        <InstanceId>1</InstanceId>
        <ProxyId>1</ProxyId>
        <CreatorId>40000</CreatorId>
        <MysqlPort>3306</MysqlPort>
        <PrivateEnable>true</PrivateEnable>
        <CreatorName>axxx</CreatorName>
        <PublicEnable>true</PublicEnable>
        <HttpsPort>443</HttpsPort>
    </ProxyList>
    <ProxyList>
        <PublicHost>dxxxxy-zxxxxxx7xxxxxxmd-pub.proxy.dms.aliyuncs.com</PublicHost>
        <PrivateHost>dxxxxy-zxxxxxx7xxxxxxmd.proxy.dms.aliyuncs.com</PrivateHost>
        <InstanceId>1</InstanceId>
        <ProxyId>1</ProxyId>
        <CreatorId>200000</CreatorId>
        <MysqlPort>3306</MysqlPort>
        <PrivateEnable>true</PrivateEnable>
        <CreatorName>exxx</CreatorName>
        <PublicEnable>false</PublicEnable>
        <HttpsPort>443</HttpsPort>
    </ProxyList>
    <RequestId>E156479F-C100-530A-A76F-9895CFEC3A6D</RequestId>
    <Success>true</Success>
</ListProxiesResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "ProxyList" : [ {
    "PublicHost" : "dxxxxy-qxxxxxkxxxxxxxxc-pub.proxy.dms.aliyuncs.com",
    "PrivateHost" : "dxxxxy-qxxxxxkxxxxxxxxc.proxy.dms.aliyuncs.com",
    "InstanceId" : 1,
    "ProxyId" : 1,
    "CreatorId" : 40000,
    "MysqlPort" : 3306,
    "PrivateEnable" : true,
    "CreatorName" : "axxx",
    "PublicEnable" : true,
    "HttpsPort" : 443
  }, {
    "PublicHost" : "dxxxxy-zxxxxxx7xxxxxxmd-pub.proxy.dms.aliyuncs.com",
    "PrivateHost" : "dxxxxy-zxxxxxx7xxxxxxmd.proxy.dms.aliyuncs.com",
    "InstanceId" : 1,
    "ProxyId" : 1,
    "CreatorId" : 200000,
    "MysqlPort" : 3306,
    "PrivateEnable" : true,
    "CreatorName" : "exxx",
    "PublicEnable" : false,
    "HttpsPort" : 443
  } ],
  "RequestId" : "E156479F-C100-530A-A76F-9895CFEC3A6D",
  "Success" : true
}

Error codes

For a list of error codes, visit the API Error Center.