Tüm Ürünler
Search
Belge Merkezi

:UpdateSynonymsDicts

Son Güncelleme:Oct 04, 2026

Elasticsearch örneğinin Eş Anlamlılar Sözlüğünü güncellemek için UpdateSynonymsDicts API'sini çağırın.

Bu arabirimi çağırırken aşağıdaki hususlara dikkat edin:

  • Sözlük dosyası OSS'ten alınıyorsa OSS paketinin herkese açık okunabilir olduğundan emin olun.

  • Yüklenen bir sözlük dosyasına ORIGIN yapılandırması eklenmezse bu işlemi çağırdığınızda sözlük dosyası silinir.

Hata Ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer farklı SDK'lar için örnek kodu dinamik olarak oluşturur.

İstek üst bilgileri

Bu işlem yalnızca ortak istek parametrelerini kullanır ve özel istek üst bilgilerini içermez. Daha fazla bilgi için ortak parametreler hakkındaki konuya bakın.

İstek sözdizimi

PUT /openapi/instances/[InstanceId]/synonymsDict HTTP/1.1

İstek parametreleri

Parametre Tür Konum Gerekli Örnek Açıklama
InstanceId String Path Evet es-cn-nif1q9o8r0008****


Örneğin ID'si.

clientToken String Query Hayır 5A2CFF0E-5718-45B5-9D4D-70B3FF****


Bu parametre isteğin yinelenebilirliğini (idempotence) sağlamak için kullanılır. Değeri istemci aracılığıyla oluşturabilirsiniz ancak farklı istekler arasında benzersiz olmasını sağlamanız gerekir. Belirteç yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz.

RequestBody

RequestBody içinde aşağıdaki parametreleri girin.

Parametre

Tür

Gerekli

Örnek

Açıklama

name

String

Evet

dic_0.txt

Yüklediğiniz sözlük dosyasının adı; TXT dosyası olmalıdır.

ossObject

Array

Hayır

OSS açık depolama dosyasının açıklaması. sourceType OSS olarak ayarlandığında bu parametre gereklidir.

└bucketName

String

Hayır

search-cloud-test-cn-****

Bir OSS paketinin adı.

└key

String

Hayır

oss/dic_0.txt

Sözlük dosyasının OSS paketi içindeki depolama yolu.

sourceType

String

Evet

OSS

Sözlük Dosyası Kaynağının türü. Geçerli değerler: OSS (OSS kullanan açık depolama hizmeti) ve ORIGIN (daha önce yüklenen sözlüklerin korunması).

Not:

Yerel dosya önce OSS'e yüklenmeli ve ardından OSS üzerinden referans verilmelidir.

Yüklenen bir sözlük ORIGIN ile yapılandırılmazsa sistem tarafından silinir.

type

String

Evet

SYNONYMS

Güncellemek istediğiniz sözlüğün türü. Değer SYNONYMS olarak sabittir.

Not

└ sembolü bir alt parametreyi belirtir.

Örnekler:

[
    {
        "name":"deploy_0.txt",
        "ossObject":{
            "bucketName":"search-cloud-test-cn-****",
            "key":"user_dict/dict_0.dic"
        },
        "sourceType":"OSS",
        "type":"MAIN"
    },
    {
        "name":"SYSTEM_MAIN.txt",
        "type":"MAIN",
        "sourceType":"ORIGIN"
    },
    {
        "name":"SYSTEM_STOPWORD.txt",
        "type":"STOP",
        "sourceType":"ORIGIN"
    }
]          

Yanıt parametreleri

Parametre Tür Örnek Açıklama
RequestId String 7C5622CC-B312-426F-85AA-B0271*******

İsteğin ID'si.

Result Array of DictList

Dönüş sonuçları.

fileSize Long 220

Sözlük dosyasının boyutu. Birim: Byte.

name String deploy_0.txt

Sözlük dosyasının adı.

sourceType String OSS

Sözlük dosyasının kaynak türü. Geçerli değerler:

  • OSS: OSS açık depolama.
  • ORIGIN: Yüklenen sözlükleri korur.
type String SYNONYMS

Sözlük türü. Geçerli değerler: SYNONYMS.

Örnekler

Örnek istekler

PUT /openapi/instances/es-cn-nif1q9o8r0008****/synonymsDict HTTP/1.1
common request header
[
    {
        "name":"deploy_0.txt",
        "ossObject":{
            "bucketName":"search-cloud-test-cn-****",
            "key":"user_dict/dict_0.dic"
        },
        "sourceType":"OSS",
        "type":"SYNONYMS"
    },
    {
        "name":"SYSTEM_STOPWORD.txt",
        "sourceType":"ORIGIN",
        "type":"SYNONYMS"
    }
]

Örnek başarılı yanıt

JSON biçimi

{
    "Result": [

        {
            "name":"deploy_0.txt",
            "fileSize":220,
            "sourceType":"OSS",
            "type":"SYNONYMS"
        },
        {
            "name":"SYSTEM_MAIN.txt",
            "fileSize":2782602,
            "sourceType":"ORIGIN",
            "type":"SYNONYMS"
        },
        {
            "name":"SYSTEM_STOPWORD.txt",
            "fileSize":132,
            "sourceType":"ORIGIN",
            "type":"SYNONYMS"
        }
    ],
    "RequestId": "1F7FE662-CCD8-474F-BA9B-A7E0792E****"
}

Hata kodu

Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.