API概览

更新时间:
复制为 MD 格式

本产品(R-kvstore/2015-01-01)的OpenAPI采用RPC签名风格,签名细节参见签名机制说明。我们已经为开发者封装了常见编程语言的SDK,开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求,可通过签名机制进行自签名对接。由于自签名细节非常复杂,需花费 5个工作日左右。因此建议加入我们的服务钉钉群(147535001692),在专家指导下进行签名对接。

在使用API前,您需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。细节请参见获取AccessKey

生命周期管理

API

标题

API概述

CreateInstance 创建实例 创建一个 Redis开源版经典架构、Redis开源版云原生架构、Tair内存型经典架构实例。若要创建云原生架构的Tair实例,请使用CreateTairInstance接口
AddShardingNode 为集群实例添加数据分片节点 为集群实例添加数据分片节点,本接口仅支持集群架构云原生版实例。
CreateGlobalDistributeCache 将存量实例转换为分布式实例中第一个子实例 将一个存量的Tair内存型(经典版)实例转换为分布式实例中第一个子实例
DeleteShardingNode 删除集群实例中的数据分片节点 删除集群实例中的数据分片节点,本接口仅支持集群架构云原生版实例。
DeleteInstance 释放实例 释放云数据库 Tair(兼容 Redis)实例。
DestroyInstance 销毁回收站中的实例 彻底销毁回收站中的实例及其数据备份
ModifyInstanceSpec 变更实例规格 变更云数据库 Tair(兼容 Redis)实例的规格。
DescribeRegions 查询可用的地域 查询云数据库 Tair(兼容 Redis)实例支持的所有地域及其对应可用区信息。
DescribeZones 查询支持的可用区 查询指定地域下,云数据库 Tair(兼容 Redis)支持的可用区。若要查询当前可购买的可用区,请使用"DescribeAvailableResource"接口获取。
DescribeAvailableResource 查询某一可用区的资源列表 查询指定可用区内可创建的实例规格。
TransformToPrePaid 将按量付费转换为包年包月 将按量付费的云数据库 Tair(兼容 Redis)实例转换为包年包月(预付费)实例。
MigrateToOtherZone 迁移实例至其他可用区 将云数据库 Tair(兼容 Redis)实例迁移到同地域内的其它可用区。

实例管理

API

标题

API概述

CreateTairInstance 创建Tair(企业版)实例 创建云原生版的Tair(企业版)实例。
CreateInstances 批量创建实例 批量创建云数据库 Tair(兼容 Redis)经典版实例。
EnableAdditionalBandwidth 调整实例带宽 调整云数据库 Tair(兼容 Redis)实例的带宽,当前仅支持按量付费的计费方式,您仅需填写InstanceId、NodeId(可选)、Bandwidth、ChargeType参数即可。
ModifyInstanceAttribute 修改实例部分信息 修改云数据库 Tair(兼容 Redis)实例的部分信息,包括实例密码、名称等。
ModifyResourceGroup 修改实例所属资源组 修改云数据库 Tair(兼容 Redis)实例所属的资源组。
ModifyInstanceMaintainTime 修改可维护时段 修改云数据库 Tair(兼容 Redis)实例的可维护时段,阿里云将在您设定的可维护时段内对实例进行例行维护。
ModifyInstanceMajorVersion 升级大版本 升级云数据库 Tair(兼容 Redis)实例的大版本。
ModifyInstanceMinorVersion 升级小版本 升级云数据库 Tair(兼容 Redis)实例的小版本。
ModifyDBInstanceAutoUpgrade 修改小版本自动升级开关 修改实例的小版本自动升级开关。
DescribeInstancesOverview 查询实例概览 查询一个或多个云数据库 Tair(兼容 Redis)实例的信息概览。
DescribeInstances 查询实例的列表信息 查询一个或多个云数据库 Tair(兼容 Redis)实例的信息。
DescribeDedicatedClusterInstanceList 查看专属集群实例的列表 查询专属集群中的云数据库 Tair(兼容 Redis)实例信息。
DescribeInstanceAttribute 查询实例的详细信息 查询云数据库 Tair(兼容 Redis)实例的详细信息。
DescribeGlobalDistributeCache 查询分布式实例的详细信息 查询分布式实例的详细信息。
DescribeEngineVersion 查询实例的大版本和小版本信息 查询云数据库 Tair(兼容 Redis)实例的大版本和小版本信息,同时可查询到小版本的发布日志信息。
DescribeRoleZoneInfo 查询节点和所属可用区信息 查询云数据库 Tair(兼容 Redis)实例中各节点的角色、类型、小版本和所属的可用区。
DescribeClusterMemberInfo 查询集群的节点配置信息 查询云数据库 Tair(兼容 Redis)集群实例的节点配置信息(例如规格、最大连接数等)。
DescribeDBInstanceNetInfo 查看实例的网络信息 查看云数据库 Tair(兼容 Redis)实例的网络信息。
DescribeDBNodeDirectVipInfo 查询直连实例子实例的VIP 查询集群版直连实例的子实例VIP(Virtual IP Address)信息。
DescribeLogicInstanceTopology 查询实例的逻辑拓扑结构 查询云数据库 Tair(兼容 Redis)实例的逻辑拓扑结构。
RestartInstance 重启实例 重启运行中的云数据库 Tair(兼容 Redis)实例。
FlushExpireKeys 清除过期Key 清除云数据库 Tair(兼容 Redis)实例中的过期Key。
FlushInstanceForDB 清理实例指定DB的数据 清理云数据库 Tair(兼容 Redis)实例中指定DB的数据。
FlushInstance 清空实例中的数据 清空云数据库 Tair(兼容 Redis)实例中的数据,不可恢复。
SwitchInstanceHA 切换实例HA 执行主备切换(即切换节点角色),可应用于容灾演练、多可用区场景下的应用就近连接等需求。
SyncDtsStatus 设置是否限制实例变配 在使用DTS迁移或同步云数据库 Tair(兼容 Redis)实例的数据前,您可以调用本接口限制该实例执行变配操作,避免因变配引起的数据迁移或同步任务失败。
RemoveSubInstance 将子实例转换为普通实例 将子实例从分布式实例中移除并转变为普通实例(数据会被保留)。
LockDBInstanceWrite 锁定实例写操作 锁定后,实例将仅支持读取数据,不支持写入。
UnlockDBInstanceWrite 解锁实例写锁定操作 对写锁定的实例进行解锁,解锁后,实例支持读取、写入数据。
RebootProxy 重启或重搭实例的代理节点 重启运行中的云数据库 Tair(兼容 Redis)实例的代理节点。
UpgradeProxy 升级集群实例的数据库代理节点 升级集群版实例代理节点 proxy 到最新的版本。

连接管理

API

标题

API概述

ModifyInstanceNetExpireTime 延长经典网络地址的保留时间 若云数据库 Tair(兼容 Redis)实例之前执行过由经典网络向VPC网络切换,并保留了经典网络连接地址,则可调用本接口延长经典网络连接地址的保留时间。
ModifyDBInstanceConnectionString 修改实例的连接地址和端口 修改云数据库 Tair(兼容 Redis)实例的连接地址和端口。
ModifyIntranetAttribute 调整专属集群中实例的内网带宽 临时调整专属集群中云数据库 Tair(兼容 Redis)实例的内网带宽。
DescribeIntranetAttribute 查询实例的带宽信息 查询云数据库 Tair(兼容 Redis)实例当前的带宽。
SwitchNetwork 切换专有网络VPC或交换机 切换云数据库 Tair(兼容 Redis)实例的专有网络VPC或交换机,如果实例为经典网络,则会将其切换为专有网络。
AllocateInstancePublicConnection 为实例申请公网连接地址 为云数据库 Tair(兼容 Redis)实例申请公网连接地址。
ReleaseInstancePublicConnection 释放公网连接地址 释放云数据库 Tair(兼容 Redis)实例的公网连接地址。
AllocateDirectConnection 申请集群实例的直连地址 申请云数据库 Tair(兼容 Redis)集群实例的直连地址。
ReleaseDirectConnection 释放集群实例的直连地址 释放云数据库 Tair(兼容 Redis)集群实例的直连地址。
SwitchInstanceProxy 开启或关闭集群实例的代理模式 开启或关闭专属集群中云数据库 Tair(兼容 Redis)集群实例的代理模式。

续费管理

API

标题

API概述

ModifyInstanceAutoRenewalAttribute 开启或关闭实例自动续费 开启或者关闭云数据库 Tair(兼容 Redis)实例的到期前自动续费功能。
DescribePrice 查询价格 查询创建、升级配置或续费云数据库 Tair(兼容 Redis)实例等操作产生的费用。
DescribeInstanceAutoRenewalAttribute 查询实例是否开通自动续费 查看云数据库 Tair(兼容 Redis)实例是否开通自动续费。
RenewAdditionalBandwidth 带宽续费 云数据库 Tair(兼容 Redis)实例的带宽已升级为按量付费模式,不再推荐使用本接口。
TransformInstanceChargeType 转换付费类型 转换云数据库 Tair(兼容 Redis)实例的付费类型,支持按量付费和包年包月付费类型之间的相互转换。
RenewInstance 手动续费 为包年包月的云数据库 Tair(兼容 Redis)实例续费。

账号管理

API

标题

API概述

CreateAccount 创建账号 创建云数据库 Tair(兼容 Redis)实例的账号。
DeleteAccount 删除账号 删除云数据库 Tair(兼容 Redis)实例的账号。
ModifyAccountDescription 修改账号的描述 修改云数据库 Tair(兼容 Redis)实例的账号描述。
ModifyAccountPassword 修改账号密码 修改云数据库 Tair(兼容 Redis)实例中指定账号的密码。
DescribeAccounts 查找账号信息 查找指定云数据库 Tair(兼容 Redis)实例列表中某个账号的信息。
ResetAccountPassword 重置密码 重置云数据库 Tair(兼容 Redis)账号的密码。
GrantAccountPrivilege 修改账号的权限 修改云数据库 Tair(兼容 Redis)账号的权限。

备份恢复

API

标题

API概述

CreateBackup 手动备份数据 为云数据库 Tair(兼容 Redis)实例创建数据备份。
ModifyBackupPolicy 修改备份策略设置 修改云数据库 Tair(兼容 Redis)实例的自动备份策略。
DescribeBackupTasks 查询备份任务执行情况 查询云数据库 Tair(兼容 Redis)实例的备份任务执行情况。
DescribeBackupPolicy 查询自动备份策略 查询云数据库 Tair(兼容 Redis)实例的备份策略,包括备份周期、备份时间等。
DescribeBackups 查看备份集列表 查询云数据库 Tair(兼容 Redis)实例的备份文件信息。
RestoreInstance 恢复数据 恢复指定备份文件中的数据到云数据库 Tair(兼容 Redis)实例中。
DescribeClusterBackupList 查询集群实例的备份列表 查询云数据库 Tair(兼容 Redis)集群实例的备份列表。

监控管理

API

标题

API概述

DescribeDBInstanceMonitor 查询Tair实例的监控采集粒度 查询Tair实例的监控采集粒度
DescribeMonitorItems 查询监控项列表 查询云数据库 Tair(兼容 Redis)实例支持的监控项列表。
DescribeHistoryMonitorValues 查看实例的性能监控信息 查看云数据库 Tair(兼容 Redis)实例的性能监控信息。

日志管理

API

标题

API概述

ModifyAuditLogConfig 修改审计日志设置 开启或修改云数据库 Tair(兼容 Redis)实例的审计日志设置。
DescribeAuditLogConfig 查询审计日志配置 查询云数据库 Tair(兼容 Redis)实例审计日志是否开启、日志保存时间等配置信息。
DescribeAuditRecords 查询实例的审计日志 查询云数据库 Tair(兼容 Redis)实例的审计日志。
DescribeRunningLogRecords 查询实例的运行日志列表 查询云数据库 Tair(兼容 Redis)实例的运行日志。
DescribeSlowLogRecords 查看慢日志明细 查询云数据库 Tair(兼容 Redis)实例在指定时间内产生的慢日志。
InitializeKvstorePermission 授权服务关联角色 为云数据库 Tair(兼容 Redis)授权服务关联角色。
DescribeServiceLinkedRoleExists 查询服务关联角色授权 查询云数据库 Tair(兼容 Redis)是否已授权服务关联角色。

网络安全

API

标题

API概述

ModifySecurityIps 修改IP白名单 设置云数据库 Tair(兼容 Redis)实例的IP白名单。
ModifySecurityGroupConfiguration 设置实例白名单中的安全组 设置云数据库 Tair(兼容 Redis)实例白名单中的安全组。
ModifyInstanceSSL 修改TLS(SSL)配置 为云数据库 Tair(兼容 Redis)实例开启TLS(Transport Layer Security)加密协议配置。
ModifyInstanceVpcAuthMode 修改专有网络免密访问设置 开启或关闭专有网络免密访问。开启后,同一专有网络内的云服务器无需使用密码即可连接云数据库 Tair(兼容 Redis)实例,同时也继续兼容通过用户名和密码的方式连接实例。
DescribeSecurityIps 查询实例的IP白名单 查询云数据库 Tair(兼容 Redis)实例的IP白名单。
DescribeSecurityGroupConfiguration 查询已配置的安全组 查看云数据库 Tair(兼容 Redis)白名单中设置的安全组。
DescribeInstanceSSL 查询是否开启TLS(SSL)加密 查询云数据库 Tair(兼容 Redis)实例是否开启了TLS(SSL)加密认证。

参数管理

API

标题

API概述

ModifyInstanceConfig 修改实例的参数配置 修改云数据库 Tair(兼容 Redis)实例的参数配置。
DescribeParameterTemplates 查询参数列表和默认值 查询云数据库 Tair(兼容 Redis)实例在不同架构和大版本下的参数列表和默认值。
DescribeInstanceConfig 查询实例参数配置 查询云数据库 Tair(兼容 Redis)实例的部分默认配置参数信息。
DescribeParameters 查询实例的配置参数和运行参数 查询云数据库 Tair(兼容 Redis)实例的配置参数和运行参数。
DescribeParameterModificationHistory 查询参数修改历史 查询云数据库 Tair(兼容 Redis)实例的参数修改历史。

标签管理

API

标题

API概述

ListTagResources 查询标签列表 查询云数据库 Tair(兼容 Redis)实例和标签的绑定关系。
TagResources 为一个或多个实例绑定标签 为一个或多个云数据库 Tair(兼容 Redis)实例绑定标签。
UntagResources 为实例解绑标签 将标签从云数据库 Tair(兼容 Redis)实例解绑。

性能优化

API

标题

API概述

CreateCacheAnalysisTask 创建缓存分析任务 手动发起实例缓存分析任务。
DescribeCacheAnalysisReport 查看实例缓存分析报告 查看实例在指定日期中的缓存分析报告。
DescribeCacheAnalysisReportList 查询实例的缓存分析报告列表 查询实例的缓存分析报告列表。

数据加密

API

标题

API概述

ModifyInstanceTDE 开启透明数据加密TDE 为云数据库 Tair(兼容 Redis)实例开启透明数据加密TDE功能,支持自定义密钥。
DescribeInstanceTDEStatus 查询实例是否开启TDE加密 查询云数据库 Tair(兼容 Redis)实例是否开启了TDE加密功能。
DescribeEncryptionKeyList 查询实例的自定义密钥列表 查询云数据库 Tair(兼容 Redis)实例使用的自定义密钥列表。
DescribeEncryptionKey 查询实例的TDE自定义密钥详情 查询云数据库 Tair(兼容 Redis)实例的透明数据加密TDE自定义密钥的详情。
CheckCloudResourceAuthorized 查询是否已授权KMS密钥 查询云数据库 Tair(兼容 Redis)实例是否已被授权使用KMS密钥服务。

运维任务管理

API

标题

API概述

DescribeActiveOperationTaskCount 查询Tair实例的运维任务数量 查询Tair实例的运维任务数量
DescribeHistoryTasks 查询历史运维任务 查看任务中心的任务列表。
DescribeHistoryTasksStat 查询任务中心的任务统计 查询任务中心的任务统计。
ModifyActiveOperationTask 修改运维任务的计划切换时间 修改运维任务的计划切换时间。
DescribeActiveOperationTask 查询运维任务详情 查询云数据库 Tair(兼容 Redis)实例的运维任务详情。
DescribeActiveOperationMaintenanceConfig 查询实例的运维任务配置 查询实例的运维任务配置。
ModifyActiveOperationMaintainConfig 修改运维任务配置 ModifyActiveOperationMaintainConf

白名单模板管理

API

标题

API概述

CreateGlobalSecurityIPGroup 创建IP白名单模板 创建全局IP白名单模板。
ModifyGlobalSecurityIPGroupName 修改IP白名单模板名称 修改全局IP白名单模板的名称。
DescribeGlobalSecurityIPGroupRelation 查询实例关联的IP白名单模板信息 查询实例关联的全局IP白名单模板信息。
DeleteGlobalSecurityIPGroup 删除IP白名单模板 删除全局IP白名单模板。
ModifyGlobalSecurityIPGroup 修改IP白名单模板 修改全局IP白名单模板。
ModifyGlobalSecurityIPGroupRelation 将实例添加到IP白名单模板中 将指定实例添加到指定的IP白名单模板中。
DescribeGlobalSecurityIPGroup 查询IP白名单模板列表 查询全局IP白名单模板列表。

参数模板管理

API

标题

API概述

ModifyInstanceParameter 应用参数模板到实例 将参数模板应用至指定实例,表示将参数模板的值赋于指定的实例中。当您修改参数模版后,您也需要重新应用至指定实例,才能将修改后的参数值赋于指定实例。
DeleteParameterGroup 删除参数模板 删除参数模板。
DescribeParameterGroupSupportParam 参数模版支持设置的参数列表 查询在不同版本的参数模版中支持设置的参数列表。
DescribeParameterGroup 查询参数模版基本信息 查询参数模版基本信息。
ModifyParameterGroup 修改参数模版 修改参数模板的设置。
DescribeParameterGroups 查询参数模版列表 查询可用的参数模版列表。
CreateParameterGroup 创建参数模板 创建参数模板。
DescribeParameterGroupTemplateList 参数模版系统参数 查询参数模板中可配置参数的具体信息,例如默认值、取值范围、描述等。

事件管理

API

标题

API概述

DescribeActiveOperationTasks 查询多个主动运维事件信息 查询实例的运维事件详情。
ModifyActiveOperationTasks 修改运维事件的计划切换时间 修改实例计划内运维事件的切换时间。
CancelActiveOperationTasks 取消运维事件 批量取消运维事件。
ModifyEventInfo 修改事件信息 事件中心修改事件信息
DescribeHistoryEvents 查询历史事件 查询事件中心中的历史事件
DescribeHistoryEventsStat 查询历史事件统计 查询历史事件统计。

故障模拟

API

标题

API概述

SwitchInstanceZoneFailOver 模拟可用区级别故障切换 模拟云数据库 Tair(兼容 Redis)集群架构实例发生可用区级别故障,实例将自动切换到备可用区中。
MasterNodeShutDownFailOver 模拟指定节点故障 模拟云数据库 Tair(兼容 Redis)的指定数据节点或Proxy节点故障,实例将自动进行主备切换,保证高可用。

其他

API

标题

API概述

ModifyInstanceBandwidth 修改实例的带宽 设置云数据库 Tair(兼容 Redis)实例的目标带宽值。
ModifyTaskInfo 修改任务操作 进行任务操作,当前支持修改任务执行时间点。
ModifyBackupExpireTime 延长手动备份数据的过期时间 延长手动备份数据的过期时间。
DeleteBackup 删除备份集 删除指定备份集,但仅支持删除手动备份的备份集。
CreateTairKVCacheVNode 创建Tair KVCache VNode实例 创建Tair VNode虚拟节点实例
DescribeTairKVCacheInferInstances 查询Tair KVCache实例的列表信息 查询一个或多个Tair KVCache实例的信息。
TransformToEcs 经典架构转换至云原生 转换本地盘到云原生
ModifyDBInstanceMonitor 修改Tair实例的监控采集粒度 修改Tair实例的监控采集粒度
DescribeTags 查询已有标签列表 查询目标地域中所有的标签信息。
DescribeDbInstanceConnectivity 获取实例链路诊断信息 检测源客户端IP到实例的联通性。