修改一个 OpenSearch 应用版本的粗排表达式配置当 dryRun=true 时,表示修改后的粗排表达式进行校验,默认 dryRun 不传为 false

调试

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

请求头

该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。

请求语法

PUT /v4/openapi/app-groups/[appGroupIdentity]/apps/[appId]/first-ranks/[name] HTTP/1.1

请求参数

名称 类型 位置 是否必选 示例值 描述
appGroupIdentity String Path my_app_group_name

应用名称

appId Integer Path 110157886

版本号

name String Path test

粗排表达式名称

dryRun Boolean Query true

是否为空运行请求

请求体

字段

类型

是否必要

示例值

描述

type

String

"STRUCT"

表达式类型

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

meta

Array 或 String

表达式信息

description

String

"my_test"

描述

active

Boolean

true

是否是默认表达式

参考:FirstRank

返回数据

名称 类型 示例值 描述
requestId String 0A6EB64B-B4C8-CF02-810F-E660812972FF

请求ID

result Struct

粗排表达式信息

active Boolean true

是否是默认表达式

description String 1

描述

meta Array of metaItem

表达式信息

arg String “1 ”

表达式函数参数

attribute String static_bm25()

属性,算分特征或搜索字段

可用的算分特征

weight Float 10

权重

取值范围:-100000~100000非0值

name String default

名称

示例

请求示例

PUT /v4/openapi/app-groups/os_function_test_v1/apps/150024378/first-ranks/ar_wear_edit_time

{
    "type": "STRUCT",
    "meta": [
        {
            "attribute": "timeliness_ms()",
            "arg": "ar_edit_time",
            "weight": 1
        }
    ],
    "description": "",
    "active": false
}

正常返回示例

XML格式

<requestId>0A6EB64B-B4C8-CF02-810F-E660812972FF</requestId>
<result>
    <name>ar_wear_edit_time</name>
    <type>STRUCT</type>
    <meta>
        <attribute>timeliness_ms()</attribute>
        <arg>ar_edit_time</arg>
        <weight>1</weight>
    </meta>
    <description/>
    <active>false</active>
    <created>0</created>
    <updated>0</updated>
</result>

JSON格式

{
    "requestId": "0A6EB64B-B4C8-CF02-810F-E660812972FF",
    "result": {
        "name": "ar_wear_edit_time",
        "type": "STRUCT",
        "meta": {
            "attribute": "timeliness_ms()",
            "arg": "ar_edit_time",
            "weight": 1
        },
        "description": "",
        "active": false,
        "created": 0,
        "updated": 0
    }
}

错误码

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