Aracılığıyla paylaş

Services - Update

  • Başvuru
Hizmet:
Search Management
API Sürümü:
2024-03-01-preview

Verilen kaynak grubunda var olan bir arama hizmetini Güncelleştirmeler.

PATCH 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
resourceGroupName
 path True

string

Geçerli abonelik içindeki kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.
searchServiceName
 path True

string

Güncelleştirilecek Azure AI Arama hizmeti adı.
subscriptionId
 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 Tür Description
identity

Identity

Arama hizmeti kimliği hakkındaki ayrıntılar. Null değer, arama hizmetinin atanmış bir kimliği olmadığını gösterir.
location

string

Kaynağın coğrafi konumu. Bu, desteklenen ve kayıtlı Azure coğrafi bölgelerinden biri olmalıdır (örneğin, Batı ABD, Doğu ABD, Güneydoğu Asya vb.). Yeni bir kaynak oluşturulurken bu özellik gereklidir.
properties.authOptions

DataPlaneAuthOptions

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

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ü'dür.
properties.encryptionWithCmk

EncryptionWithCmk

Bir arama hizmeti içindeki customer manager anahtarlarını kullanarak kaynakların (dizinler gibi) şifrelenmesiyle ilgili tüm ilkeleri belirtir.
properties.hostingMode

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

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

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

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.
sku

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

Azure portal kaynağı kategorilere ayırmaya yardımcı olacak etiketler.

Yanıtlar

Name Tür Description
200 OK

SearchService

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.
Other Status Codes

CloudError

HTTP 400 (Hatalı İstek): Verilen hizmet tanımı geçersiz veya sabit bir özelliği değiştirmeye çalıştınız. 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

SearchUpdateService
SearchUpdateServiceAuthOptions
SearchUpdateServiceDisableLocalAuth
SearchUpdateServiceToAllowAccessFromPrivateEndpoints
SearchUpdateServiceToAllowAccessFromPublicCustomIPs
SearchUpdateServiceToAllowAccessFromPublicCustomIPsAndBypass
SearchUpdateServiceToRemoveIdentity
SearchUpdateServiceWithCmkEnforcement
SearchUpdateServiceWithDataExfiltration
SearchUpdateServiceWithSemanticSearch

SearchUpdateService

Örnek isteği

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview

{
  "tags": {
    "app-name": "My e-commerce app",
    "new-tag": "Adding a new tag"
  },
  "properties": {
    "replicaCount": 2
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "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",
    "new-tag": "Adding a new tag"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 2,
    "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": []
  }
}

SearchUpdateServiceAuthOptions

Örnek isteği

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview

{
  "tags": {
    "app-name": "My e-commerce app",
    "new-tag": "Adding a new tag"
  },
  "properties": {
    "replicaCount": 2,
    "authOptions": {
      "aadOrApiKey": {
        "aadAuthFailureMode": "http401WithBearerChallenge"
      }
    }
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "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",
    "new-tag": "Adding a new tag"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 2,
    "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": []
  }
}

SearchUpdateServiceDisableLocalAuth

Örnek isteği

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview

{
  "tags": {
    "app-name": "My e-commerce app",
    "new-tag": "Adding a new tag"
  },
  "properties": {
    "replicaCount": 2,
    "disableLocalAuth": true
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "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",
    "new-tag": "Adding a new tag"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 2,
    "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": []
  }
}

SearchUpdateServiceToAllowAccessFromPrivateEndpoints

Örnek isteği

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview

{
  "properties": {
    "replicaCount": 1,
    "partitionCount": 1,
    "publicNetworkAccess": "disabled"
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "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",
    "new-tag": "Adding a new tag"
  },
  "sku": {
    "name": "basic"
  },
  "properties": {
    "replicaCount": 1,
    "partitionCount": 1,
    "status": "running",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "succeeded",
    "publicNetworkAccess": "disabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": []
  }
}

SearchUpdateServiceToAllowAccessFromPublicCustomIPs

Örnek isteği

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview

{
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ]
    }
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "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",
    "new-tag": "Adding a new tag"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "status": "running",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "succeeded",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "10.2.3.4"
        }
      ]
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": []
  }
}

SearchUpdateServiceToAllowAccessFromPublicCustomIPsAndBypass

Örnek isteği

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview

{
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ],
      "bypass": "AzurePortal"
    }
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "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",
    "new-tag": "Adding a new tag"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "status": "running",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "succeeded",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "10.2.3.4"
        }
      ],
      "bypass": "AzurePortal"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": []
  }
}

SearchUpdateServiceToRemoveIdentity

Örnek isteği

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview

{
  "sku": {
    "name": "standard"
  },
  "identity": {
    "type": "None"
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {},
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "status": "running",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "succeeded",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "disabledDataExfiltrationOptions": []
  }
}

SearchUpdateServiceWithCmkEnforcement

Örnek isteği

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview

{
  "tags": {
    "app-name": "My e-commerce app",
    "new-tag": "Adding a new tag"
  },
  "properties": {
    "replicaCount": 2,
    "encryptionWithCmk": {
      "enforcement": "Enabled"
    }
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "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",
    "new-tag": "Adding a new tag"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 2,
    "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": []
  }
}

SearchUpdateServiceWithDataExfiltration

Örnek isteği

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview

{
  "tags": {
    "app-name": "My e-commerce app",
    "new-tag": "Adding a new tag"
  },
  "properties": {
    "replicaCount": 2,
    "disabledDataExfiltrationOptions": [
      "All"
    ]
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "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",
    "new-tag": "Adding a new tag"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 2,
    "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"
    ]
  }
}

SearchUpdateServiceWithSemanticSearch

Örnek isteği

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2024-03-01-preview

{
  "tags": {
    "app-name": "My e-commerce app",
    "new-tag": "Adding a new tag"
  },
  "properties": {
    "replicaCount": 2,
    "semanticSearch": "standard"
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "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",
    "new-tag": "Adding a new tag"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 2,
    "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": "standard"
  }
}

Tanımlar

Name Description
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.
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.
CloudErrorBody

Hata kodu ve ileti içeren belirli bir API hatası açıklanır.
DataPlaneAadOrApiKeyAuthOption

Kimlik doğrulaması için API anahtarının veya Microsoft Entra ID kiracıdaki bir erişim belirtecinin kullanılabileceğini gösterir.
DataPlaneAuthOptions

Arama hizmetinin bir veri düzlemi isteğinin kimliğini doğrulama seçeneklerini tanımlar. 'disableLocalAuth' true olarak ayarlandıysa bu ayarlanamaz.
EncryptionWithCmk

Arama hizmeti içindeki kaynakların müşteri tarafından yönetilen anahtarlarla nasıl şifreleneceğini belirleyen bir ilkeyi açıklar.
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.
Identity

Arama hizmeti kimliği hakkındaki ayrıntılar. Null değer, arama hizmetinin atanmış bir kimliği olmadığını gösterir.
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.
IpRule

Azure AI Arama hizmeti IP kısıtlama kuralı.
NetworkRuleSet

Azure yapay zeka Arama hizmeti nasıl ulaşabileceğini belirleyen ağa özgü kurallar.
PrivateEndpoint

Microsoft.Network sağlayıcısından özel uç nokta kaynağı.
PrivateEndpointConnection

Azure AI Arama hizmeti var olan bir özel uç nokta bağlantısını açıklar.
PrivateEndpointConnectionProperties

Arama hizmetine var olan bir özel uç nokta bağlantısının özelliklerini açıklar.
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.
PrivateLinkServiceConnectionState

Özel uç noktaya var olan bir Azure Özel Bağlantı hizmeti bağlantısının geçerli durumunu açıklar.
PrivateLinkServiceConnectionStatus

Özel bağlantı hizmeti bağlantısının durumu. Geçerli değerler Beklemede, Onaylandı, Reddedildi veya Bağlantısı Kesildi şeklindedir.
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.
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.
SearchBypass

'ipRules' bölümünde tanımlanan kuralları atlayan gelen trafiğin olası çıkış noktaları.
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ü'dür.
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 etkinleştirildiyse, hizmet uyumsuz olarak işaretlenir.
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.
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.
SearchService

Azure AI Arama hizmeti ve geçerli durumunu açıklar.
SearchServiceStatus

Arama hizmetinin durumu. Olası değerler şunlardır: 'çalışıyor': Arama hizmeti çalışıyor ve hiçbir sağlama işlemi 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. 'disabled': 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 göre ücretlendirilebilir.
SearchServiceUpdate

Azure AI Arama hizmeti güncelleştirmek için kullanılan parametreler.
SharedPrivateLinkResource

Azure AI Arama hizmeti tarafından yönetilen paylaşılan bir özel bağlantı kaynağını açıklar.
SharedPrivateLinkResourceProperties

Azure AI Arama hizmeti tarafından yönetilen mevcut paylaşılan özel bağlantı kaynağının özelliklerini açıklar.
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.
SharedPrivateLinkResourceStatus

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.
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.'
UserAssignedManagedIdentity

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

CloudErrorBody

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

CloudErrorBody[]

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

Kimlik doğrulaması için API anahtarının veya Microsoft Entra ID kiracıdaki bir erişim belirtecinin kullanılabileceğini gösterir.

Name Tür Description
aadAuthFailureMode

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.

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

DataPlaneAadOrApiKeyAuthOption

Kimlik doğrulaması için API anahtarının veya Microsoft Entra ID kiracıdaki bir erişim belirtecinin kullanılabileceğini gösterir.
apiKeyOnly

ApiKeyOnly

Kimlik doğrulaması için yalnızca API anahtarının kullanılabileceğini gösterir.

EncryptionWithCmk

Arama hizmeti içindeki kaynakların müşteri tarafından yönetilen anahtarlarla nasıl şifreleneceğini belirleyen bir ilkeyi açıklar.

Name Tür Description
encryptionComplianceStatus

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 etkinleştirildiyse, hizmet uyumsuz olarak işaretlenir.
enforcement

SearchEncryptionWithCmk

Müşteri tarafından yönetilen anahtarla şifrelenmemiş nesneler bulursa arama hizmetinin uyumluluğu nasıl zorunlu kılması gerektiğini açıklar.

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.

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 1000'e kadar dizine sahip olabileceği standart3 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

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 kimlik kümesini içerir. 'Hiçbiri' türü hizmetten tüm kimlikleri kaldırır.
userAssignedIdentities

<string,  UserAssignedManagedIdentity>

Kaynakla ilişkilendirilmiş kullanıcı kimliklerinin listesi. Kullanıcı kimliği sözlüğü anahtar başvuruları şu biçimde 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 yapay zeka Arama hizmeti nasıl ulaşabileceğini belirleyen ağa özgü kurallar.

Name Tür Description
bypass

SearchBypass

'ipRules' bölümünde tanımlanan kuralları atlayan gelen trafiğin olası çıkış noktaları.
ipRules

IpRule[]

Arama hizmeti uç noktasına erişim izni veren gelen ağları 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 olabilir.

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 var olan bir ö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

PrivateEndpointConnectionProperties

Azure AI Arama hizmeti var olan bir ö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

PrivateEndpoint

Microsoft.Network sağlayıcısından özel uç nokta kaynağı.
privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Özel uç noktaya var olan bir Azure Özel Bağlantı hizmeti bağlantısının geçerli durumunu açıklar.
provisioningState

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.

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

PrivateLinkServiceConnectionStatus

Ö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ı 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.

Name Tür Description
disabled

string

Arama hizmetine genel İnternet'ten kaynaklanan trafikten erişilemez. 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ü'dür.

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 etkinleştirildiyse, 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 belirtilmez 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

Identity

Kaynağın kimliği.
location

string

Kaynağın bulunduğu coğrafi konum
name

string

Kaynağın adı
properties.authOptions

DataPlaneAuthOptions

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

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ü'dür.
properties.eTag

string

Güncelleştirmeler sırasında iyimser eşzamanlılık denetimi için olabilecek hizmetin etiketini temsil eden sistem tarafından oluşturulan özellik.
properties.encryptionWithCmk

EncryptionWithCmk

Bir arama hizmeti içindeki customer manager anahtarlarını kullanarak kaynakların (dizinler gibi) şifrelenmesiyle ilgili tüm ilkeleri belirtir.
properties.hostingMode

HostingMode

default

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

NetworkRuleSet

Azure yapay zeka 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

PrivateEndpointConnection[]

Azure yapay zeka Arama hizmeti özel uç nokta bağlantılarının listesi.
properties.provisioningState

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.
properties.publicNetworkAccess

PublicNetworkAccess

enabled

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

1

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

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.
properties.sharedPrivateLinkResources

SharedPrivateLinkResource[]

Azure AI Arama hizmeti tarafından yönetilen paylaşılan özel bağlantı kaynaklarının listesi.
properties.status

SearchServiceStatus

Arama hizmetinin durumu. Olası değerler şunlardır: 'çalışıyor': Arama hizmeti çalışıyor ve hiçbir sağlama işlemi 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. 'disabled': 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 göre ücretlendirilebilir.
properties.statusDetails

string

Arama hizmeti durumunun ayrıntıları.
sku

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.
type

string

Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

SearchServiceStatus

Arama hizmetinin durumu. Olası değerler şunlardır: 'çalışıyor': Arama hizmeti çalışıyor ve hiçbir sağlama işlemi 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. 'disabled': 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 göre ü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 hiçbir sağlama işlemi devam ediyor.
stopped

string

Arama hizmeti devre dışı bırakılmış bir aboneliktedir.

SearchServiceUpdate

Azure AI Arama hizmeti güncelleştirmek için kullanılan parametreler.

Name Tür Default value Description
id

string

Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity

Identity

Arama hizmeti kimliği hakkındaki ayrıntılar. Null değer, arama hizmetinin atanmış bir kimliği olmadığını gösterir.
location

string

Kaynağın coğrafi konumu. Bu, desteklenen ve kayıtlı Azure coğrafi bölgelerinden biri olmalıdır (örneğin, Batı ABD, Doğu ABD, Güneydoğu Asya vb.). Yeni bir kaynak oluşturulurken bu özellik gereklidir.
name

string

Kaynağın adı
properties.authOptions

DataPlaneAuthOptions

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

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.
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

EncryptionWithCmk

Arama hizmetindeki customer manager anahtarlarını kullanarak kaynakların (dizinler gibi) şifrelenmesiyle ilgili tüm ilkeleri belirtir.
properties.hostingMode

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

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

PrivateEndpointConnection[]

Azure yapay zeka Arama hizmeti özel uç nokta bağlantılarının listesi.
properties.provisioningState

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

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

SearchSemanticSearch

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

SharedPrivateLinkResource[]

Azure AI Arama hizmeti tarafından yönetilen paylaşılan özel bağlantı kaynaklarının listesi.
properties.status

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.
properties.statusDetails

string

Arama hizmeti durumunun ayrıntıları.
sku

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

Azure portal kaynağı kategorilere ayırmaya yardımcı olacak etiketler.
type

string

Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

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

SharedPrivateLinkResourceProperties

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 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 kaynak sağlayıcısından grup kimliği.
privateLinkResourceId

string

Paylaşılan özel bağlantı kaynağının kaynak kimliği.
provisioningState

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.
requestMessage

string

Paylaşılan özel bağlantı kaynağının onayı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

SharedPrivateLinkResourceStatus

Paylaşılan özel bağlantı kaynağının durumu. Geçerli değerler Beklemede, Onaylandı, Reddedildi veya Bağlantısı Kesildi şeklindedir.

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

SkuName

Arama hizmetinin SKU'su. Geçerli değerler şunlardır: 'free': Paylaşılan hizmet. 'basic': 3 çoğaltmaya kadar ayrılmış hizmet. 'standard': En fazla 12 bölüm ve 12 çoğaltma ile ayrılmış hizmet. 'standard2': Standarta 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 dizine sahip 3 bölüme kadar) sahip en büyük Standart teklif. 'storage_optimized_l1': Bölüm başına en fazla 12 bölüm olmak üzere 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.