文档中心

云数据库 veDB MySQL 版

连接管理

ModifyDBEndpointAddress - 修改终端端口或前缀

调用 ModifyDBEndpointAddress 接口修改连接地址端口或前缀。

请求类型

异步请求。

注意事项

新地址生效后，老地址会在三分钟后关闭，请同步修改应用程序的连接配置，否则可能会影响业务，请谨慎操作。

端口号修改，会同步修改公网和私网的端口号。新端口生效后，老端口会即刻关闭，请同步修改应用程序的连接配置，否则可能会影响业务，请谨慎操作。

调试

API Explorer

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

去调试

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	vedbm-6subnyth****	实例 ID。
EndpointId	String	是	vedbm-6subnyth****-Custom-0cul	连接终端 ID。
NetworkType	String	是	Private	网络地址类型，取值固定为 Private，即私网地址。
DomainPrefix	String	否	vedbm-55556hhh	新的私网地址前缀。连接地址前缀规则如下：连接地址前缀至少包含 8 个字符，不得超过 63 个字符。连接地址总长度不得超过 253 个字符。以小写字母开头，且以小写字母或数字结尾。由小写字母、数字和连字符（-）组成。说明仅支持修改私网连接地址前缀，不支持修改公网连接地址前缀。新地址生效后，老地址会在三分钟后关闭，请同步修改应用程序的连接配置，否则可能会影响业务，请谨慎操作。
Port	Integer	否	3307	输入新的端口号，端口号取值范围为 1000~65534。说明修改端口号，会同步修改私网和公网的端口号。新端口生效后，老端口会即刻关闭，请同步修改应用程序的连接配置，否则可能会影响业务，请谨慎操作。

返回参数

null

示例

请求示例

POST /?Action=ModifyDBEndpointAddress&Version=2022-01-01 HTTP/1.1​
Content-Type: application/json​
Host:vedbm.cn-beijing.volcengineapi.com​
X-Date: 20220101T101010Z​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20220101/cn-beijing/vedbm/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645****​
{​
    "InstanceId": "vedbm-6subnyth****",​
    "NetworkType": "Private",​
    "EndpointId": "vedbm-6subnyth****-Custom-0cul",​
    "DomainPrefix": "vedbm-55556hhh",​
    "Port": 3307​
}​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "202507301130483757D4D5820D32C11554-4010bd",​
        "Action": "ModifyDBEndpointAddress",​
        "Version": "2022-01-01",​
        "Service": "vedbm",​
        "Region": "cn-beijing"​
    },​
    "Result": null​
}​

错误码

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

最近更新时间：2026.04.22 11:15:25

这个页面对您有帮助吗？

有用

无用