ModifyFirstRank - OpenSearch - Alibaba Cloud Documentation Center

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Debug

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

Operation: the value that you can use in the Action element to specify the operation on a resource.
Access level: the access level of each operation. The levels are read, write, and list.
Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
Condition Key: the condition key that is defined by the cloud service.
Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.

Operation	Access level	Resource type	Condition key	Associated operation
opensearch:WriteFirstRank		FirstRank acs:opensearch:{#regionId}:{#accountId}:apps/{#AppGroupId}	none	none

Request syntax

PUT /v4/openapi/app-groups/{appGroupIdentity}/apps/{appId}/first-ranks/{name}

Request parameters

Parameter	Type	Required	Description	Example
dryRun	boolean	No	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 }	true
appGroupIdentity	string	Yes	The name of the application	my_app_group_name
appId	integer	Yes	The version number of the application.	110157886
name	string	Yes	true	test
body	FirstRank	No	The body of request.

Request body

Parameter	Type	Required	Example	Description
type	String	Yes	"STRUCT"	Expression Type - STRUCT (Structured, default Expression) - STRING (Custom Expression)
meta	Array 或 String	Yes		Expression Information
description	String	No	"my_test"	Description
active	Boolean	No	true	Is it a default expression.

see: FirstRank

Response parameters

Parameter	Type	Description	Example
	object
requestId	string	my_app_group_name	0A6EB64B-B4C8-CF02-810F-E660812972FF
result	object	110157886
description	string	test	1
active	boolean	The ID of the request.	true
name	string	The information about the rough sort expression.	default
meta	object []	The description of the expression.
arg	string	Indicates whether the expression is the default one.	“1 ”
attribute	string	The name of the expression.	static_bm25()
weight	float	The content of the expression.	10

Examples

Sample success responses

JSONformat

{
  "requestId": "0A6EB64B-B4C8-CF02-810F-E660812972FF",
  "result": {
    "description": "1",
    "active": true,
    "name": "default",
    "meta": [
      {
        "arg": "“1 ”",
        "attribute": "static_bm25()",
        "weight": 10
      }
    ]
  }
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change time

Summary of changes

Operation

2023-05-24

The request parameters of the API has changed

see changesets

Change item	Change content
Input Parameters	The request parameters of the API has changed.
	Added Input Parameters: body