DescribeDBProxyConfig--云数据库 MySQL 版-火山引擎

文档中心

立即注册

导航

DescribeDBProxyConfig

最近更新时间：2025.01.22 12:04:47首次发布时间：2023.08.14 13:15:55

调用 DescribeDBProxyConfig 接口查询指定 MySQL 实例的数据库代理信息。

请求类型

同步请求。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	mysql-46609cf2****	实例 ID。

返回参数

参数	类型	示例值	描述
BinlogDump	Boolean	true	是否支持 binlog 能力，取值： `true`：是。 `false`：否。说明在实例的数据库代理功能开启时才会返回该参数。
CheckModifyDBProxyAllowed	Object	请参见返回示例。	是否允许执行 ModifyDBProxy 接口的判断信息。说明该字段已弃用。
CheckModifyDBProxyAllowedV2	Object[]	请参见返回示例。	是否允许执行 ModifyDBProxy 接口的检查结果。
ConnectionPoolType	String	Transaction	连接池类型，当开启了数据库代理后，才会返回该参数，取值范围： `Direct`：直连模式。 `Transaction`：事务级连接池。
DBProxyStatus	String	Creating	代理实例的运行状态。取值： `Creating`：代理开启中。 `Running`：代理运行中。 `Shutdown`：代理已关闭。 `Deleting`：代理关闭中。说明只有在实例的数据库代理功能开启时才返回该参数，
FeatureStates	Object[]	请参见返回示例。	功能状态。
GlobalReadOnly	Boolean	true	是否开启全局只读。 `true`：是。 `false`：否。
InstanceId	String	mysql-46609cf2****	实例 ID。
ProxyResourceInfo	Object	请参见返回示例。	实例数据库代理服务的配置信息。

示例

请求示例

POST /?Action=DescribeDBProxyConfig&Version=2022-01-01 HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: rds.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****
{
    "InstanceId": "mysql-46609cf2****"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230809195305F4B9418A25C0D091AECF",
        "Action": "DescribeDBProxyConfig",
        "Version": "2022-01-01",
        "Service": "rds_mysql",
        "Region": "cn-beijing"
    },
    "Result": {
        "BinlogDump": false,
        "CheckModifyDBProxyAllowed": {
            "Allowed": false,
            "Message": "当前实例已开启事务级连接池，不支持开关代理",
            "Reason": "Other"
        },
        "CheckModifyDBProxyAllowedV2": [
            {
                "Allowed": false,
                "CheckItem": "InstanceConfig",
                "Reason": "当前实例已开启事务级连接池，不支持开关代理"
            }
        ],
        "ConnectionPoolType": "Transaction",
        "DBProxyStatus": "Running",
        "FeatureStates": [
            {
                "Enable": false,
                "FeatureName": "ProxyBinlogDump",
                "Support": true
            }
        ],
        "GlobalReadOnly": false,
        "InstanceId": "mysql-46609cf2****",
        "ProxyResourceInfo": {
            "CurrentProxyCpuNum": 6,
            "MaxProxyCpuNum": 1024,
            "MinProxyCpuNum": 2
        }
    }
}

错误码

更多详情，请参见错误码。