Services - Create Or Update
Verilen kaynak grubunda bir arama hizmeti oluşturur veya güncelleştirir. Arama hizmeti zaten varsa, tüm özellikler verilen değerlerle güncelleştirilir.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}?api-version=2024-03-01-preview
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Geçerli abonelik içindeki kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz. |
search
|
path | True |
string |
Oluşturulacak veya güncelleştirilecek Azure AI Arama hizmeti adı. Arama hizmeti adları yalnızca küçük harf, rakam veya tire içermelidir, ilk iki veya son bir karakter olarak tire kullanamaz, ardışık tireler içeremez ve 2 ile 60 karakter uzunluğunda olmalıdır. Arama hizmeti adları, hizmet URI'sinin parçası olduklarından genel olarak benzersiz olmalıdır (https://.search.windows.net). Hizmet oluşturulduktan sonra hizmet adını değiştiremezsiniz. |
subscription
|
path | True |
string |
Microsoft Azure aboneliğinin benzersiz tanımlayıcısı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz. |
api-version
|
query | True |
string |
Her istek için kullanılacak API sürümü. |
İstek Başlığı
Name | Gerekli | Tür | Description |
---|---|---|---|
x-ms-client-request-id |
string uuid |
Bu isteği tanımlayan istemci tarafından oluşturulan GUID değeri. Belirtilirse, isteği izlemenin bir yolu olarak yanıt bilgilerine eklenir. |
İstek Gövdesi
Name | Gerekli | Tür | Description |
---|---|---|---|
location | True |
string |
Kaynağın bulunduğu coğrafi konum |
identity |
Kaynağın kimliği. |
||
properties.authOptions |
Arama hizmetinin veri düzlemi API'sinin isteklerin kimliğini doğrulama seçeneklerini tanımlar. 'disableLocalAuth' true olarak ayarlandıysa bu ayarlanamaz. |
||
properties.disableLocalAuth |
boolean |
true olarak ayarlandığında, arama hizmetine yapılan çağrıların kimlik doğrulaması için API anahtarlarını kullanmasına izin verilmez. 'dataPlaneAuthOptions' tanımlanmışsa bu true olarak ayarlanamaz. |
|
properties.disabledDataExfiltrationOptions |
Arama hizmeti için açıkça izin verilmeyen veri sızdırma senaryolarının listesi. Şu anda desteklenen tek değer ,gelecekte daha ayrıntılı denetimlerle tüm olası veri dışarı aktarma senaryolarını devre dışı bırakmak için 'Tümü'dür. |
||
properties.encryptionWithCmk |
Bir arama hizmeti içindeki customer manager anahtarlarını kullanarak kaynakların (dizinler gibi) şifrelenmesiyle ilgili tüm ilkeleri belirtir. |
||
properties.hostingMode |
Yalnızca standart3 SKU için geçerlidir. Bu özelliği, diğer SKU'lar için izin verilen en fazla dizinden çok daha yüksek olan 1000'e kadar dizine izin veren 3'e kadar yüksek yoğunluklu bölümü etkinleştirecek şekilde ayarlayabilirsiniz. Standart3 SKU'su için değer 'default' veya 'highDensity' şeklindedir. Diğer tüm SKU'lar için bu değer 'varsayılan' olmalıdır. |
||
properties.networkRuleSet |
Azure yapay zeka Arama hizmeti nasıl ulaşabileceğini belirleyen ağa özgü kurallar. |
||
properties.partitionCount |
integer |
Arama hizmetindeki bölüm sayısı; belirtilirse 1, 2, 3, 4, 6 veya 12 olabilir. 1'den büyük değerler yalnızca standart SKU'lar için geçerlidir. hostingMode 'highDensity' olarak ayarlanmış 'standard3' hizmetleri için izin verilen değerler 1 ile 3 arasındadır. |
|
properties.publicNetworkAccess |
Mevcut müşteri kaynakları ve şablonlarında hataya neden olan değişiklikleri önlemek için bu değer 'etkin' olarak ayarlanabilir. 'Devre dışı' olarak ayarlanırsa, genel arabirim üzerinden trafiğe izin verilmez ve özel uç nokta bağlantıları özel erişim yöntemi olabilir. |
||
properties.replicaCount |
integer |
Arama hizmetindeki çoğaltma sayısı. Belirtilirse, standart SKU'lar için 1 ile 12 arasında bir değer veya temel SKU için 1 ile 3 arasında bir değer olmalıdır. |
|
properties.semanticSearch |
Anlamsal aramanın kullanılabilirliğini denetleyebilen seçenekleri ayarlar. Bu yapılandırma yalnızca belirli konumlardaki belirli Azure AI Arama SKU'ları için mümkündür. |
||
sku |
Fiyat katmanını ve kapasite sınırlarını belirleyen arama hizmetinin SKU'su. Bu özellik, yeni bir arama hizmeti oluştururken gereklidir. |
||
tags |
object |
Kaynak etiketleri. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Mevcut hizmet tanımı başarıyla güncelleştirildi. Çoğaltma veya bölüm sayısını değiştirdiyseniz ölçeklendirme işlemi zaman uyumsuz olarak gerçekleşir. Get Service isteğinin provisioningState özelliği aracılığıyla ölçeklendirme işleminin durumunu de kontrol edebilirsiniz. |
|
201 Created |
Ücretsiz bir arama hizmeti oluşturma isteğinde bulunduysanız, dns yayma gecikmesine tabi olarak hizmet artık sağlanmış ve kullanıma hazır durumdadır. Diğer SKU türleri için sağlama zaman uyumsuz olarak gerçekleşir. Get Service isteğinin provisioningState özelliği aracılığıyla ölçeklendirme işleminin durumunu de kontrol edebilirsiniz. |
|
Other Status Codes |
HTTP 400 (Hatalı İstek): Verilen hizmet adı veya hizmet tanımı geçersiz. Ayrıntılar için yanıttaki hata koduna ve iletiye bakın. HTTP 404 (Bulunamadı): Abonelik veya kaynak grubu bulunamadı. HTTP 409 (Çakışma): Belirtilen abonelik devre dışı bırakıldı. |
Güvenlik
azure_auth
Microsoft Identity platformunda desteklendiği gibi örtük bir izin akışı belirtir.
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
Name | Description |
---|---|
user_impersonation | kullanıcı hesabınızın kimliğine bürünme |
Örnekler
SearchCreateOrUpdateService
Örnek isteği
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview
{
"location": "westus",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"hostingMode": "default"
}
}
Örnek yanıt
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [],
"bypass": "None"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": false,
"authOptions": {
"apiKeyOnly": {}
},
"disabledDataExfiltrationOptions": []
}
}
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [],
"bypass": "None"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": false,
"authOptions": {
"apiKeyOnly": {}
},
"disabledDataExfiltrationOptions": []
}
}
SearchCreateOrUpdateServiceAuthOptions
Örnek isteği
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview
{
"location": "westus",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"hostingMode": "default",
"authOptions": {
"aadOrApiKey": {
"aadAuthFailureMode": "http401WithBearerChallenge"
}
}
}
}
Örnek yanıt
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [],
"bypass": "None"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"authOptions": {
"aadOrApiKey": {
"aadAuthFailureMode": "http401WithBearerChallenge"
}
},
"disabledDataExfiltrationOptions": []
}
}
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [],
"bypass": "None"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"authOptions": {
"aadOrApiKey": {
"aadAuthFailureMode": "http401WithBearerChallenge"
}
},
"disabledDataExfiltrationOptions": []
}
}
SearchCreateOrUpdateServiceDisableLocalAuth
Örnek isteği
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview
{
"location": "westus",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"hostingMode": "default",
"disableLocalAuth": true
}
}
Örnek yanıt
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [],
"bypass": "None"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": true,
"authOptions": null,
"disabledDataExfiltrationOptions": []
}
}
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [],
"bypass": "None"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": true,
"authOptions": null,
"disabledDataExfiltrationOptions": []
}
}
SearchCreateOrUpdateServiceToAllowAccessFromPrivateEndpoints
Örnek isteği
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview
{
"location": "westus",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"publicNetworkAccess": "disabled",
"hostingMode": "default"
}
}
Örnek yanıt
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "disabled",
"networkRuleSet": {
"ipRules": [],
"bypass": "None"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": false,
"authOptions": {
"apiKeyOnly": {}
},
"disabledDataExfiltrationOptions": []
}
}
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "disabled",
"networkRuleSet": {
"ipRules": [],
"bypass": "None"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": false,
"authOptions": {
"apiKeyOnly": {}
},
"disabledDataExfiltrationOptions": []
}
}
SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPs
Örnek isteği
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview
{
"location": "westus",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 1,
"partitionCount": 1,
"networkRuleSet": {
"ipRules": [
{
"value": "123.4.5.6"
},
{
"value": "123.4.6.0/18"
}
]
},
"hostingMode": "default"
}
}
Örnek yanıt
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 1,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [
{
"value": "123.4.5.6"
},
{
"value": "123.4.6.0/18"
}
]
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": false,
"authOptions": {
"apiKeyOnly": {}
},
"disabledDataExfiltrationOptions": []
}
}
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 1,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [
{
"value": "123.4.5.6"
},
{
"value": "123.4.6.0/18"
}
]
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": false,
"authOptions": {
"apiKeyOnly": {}
},
"disabledDataExfiltrationOptions": []
}
}
SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPsAndBypass
Örnek isteği
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview
{
"location": "westus",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 1,
"partitionCount": 1,
"networkRuleSet": {
"ipRules": [
{
"value": "123.4.5.6"
},
{
"value": "123.4.6.0/18"
}
],
"bypass": "AzurePortal"
},
"hostingMode": "default"
}
}
Örnek yanıt
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 1,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [
{
"value": "123.4.5.6"
},
{
"value": "123.4.6.0/18"
}
],
"bypass": "AzurePortal"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": false,
"authOptions": {
"apiKeyOnly": {}
},
"disabledDataExfiltrationOptions": []
}
}
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 1,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [
{
"value": "123.4.5.6"
},
{
"value": "123.4.6.0/18"
}
],
"bypass": "AzurePortal"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": false,
"authOptions": {
"apiKeyOnly": {}
},
"disabledDataExfiltrationOptions": []
}
}
SearchCreateOrUpdateServiceWithCmkEnforcement
Örnek isteği
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview
{
"location": "westus",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"hostingMode": "default",
"encryptionWithCmk": {
"enforcement": "Enabled"
}
}
}
Örnek yanıt
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [],
"bypass": "None"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Enabled",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": false,
"authOptions": {
"apiKeyOnly": {}
},
"disabledDataExfiltrationOptions": []
}
}
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [],
"bypass": "None"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Enabled",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": false,
"authOptions": {
"apiKeyOnly": {}
},
"disabledDataExfiltrationOptions": []
}
}
SearchCreateOrUpdateServiceWithDataExfiltration
Örnek isteği
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview
{
"location": "westus",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"hostingMode": "default",
"disabledDataExfiltrationOptions": [
"All"
]
}
}
Örnek yanıt
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [],
"bypass": "None"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": false,
"authOptions": {
"apiKeyOnly": {}
},
"disabledDataExfiltrationOptions": [
"All"
]
}
}
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [],
"bypass": "None"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": false,
"authOptions": {
"apiKeyOnly": {}
},
"disabledDataExfiltrationOptions": [
"All"
]
}
}
SearchCreateOrUpdateServiceWithIdentity
Örnek isteği
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview
{
"location": "westus",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"hostingMode": "default"
},
"identity": {
"type": "SystemAssigned, UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/user-mi": {}
}
}
}
Örnek yanıt
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [],
"bypass": "None"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": false,
"authOptions": {
"apiKeyOnly": {}
},
"disabledDataExfiltrationOptions": []
},
"identity": {
"type": "SystemAssigned, UserAssigned",
"principalId": "9d1e1f18-2122-4988-a11c-878782e40a5c",
"tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/user-mi": {
"clientId": "cd1dcac8-82dd-45b5-9aed-76795d529f6b",
"principalId": "24e07a75-1286-41e5-a15d-ded85ec3acd7"
}
}
}
}
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [],
"bypass": "None"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": false,
"authOptions": {
"apiKeyOnly": {}
},
"disabledDataExfiltrationOptions": []
},
"identity": {
"type": "SystemAssigned, UserAssigned",
"principalId": "9d1e1f18-2122-4988-a11c-878782e40a5c",
"tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/user-mi": {
"clientId": "cd1dcac8-82dd-45b5-9aed-76795d529f6b",
"principalId": "24e07a75-1286-41e5-a15d-ded85ec3acd7"
}
}
}
}
SearchCreateOrUpdateWithSemanticSearch
Örnek isteği
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview
{
"location": "westus",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"hostingMode": "default",
"semanticSearch": "free"
}
}
Örnek yanıt
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [],
"bypass": "None"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": false,
"authOptions": {
"apiKeyOnly": {}
},
"disabledDataExfiltrationOptions": [],
"semanticSearch": "free"
}
}
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
"name": "mysearchservice",
"location": "westus",
"type": "Microsoft.Search/searchServices",
"tags": {
"app-name": "My e-commerce app"
},
"sku": {
"name": "standard"
},
"properties": {
"replicaCount": 3,
"partitionCount": 1,
"status": "provisioning",
"statusDetails": "",
"hostingMode": "default",
"provisioningState": "provisioning",
"publicNetworkAccess": "enabled",
"networkRuleSet": {
"ipRules": [],
"bypass": "None"
},
"privateEndpointConnections": [],
"sharedPrivateLinkResources": [],
"encryptionWithCmk": {
"enforcement": "Unspecified",
"encryptionComplianceStatus": "Compliant"
},
"disableLocalAuth": false,
"authOptions": {
"apiKeyOnly": {}
},
"disabledDataExfiltrationOptions": [],
"semanticSearch": "free"
}
}
Tanımlar
Name | Description |
---|---|
Aad |
Bir arama hizmetinin veri düzlemi API'sinin kimlik doğrulaması başarısız olan istekler için hangi yanıtı göndereceğini açıklar. |
Api |
Kimlik doğrulaması için yalnızca API anahtarının kullanılabileceğini gösterir. |
Cloud |
API hatası hakkında bilgi içerir. |
Cloud |
Hata kodu ve ileti içeren belirli bir API hatası açıklanır. |
Data |
Microsoft Entra ID kiracıdan alınan API anahtarının veya erişim belirtecinin kimlik doğrulaması için kullanılabileceğini gösterir. |
Data |
Arama hizmetinin bir veri düzlemi isteğinin kimliğini doğrulama seçeneklerini tanımlar. 'disableLocalAuth' true olarak ayarlandıysa bu ayarlanamaz. |
Encryption |
Arama hizmetindeki kaynakların müşteri tarafından yönetilen anahtarlarla nasıl şifreleneceğini belirleyen bir ilkeyi açıklar. |
Hosting |
Yalnızca standard3 SKU için geçerlidir. Bu özelliği, 1000'e kadar dizine izin veren en fazla 3 yüksek yoğunluklu bölümü etkinleştirecek şekilde ayarlayabilirsiniz; bu, diğer SKU'lar için izin verilen en yüksek dizinden çok daha yüksektir. Standard3 SKU'su için değer 'default' veya 'highDensity' şeklindedir. Diğer tüm SKU'lar için bu değer 'varsayılan' olmalıdır. |
Identity |
Arama hizmeti kimliği hakkındaki ayrıntılar. Null değer, arama hizmetinin atanmış bir kimliği olmadığını gösterir. |
Identity |
Kaynak için kullanılan kimlik türü. 'SystemAssigned, UserAssigned' türü hem sistem tarafından oluşturulan bir kimliği hem de kullanıcı tarafından atanan bir kimlik kümesini içerir. 'Hiçbiri' türü hizmetten tüm kimlikleri kaldırır. |
Ip |
Azure AI Arama hizmeti IP kısıtlama kuralı. |
Network |
Azure AI Arama hizmeti nasıl ulaşabileceğini belirleyen ağa özgü kurallar. |
Private |
Microsoft.Network sağlayıcısından özel uç nokta kaynağı. |
Private |
Azure AI Arama hizmeti mevcut özel uç nokta bağlantısını açıklar. |
Private |
Arama hizmetine var olan bir özel uç nokta bağlantısının özelliklerini açıklar. |
Private |
Özel bağlantı hizmeti bağlantısının sağlama durumu. Geçerli değerler Güncelleştirme, Silme, Başarısız, Başarılı, Tamamlanmadı veya İptal Edildi değerleridir. |
Private |
Özel uç noktaya var olan bir Azure Özel Bağlantı hizmeti bağlantısının geçerli durumunu açıklar. |
Private |
Özel bağlantı hizmeti bağlantısının durumu. Geçerli değerler Beklemede, Onaylandı, Reddedildi veya Bağlantısı Kesildi şeklindedir. |
Provisioning |
Arama hizmetinde gerçekleştirilen son sağlama işleminin durumu. Sağlama, hizmet kapasitesi oluşturulurken oluşan bir ara durumdur. Kapasite ayarlandıktan sonra provisioningState değeri 'başarılı' veya 'başarısız' olarak değişir. İstemci uygulamaları, bir işlemin ne zaman tamamlandığını görmek için Arama Hizmetini Al işlemini kullanarak sağlama durumunu yoklayabilir (önerilen yoklama aralığı 30 saniyeden bir dakikaya kadardır). Ücretsiz hizmeti kullanıyorsanız, bu değer arama hizmeti oluşturma çağrısında 'başarılı' olarak geri dönme eğilimindedir. Bunun nedeni, ücretsiz hizmetin zaten ayarlanmış kapasiteyi kullanmasıdır. |
Public |
Mevcut müşteri kaynaklarında ve şablonlarında hataya neden olan değişiklikleri önlemek için bu değer 'etkin' olarak ayarlanabilir. 'Devre dışı' olarak ayarlanırsa, ortak arabirim üzerinden trafiğe izin verilmez ve özel uç nokta bağlantıları özel erişim yöntemi olacaktır. |
Search |
'ipRules' bölümünde tanımlanan kuralları atlayan gelen trafiğin olası çıkış noktaları. |
Search |
Arama hizmeti için açıkça izin verilmeyen veri sızdırma senaryolarının listesi. Şu anda desteklenen tek değer ,gelecekte daha ayrıntılı denetimlerle tüm olası veri dışarı aktarma senaryolarını devre dışı bırakmak için 'Tümü' değeridir. |
Search |
CMK ile şifrelenmemiş nesnelere göre arama hizmeti uyumluluğunun durumunu döndürür. Bir hizmetin birden fazla şifrelenmemiş nesnesi varsa ve zorlama etkinse, hizmet uyumsuz olarak işaretlenir. |
Search |
Bir arama hizmetinin müşteri tarafından yönetilen anahtarla şifrelenmemiş nesneler bulması durumunda uyumluluğu nasıl zorunlu kılması gerektiğini açıklar. |
Search |
Anlamsal aramanın kullanılabilirliğini denetleyebilen seçenekleri ayarlar. Bu yapılandırma yalnızca belirli konumlardaki belirli Azure AI Arama SKU'ları için mümkündür. |
Search |
Azure AI Arama hizmeti ve geçerli durumunu açıklar. |
Search |
Arama hizmetinin durumu. Olası değerler şunlardır: 'running': Arama hizmeti çalışıyor ve sağlama işlemleri devam ediyor. 'sağlama': Arama hizmeti sağlanıyor veya ölçeği artırılıyor veya azaltılıyor. 'silme': Arama hizmeti siliniyor. 'Düzeyi düşürüldü': Arama hizmetinin düzeyi düşürüldü. Temel alınan arama birimleri iyi durumda olmadığında bu durum oluşabilir. Arama hizmeti büyük olasılıkla çalışır durumdadır, ancak performans yavaş olabilir ve bazı istekler bırakılabilir. 'devre dışı': Arama hizmeti devre dışı bırakıldı. Bu durumda hizmet tüm API isteklerini reddeder. 'error': Arama hizmeti bir hata durumunda. 'durduruldu': Arama hizmeti devre dışı bırakılmış bir abonelikte. Hizmetiniz düzeyi düşürülmüş, devre dışı bırakılmış veya hata durumlarındaysa Bu, Azure AI Search ekibinin temel sorunu etkin bir şekilde araştırdığını gösterir. Bu durumlardaki ayrılmış hizmetler, sağlanan arama birimi sayısına bağlı olarak ücretlendirilebilir. |
Shared |
Azure AI Arama hizmeti tarafından yönetilen paylaşılan bir özel bağlantı kaynağını açıklar. |
Shared |
Azure AI Arama hizmeti tarafından yönetilen mevcut bir paylaşılan özel bağlantı kaynağının özelliklerini açıklar. |
Shared |
Paylaşılan özel bağlantı kaynağının sağlama durumu. Geçerli değerler Güncelleştirme, Silme, Başarısız, Başarılı veya Tamamlanmadı değerleridir. |
Shared |
Paylaşılan özel bağlantı kaynağının durumu. Geçerli değerler Beklemede, Onaylandı, Reddedildi veya Bağlantısı Kesildi şeklindedir. |
Sku |
Faturalama oranını ve kapasite sınırlarını belirleyen arama hizmetinin SKU'sunu tanımlar. |
Sku |
Arama hizmetinin SKU'su. Geçerli değerler şunlardır: 'free': Paylaşılan hizmet. 'basic': En fazla 3 çoğaltması olan ayrılmış hizmet. 'standart': En fazla 12 bölüm ve 12 çoğaltma ile ayrılmış hizmet. 'standard2': Standartla benzer, ancak arama birimi başına daha fazla kapasiteye sahiptir. 'standard3': 12 bölüme ve 12 çoğaltmaya (veya hostingMode özelliğini 'highDensity' olarak ayarladıysanız daha fazla dizin içeren en fazla 3 bölüme) sahip en büyük Standart teklif. 'storage_optimized_l1': Bölüm başına 12 bölüme kadar 1 TB destekler. 'storage_optimized_l2': Bölüm başına en fazla 12 bölüm olmak üzere 2 TB destekler.' |
User |
Arama hizmetine atanan kullanıcı tarafından atanan yönetilen kimliğin ayrıntıları. |
AadAuthFailureMode
Bir arama hizmetinin veri düzlemi API'sinin kimlik doğrulaması başarısız olan istekler için hangi yanıtı göndereceğini açıklar.
Name | Tür | Description |
---|---|---|
http401WithBearerChallenge |
string |
Başarısız kimlik doğrulaması isteklerinin 401 (Yetkisiz) HTTP durum koduyla sunulması ve Taşıyıcı Sınaması sunması gerektiğini gösterir. |
http403 |
string |
Başarısız kimlik doğrulaması isteklerine 403 (Yasak) HTTP durum kodu sunulması gerektiğini gösterir. |
ApiKeyOnly
Kimlik doğrulaması için yalnızca API anahtarının kullanılabileceğini gösterir.
CloudError
API hatası hakkında bilgi içerir.
Name | Tür | Description |
---|---|---|
error |
Hata kodu ve ileti içeren belirli bir API hatası açıklanır. |
|
message |
string |
Neyin yanlış gittiğini gösteren hatanın kısa bir açıklaması (ayrıntılar/hata ayıklama bilgileri için 'error.message' özelliğine bakın). |
CloudErrorBody
Hata kodu ve ileti içeren belirli bir API hatası açıklanır.
Name | Tür | Description |
---|---|---|
code |
string |
Http durum kodundan daha kesin bir şekilde hata koşulunu açıklayan bir hata kodu. Belirli hata durumlarını program aracılığıyla işlemek için kullanılabilir. |
details |
Bu hatayla ilgili iç içe hatalar içerir. |
|
message |
string |
Hatayı ayrıntılı olarak açıklayan ve hata ayıklama bilgileri sağlayan bir ileti. |
target |
string |
Belirli bir hatanın hedefi (örneğin, hatadaki özelliğin adı). |
DataPlaneAadOrApiKeyAuthOption
Microsoft Entra ID kiracıdan alınan API anahtarının veya erişim belirtecinin kimlik doğrulaması için kullanılabileceğini gösterir.
Name | Tür | Description |
---|---|---|
aadAuthFailureMode |
Bir arama hizmetinin veri düzlemi API'sinin kimlik doğrulaması başarısız olan istekler için göndereceği yanıtı açıklar. |
DataPlaneAuthOptions
Arama hizmetinin bir veri düzlemi isteğinin kimliğini doğrulama seçeneklerini tanımlar. 'disableLocalAuth' true olarak ayarlandıysa bu ayarlanamaz.
Name | Tür | Description |
---|---|---|
aadOrApiKey |
Microsoft Entra ID kiracıdan alınan API anahtarının veya erişim belirtecinin kimlik doğrulaması için kullanılabileceğini gösterir. |
|
apiKeyOnly |
Kimlik doğrulaması için yalnızca API anahtarının kullanılabileceğini gösterir. |
EncryptionWithCmk
Arama hizmetindeki kaynakların müşteri tarafından yönetilen anahtarlarla nasıl şifreleneceğini belirleyen bir ilkeyi açıklar.
Name | Tür | Description |
---|---|---|
encryptionComplianceStatus |
CMK ile şifrelenmemiş nesnelere göre arama hizmeti uyumluluğunun durumunu döndürür. Bir hizmetin birden fazla şifrelenmemiş nesnesi varsa ve zorlama etkinse, hizmet uyumsuz olarak işaretlenir. |
|
enforcement |
Bir arama hizmetinin müşteri tarafından yönetilen anahtarla şifrelenmemiş nesneler bulması durumunda uyumluluğu nasıl zorunlu kılması gerektiğini açıklar. |
HostingMode
Yalnızca standard3 SKU için geçerlidir. Bu özelliği, 1000'e kadar dizine izin veren en fazla 3 yüksek yoğunluklu bölümü etkinleştirecek şekilde ayarlayabilirsiniz; bu, diğer SKU'lar için izin verilen en yüksek dizinden çok daha yüksektir. Standard3 SKU'su için değer 'default' veya 'highDensity' şeklindedir. Diğer tüm SKU'lar için bu değer 'varsayılan' olmalıdır.
Name | Tür | Description |
---|---|---|
default |
string |
Dizin sayısı sınırı, SKU'nun varsayılan sınırlarına göre belirlenir. |
highDensity |
string |
Yalnızca arama hizmetinin en fazla 1000 dizine sahip olabileceği standard3 SKU'su için uygulama. |
Identity
Arama hizmeti kimliği hakkındaki ayrıntılar. Null değer, arama hizmetinin atanmış bir kimliği olmadığını gösterir.
Name | Tür | Description |
---|---|---|
principalId |
string |
Arama hizmetinin sistem tarafından atanan kimliğinin asıl kimliği. |
tenantId |
string |
Arama hizmetinin sistem tarafından atanan kimliğinin kiracı kimliği. |
type |
Kaynak için kullanılan kimlik türü. 'SystemAssigned, UserAssigned' türü hem sistem tarafından oluşturulan bir kimliği hem de kullanıcı tarafından atanan bir kimlik kümesini içerir. 'Hiçbiri' türü hizmetten tüm kimlikleri kaldırır. |
|
userAssignedIdentities |
<string,
User |
Kaynakla ilişkili kullanıcı kimliklerinin listesi. Kullanıcı kimliği sözlüğü anahtar başvuruları şu formda ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
IdentityType
Kaynak için kullanılan kimlik türü. 'SystemAssigned, UserAssigned' türü hem sistem tarafından oluşturulan bir kimliği hem de kullanıcı tarafından atanan bir kimlik kümesini içerir. 'Hiçbiri' türü hizmetten tüm kimlikleri kaldırır.
Name | Tür | Description |
---|---|---|
None |
string |
Arama hizmetiyle ilişkili tüm kimliklerin kaldırılması gerektiğini gösterir. |
SystemAssigned |
string |
Arama hizmeti için sistem tarafından atanan kimliğin etkinleştirileceğini gösterir. |
SystemAssigned, UserAssigned |
string |
Arama hizmeti için sistem tarafından atanan kimliğin, bir veya daha fazla kullanıcı tarafından atanan kimlik atamasıyla birlikte etkinleştirileceğini gösterir. |
UserAssigned |
string |
Kullanıcı tarafından atanan bir veya daha fazla kimliğin arama hizmetine atanacağını gösterir. |
IpRule
Azure AI Arama hizmeti IP kısıtlama kuralı.
Name | Tür | Description |
---|---|---|
value |
string |
Tek bir IPv4 adresine (örneğin, 123.1.2.3) veya CIDR biçiminde bir IP aralığına (örneğin, 123.1.2.3/24) karşılık gelen değere izin verilir. |
NetworkRuleSet
Azure AI Arama hizmeti nasıl ulaşabileceğini belirleyen ağa özgü kurallar.
Name | Tür | Description |
---|---|---|
bypass |
'ipRules' bölümünde tanımlanan kuralları atlayan gelen trafiğin olası çıkış noktaları. |
|
ipRules |
Ip |
Arama hizmeti uç noktasına erişim izni veren gelen ağlarını tanımlayan IP kısıtlama kurallarının listesi. Bu arada, diğer tüm genel IP ağları güvenlik duvarı tarafından engellenir. Bu kısıtlama kuralları yalnızca arama hizmetinin 'publicNetworkAccess' değeri 'etkin' olduğunda uygulanır; aksi takdirde, genel arabirim üzerinden trafiğe genel IP kurallarıyla bile izin verilmez ve özel uç nokta bağlantıları özel erişim yöntemi olacaktır. |
PrivateEndpoint
Microsoft.Network sağlayıcısından özel uç nokta kaynağı.
Name | Tür | Description |
---|---|---|
id |
string |
Microsoft.Network sağlayıcısından gelen özel uç nokta kaynağının kaynak kimliği. |
PrivateEndpointConnection
Azure AI Arama hizmeti mevcut özel uç nokta bağlantısını açıklar.
Name | Tür | Description |
---|---|---|
id |
string |
Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Kaynağın adı |
properties |
Azure AI Arama hizmeti mevcut özel uç nokta bağlantısının özelliklerini açıklar. |
|
type |
string |
Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts" |
PrivateEndpointConnectionProperties
Arama hizmetine var olan bir özel uç nokta bağlantısının özelliklerini açıklar.
Name | Tür | Description |
---|---|---|
groupId |
string |
Özel bağlantı hizmetinin ait olduğu Azure kaynağının grup kimliği. |
privateEndpoint |
Microsoft.Network sağlayıcısından özel uç nokta kaynağı. |
|
privateLinkServiceConnectionState |
Özel uç noktaya var olan bir Azure Özel Bağlantı hizmeti bağlantısının geçerli durumunu açıklar. |
|
provisioningState |
Özel bağlantı hizmeti bağlantısının sağlama durumu. Geçerli değerler Güncelleştirme, Silme, Başarısız, Başarılı, Tamamlanmadı veya İptal Edildi değerleridir. |
PrivateLinkServiceConnectionProvisioningState
Özel bağlantı hizmeti bağlantısının sağlama durumu. Geçerli değerler Güncelleştirme, Silme, Başarısız, Başarılı, Tamamlanmadı veya İptal Edildi değerleridir.
Name | Tür | Description |
---|---|---|
Canceled |
string |
Özel bağlantı hizmeti bağlantı kaynağı için sağlama isteği iptal edildi. |
Deleting |
string |
Özel bağlantı hizmeti bağlantısı siliniyor. |
Failed |
string |
Özel bağlantı hizmeti bağlantısı sağlanamadı veya silinemedi. |
Incomplete |
string |
Özel bağlantı hizmeti bağlantı kaynağı için sağlama isteği kabul edildi, ancak oluşturma işlemi henüz başlamadı. |
Succeeded |
string |
Özel bağlantı hizmeti bağlantısı sağlamayı tamamladı ve onay için hazır. |
Updating |
string |
Özel bağlantı hizmeti bağlantısı, tamamen işlevsel olması için diğer kaynaklarla birlikte oluşturulma sürecindedir. |
PrivateLinkServiceConnectionState
Özel uç noktaya var olan bir Azure Özel Bağlantı hizmeti bağlantısının geçerli durumunu açıklar.
Name | Tür | Default value | Description |
---|---|---|---|
actionsRequired |
string |
None |
Gerekli olabilecek ek eylemlerin açıklaması. |
description |
string |
Özel bağlantı hizmeti bağlantı durumunun açıklaması. |
|
status |
Özel bağlantı hizmeti bağlantısının durumu. Geçerli değerler Beklemede, Onaylandı, Reddedildi veya Bağlantısı Kesildi şeklindedir. |
PrivateLinkServiceConnectionStatus
Özel bağlantı hizmeti bağlantısının durumu. Geçerli değerler Beklemede, Onaylandı, Reddedildi veya Bağlantısı Kesildi şeklindedir.
Name | Tür | Description |
---|---|---|
Approved |
string |
Özel uç nokta bağlantısı onaylandı ve kullanıma hazır. |
Disconnected |
string |
Özel uç nokta bağlantısı hizmetten kaldırıldı. |
Pending |
string |
Özel uç nokta bağlantısı oluşturuldu ve onay bekliyor. |
Rejected |
string |
Özel uç nokta bağlantısı reddedildi ve kullanılamaz. |
ProvisioningState
Arama hizmetinde gerçekleştirilen son sağlama işleminin durumu. Sağlama, hizmet kapasitesi oluşturulurken oluşan bir ara durumdur. Kapasite ayarlandıktan sonra provisioningState değeri 'başarılı' veya 'başarısız' olarak değişir. İstemci uygulamaları, bir işlemin ne zaman tamamlandığını görmek için Arama Hizmetini Al işlemini kullanarak sağlama durumunu yoklayabilir (önerilen yoklama aralığı 30 saniyeden bir dakikaya kadardır). Ücretsiz hizmeti kullanıyorsanız, bu değer arama hizmeti oluşturma çağrısında 'başarılı' olarak geri dönme eğilimindedir. Bunun nedeni, ücretsiz hizmetin zaten ayarlanmış kapasiteyi kullanmasıdır.
Name | Tür | Description |
---|---|---|
failed |
string |
Son sağlama işlemi başarısız oldu. |
provisioning |
string |
Arama hizmeti sağlanıyor veya ölçeği artırılıyor veya azaltılıyor. |
succeeded |
string |
Son sağlama işlemi başarıyla tamamlandı. |
PublicNetworkAccess
Mevcut müşteri kaynaklarında ve şablonlarında hataya neden olan değişiklikleri önlemek için bu değer 'etkin' olarak ayarlanabilir. 'Devre dışı' olarak ayarlanırsa, ortak arabirim üzerinden trafiğe izin verilmez ve özel uç nokta bağlantıları özel erişim yöntemi olacaktır.
Name | Tür | Description |
---|---|---|
disabled |
string |
Arama hizmetine genel İnternet'ten kaynaklanan trafikten erişilemiyor. Erişime yalnızca onaylanan özel uç nokta bağlantıları üzerinden izin verilir. |
enabled |
string |
Arama hizmetine genel İnternet'ten kaynaklanan trafikten erişilebilir. |
SearchBypass
'ipRules' bölümünde tanımlanan kuralları atlayan gelen trafiğin olası çıkış noktaları.
Name | Tür | Description |
---|---|---|
AzurePortal |
string |
Azure portal kaynaklı isteklerin 'ipRules' bölümünde tanımlanan kuralları atlayabileceğinizi gösterir. |
None |
string |
Hiçbir kaynağın 'ipRules' bölümünde tanımlanan kuralları atlayağını gösterir. Bu varsayılan seçenektir. |
SearchDisabledDataExfiltrationOption
Arama hizmeti için açıkça izin verilmeyen veri sızdırma senaryolarının listesi. Şu anda desteklenen tek değer ,gelecekte daha ayrıntılı denetimlerle tüm olası veri dışarı aktarma senaryolarını devre dışı bırakmak için 'Tümü' değeridir.
Name | Tür | Description |
---|---|---|
All |
string |
Tüm veri sızdırma senaryolarının devre dışı bırakıldığını gösterir. |
SearchEncryptionComplianceStatus
CMK ile şifrelenmemiş nesnelere göre arama hizmeti uyumluluğunun durumunu döndürür. Bir hizmetin birden fazla şifrelenmemiş nesnesi varsa ve zorlama etkinse, hizmet uyumsuz olarak işaretlenir.
Name | Tür | Description |
---|---|---|
Compliant |
string |
CMK ile şifrelenmeyen nesnelerin sayısı sıfır olduğundan veya zorlama devre dışı bırakıldığından, arama hizmetinin uyumlu olduğunu gösterir. |
NonCompliant |
string |
Arama hizmetinin birden fazla CMK ile şifrelenmemiş nesnesi olduğunu gösterir. |
SearchEncryptionWithCmk
Bir arama hizmetinin müşteri tarafından yönetilen anahtarla şifrelenmemiş nesneler bulması durumunda uyumluluğu nasıl zorunlu kılması gerektiğini açıklar.
Name | Tür | Description |
---|---|---|
Disabled |
string |
Müşteri tarafından yönetilen anahtar şifrelemesi uygulanmaz. Yalnızca yerleşik hizmet tarafından yönetilen şifreleme kullanılır. |
Enabled |
string |
Arama hizmeti, bir veya daha fazla nesne müşteri tarafından yönetilen bir anahtarla şifrelenmemişse uyumsuz olarak işaretlenir. |
Unspecified |
string |
Zorlama ilkesi açıkça belirtilmemiştir ve davranış 'Devre Dışı' olarak ayarlanmış gibi olur. |
SearchSemanticSearch
Anlamsal aramanın kullanılabilirliğini denetleyebilen seçenekleri ayarlar. Bu yapılandırma yalnızca belirli konumlardaki belirli Azure AI Arama SKU'ları için mümkündür.
Name | Tür | Description |
---|---|---|
disabled |
string |
Anlamsal yeniden sıralamanın arama hizmeti için devre dışı bırakıldığını gösterir. Bu varsayılan seçenektir. |
free |
string |
Bir arama hizmetinde anlamsal yeniden sıralamayı etkinleştirir ve ücretsiz planın sınırları içinde kullanılacağını belirtir. Ücretsiz plan, anlamsal derecelendirme isteklerinin hacmini kapsayacak ve ek ücret ödemeden sunulur. Bu, yeni sağlanan arama hizmetleri için varsayılan değerdir. |
standard |
string |
Daha yüksek aktarım hızına ve anlamsal olarak yeniden kaydedilen sorgu hacmine sahip, faturalanabilir bir özellik olarak arama hizmetinde anlamsal yeniden düzenlemeyi etkinleştirir. |
SearchService
Azure AI Arama hizmeti ve geçerli durumunu açıklar.
Name | Tür | Default value | Description |
---|---|---|---|
id |
string |
Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
|
identity |
Kaynağın kimliği. |
||
location |
string |
Kaynağın bulunduğu coğrafi konum |
|
name |
string |
Kaynağın adı |
|
properties.authOptions |
Arama hizmetinin veri düzlemi API'sinin isteklerin kimliğini doğrulama seçeneklerini tanımlar. 'disableLocalAuth' true olarak ayarlandıysa bu ayarlanamaz. |
||
properties.disableLocalAuth |
boolean |
true olarak ayarlandığında, arama hizmetine yapılan çağrıların kimlik doğrulaması için API anahtarlarını kullanmasına izin verilmez. 'dataPlaneAuthOptions' tanımlanmışsa bu true olarak ayarlanamaz. |
|
properties.disabledDataExfiltrationOptions |
Arama hizmeti için açıkça izin verilmeyen veri sızdırma senaryolarının listesi. Şu anda desteklenen tek değer ,gelecekte daha ayrıntılı denetimlerle tüm olası veri dışarı aktarma senaryolarını devre dışı bırakmak için 'Tümü' değeridir. |
||
properties.eTag |
string |
Güncelleştirmeler sırasında iyimser eşzamanlılık denetimi için olabilecek hizmetin etag'ini temsil eden sistem tarafından oluşturulan özellik. |
|
properties.encryptionWithCmk |
Arama hizmetindeki customer manager anahtarlarını kullanarak kaynakların (dizinler gibi) şifrelenmesiyle ilgili tüm ilkeleri belirtir. |
||
properties.hostingMode | default |
Yalnızca standard3 SKU için geçerlidir. Bu özelliği, 1000'e kadar dizine izin veren en fazla 3 yüksek yoğunluklu bölümü etkinleştirecek şekilde ayarlayabilirsiniz; bu, diğer SKU'lar için izin verilen en yüksek dizinden çok daha yüksektir. Standard3 SKU'su için değer 'default' veya 'highDensity' şeklindedir. Diğer tüm SKU'lar için bu değer 'varsayılan' olmalıdır. |
|
properties.networkRuleSet |
Azure AI Arama hizmeti nasıl ulaşabileceğini belirleyen ağa özgü kurallar. |
||
properties.partitionCount |
integer |
1 |
Arama hizmetindeki bölüm sayısı; belirtilirse, 1, 2, 3, 4, 6 veya 12 olabilir. 1'den büyük değerler yalnızca standart SKU'lar için geçerlidir. hostingMode 'highDensity' olarak ayarlanmış 'standard3' hizmetleri için izin verilen değerler 1 ile 3 arasındadır. |
properties.privateEndpointConnections |
Azure yapay zeka Arama hizmeti özel uç nokta bağlantılarının listesi. |
||
properties.provisioningState |
Arama hizmetinde gerçekleştirilen son sağlama işleminin durumu. Sağlama, hizmet kapasitesi oluşturulurken oluşan bir ara durumdur. Kapasite ayarlandıktan sonra provisioningState değeri 'başarılı' veya 'başarısız' olarak değişir. İstemci uygulamaları, bir işlemin ne zaman tamamlandığını görmek için Arama Hizmetini Al işlemini kullanarak sağlama durumunu yoklayabilir (önerilen yoklama aralığı 30 saniyeden bir dakikaya kadardır). Ücretsiz hizmeti kullanıyorsanız, bu değer doğrudan Arama hizmeti oluşturma çağrısında 'başarılı' olarak geri dönme eğilimindedir. Bunun nedeni, ücretsiz hizmetin zaten ayarlanmış kapasiteyi kullanmasıdır. |
||
properties.publicNetworkAccess | enabled |
Mevcut müşteri kaynaklarında ve şablonlarında hataya neden olan değişiklikleri önlemek için bu değer 'etkin' olarak ayarlanabilir. 'Devre dışı' olarak ayarlanırsa, ortak arabirim üzerinden trafiğe izin verilmez ve özel uç nokta bağlantıları özel erişim yöntemi olacaktır. |
|
properties.replicaCount |
integer |
1 |
Arama hizmetindeki çoğaltma sayısı. Belirtilirse, standart SKU'lar için 1 ile 12 arasında (bunlar dahil) veya temel SKU'lar için 1 ile 3 arasında bir değer olmalıdır. |
properties.semanticSearch |
Anlamsal aramanın kullanılabilirliğini denetleye seçenekleri ayarlar. Bu yapılandırma yalnızca belirli konumlardaki belirli Azure AI Arama SKU'ları için mümkündür. |
||
properties.sharedPrivateLinkResources |
Azure AI Arama hizmeti tarafından yönetilen paylaşılan özel bağlantı kaynaklarının listesi. |
||
properties.status |
Arama hizmetinin durumu. Olası değerler şunlardır: 'running': Arama hizmeti çalışıyor ve sağlama işlemleri devam ediyor. 'sağlama': Arama hizmeti sağlanıyor veya ölçeği artırılıyor veya azaltılıyor. 'silme': Arama hizmeti siliniyor. 'Düzeyi düşürüldü': Arama hizmetinin düzeyi düşürüldü. Temel alınan arama birimleri iyi durumda olmadığında bu durum oluşabilir. Arama hizmeti büyük olasılıkla çalışır durumdadır, ancak performans yavaş olabilir ve bazı istekler bırakılabilir. 'devre dışı': Arama hizmeti devre dışı bırakıldı. Bu durumda hizmet tüm API isteklerini reddeder. 'error': Arama hizmeti bir hata durumunda. 'durduruldu': Arama hizmeti devre dışı bırakılmış bir abonelikte. Hizmetiniz düzeyi düşürülmüş, devre dışı bırakılmış veya hata durumlarındaysa Bu, Azure AI Search ekibinin temel sorunu etkin bir şekilde araştırdığını gösterir. Bu durumlardaki ayrılmış hizmetler, sağlanan arama birimi sayısına bağlı olarak ücretlendirilebilir. |
||
properties.statusDetails |
string |
Arama hizmeti durumunun ayrıntıları. |
|
sku |
Fiyat katmanını ve kapasite sınırlarını belirleyen arama hizmetinin SKU'su. Yeni bir arama hizmeti oluşturulurken bu özellik gereklidir. |
||
tags |
object |
Kaynak etiketleri. |
|
type |
string |
Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts" |
SearchServiceStatus
Arama hizmetinin durumu. Olası değerler şunlardır: 'running': Arama hizmeti çalışıyor ve sağlama işlemleri devam ediyor. 'sağlama': Arama hizmeti sağlanıyor veya ölçeği artırılıyor veya azaltılıyor. 'silme': Arama hizmeti siliniyor. 'Düzeyi düşürüldü': Arama hizmetinin düzeyi düşürüldü. Temel alınan arama birimleri iyi durumda olmadığında bu durum oluşabilir. Arama hizmeti büyük olasılıkla çalışır durumdadır, ancak performans yavaş olabilir ve bazı istekler bırakılabilir. 'devre dışı': Arama hizmeti devre dışı bırakıldı. Bu durumda hizmet tüm API isteklerini reddeder. 'error': Arama hizmeti bir hata durumunda. 'durduruldu': Arama hizmeti devre dışı bırakılmış bir abonelikte. Hizmetiniz düzeyi düşürülmüş, devre dışı bırakılmış veya hata durumlarındaysa Bu, Azure AI Search ekibinin temel sorunu etkin bir şekilde araştırdığını gösterir. Bu durumlardaki ayrılmış hizmetler, sağlanan arama birimi sayısına bağlı olarak ücretlendirilebilir.
Name | Tür | Description |
---|---|---|
degraded |
string |
Temel alınan arama birimleri iyi durumda olmadığından arama hizmetinin düzeyi düşürüldü. |
deleting |
string |
Arama hizmeti siliniyor. |
disabled |
string |
Arama hizmeti devre dışı bırakılır ve tüm API istekleri reddedilir. |
error |
string |
Arama hizmeti hata durumundadır ve sağlama veya silme işleminin başarısız olduğunu gösterir. |
provisioning |
string |
Arama hizmeti sağlanıyor veya ölçeği artırılıyor veya azaltılıyor. |
running |
string |
Arama hizmeti çalışıyor ve sağlama işlemleri devam ediyor. |
stopped |
string |
Arama hizmeti devre dışı bırakılmış bir aboneliktedir. |
SharedPrivateLinkResource
Azure AI Arama hizmeti tarafından yönetilen paylaşılan bir özel bağlantı kaynağını açıklar.
Name | Tür | Description |
---|---|---|
id |
string |
Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Kaynağın adı |
properties |
Azure AI Arama hizmeti tarafından yönetilen paylaşılan özel bağlantı kaynağının özelliklerini açıklar. |
|
type |
string |
Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts" |
SharedPrivateLinkResourceProperties
Azure AI Arama hizmeti tarafından yönetilen mevcut bir paylaşılan özel bağlantı kaynağının özelliklerini açıklar.
Name | Tür | Description |
---|---|---|
groupId |
string |
Paylaşılan özel bağlantı kaynağının ait olduğu kaynak sağlayıcısının grup kimliği. |
privateLinkResourceId |
string |
Paylaşılan özel bağlantı kaynağının kaynak kimliği. |
provisioningState |
Paylaşılan özel bağlantı kaynağının sağlama durumu. Geçerli değerler Güncelleştirme, Silme, Başarısız, Başarılı veya Tamamlanmadı değerleridir. |
|
requestMessage |
string |
Paylaşılan özel bağlantı kaynağının onaylanmasını isteme iletisi. |
resourceRegion |
string |
İsteğe bağlı. Paylaşılan özel bağlantının oluşturulduğu kaynağın Azure Resource Manager konumunu belirtmek için kullanılabilir. Bu yalnızca DNS yapılandırması bölgesel olan (Azure Kubernetes Service gibi) kaynaklar için gereklidir. |
status |
Paylaşılan özel bağlantı kaynağının durumu. Geçerli değerler Beklemede, Onaylandı, Reddedildi veya Bağlantısı Kesildi. |
SharedPrivateLinkResourceProvisioningState
Paylaşılan özel bağlantı kaynağının sağlama durumu. Geçerli değerler Güncelleştirme, Silme, Başarısız, Başarılı veya Tamamlanmadı değerleridir.
Name | Tür | Description |
---|---|---|
Deleting |
string |
Paylaşılan özel bağlantı kaynağı silinme aşamasındadır. |
Failed |
string |
Paylaşılan özel bağlantı kaynağı sağlanamadı veya silinemedi. |
Incomplete |
string |
Paylaşılan özel bağlantı kaynağı için sağlama isteği kabul edildi, ancak oluşturma işlemi henüz başlamadı. |
Succeeded |
string |
Paylaşılan özel bağlantı kaynağı sağlamayı tamamladı ve onay için hazır. |
Updating |
string |
Paylaşılan özel bağlantı kaynağı, tamamen işlevsel olması için diğer kaynaklarla birlikte oluşturulma sürecindedir. |
SharedPrivateLinkResourceStatus
Paylaşılan özel bağlantı kaynağının durumu. Geçerli değerler Beklemede, Onaylandı, Reddedildi veya Bağlantısı Kesildi şeklindedir.
Name | Tür | Description |
---|---|---|
Approved |
string |
Paylaşılan özel bağlantı kaynağı onaylandı ve kullanıma hazır. |
Disconnected |
string |
Paylaşılan özel bağlantı kaynağı hizmetten kaldırıldı. |
Pending |
string |
Paylaşılan özel bağlantı kaynağı oluşturuldu ve onay bekliyor. |
Rejected |
string |
Paylaşılan özel bağlantı kaynağı reddedildi ve kullanılamaz. |
Sku
Faturalama oranını ve kapasite sınırlarını belirleyen arama hizmetinin SKU'sunu tanımlar.
Name | Tür | Description |
---|---|---|
name |
Arama hizmetinin SKU'su. Geçerli değerler şunlardır: 'free': Paylaşılan hizmet. 'basic': En fazla 3 çoğaltması olan ayrılmış hizmet. 'standart': En fazla 12 bölüm ve 12 çoğaltma ile ayrılmış hizmet. 'standard2': Standartla benzer, ancak arama birimi başına daha fazla kapasiteye sahiptir. 'standard3': 12 bölüme ve 12 çoğaltmaya (veya hostingMode özelliğini 'highDensity' olarak ayarladıysanız daha fazla dizin içeren en fazla 3 bölüme) sahip en büyük Standart teklif. 'storage_optimized_l1': Bölüm başına 12 bölüme kadar 1 TB destekler. 'storage_optimized_l2': Bölüm başına en fazla 12 bölüm olmak üzere 2 TB destekler.' |
SkuName
Arama hizmetinin SKU'su. Geçerli değerler şunlardır: 'free': Paylaşılan hizmet. 'basic': En fazla 3 çoğaltması olan ayrılmış hizmet. 'standart': En fazla 12 bölüm ve 12 çoğaltma ile ayrılmış hizmet. 'standard2': Standartla benzer, ancak arama birimi başına daha fazla kapasiteye sahiptir. 'standard3': 12 bölüme ve 12 çoğaltmaya (veya hostingMode özelliğini 'highDensity' olarak ayarladıysanız daha fazla dizin içeren en fazla 3 bölüme) sahip en büyük Standart teklif. 'storage_optimized_l1': Bölüm başına 12 bölüme kadar 1 TB destekler. 'storage_optimized_l2': Bölüm başına en fazla 12 bölüm olmak üzere 2 TB destekler.'
Name | Tür | Description |
---|---|---|
basic |
string |
En fazla 3 çoğaltmaya sahip ayrılmış bir hizmet için faturalanabilir katman. |
free |
string |
Ücretsiz katman, SLA garantisi olmadan ve faturalanabilir katmanlarda sunulan özelliklerin bir alt kümesiyle. |
standard |
string |
En fazla 12 bölüme ve 12 çoğaltmaya sahip ayrılmış bir hizmet için faturalanabilir katman. |
standard2 |
string |
'Standart'a benzer, ancak arama birimi başına daha fazla kapasiteye sahiptir. |
standard3 |
string |
12 bölüme ve 12 çoğaltmaya (veya hostingMode özelliğini 'highDensity' olarak ayarladıysanız daha fazla dizine sahip en fazla 3 bölüme) sahip en büyük Standart teklif. |
storage_optimized_l1 |
string |
Bölüm başına 12 bölüme kadar 1 TB destekleyen ayrılmış bir hizmet için faturalanabilir katman. |
storage_optimized_l2 |
string |
Bölüm başına en fazla 12 bölüm olmak üzere 2 TB destekleyen ayrılmış bir hizmet için faturalanabilir katman. |
UserAssignedManagedIdentity
Arama hizmetine atanan kullanıcı tarafından atanan yönetilen kimliğin ayrıntıları.
Name | Tür | Description |
---|---|---|
clientId |
string |
Kullanıcı tarafından atanan kimliğin istemci kimliği. |
principalId |
string |
Kullanıcı tarafından atanan kimliğin asıl kimliği. |