修改一个 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
    }
}

错误码

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