DescribeApps - 获取一个应用的版本列表

获取一个 OpenSearch 应用的版本列表。

接口说明

  • 若已存在同名标准版应用,则创建新版本;
  • 在新建版本情况下,autoSwitch 和 realtimeShared 也是必填的;
  • 在新建版本情况下,quota 是自动从上一个版本继承的;
  • 在新建版本情况下,修改 quota 是无效的。

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
opensearch:ListApplist
*App
acs:opensearch:{#regionId}:{#accountId}:app-groups/{#AppGroupId}

请求语法

GET /v4/openapi/app-groups/{appGroupIdentity}/apps HTTP/1.1

请求参数

名称类型必填描述示例值
appGroupIdentitystring

应用名称

my_app_group_name

返回参数

名称类型描述示例值
object
requestIdstring

请求 ID

77CAA411-0010-4DB9-82E2-1C384E590AFF
resultarray<object>

返回结果

resultobject

版本信息,参考: App

idstring

组 ID

100302881
isCurrentboolean

是否是在线版本。

12333
clusterNamestring

集群名称

vpc_sh_domain_1
autoSwitchboolean

是否自动切换

true
typestring

应用类型

  • standard 标准版
  • advance 老高级版(新应用不支持此类型)
  • enhanced 新高级版
enhanced
descriptionstring

描述

""
statusstring

版本状态

  • ok 正常
  • stopped 暂停
  • frozen 已冻结
  • initializing 版本初始化中
  • unavailable 版本已失效
  • data_waiting 等待数据初始化
  • data_preparing 数据初始化中
normal
schemaobject

应用结构

tablesobject

表结构。

indexesobject

索引结构

filterFieldsarray

属性字段

filterFieldsstring

属性字段

id
searchFieldsobject

索引字段

routeFieldstring

一级分列字段名称

field1
routeFieldValuesarray

一级分列字段热点值

routeFieldValuesstring

一级分列字段热点值

routeFieldValues
secondRouteFieldstring

二级分列字段名称(当且仅当配置有 routeFieldValues 时生效,默认使用宽表主键)

field2
ttlFieldobject

文档清理配置

namestring

文档清理字段

text1
ttllong

存活时间(毫秒)

1000
indexSortConfigarray<object>

倒排索引配置

indexSortConfigobject

倒排索引配置

fieldstring

排序字段

field1
directionstring

排序方式

  • ASC
  • DESC
DESC
namestring

宽表表名

test
progressPercentinteger

数据导入进度百分比(如 83 代表 83%)

100
fetchFieldsarray

默认展示字段

fetchFieldsstring

默认展示字段

{}
quotaobject

配额信息

specstring

规格

  • opensearch.share.junior 入门型
  • opensearch.share.common 共享通用型
  • opensearch.share.compute 共享计算型
  • opensearch.share.storage 共享存储型
  • opensearch.private.common 独享通用型
  • opensearch.private.compute 独享计算型
  • opensearch.private.storage 独享存储型
opensearch.share.common
qpsinteger

搜索请求(单位:次/秒)(老计费模型使用)

5
docSizeinteger

存储容量(单位:GB)

1
computeResourceinteger

计算资源(单位:LCU)

20
domainobject

行业类型

  • GENERAL 通用
  • ECOMMERCE 电商
  • IT_CONTENT IT 内容
categorystring

类型-standard 标准版-advance 老高级版(新应用不支持此类型)-enhanced 新高级版

-
namestring

英文名称

test
functionsobject

搜索结果

servicearray

功能 1

servicestring

功能 1

-
qparray

信息 1

qpstring

信息 1

spellcheck
algoarray

结构 1

algostring

结构 1

pop
schemasarray<object>

单表应用结构

schemasobject

单表应用结构

tablesobject

表结构

indexesobject

索引结构

filterFieldsarray

属性字段

filterFieldsstring

属性字段

field1
searchFieldsobject

索引字段

routeFieldstring

一级分列字段名称

field1
routeFieldValuesarray

一级分列字段热点值

routeFieldValuesstring

一级分列字段热点值

routeFieldValues
secondRouteFieldstring

二级分列字段名称(当且仅当配置有 routeFieldValues 时生效,默认使用宽表主键)

field2
ttlFieldobject

文档清理配置

namestring

文档时间字段

fIeld1
ttllong

存活时间(毫秒)

1000
indexSortConfigarray<object>

倒排索引配置

indexSortConfigobject

倒排索引配置

fieldstring

排序字段

fIeld1
directionstring

排序方式

  • ASC
  • DESC
DESC
namestring

宽表表名

main
firstRanksarray<object>

粗排配置

firstRanksobject

粗排配置

typestring

表达式类型

STRUCT 结构化, 默认值- STRING 自定义公式

STRING
namestring

粗排名称

test
descriptionstring

描述

描述
activeboolean

是否是默认表达式

False
metaany

表达式信息(Array 或 String)

String :"random()*100+now()"; Array: [ { "attribute": "static_bm25()", "arg": "", "weight": 10 } ]
secondRanksarray<object>

精排配置

secondRanksobject

精排配置

metaany

精排表达式(可以编写包含字段、算分特征和数学函数的表达式,实现复杂的排序逻辑)

"cate_id > 0 and cate_id < 1000"
namestring

精排名称

default
descriptionstring

描述

描述
activeboolean

是否是默认表达式

False
dataSourcesarray<object>

数据源配置

dataSourcesobject

数据源配置

tableNamestring

应用表名

main
typestring

数据源类型

  • rds
  • odps
  • opensearch
  • polardb
rds
fieldsarray<object>

表字段映射信息

fieldsobject

表字段映射信息

pluginsobject

字段数据处理插件

插件名称(name)

  • JsonKeyValueExtractor
  • MultiValueSpliter
  • KeyValueExtractor
  • StringCatenateExtractor
  • HTMLTagRemover

插件参数(parameters):

  • JsonKeyValueExtractor
  • MultiValueSpliter
  • KeyValueExtractor
  • StringCatenateExtractor
  • HTMLTagRemover
keyFieldstring

主键

id
schemaNamestring

宽表名称

name
parametersobject

数据源信息

summariesarray<object>

搜索结果摘要配置

summariesobject

搜索结果摘要配置

namestring

分组名

fefault
metaarray<object>

摘要配置

metaobject

摘要配置

fieldstring

字段

field1
leninteger

片段长度,取值区间:[1-300]

50
elementstring

飘红标签

em
ellipsisstring

片段链接符

...
snippetstring

片段数量,取值区间:[1-5]

5
queryProcessorsarray<object>

查询意图理解配置

queryProcessorsobject

查询意图理解配置

namestring

规则名称

test
domainstring

行业类型

  • GENERAL 通用
  • ECOMMERCE 电商
  • IT_CONTENT IT 内容
GENERAL
categorystring

行业垂类

""
processorsarray<object>

包含功能

processorsobject

包含功能

indexesarray

应用索引

indexesstring

应用索引

default
activeboolean

是否默认规则

False
clusterobject

能力开放配置

maxTimeoutMSinteger

集群的超时时间,单位是 ms

750
maxQueryClauseLengthinteger

query 字句最大长度

1024
interpretationsobject

LLM 字段模型

promptsarray<object>

prompt 配置

promptsobject

prompt 配置

示例

正常返回示例

JSON格式

{
  "requestId": "77CAA411-0010-4DB9-82E2-1C384E590AFF",
  "result": [
    {
      "id": "100302881",
      "isCurrent": true,
      "clusterName": "vpc_sh_domain_1",
      "autoSwitch": true,
      "type": "enhanced",
      "description": "\"\"",
      "status": "normal",
      "schema": {
        "tables": {
          "test": "test",
          "test2": 1
        },
        "indexes": {
          "filterFields": [
            "id"
          ],
          "searchFields": {
            "test": "test",
            "test2": 1
          }
        },
        "routeField": "field1",
        "routeFieldValues": [
          "routeFieldValues"
        ],
        "secondRouteField": "field2\n",
        "ttlField": {
          "name": "text1\n",
          "ttl": 1000
        },
        "indexSortConfig": [
          {
            "field": "field1",
            "direction": "DESC"
          }
        ],
        "name": "test"
      },
      "progressPercent": 100,
      "fetchFields": [
        "{}"
      ],
      "quota": {
        "spec": "opensearch.share.common",
        "qps": 5,
        "docSize": 1,
        "computeResource": 20
      },
      "domain": {
        "category": "-",
        "name": "test",
        "functions": {
          "service": [
            "-"
          ],
          "qp": [
            "spellcheck"
          ],
          "algo": [
            "pop"
          ]
        }
      },
      "schemas": [
        {
          "tables": {
            "test": "test",
            "test2": 1
          },
          "indexes": {
            "filterFields": [
              "field1"
            ],
            "searchFields": {
              "test": "test",
              "test2": 1
            }
          },
          "routeField": "field1\n",
          "routeFieldValues": [
            "routeFieldValues"
          ],
          "secondRouteField": "field2",
          "ttlField": {
            "name": "fIeld1",
            "ttl": 1000
          },
          "indexSortConfig": [
            {
              "field": "fIeld1",
              "direction": "DESC"
            }
          ],
          "name": "main"
        }
      ],
      "firstRanks": [
        {
          "type": "STRING",
          "name": "test",
          "description": "描述",
          "active": true,
          "meta": "String :\"random()*100+now()\";\nArray: [\n    {\n      \"attribute\": \"static_bm25()\",\n      \"arg\": \"\",\n      \"weight\": 10\n    }\n  ]"
        }
      ],
      "secondRanks": [
        {
          "meta": "\"cate_id > 0 and cate_id < 1000\"\n",
          "name": "default\n",
          "description": "描述",
          "active": true
        }
      ],
      "dataSources": [
        {
          "tableName": "main",
          "type": "rds",
          "fields": [
            {
              "test": "test",
              "test2": 1
            }
          ],
          "plugins": {
            "test": "test",
            "test2": 1
          },
          "keyField": "id",
          "schemaName": "name",
          "parameters": {
            "test": "test",
            "test2": 1
          }
        }
      ],
      "summaries": [
        {
          "name": "fefault",
          "meta": [
            {
              "field": "field1",
              "len": 50,
              "element": "em",
              "ellipsis": "...",
              "snippet": "5"
            }
          ]
        }
      ],
      "queryProcessors": [
        {
          "name": "test",
          "domain": "GENERAL",
          "category": "\"\"",
          "processors": [
            {
              "test": "test",
              "test2": 1
            }
          ],
          "indexes": [
            "default"
          ],
          "active": true
        }
      ],
      "cluster": {
        "maxTimeoutMS": 750,
        "maxQueryClauseLength": 1024
      },
      "interpretations": {
        "test": "test",
        "test2": 1
      },
      "prompts": [
        {
          "test": "test",
          "test2": 1
        }
      ]
    }
  ]
}

错误码

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

变更历史

变更时间变更内容概要操作
2024-08-26OpenAPI 返回结构发生变更查看变更详情