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

文档中心

立即注册

导航

ModifyDBEndpointConnectionMode

最近更新时间：2025.06.09 14:26:08首次发布时间：2025.06.09 14:26:08

调用 ModifyDBEndpointConnectionMode 接口修改连接终端的类型。

请求类型

异步请求。

注意事项

仅在实例的数据库代理服务开启时支持切换终端的类型。

调试

API Explorer

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

去调试

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	mysql-25651c34****	实例 ID。
EndpointId	String	是	mysql-25651c34****-cluster	连接终端 ID。
ConnectionMode	String	是	Proxy	连接终端类型。取值： `Proxy`：代理终端。 `Direct`：直连终端。说明如实例的数据库代理功能已开启，可以取值为 `Proxy` 或 `Direct`。如实例的数据库代理功能未开启，仅可以取值为 `Direct`。可调用 DescribeDBInstanceDetail 接口查询实例数据库代理功能的开启状态。
CreateDBEndpointReq	Object	是	请参见请求示例。	连接终端转换后的配置。

返回参数

null

示例

请求示例 1

连接终端转换为直连终端

POST /?Action=ModifyDBEndpointConnectionMode&Version=2022-01-01 HTTP/1.1
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-25651c34****",
    "EndpointId": "mysql-25651c34****-cluster",
    "ConnectionMode": "Direct",
    "CreateDBEndpointReq": {
        "InstanceId": "mysql-25651c34****",
        "EndpointType": "Cluster",
        "Nodes": "Primary"
    }
}

返回示例 1

{
    "ResponseMetadata": {
        "RequestId": "20250606170159831A107E095666D8676C-157121",
        "Action": "ModifyDBEndpointConnectionMode",
        "Version": "2022-01-01",
        "Service": "rds_mysql",
        "Region": "cn-beijing"
    },
    "Result": {}
}

请求示例 2

直连终端转为代理终端

POST /?Action=ModifyDBEndpointConnectionMode&Version=2022-01-01 HTTP/1.1
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-25651c34****",
    "EndpointId": "mysql-25651c34****-cluster",
    "ConnectionMode": "Proxy",
    "CreateDBEndpointReq": {
        "InstanceId": "mysql-25651c34****",
        "EndpointType": "Cluster",
        "Nodes": "Primary,mysql-25651c34****-r399d"
    }
}

返回示例 2

{
    "ResponseMetadata": {
        "RequestId": "20250606170252D33B79CAF18434F0B6DC-1db1c3",
        "Action": "ModifyDBEndpointConnectionMode",
        "Version": "2022-01-01",
        "Service": "rds_mysql",
        "Region": "cn-beijing"
    },
    "Result": {}
}

错误码

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