PrecheckDuckDBDependency - 检查创建DuckDB分析实例前提条件 - 云数据库 RDS

该接口用于检查RDS PostgreSQL主实例是否满足创建DuckDB分析实例的前提条件。对于不满足的条件将返回失败原因，并提供解决方案或建议的目标值。

接口说明

适用引擎

RDS PostgreSQL

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

rds:PrecheckDuckDBDependency

get

*DBInstance

acs:rds:{#regionId}:{#accountId}:dbinstance/{#DbInstanceId}

无

请求语法

POST  HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
DBInstanceId	string	是	主实例 ID。	pgm-2zegy5pdkg58****
TargetMode	string	否		readOnly

返回参数

名称	类型	描述	示例值
	object	返回参数详情。
FailedCheckItems	array<object>	不符合创建 DuckDB 分析实例的条目。
	object
AllowAutoModify	boolean	是否可以一键修复。 true：是。可以通过调用 ModifyDBInstanceConfig 接口一键修复。 false：否。重要当数据库实例大版本不符合要求时，需要通过手动升级。枚举值： true : true false : false	false
CurrentValue	string	检查项的当前值。	15.0
Name	string	检查项名称。	MajorVersion
RequiredValue	string	检查项的目标值（或目标区间）。	17.0
Type	string	检查项。取值： Parameter：参数。 MinorVersion：内核小版本。 MajorVersion：数据库大版本。枚举值： MajorVersion : MajorVersion Parameter : Parameter MinorVersion : MinorVersion	Parameter
Result	boolean	是否通过创建 DuckDB 分析实例的前置校验。取值： true：是。 false：否。枚举值： true : true false : false	false

示例

正常返回示例

JSON格式

{
  "FailedCheckItems": [
    {
      "AllowAutoModify": true,
      "CurrentValue": "15.0",
      "Name": "MajorVersion",
      "RequiredValue": "17.0",
      "Type": "Parameter"
    }
  ],
  "Result": true
}

错误码

HTTP status code	错误码	错误信息	描述
400	IdempotentParameterMismatch	The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.
400	ReadonlyInstanceNotSupport	The operation is not permitted due to type of the instance.	指定的只读实例不支持此操作。
400	InvalidEngineVersion	The specified EngineVersion is invalid.	指定的数据库版本号无效
400	MissingParameter.MinorVersionTag	You must specify the parameter MinorVersionTag.	小版本号不能为空
400	Workbench.InternalFailure	ECS workbench returns an internal failure. Please check password expiration policy and / or other issues.	ECS workbench API 返回了一个内部错误，大概率是账号密码错误。请检查主机账号密码是否过期，和其他可能的情况。
400	DuckDBOperationConflictBetweenPrimaryAndReadOnlyInstance	Current instance is already attached to another duckdb instance, operation is conflict.	当前实例已经关联了另一个 DUCKDB 实例，这和当前的 DUCKDB 操作冲突了
500	InternalFailure	The request processing has failed due to some unknown error, exception or failure.	由于未知错误、异常或失败，请求处理失败。
403	ReadOnlyInstanceNotSupport	Read-only instance does not support this operation.	只读实例不支持此操作。
403	DBInstanceStatusNotActive	The status of the current instance is not active.	操作失败，请检查实例运行状态。
403	IncorrectDBInstanceType	The database instance type does not support the operation.	操作失败，当前数据库类型不支持该操作。
403	GroupReplicationNotSupport.InvalidEngineVersion	Group Replication requires the instance engine version to be 8.0.	实例数据库版本不是MySQL 8.0，不支持组复制。
403	IncorrectDBInstance	The current DB instance does not support this operation.	操作失败，当前实例不支持此操作。
403	IncorrectDBInstanceState	Current DB instance state does not support this operation.	当前实例状态不支持此操作。
404	IncorrectDBInstanceLockMode	Current DB instance lock mode does not support this operation.	操作失败，实例处于锁定状态。
404	InvalidDBInstance.NotFound	The specified instance does not exist or is not supported.	没有找到指定的实例，请检查实例的正确性。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。

云数据库 RDS：PrecheckDuckDBDependency - 检查创建DuckDB分析实例前提条件