本产品（
云原生数据仓库 AnalyticDB PostgreSQL版/2016-05-03）的OpenAPI采用RPC签名风格，签名细节参见签名机制说明。我们已经为开发者封装了常见编程语言的SDK，开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求，可通过签名机制进行自签名对接。由于自签名细节非常复杂，需花费 5个工作日左右。因此建议加入我们的服务钉钉群（11370001915），在专家指导下进行签名对接。在使用API前，您需要准备好身份账号及访问密钥（AccessKey），才能有效通过客户端工具（SDK、CLI等）访问API。细节请参见获取AccessKey。
AI Service
| API | 标题 | API概述 |
|---|---|---|
| InitVectorDatabase | 初始化向量数据库 | 初始化向量检索数据库。 |
| 命名空间管理 | 命名空间管理 | |
| CreateNamespace | 创建命名空间 | 创建向量数据的命名空间。 |
| DescribeNamespace | 查询命名空间信息 | 查询命名空间信息。 |
| DeleteNamespace | 删除命名空间 | 删除命名空间。 |
| ListNamespaces | 查询命名空间列表 | 查询命名空间列表。 |
| 文档库管理 | 文档库管理 | |
| ListDocumentCollections | 查询文档库列表 | 查询文档库列表。 |
| DeleteDocumentCollection | 删除文档库 | 删除文档库。 |
| CreateDocumentCollection | 创建文档库 | 创建文档库。 |
| 文档管理 | 文档管理 | |
| ListDocuments | 查询文档列表 | 查询文档库中的文档列表。 |
| DescribeDocument | 查看文档详细信息 | 查看文档详细信息。 |
| DeleteDocument | 删除文档 | 删除文档库中的文档。 |
| 文档上传和检索 | 文档上传和检索 | |
| GetUploadDocumentJob | 获取上传文档任务 | 通过JobId获取异步上传文档的任务的进度和结果。 |
| UploadDocumentAsync | 异步上传文档 | 使用本地文件或公网可免密访问的文件链接异步上传文档，服务端对文档做Loader、Chunk、Embedding然后入库，最大支持200MB。 |
| CancelUploadDocumentJob | 取消上传文档任务 | 通过JobId取消异步上传文档的任务。 |
| QueryContent | 查询文档内容 | 用自然语句从指定文档库检索向量和元数据。 |
| UpsertChunks | 上传切分后的文档 | 将切分后的文档列表向量化并上传到文档库。 |
向量检索
| API | 标题 | API概述 |
|---|---|---|
| 向量集管理 | 向量集管理 | |
| CreateCollection | 创建向量数据集 | 创建向量数据集。 |
| DescribeCollection | 查询向量集信息 | 查询向量集信息。 |
| DeleteCollection | 删除向量集 | 删除向量数据集。 |
| GrantCollection | 向量集授权 | 向量集授权。 |
| ListCollections | 查询向量集列表 | 查询向量集列表。 |
| 索引管理 | 索引管理 | |
| CreateVectorIndex | 创建向量索引 | 创建向量集的索引。 |
| DeleteVectorIndex | 删除向量索引 | 删除向量索引。 |
| 数据服务 | 数据服务 | |
| GetUpsertCollectionDataJob | 获取异步上传向量数据任务 | 通过JobId获取异步上传向量数据的任务的进度和结果。 |
| UpsertCollectionDataAsync | 异步上传向量数据 | 使用本地文件或公网可免密访问的文件链接异步上传向量数据，最大支持200MB。 |
| CancelUpsertCollectionDataJob | 取消异步上传向量数据任务 | 通过JobId取消异步上传向量数据的任务。 |
| UpdateCollectionDataMetadata | 更新向量数据中的Metadata值 | 更新向量数据中的Metadata数据。 |
| UpsertCollectionData | 上传向量数据 | 上传向量数据到指定的向量集中。 |
| QueryCollectionData | 召回向量数据 | 召回向量数据。 |
| DeleteCollectionData | 删除向量数据 | 删除向量数据。 |
创建实例
| API | 标题 | API概述 |
|---|---|---|
| CreateDBInstance | 创建实例 | 创建AnalyticDB PostgreSQL版实例。 |
实例管理
| API | 标题 | API概述 |
|---|---|---|
| DeleteDBInstance | 释放按量付费实例 | 释放按量付费的AnalyticDB PostgreSQL版实例。 |
| ModifyDBInstanceDescription | 修改实例备注 | 修改AnalyticDB PostgreSQL版实例的备注。 |
| ModifyDBInstanceMaintainTime | 修改实例可运维时间 | 修改AnalyticDB PostgreSQL版实例的可维护时间。 |
| ModifyDBInstanceResourceGroup | 修改实例所属资源组 | 将AnalyticDB PostgreSQL版实例移动到指定资源组。 |
| ModifyVectorConfiguration | 修改实例向量引擎优化配置 | 修改实例向量引擎优化配置。 |
| PauseInstance | 暂停实例 | 暂停AnalyticDB PostgreSQL版实例。 |
| RebalanceDBInstance | 实例部署平衡 | 对AnalyticDB PostgreSQL版实例进行部署平衡。 |
| RestartDBInstance | 重启实例 | 重启AnalyticDB PostgreSQL版实例。 |
| ResumeInstance | 启动实例 | 启动AnalyticDB PostgreSQL版实例。 |
| UpgradeDBVersion | 升级内核小版本 | 为指定AnalyticDB PostgreSQL版实例升级内核小版本。 |
实例变配
| API | 标题 | API概述 |
|---|---|---|
| DescribeDataReDistributeInfo | 查询数据重分布进度 | 查询存储弹性模式6.0版实例在节点扩缩容过程中，数据重分布的进度。 |
| ModifyDBInstanceConfig | 修改计算资源阈值 | 修改AnalyticDB PostgreSQL版Serverless自动调度模式实例的计算资源阈值和空闲释放等待时长。 |
| UpgradeDBInstance | 变更实例规格 | 变更AnalyticDB PostgreSQL版实例的规格。 |
查询实例
| API | 标题 | API概述 |
|---|---|---|
| DescribeDBClusterNode | 查询节点信息 | 查询AnalyticDB PostgreSQL版实例中的节点信息。 |
| DescribeDBInstanceAttribute | 查询实例详情 | 查询AnalyticDB PostgreSQL版实例详情。 |
| DescribeDBInstances | 查询数据库实例列表 | 查询AnalyticDB PostgreSQL版数据库实例列表。 |
| DescribeDBVersionInfos | 查询内核版本信息 | 查询内核版本信息。 |
| DescribeSupportFeatures | 查询实例支持的功能特性 | 查询当前AnalyticDB PostgreSQL版实例支持的功能特性。 |
参数管理
| API | 标题 | API概述 |
|---|---|---|
| DescribeModifyParameterLog | 查询参数修改历史 | 获取AnalyticDB PostgreSQL版实例的参数修改历史。 |
| DescribeParameters | 获取配置参数信息 | 获取AnalyticDB PostgreSQL版实例的配置参数信息。 |
| ModifyParameters | 修改配置参数 | 修改AnalyticDB PostgreSQL版实例的配置参数。 |
备份管理
| API | 标题 | API概述 |
|---|---|---|
| DescribeBackupPolicy | 查看实例备份策略 | 查看AnalyticDB PostgreSQL版实例的备份策略。 |
| DescribeDataBackups | 查看实例的数据备份列表和可恢复点 | 查看AnalyticDB PostgreSQL版实例的数据备份列表和可恢复点。 |
| DescribeLogBackups | 查看日志备份列表 | 查看日志备份列表。 |
| ModifyBackupPolicy | 设置实例备份策略 | 设置AnalyticDB PostgreSQL版实例的备份策略。 |
账号管理
| API | 标题 | API概述 |
|---|---|---|
| CreateAccount | 创建初始账号 | 创建AnalyticDB PostgreSQL版实例的初始账号。 |
| DescribeAccounts | 查询账号信息 | 查询AnalyticDB PostgreSQL版数据库的账号信息。 |
| DescribeDiagnosisDimensions | 查询所有数据库和用户 | 获取AnalyticDB PostgreSQL版实例中所有数据库和用户。 |
| ModifyAccountDescription | 修改账号备注 | 修改数据库账号的备注信息。 |
| ResetAccountPassword | 重置账号密码 | 重置账户密码。 |
数据共享
| API | 标题 | API概述 |
|---|---|---|
| DescribeDataShareInstances | 查看数据共享详细信息 | 查看数据共享的状态。 |
| DescribeDataSharePerformance | 查看数据共享的性能指标 | 查看数据共享的性能指标。 |
| SetDataShareInstance | 将实例加入或移出数据共享 | 将AnalyticDB PostgreSQL版实例加入数据共享或从数据共享中移除。 |
诊断与优化
| API | 标题 | API概述 |
|---|---|---|
| DescribeDBClusterPerformance | 查看实例性能数据 | 查看AnalyticDB PostgreSQL版实例在指定时间段的性能监控。 |
| DescribeDBInstanceDataBloat | 查看数据膨胀相关信息 | 获取AnalyticDB PostgreSQL版实例的数据膨胀情况。 |
| DescribeDBInstanceDataSkew | 查看数据倾斜的相关信息 | 获取AnalyticDB PostgreSQL版实例的数据倾斜情况。 |
| DescribeDBInstanceDiagnosisSummary | 查看节点详情 | 获取AnalyticDB PostgreSQL版实例的节点详情。 |
| DescribeDBInstanceIndexUsage | 查看索引的使用情况 | 获取AnalyticDB PostgreSQL版实例中索引的使用情况。 |
| DescribeDBInstancePerformance | 查询指定性能参数的监控数据 | 查看某个AnalyticDB PostgreSQL存储预留模式实例在某个时间段内指定性能参数的性能监控数据。 |
| DescribeDiagnosisMonitorPerformance | 查看SQL执行信息 | 本接口用于查看指定时间段的AnalyticDB PostgreSQL版存储弹性模式实例的SQL执行信息。 |
| DescribeDiagnosisRecords | 获取SQL查询列表 | 获取AnalyticDB PostgreSQL版实例SQL查询列表。 |
| DescribeDiagnosisSQLInfo | 查看SQL语句的详细信息 | 获取AnalyticDB PostgreSQL版实例中指定查询语句的详细信息。 |
| DescribeDownloadRecords | 获取查询诊断信息的下载记录 | 获取AnalyticDB PostgreSQL版查询诊断信息的下载记录。 |
| DescribeDownloadSQLLogs | 查询慢SQL信息下载记录 | 获取AnalyticDB PostgreSQL版慢查询信息的最近五条下载记录。 |
| DescribeHealthStatus | 查看实例和节点的健康状态 | 查看实例和节点的健康状态。 |
| DescribeWaitingSQLInfo | 获取锁诊断详细信息 | 获取AnalyticDB PostgreSQL版实例锁等待详情信息。 |
| DescribeWaitingSQLRecords | 获取锁诊断列表 | 获取AnalyticDB PostgreSQL版实例锁诊断列表。 |
| DownloadDiagnosisRecords | 下载查询诊断记录 | 下载AnalyticDB PostgreSQL的实例的查询诊断记录。 |
| DownloadSQLLogsRecords | 下载慢SQL记录 | 下载AnalyticDB PostgreSQL的实例的慢SQL记录。 |
计划管理
| API | 标题 | API概述 |
|---|---|---|
| CreateDBInstancePlan | 创建定时计划 | 创建定时计划。 |
| DeleteDBInstancePlan | 删除定时计划 | 删除AnalyticDB PostgreSQL版实例的计划。 |
| DescribeDBInstancePlans | 查询计划详情 | 查看AnalyticDB PostgreSQL版实例的计划详情。 |
| SetDBInstancePlanStatus | 启用或禁用计划 | 启用或禁用AnalyticDB PostgreSQL版实例的计划。 |
| UpdateDBInstancePlan | 修改定时计划 | 修改AnalyticDB PostgreSQL版的定时计划。 |
标签管理
| API | 标题 | API概述 |
|---|---|---|
| DescribeTags | 查询标签列表 | 查询AnalyticDB PostgreSQL版实例的标签列表。 |
| ListTagResources | 查询实例绑定的标签 | 查询一个或多个AnalyticDB PostgreSQL实例已经绑定的标签列表。 |
| TagResources | 创建并绑定标签 | 创建并绑定标签。 |
| UntagResources | 解绑标签 | 为指定的AnalyticDB PostgreSQL实例列表统一解绑标签。解绑后，如果该标签没有绑定其他任何实例，会被自动删除。 |
安全管理
| API | 标题 | API概述 |
|---|---|---|
| CheckServiceLinkedRole | 查询服务关联角色 | 检查是否创建了服务关联角色。 |
| CreateServiceLinkedRole | 创建服务关联角色 | 创建服务关联角色（SLR）。 |
| DescribeDBInstanceIPArrayList | 查看实例IP白名单 | 查询允许访问AnalyticDB PostgreSQL版实例的IP白名单。 |
| DescribeDBInstanceSSL | 查询实例SSL设置详情 | 获取AnalyticDB PostgreSQL版实例的SSL信息。 |
| DescribeUserEncryptionKeyList | 查询实例自定义KMS密钥列表 | 获取用户开通的KMS密钥列表。 |
| ModifyDBInstanceSSL | 修改SSL加密状态 | 开启、关闭或更新SSL加密。 |
| ModifySecurityIps | 修改IP白名单 | 修改AnalyticDB PostgreSQL版实例的IP白名单。 |
日志管理
| API | 标题 | API概述 |
|---|---|---|
| DescribeDBInstanceErrorLog | 查询实例的错误日志 | 获取AnalyticDB PostgreSQL版实例的错误日志。 |
| DescribeSQLLogCount | 获取SQL审计日志数量 | 获取AnalyticDB PostgreSQL版实例的审计日志数量。 |
| DescribeSQLLogsV2 | 查询SQL执行记录 | 调用DescribeSQLLogs接口查询指定时间段的SQL执行记录。 |
| ModifySQLCollectorPolicy | 开启或关闭SQL洞察功能 | 开启或关闭指定实例的SQL洞察功能。 |
网络管理
| API | 标题 | API概述 |
|---|---|---|
| AllocateInstancePublicConnection | 申请外网地址 | 分配实例外网链接地址。 |
| DescribeDBInstanceNetInfo | 查看实例的连接地址信息 | 查询实例的连接信息。 |
| DescribeRdsVpcs | 获取VPC列表 | 获取VPC列表。 |
| DescribeRdsVSwitchs | 获取虚拟交换机列表 | 获取虚拟交换机（vSwitch）列表。 |
| ModifyDBInstanceConnectionString | 修改连接地址 | 修改AnalyticDB PostgreSQL版实例的连接地址。 |
| ReleaseInstancePublicConnection | 释放外网地址 | 释放AnalyticDB PostgreSQL版的外网地址。 |
| SwitchDBInstanceNetType | 切换内外网地址 | 切换AnalyticDB PostgreSQL版实例的内外网地址。 |
资源管理
| API | 标题 | API概述 |
|---|---|---|
| DescribeAvailableResources | 获取可用资源信息 | 获取AnalyticDB PostgreSQL版的可用售卖资源。 |
| DescribeRegions | 查看可选的地域和可用区 | 查询创建AnalyticDB PostgreSQL版实例时用户可选的地域和可用区。 |
样本数据集
| API | 标题 | API概述 |
|---|---|---|
| CreateSampleData | 创建样本数据集 | 为AnalyticDB PostgreSQL版实例创建样本数据集。 |
| DescribeSampleData | 查询是否加载样本数据集 | 查询AnalyticDB PostgreSQL版实例中是否加载了样本数据集。 |
| UnloadSampleData | 卸载样本数据集 | 释放AnalyticDB PostgreSQL版的样本数据集。 |
资源组
| API | 标题 | API概述 |
|---|---|---|
| DescribeDBResourceManagementMode | 获取实例资源管理模式 | 获取实例资源管理模式。 |
其他
| API | 标题 | API概述 |
|---|---|---|
| ModifyMasterSpec | 变更master资源 | 变更AnalyticDB PostgreSQL版实例的master资源。 |
| DescribeSQLLogs | 获取SQL执行记录 | 查询SQL执行记录。 |
| HandleActiveSQLRecord | 处理某个活跃查询 | 处理某个或多个活跃查询。 |
| DescribeDBInstanceSupportMaxPerformance | 查看实例的最大吞吐 | 查看实例的最大吞吐。 |
| ResetIMVMonitorData | 重置IMV统计信息 | 重置IMV统计信息。 |
| DescribeIMVInfos | 查询实时物化视图详情 | 查询AnalyticDB PostgreSQL版实例的实时物化视图详情。 |
| DescribeActiveSQLRecords | 查询活跃SQL记录 | 查询活跃SQL记录。 |