Aliases - Create Or Update

Hizmet:: Search Service

API Sürümü:: 2026-04-01

Yeni bir arama diğer adı oluşturur veya zaten varsa diğer adı güncelleştirir.

PUT {endpoint}/aliases('{aliasName}')?api-version=2026-04-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
aliasName	path	True	string	Diğer adın adı.
endpoint	path	True	string (uri)	Arama hizmetinin uç nokta URL'si.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Başlığı

Name	Gerekli	Tür	Description
Accept		Accept	Kabul Et başlığı.
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	Prefer	HTTP PUT istekleri için, hizmete başarılı olduğunda oluşturulan/güncelleştirilen kaynağı döndürmesini söyler.
x-ms-client-request-id		string (uuid)	İstek için opak, genel olarak benzersiz, istemci tarafından oluşturulan bir dize tanımlayıcısı.

İ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	İstek başarılı oldu.
201 Created	SearchAlias	İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu.
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Güvenlik

api-key

Tür: apiKey
İçinde: header

OAuth2Auth

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Kapsamlar

Name	Description
https://search.azure.com/.default

Örnekler

SearchServiceCreateOrUpdateAlias

Örnek isteği

HTTP

PUT https://exampleservice.search.windows.net/aliases('myalias')?api-version=2026-04-01





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

Örnek yanıt

Durum kodu:: 200

{
  "name": "myalias",
  "indexes": [
    "example-index"
  ]
}

Durum kodu:: 201

{
  "name": "myalias",
  "indexes": [
    "example-index"
  ]
}

Tanımlar

Name	Description
Accept	Kabul Et başlığı.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıt biçimini de izler.).
Prefer	HTTP PUT istekleri için, hizmete başarılı olduğunda oluşturulan/güncelleştirilen kaynağı döndürmesini söyler.
SearchAlias	Diğer addan dizine eşlemeyi açıklayan dizin diğer adını temsil eder. Diğer ad, desteklenen işlemler için dizin adının yerine kullanılabilir.

Accept

Numaralandırma

Kabul Et başlığı.

Değer	Description
application/json;odata.metadata=minimal

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info		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

Başarısız işlemlerin hata ayrıntılarını döndürmek için tüm Azure Resource Manager API'leri için genel hata yanıtı. (Bu, OData hata yanıt biçimini de izler.).

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

Prefer

Numaralandırma

HTTP PUT istekleri için, hizmete başarılı olduğunda oluşturulan/güncelleştirilen kaynağı döndürmesini söyler.

Değer	Description
return=representation

SearchAlias

Nesne

Diğer addan dizine eşlemeyi açıklayan dizin diğer adını temsil eder. Diğer 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ı.