All Products
Search
Document Center

Intelligent Media Services:AlterSearchIndex

Last Updated:Mar 14, 2025

Modifies search index information including index status and configurations.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
SearchLibNamestringNo

The name of the search library.

  • If you leave this parameter empty, the search index is created in the default search library of Intelligent Media Service (IMS). Default value: ims-default-search-lib.
  • To query information about an existing search library, call the QuerySearchLib API operation.
test1
IndexTypestringYes

The category of the index. Valid values:

  • mm: large visual model.
  • face: face recognition.
  • aiLabel: smart tagging.
mm
IndexStatusstringNo

The state of the index. Valid values:

  • active (default): the index is enabled.
  • Deactive: the index is not enabled.
Note You must specify either IndexStatus or IndexConfig.
Enumeration Value:
  • Active: Active.
  • Deactive: Deactive.
Active
IndexConfigstringNo

The configurations of the index.

Note You must specify either IndexStatus or IndexConfig.
{}

Response parameters

ParameterTypeDescriptionExample
object

Schema of Response

RequestIdstring

The ID of the request.

******3B-0E1A-586A-AC29-742247******
Successstring

Indicates whether the request was successful. Valid values:

  • true
  • false
true
Codestring

The status code returned.

200

Examples

Sample success responses

JSONformat

{
  "RequestId": "******3B-0E1A-586A-AC29-742247******",
  "Success": "true",
  "Code": "200"
}

Error codes

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

Change history

Change timeSummary of changesOperation
2023-11-23The request parameters of the API has changedView Change Details
2023-11-22The request parameters of the API has changed. The response structure of the API has changedView Change Details