You need to enable JavaScript to run this app.
导航
云数据库 MySQL 版
  • 文档首页
    • /
  • 云数据库 MySQL 版

ModifyDBEndpointAddress

最近更新时间：2024.04.11 22:47:24

首次发布时间：2023.02.02 17:41:21

我的收藏

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

说明

  • 新连接地址在成功调用接口后生效。老连接地址会在新连接地址生效三分钟后失效，请同步修改应用程序的连接配置，否则可能会影响业务，请谨慎操作。
  • 在一次调用中，不能同时修改连接地址前缀和端口。

请求类型

异步请求。

请求参数

名称类型是否必选示例值描述
InstanceIdString是mysql-935479e57cbf***实例 ID。
EndpointIdString是mysql-935479e5****-cluster实例连接终端 ID。

NetworkType

String

是

Private

网络类型。取值为：

  • Public：公网地址。
  • Private：私网地址。

DomainPrefix

String

否

mysql935479e57cbf***

连接地址前缀。连接地址的前缀需满足以下规则：

  • 以小写字母开头，以小写字母或数字结尾。
  • 由小写字母、数字和中划线（-）中的至少两种组成。
  • 连接地址前缀应至少包含 8 个字符，连接地址总长度（前缀+后缀）不得超过 63个字符。
PortInteger否3306端口。端口号取值范围为 1000~65534。

返回参数

null

请求示例

POST /?Action=ModifyDBEndpointAddress&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=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645a****

{
    "InstanceId": "mysql-935479e57cbf***",
    "EndpointId": "mysql-935479e5****-cluster",
    "NetworkType": "Private",
    "Port": 3306
}

返回示例

正常返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230111161007B09FD872D02C2F8AE508",
        "Action": "ModifyDBEndpointAddress",
        "Version": "2022-01-01",
        "Service": "rds_mysql",
        "Region": "cn-beijing"
    },
    "Result": null
}

错误码

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