Synonym Maps - Create Or Update
Yeni bir eş anlamlı eşlem oluşturur veya zaten varsa eş anlamlı eşlemeyi güncelleştirir.
PUT {endpoint}/synonymmaps('{synonymMapName}')?api-version=2024-03-01-Preview
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
endpoint
|
path | True |
string |
Arama hizmetinin uç nokta URL'si. |
synonym
|
path | True |
string |
Oluşturulacak veya güncelleştirilecek eş anlamlı eşlem adı. |
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şiyorsa gerçekleştirilir. |
|
If-None-Match |
string |
If-None-Match koşulunu tanımlar. İşlem yalnızca sunucudaki ETag bu değerle eşleşmiyorsa 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 bildirir. |
İstek Gövdesi
Name | Gerekli | Tür | Description |
---|---|---|---|
format | True |
Eş anlamlı eşlem biçimi. Şu anda yalnızca 'solr' biçimi desteklenmektedir. |
|
name | True |
string |
Eş anlamlı eşlem adı. |
synonyms | True |
string |
Belirtilen eş anlamlı eşlem biçiminde bir dizi eş anlamlı kural. Kurallar yeni satırlarla ayrılmalıdır. |
@odata.etag |
string |
Eş anlamlı haritanın ETag'i. |
|
encryptionKey |
Azure Key Vault'de oluşturduğunuz şifreleme anahtarının açıklaması. Bu anahtar, Microsoft'un bile değil, kimsenin verilerinizin şifresini çözemediğini tam olarak güvenceye almak istediğinizde verileriniz için ek bir bekleyen şifreleme düzeyi sağlamak için kullanılır. Verilerinizi şifreledikten sonra her zaman şifrelenmiş olarak kalır. Arama hizmeti bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek istiyorsanız bu özelliği gerektiği gibi değiştirebilirsiniz; Verileriniz etkilenmez. Müşteri tarafından yönetilen anahtarlarla şifreleme ücretsiz arama hizmetleri için kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK | ||
201 Created | ||
Other Status Codes |
Hata yanıtı. |
Örnekler
SearchServiceCreateOrUpdateSynonymMap
Örnek isteği
PUT https://myservice.search.windows.net/synonymmaps('mysynonymmap')?api-version=2024-03-01-Preview
{
"name": "mysynonymmap",
"format": "solr",
"synonyms": "United States, United States of America, USA\nWashington, Wash. => WA",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": null
}
}
Örnek yanıt
{
"name": "mysynonymmap",
"format": "solr",
"synonyms": "United States, United States of America, USA\nWashington, Wash. => WA",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": null
}
}
{
"name": "mysynonymmap",
"format": "solr",
"synonyms": "United States, United States of America, USA\nWashington, Wash. => WA",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": null
}
}
Tanımlar
Name | Description |
---|---|
Azure |
Arama hizmetiniz için oluşturulan ve Azure Key Vault depolanan şifreleme anahtarlarına kimliği doğrulanmış erişim için kullanılan kayıtlı bir uygulamanın kimlik bilgileri. |
Error |
Kaynak yönetimi hatası ek bilgileri. |
Error |
Hata ayrıntısı. |
Error |
Hata yanıtı |
Search |
Bir veri kaynağının kimlik özelliğini temizler. |
Search |
Kullanılacak veri kaynağının kimliğini belirtir. |
Search |
Azure Key Vault'da müşteri tarafından yönetilen bir şifreleme anahtarı. Oluşturduğunuz ve yönettiğiniz anahtarlar, dizinler ve eş anlamlı haritalar gibi bekleyen verileri şifrelemek veya şifresini çözmek için kullanılabilir. |
Synonym |
Eş anlamlı eşlem tanımını temsil eder. |
Synonym |
Eş anlamlı eşlem biçimi. Şu anda yalnızca 'solr' biçimi desteklenmektedir. |
AzureActiveDirectoryApplicationCredentials
Arama hizmetiniz için oluşturulan ve Azure Key Vault depolanan şifreleme anahtarlarına kimliği doğrulanmış erişim için kullanılan kayıtlı bir uygulamanın kimlik bilgileri.
Name | Tür | Description |
---|---|---|
applicationId |
string |
Bekleyen verilerinizi şifrelerken kullanılacak Azure Key Vault gerekli erişim izinlerine sahip bir AAD Uygulama Kimliği. Uygulama Kimliği, AAD Uygulamanızın Nesne Kimliği ile karıştırılmamalıdır. |
applicationSecret |
string |
Belirtilen AAD uygulamasının kimlik doğrulama anahtarı. |
ErrorAdditionalInfo
Kaynak yönetimi hatası ek bilgileri.
Name | Tür | Description |
---|---|---|
info |
object |
Ek bilgiler. |
type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
Name | Tür | Description |
---|---|---|
additionalInfo |
Hata ek bilgileri. |
|
code |
string |
Hata kodu. |
details |
Hata ayrıntıları. |
|
message |
string |
Hata iletisi. |
target |
string |
Hata hedefi. |
ErrorResponse
Hata yanıtı
Name | Tür | Description |
---|---|---|
error |
Hata nesnesi. |
SearchIndexerDataNoneIdentity
Bir veri kaynağının kimlik özelliğini temizler.
Name | Tür | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Kimliğin türünü belirten bir URI parçası. |
SearchIndexerDataUserAssignedIdentity
Kullanılacak veri kaynağının kimliğini belirtir.
Name | Tür | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
Kimliğin türünü belirten bir URI parçası. |
userAssignedIdentity |
string |
Kullanıcı tarafından atanan yönetilen kimliğin tam Azure kaynak kimliği genellikle arama hizmetine atanması gereken "/subscriptions/12345678-1234-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId" biçimindedir. |
SearchResourceEncryptionKey
Azure Key Vault'da müşteri tarafından yönetilen bir şifreleme anahtarı. Oluşturduğunuz ve yönettiğiniz anahtarlar, dizinler ve eş anlamlı haritalar gibi bekleyen verileri şifrelemek veya şifresini çözmek için kullanılabilir.
Name | Tür | Description |
---|---|---|
accessCredentials |
Azure Key Vault erişmek için kullanılan isteğe bağlı Azure Active Directory kimlik bilgileri. Bunun yerine yönetilen kimlik kullanılıyorsa gerekli değildir. |
|
identity | SearchIndexerDataIdentity: |
Bu şifreleme anahtarı için kullanılacak açık bir yönetilen kimlik. Belirtilmezse ve erişim kimlik bilgileri özelliği null ise, sistem tarafından atanan yönetilen kimlik kullanılır. Kaynağa güncelleştirildiğinde, açık kimlik belirtilmemişse değişmeden kalır. "Hiçbiri" belirtilirse, bu özelliğin değeri temizlenir. |
keyVaultKeyName |
string |
Bekleyen verilerinizi şifrelemek için kullanılacak Azure Key Vault anahtarınızın adı. |
keyVaultKeyVersion |
string |
Bekleyen verilerinizi şifrelemek için kullanılacak Azure Key Vault anahtarınızın sürümü. |
keyVaultUri |
string |
Bekleyen verilerinizi şifrelemek için kullanılacak anahtarı içeren DNS adı olarak da adlandırılan Azure Key Vault URI'niz. Örnek bir URI olabilir |
SynonymMap
Eş anlamlı eşlem tanımını temsil eder.
Name | Tür | Description |
---|---|---|
@odata.etag |
string |
Eş anlamlı haritanın ETag'i. |
encryptionKey |
Azure Key Vault'de oluşturduğunuz şifreleme anahtarının açıklaması. Bu anahtar, Microsoft'un bile değil, kimsenin verilerinizin şifresini çözemediğini tam olarak güvenceye almak istediğinizde verileriniz için ek bir bekleyen şifreleme düzeyi sağlamak için kullanılır. Verilerinizi şifreledikten sonra her zaman şifrelenmiş olarak kalır. Arama hizmeti bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek istiyorsanız bu özelliği gerektiği gibi değiştirebilirsiniz; Verileriniz etkilenmez. Müşteri tarafından yönetilen anahtarlarla şifreleme ücretsiz arama hizmetleri için kullanılamaz ve yalnızca 1 Ocak 2019 veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir. |
|
format |
Eş anlamlı eşlem biçimi. Şu anda yalnızca 'solr' biçimi desteklenmektedir. |
|
name |
string |
Eş anlamlı eşlem adı. |
synonyms |
string |
Belirtilen eş anlamlı eşlem biçiminde bir dizi eş anlamlı kural. Kurallar yeni satırlarla ayrılmalıdır. |
SynonymMapFormat
Eş anlamlı eşlem biçimi. Şu anda yalnızca 'solr' biçimi desteklenmektedir.
Name | Tür | Description |
---|---|---|
solr |
string |
Eş anlamlı eşlemeler için SOLR biçimini seçer. |