You need to enable JavaScript to run this app.
导航
CreateDBEndpoint
最近更新时间:2024.01.15 19:02:14首次发布时间:2023.02.02 17:41:21

调用 CreateDBEndpoint 接口创建 Endpoint。

请求类型

异步请求。

请求参数

名称类型是否必选示例值描述
InstanceIdStringmysql-e26822cf****实例 ID。

EndpointType

String

Primary

集群地址类型:

  • Primary:主连接终端。
  • Custom:自定义终端(默认)。

ReadWriteMode

String

ReadOnly

读写模式:

  • ReadWrite:读写。
  • ReadOnly:只读(默认)。

EndpointName

String

EndpointName

实例连接终端名称。

  • 不能以数字、中划线(-)开头。
  • 只能包含中文、字母、数字、下划线(_)和中划线(-)。
  • 长度需要在1~64个字符内。
DescriptionString备注备注。

Nodes

String

Primary,mysql-3c25f219****-r5b3f

连接终端配置的节点 ID 列表。
当 EndpointType 为 Custom 时必选。

说明

  • 如需将主节点加入终端,不需填写主节点 ID,只需填写 Primary。
  • 多个节点 ID 之间用英文逗号(,)分隔。

AutoAddNewNodes

Boolean

true

当终端类型为读写终端或只读终端时,支持设置新节点是否自动加入。取值:

  • true:自动加入。
  • false:不自动加入(默认)。

返回参数

名称类型示例值描述
InstanceIdStringmysql-3c25f219****实例 ID。
EndpointIdStringmysql-3c25f219****-custom-eeb5终端 ID。

请求示例

POST /?Action=CreateDBEndpoint&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-3c25f219****",
    "EndpointName": "自定义终端",
    "EndpointType": "Custom",
    "Nodes": "Primary",
    "ReadWriteMode": "ReadWrite",
    "AutoAddNewNodes": true
}

返回示例

正常返回示例

{
    "ResponseMetadata":{
        "RequestId":"20230302225000051F23B8DD57341993BE",
        "Action":"CreateDBEndpoint",
        "Version":"2022-01-01",
        "Service":"rds_mysql",
        "Region":"cn-beijing"
        },
        "Result":{
            "EndpointId":"mysql-f23648f2****-custom-eeb5",
            "InstanceId":"mysql-f23648f2****"
            }
}

错误码

更多详情,请参见错误码