更新时间:2025-04-01 GMT+08:00

获取参数模板列表

功能介绍

获取参数模板列表,包括所有数据库的默认参数模板和用户创建的参数模板。

该接口计划下线,建议及时切换到新接口获取参数模板列表

接口约束

该接口支持如下数据库实例:

  • GeminiDB Cassandra
  • GeminiDB Mongo
  • GeminiDB Influx经典部署模式实例
  • GeminiDB Redis经典部署模式实例

URI

  • URI格式

    GET https://{Endpoint}/v3/{project_id}/configurations

  • URI样例

    https://gaussdb-nosql.ap-southeast-1.myhuaweicloud.com/v3/375d8d8fad1f43039e23d3b6c0f60a19/configurations

  • 参数说明
    表1 参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    String

    参数解释:

    租户在某一region下的project ID。获取方法请参见获取项目ID

    约束限制:

    不涉及。

    取值范围:

    不涉及。

    默认取值:

    不涉及。

    表2 Query参数

    参数

    是否必选

    参数类型

    描述

    datastore_name

    String

    参数解释:

    数据库名称。

    约束限制:

    不涉及。

    取值范围:

    cassandra:表示支持GeminiDB Cassandra实例。

    redis:表示支持GeminiDB Redis实例。

    influxdb:表示支持GeminiDB Influx实例。

    mongodb: 表示支持GeminiDB Mongo实例。

    默认取值:

    不传该参数,则表示查询所有数据库类型。

    mode

    String

    参数解释:

    数据库实例类型。

    约束限制:

    不涉及。

    取值范围:

    • 取值为“CloudNativeCluster”, 表示查询支持GeminiDB Cassandra云原生部署模式实例的参数模板。
    • 取值为“Cluster”, 表示查询GeminiDB Cassandra经典部署模式集群、GeminiDB Influx经典部署模式集群、GeminiDB Redis Proxy集群经典部署模式集群实例支持的参数模板。
    • 取值为“InfluxdbSingle”, 表示查询支持GeminiDB Influx经典部署模式单节点类型实例的参数模板。
    • 取值为“ReplicaSet”, 表示查询支持GeminiDB Mongo副本集类型实例的参数组。
    • 取值为“All”, 表示查询所有部署模式的参数模板。

    默认取值:

    不传该参数,则表示查询经典部署模式实例支持的参数组。

请求消息

无。

响应消息

  • 正常响应要素说明
    表3 要素说明

    名称

    参数类型

    说明

    count

    Integer

    总记录数

    configurations

    Array of objects

    参数模板列表。

    详情请参见表4

    表4 configurations字段数据结构说明

    名称

    参数类型

    说明

    id

    String

    参数模板ID。

    name

    String

    参数模板名称。

    description

    String

    参数模板描述。

    datastore_version_name

    String

    数据库版本名称。

    datastore_name

    String

    数据库名称。

    created

    String

    创建时间,格式为"yyyy-MM-ddTHH:mm:ssZ"。

    其中,T指某个时间的开始;Z指时区偏移量。

    updated

    String

    更新时间,格式为"yyyy-MM-ddTHH:mm:ssZ"。

    其中,T指某个时间的开始;Z指时区偏移量。

    user_defined

    Boolean

    是否是用户自定义参数模板。

    • 取值为“false”,表示为系统默认参数模板。
    • 取值为“true”,表示为用户自定义参数模板。
  • 正常响应样例
    { 
        "count": 2,
        "configurations": [{ 
                "id": "887ea0d1bb0843c49e8d8e5a09a95652pr06", 
                "name": "configuration_test", 
                "description": "configuration_test", 
                "datastore_version_name": "3.11", 
                "datastore_name": "cassandra", 
                "created": "2019-05-15T11:53:34+0000", 
                "updated": "2019-05-15T11:53:34+0000", 
                "user_defined": true 
            }, 
            { 
                "id": "3bc1e9cc0d34404b9225ed7a58fb284epr06", 
                "name": "Default-Cassandra-3.11", 
                "description": "Default parameter group for cassandra 3.11", 
                "datastore_version_name": "3.11", 
                "datastore_name": "cassandra", 
                "created": "2020-03-21T03:38:51+0000", 
                "updated": "2019-03-21T03:38:51+0000", 
                "user_defined": false 
            } 
        ] 
    }

状态码

详情请参见状态码

错误码

详情请参见错误码