API概览

本产品(云数据库 Tair(兼容 Redis®)/2015-01-01)的OpenAPI采用RPC签名风格,签名细节参见签名机制说明我们已经为开发者封装了常见编程语言的SDK,开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求,可通过签名机制进行自签名对接。由于自签名细节非常复杂,需花费 5个工作日左右。因此建议加入我们的服务钉钉群(78410016550),在专家指导下进行签名对接。
在使用API前,您需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。细节请参见获取AccessKey

生命周期管理

API标题API概述
CreateInstance创建实例创建一个Redis开源版或Tair内存型经典版实例。若要创建云原生型的Tair实例,请使用CreateTairInstance接口。
AddShardingNode为集群实例添加数据分片节点为集群实例添加数据分片节点,本接口仅支持集群架构云原生版实例。
CreateGlobalDistributeCache将存量实例转换为分布式实例中第一个子实例将一个存量的Tair内存型(经典版)实例转换为分布式实例中第一个子实例。
DeleteShardingNode删除集群实例中的数据分片节点删除集群实例中的数据分片节点,本接口仅支持集群架构云原生版实例。
DeleteInstance释放实例释放云数据库 Tair(兼容 Redis)实例。
ModifyInstanceSpec变更实例规格变更云数据库 Tair(兼容 Redis)实例的规格。
DescribeRegions查询可用的地域查询云数据库 Tair(兼容 Redis)实例支持的所有地域及其对应可用区信息。
DescribeZones查询支持的可用区查询指定地域下,云数据库 Tair(兼容 Redis)支持的可用区。
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)集群实例的节点配置信息(例如规格、最大连接数等)。
DescribeTasks查询实例某个时间段内所有任务信息查询云数据库 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解锁实例写锁定操作对写锁定的实例进行解锁,解锁后,实例支持读取、写入数据。

连接管理

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概述
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)授权服务关联角色。

网络安全

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概述
DescribeHistoryTasks查询历史运维任务查看任务中心的任务列表。

白名单模板管理

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取消运维事件批量取消运维事件。

故障模拟

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

其他

API标题API概述
ModifyInstanceBandwidth修改实例的带宽设置云数据库 Tair(兼容 Redis)实例的目标带宽值。