更新时间:2025-08-11 GMT+08:00

插件安装

功能介绍

安装数据库插件。

URI

POST /v3/{project_id}/instances/{instance_id}/kernel-plugin

表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

参数解释:

租户在某一Region下的项目ID。

获取方法请参见获取项目ID

约束限制:

不涉及。

取值范围:

只能由英文字母、数字组成,且长度为32个字符。

默认取值

不涉及。

instance_id

String

参数解释:

实例ID,此参数是用户创建实例的唯一标识。

约束限制:

不涉及。

取值范围:

只能由英文字母、数字组成,且长度为36个字符。

默认取值

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。

通过调用IAM服务获取用户Token接口获取。

请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

约束限制:

不涉及。

取值范围

不涉及。

默认取值

不涉及。

X-Language

String

参数解释:

语言。

约束限制:

不涉及。

取值范围

  • zh-cn
  • en-us

默认取值

en-us

表3 请求Body参数

参数

是否必选

参数类型

描述

plugin_name

String

参数解释:

插件包名称。

约束限制:

不涉及。

取值范围:

仅支持yukon的postgis插件。

默认取值

不涉及。

url

String

参数解释:

插件包安装链接。要求为OBS租户桶分享链接。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值

不涉及。

sha_256

String

参数解释:

插件包对应的sha256字符串。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值

不涉及。

响应参数

表4 参数说明

参数

参数类型

描述

job_id

String

参数解释:

插件安装工作流ID。

取值范围:

不涉及。

请求示例

https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3/0c8243400d37468bb4aed3cc94c2911d/instances/f9b5f9b296ec6808e067in14/kernel-plugin
{ 
  "plugin_name" : "postgis", 
  "url" : "xxxx.obs.bucket1", 
  "sha_256" : "791a8d68064ca3208b52ac2584b3b1ab89e4945069baf48e2b14ed5a7151889b" 
}

响应示例

{ 
  "job_id" : "bf26cf3c-d046-4080-bb45-f114be7afa5f" 
}

状态码

错误码

请参见错误码