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

文档中心

立即注册

导航

ModifyReadOnlyNodeDelayReplicationTime

最近更新时间：2024.11.05 16:00:08首次发布时间：2024.01.05 16:55:48

调用 ModifyReadOnlyNodeDelayReplicationTime 接口配置只读节点的延迟复制功能。

请求类型

同步请求。

调试

API Explorer

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

去调试

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	mysql-3fb9a5be****	待查询只读节点所属实例的实例 ID。
NodeId	String	是	mysql-3fb9a5be****-r3e01	待查询的只读节点的节点 ID。
DelayReplicationTime	Long	是	1000	只读节点的数据延迟时间，取值为 0~604800，单位为秒。说明设置为 0 时，表示关闭该只读节点的延迟复制功能。
UpdateEndpointIds	String[]	是	["mysql-3fb9a5be**-custom-a774","mysql-3fb9a5be**-cluster"]	需取消与待设置延迟复制的只读节点关联的连接终端的 ID。可调用 DescribeDBInstanceDetail 接口查询该只读节点关联的连接终端。说明开启只读节点的延迟复制功能后，该只读节点只能作为连接终端的唯一节点。因此在开启延迟复制功能时，需要取消该只读节点和其他终端的关联。当 DelayReplicationTime 取值为 0，即关闭只读节点的延迟复制功能时，UpdateEndpointIds 为可选。当只读节点未关联连接终端时，UpdateEndpointIds 为可选。

返回参数

null

示例

请求示例

POST /?Action=ModifyReadOnlyNodeDelayReplicationTime&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-3fb9a5be****",
    "NodeId": "mysql-3fb9a5be****-ra779",
    "DelayReplicationTime": 1000,
    "UpdateEndpointIds": [
        "mysql-3fb9a5be****-custom-a774",
        "mysql-3fb9a5be****-cluster"
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202312251441147989AF4644F5D7556D08",
        "Action": "ModifyReadOnlyNodeDelayReplicationTime",
        "Version": "2022-01-01",
        "Service": "rds_mysql",
        "Region": "cn-guangzhou"
    },
    "Result": null
}

错误码

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