PrecheckDuckDBDependency - 檢查建立DuckDB分析執行個體前提條件 - ApsaraDB 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.	沒有找到指定的執行個體，請檢查執行個體的正確性。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。

ApsaraDB RDS：PrecheckDuckDBDependency - 檢查建立DuckDB分析執行個體前提條件