Aliases - Create Or Update

Hizmet:: Search Service

API Sürümü:: 2025-08-01-preview

Yeni bir arama takma adı oluşturur veya zaten varsa bir takma adı günceller.

PUT {endpoint}/aliases('{aliasName}')?api-version=2025-08-01-preview

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
aliasName	path	True	string	Oluşturulacak veya güncellenecek diğer adın tanımı.
endpoint	path	True	string	Arama hizmetinin uç nokta URL'si.
api-version	query	True	string	İstemci API sürümü.

İstek Başlığı

Name	Gerekli	Tür	Description
x-ms-client-request-id		string (uuid)	Hata ayıklamaya yardımcı olmak için istekle birlikte gönderilen izleme kimliği.
If-Match		string	If-Match koşulunu tanımlar. İşlem yalnızca sunucudaki ETag bu değerle eşleşirse gerçekleştirilir.
If-None-Match		string	If-None-Match koşulunu tanımlar. İşlem yalnızca sunucudaki ETag bu değerle eşleşmezse gerçekleştirilir.
Prefer	True	string	HTTP PUT istekleri için, hizmete başarılı olduğunda oluşturulan/güncelleştirilen kaynağı döndürmesini söyler.

İstek Gövdesi

Name	Gerekli	Tür	Description
indexes	True	string[]	Bu diğer adın eşlendiği dizinin adı. Yalnızca bir dizin adı belirtilebilir.
name	True	string	Diğer adın adı.
@odata.etag		string	Diğer adın ETag'i.

Yanıtlar

Name	Tür	Description
200 OK	SearchAlias
201 Created	SearchAlias
Other Status Codes	ErrorResponse	Hata yanıtı.

Örnekler

SearchServiceCreateOrUpdateAlias

Örnek isteği

HTTP

PUT https://previewexampleservice.search.windows.net/aliases('myalias')?api-version=2025-08-01-preview





{
  "name": "myalias",
  "indexes": [
    "preview-test"
  ],
  "@odata.etag": "0x1234568AE7E58A1"
}

Örnek yanıt

Durum kodu:: 200

{
  "name": "myalias",
  "indexes": [
    "preview-test"
  ]
}

Durum kodu:: 201

{
  "name": "myalias",
  "indexes": [
    "preview-test"
  ]
}

Tanımlar

Name	Description
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
SearchAlias	Diğer ad adından bir dizine eşlemeyi açıklayan bir dizin diğer adını temsil eder. Diğer ad adı, desteklenen işlemler için dizin adının yerine kullanılabilir.

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

SearchAlias

Nesne

Diğer ad adından bir dizine eşlemeyi açıklayan bir dizin diğer adını temsil eder. Diğer ad adı, desteklenen işlemler için dizin adının yerine kullanılabilir.

Name	Tür	Description
@odata.etag	string	Diğer adın ETag'i.
indexes	string[]	Bu diğer adın eşlendiği dizinin adı. Yalnızca bir dizin adı belirtilebilir.
name	string	Diğer adın adı.