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

调试

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

请求头

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

请求语法

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

请求参数

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

应用名称

appId Integer Path 110157886

版本号

name String Path true

精排表达式名称

dryRun Boolean Query true

是否为空运行请求

请求体

字段

类型

是否必要

示例值

描述

meta

String

"text_relevance(name)"

表达式配置

description

String

"my_test"

描述

active

Boolean

true

是否是默认表达式

返回数据

名称 类型 示例值 描述
requestId String C5E2F73C-8241-81F8-3A62-65478C5A3111

请求ID

result Struct

精排表达式信息

active Boolean true

是否是默认表达式

created Integer 1
description String "11"

描述

id String 890473

ID(返回时展示,不作传参)

isDefault String true

是否是默认表达式(返回时展示,不作传参)

  • true 是
  • false 否
isSys String false

是否是系统表达式(返回时展示,不作传参)

  • true 是
  • false 否
meta String cate_id > 0 and cate_id < 1000

精排表达式

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

name String lsh_second_1

名称

updated Integer 1

示例

请求示例

PUT /v4/openapi/app-groups/os_function_test_v1/apps/150024378/second-ranks/name_relevance

{
    "meta": "text_relevance(name)",
    "description": "123",
    "active": true
}

正常返回示例

XML格式

<requestId>C5E2F73C-8241-81F8-3A62-65478C5A3111</requestId>
<result>
    <id>890473</id>
    <name>name_relevance</name>
    <meta>text_relevance(name)</meta>
    <active>true</active>
    <description>123</description>
    <created>1593679894</created>
    <updated>1593679894</updated>
    <isDefault>true</isDefault>
    <isSys>false</isSys>
</result>

JSON格式

{
    "requestId": "C5E2F73C-8241-81F8-3A62-65478C5A3111",
    "result": {
        "id": 890473,
        "name": "name_relevance",
        "meta": "text_relevance(name)",
        "active": true,
        "description": 123,
        "created": 1593679894,
        "updated": 1593679894,
        "isDefault": true,
        "isSys": false
    }
}

错误码

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