Services - Create Or Update

Hizmet:
Search Management
API Sürümü:
2025-05-01

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=2025-05-01

URI Parametreleri

Name İçinde Gerekli Tür Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Kaynak grubunun adı. Ad büyük/küçük harfe duyarsız.
searchServiceName
 path True

string

pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$

Belirtilen kaynak grubuyla ilişkili Azure AI Search hizmetinin adı.
subscriptionId
 path True

string (uuid)

Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version
 query True

string

minLength: 1

Bu işlem için kullanılacak API sürümü.

İstek Başlığı

Name Gerekli Tür Description
x-ms-client-request-id

string (uuid)

Bu isteği tanımlayan istemci tarafından oluşturulan BIR 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

Identity

Kaynağın kimliği.
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.computeType

ComputeType

Bu özelliği, Varsayılan İşlem veya Azure Gizli İşlem'i kullanarak arama hizmetini destekleyecek şekilde yapılandırın.
properties.dataExfiltrationProtections

SearchDataExfiltrationProtection[]

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

EncryptionWithCmk

Arama hizmetindeki müşteri yöneticisi anahtarlarını kullanarak kaynakların (dizinler gibi) şifrelenmesiyle ilgili tüm ilkeleri belirtir.
properties.endpoint

string (uri)

Azure AI Search hizmetinin uç noktası.
properties.hostingMode

HostingMode

Yalnızca standart3 SKU için geçerlidir. Bu özelliği, diğer tüm SKU'lar için izin verilen en fazla dizinden çok daha yüksek olan 1000'e kadar dizine izin veren en fazla 3 yüksek yoğunluklu bölümü etkinleştirecek şekilde ayarlayabilirsiniz. standard3 SKU'su için değer 'Varsayılan' veya 'HighDensity' olur. Diğer tüm SKU'lar için bu değer 'Varsayılan' olmalıdır.
properties.networkRuleSet

NetworkRuleSet

Azure AI Search hizmetine nasıl ulaşılabileceğini belirleyen ağa özgü kurallar.
properties.partitionCount

integer (int32)

minimum: 1
maximum: 12

Özel 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

Bu değer, mevcut müşteri kaynakları ve şablonlarında hataya neden olan değişiklikleri önlemek için '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 olur.
properties.replicaCount

integer (int32)

minimum: 1
maximum: 12

Özel arama hizmetindeki replika sayısı. Belirtilirse, standart SKU'lar için 1 ile 12 arasında veya temel SKU'lar için 1 ile 3 arasında bir değer olmalıdır.
properties.semanticSearch

SearchSemanticSearch

Azure AI Arama hizmetinde anlamsal arama için kullanılabilirlik ve faturalama planını belirtir. Bu yapılandırma yalnızca belirli bölgelerdeki fiyatlandırma katmanları için mevcuttur.
properties.upgradeAvailable

UpgradeAvailable

Arama hizmetinin kullanılabilir bir yükseltmesi olup olmadığını gösterir.
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

Kaynak etiketleri.

Yanıtlar

Name Tür Description
200 OK

SearchService

Kaynak 'SearchService' güncelleme işlemi başarılı oldu
201 Created

SearchService

Resource 'SearchService' oluşturma işlemi başarılı oldu

Üst Bilgiler

  • Location: string
  • Retry-After: integer
Other Status Codes

CloudError

Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

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
SearchCreateOrUpdateServiceAuthOptions
SearchCreateOrUpdateServiceDisableLocalAuth
SearchCreateOrUpdateServiceToAllowAccessFromPrivateEndpoints
SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPs
SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPsAndBypass
SearchCreateOrUpdateServiceWithCmkEnforcement
SearchCreateOrUpdateServiceWithDataExfiltration
SearchCreateOrUpdateServiceWithIdentity
SearchCreateOrUpdateWithSemanticSearch

SearchCreateOrUpdateService

Örnek isteği

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "properties": {
    "computeType": "Default",
    "hostingMode": "Default",
    "partitionCount": 1,
    "replicaCount": 3
  },
  "sku": {
    "name": "standard"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": {
      "apiKeyOnly": {}
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "disableLocalAuth": false,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "None",
      "ipRules": []
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 3,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}
Durum kodu:
201 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": {
      "apiKeyOnly": {}
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "disableLocalAuth": false,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "None",
      "ipRules": []
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 3,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

SearchCreateOrUpdateServiceAuthOptions

Örnek isteği

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "properties": {
    "authOptions": {
      "aadOrApiKey": {
        "aadAuthFailureMode": "http401WithBearerChallenge"
      }
    },
    "computeType": "Default",
    "hostingMode": "Default",
    "partitionCount": 1,
    "replicaCount": 3
  },
  "sku": {
    "name": "standard"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": {
      "aadOrApiKey": {
        "aadAuthFailureMode": "http401WithBearerChallenge"
      }
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "None",
      "ipRules": []
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 3,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}
Durum kodu:
201 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": {
      "aadOrApiKey": {
        "aadAuthFailureMode": "http401WithBearerChallenge"
      }
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "None",
      "ipRules": []
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 3,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

SearchCreateOrUpdateServiceDisableLocalAuth

Örnek isteği

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "properties": {
    "computeType": "Default",
    "disableLocalAuth": true,
    "hostingMode": "Default",
    "partitionCount": 1,
    "replicaCount": 3
  },
  "sku": {
    "name": "standard"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": null,
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "disableLocalAuth": true,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "None",
      "ipRules": []
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 3,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}
Durum kodu:
201 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": null,
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "disableLocalAuth": true,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "None",
      "ipRules": []
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 3,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

SearchCreateOrUpdateServiceToAllowAccessFromPrivateEndpoints

Örnek isteği

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "properties": {
    "computeType": "Default",
    "hostingMode": "Default",
    "partitionCount": 1,
    "publicNetworkAccess": "Disabled",
    "replicaCount": 3
  },
  "sku": {
    "name": "standard"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": {
      "apiKeyOnly": {}
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "disableLocalAuth": false,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "None",
      "ipRules": []
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Disabled",
    "replicaCount": 3,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}
Durum kodu:
201 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": {
      "apiKeyOnly": {}
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "disableLocalAuth": false,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "None",
      "ipRules": []
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Disabled",
    "replicaCount": 3,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPs

Örnek isteği

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "properties": {
    "computeType": "Default",
    "hostingMode": "Default",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ]
    },
    "partitionCount": 1,
    "replicaCount": 1
  },
  "sku": {
    "name": "standard"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": {
      "apiKeyOnly": {}
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "disableLocalAuth": false,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ]
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 1,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}
Durum kodu:
201 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": {
      "apiKeyOnly": {}
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "disableLocalAuth": false,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ]
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 1,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPsAndBypass

Örnek isteği

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "properties": {
    "computeType": "Default",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "AzureServices",
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ]
    },
    "partitionCount": 1,
    "replicaCount": 1
  },
  "sku": {
    "name": "standard"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": {
      "apiKeyOnly": {}
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "disableLocalAuth": false,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "AzureServices",
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ]
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 1,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}
Durum kodu:
201 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": {
      "apiKeyOnly": {}
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "disableLocalAuth": false,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "AzureServices",
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ]
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 1,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

SearchCreateOrUpdateServiceWithCmkEnforcement

Örnek isteği

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "properties": {
    "computeType": "Default",
    "encryptionWithCmk": {
      "enforcement": "Enabled"
    },
    "hostingMode": "Default",
    "partitionCount": 1,
    "replicaCount": 3
  },
  "sku": {
    "name": "standard"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": {
      "apiKeyOnly": {}
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "disableLocalAuth": false,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Enabled"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "None",
      "ipRules": []
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 3,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}
Durum kodu:
201 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": {
      "apiKeyOnly": {}
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "disableLocalAuth": false,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Enabled"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "None",
      "ipRules": []
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 3,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

SearchCreateOrUpdateServiceWithDataExfiltration

Örnek isteği

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "properties": {
    "computeType": "Default",
    "dataExfiltrationProtections": [
      "BlockAll"
    ],
    "hostingMode": "Default",
    "partitionCount": 1,
    "replicaCount": 3
  },
  "sku": {
    "name": "standard"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": {
      "apiKeyOnly": {}
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [
      "BlockAll"
    ],
    "disableLocalAuth": false,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "None",
      "ipRules": []
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 3,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}
Durum kodu:
201 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": {
      "apiKeyOnly": {}
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [
      "BlockAll"
    ],
    "disableLocalAuth": false,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "None",
      "ipRules": []
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 3,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

SearchCreateOrUpdateServiceWithIdentity

Örnek isteği

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/user-mi": {}
    }
  },
  "location": "westus",
  "properties": {
    "computeType": "Default",
    "hostingMode": "Default",
    "partitionCount": 1,
    "replicaCount": 3
  },
  "sku": {
    "name": "standard"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "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"
      }
    }
  },
  "location": "westus",
  "properties": {
    "authOptions": {
      "apiKeyOnly": {}
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "disableLocalAuth": false,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "None",
      "ipRules": []
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 3,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}
Durum kodu:
201 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "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"
      }
    }
  },
  "location": "westus",
  "properties": {
    "authOptions": {
      "apiKeyOnly": {}
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "disableLocalAuth": false,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "None",
      "ipRules": []
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 3,
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

SearchCreateOrUpdateWithSemanticSearch

Örnek isteği

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "properties": {
    "computeType": "Default",
    "hostingMode": "Default",
    "partitionCount": 1,
    "replicaCount": 3,
    "semanticSearch": "free"
  },
  "sku": {
    "name": "standard"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

Örnek yanıt

Durum kodu:
200 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": {
      "apiKeyOnly": {}
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "disableLocalAuth": false,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "None",
      "ipRules": []
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 3,
    "semanticSearch": "free",
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}
Durum kodu:
201 
{
  "name": "mysearchservice",
  "type": "Microsoft.Search/searchServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "location": "westus",
  "properties": {
    "authOptions": {
      "apiKeyOnly": {}
    },
    "computeType": "Default",
    "dataExfiltrationProtections": [],
    "disableLocalAuth": false,
    "encryptionWithCmk": {
      "encryptionComplianceStatus": "Compliant",
      "enforcement": "Unspecified"
    },
    "endpoint": "https://mysearchservice.search.windows.net/",
    "hostingMode": "Default",
    "networkRuleSet": {
      "bypass": "None",
      "ipRules": []
    },
    "partitionCount": 1,
    "privateEndpointConnections": [],
    "provisioningState": "provisioning",
    "publicNetworkAccess": "Enabled",
    "replicaCount": 3,
    "semanticSearch": "free",
    "serviceUpgradedAt": null,
    "sharedPrivateLinkResources": [],
    "status": "provisioning",
    "statusDetails": "",
    "upgradeAvailable": "notAvailable"
  },
  "sku": {
    "name": "standard"
  },
  "systemData": {
    "createdAt": "2024-01-01T00:00:00Z",
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "lastModifiedAt": "2024-11-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User"
  },
  "tags": {
    "app-name": "My e-commerce app"
  }
}

Tanımlar

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

API hatası hakkında bilgi içerir.
CloudErrorBody

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

Bu özelliği, Varsayılan İşlem veya Azure Gizli İşlem'i kullanarak arama hizmetini destekleyecek şekilde yapılandırın.
createdByType

Kaynağı oluşturan kimliğin türü.
DataPlaneAadOrApiKeyAuthOption

Kimlik doğrulaması için API anahtarının veya Microsoft Entra Id kiracısından 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 tüm SKU'lar için izin verilen en fazla dizinden çok daha yüksek olan 1000'e kadar dizine izin veren en fazla 3 yüksek yoğunluklu bölümü etkinleştirecek şekilde ayarlayabilirsiniz. standard3 SKU'su için değer 'Varsayılan' veya 'HighDensity' olur. 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ış 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 Search hizmetinin IP kısıtlama kuralı.
NetworkRuleSet

Azure AI Search hizmetine nasıl ulaşılabileceğini belirleyen ağa özgü kurallar.
PrivateEndpointConnection

Azure AI Search hizmetine yönelik mevcut bir özel uç nokta bağlantısını açıklar.
PrivateEndpointConnectionProperties

Arama hizmetine var olan özel uç nokta bağlantısının özelliklerini açıklar.
PrivateEndpointConnectionPropertiesPrivateEndpoint

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

Özel uç noktaya var olan bir Azure Özel Bağlantı hizmeti bağlantısının geçerli durumunu 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ı, Tamamlanmamış veya İptal Edildi değerleridir.
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 Hizmeti 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.
PublicNetworkAccess

Bu değer, mevcut müşteri kaynakları ve şablonlarında hataya neden olan değişiklikleri önlemek için '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 olur.
SearchBypass

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

Hizmet için devre dışı bırakılmış belirli bir veri tahrip senaryosu.
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

Arama hizmetinin müşteri tarafından yönetilen anahtarla şifrelenmemiş nesneleri bulması durumunda uyumluluğu nasıl zorunlu kılması gerektiğini açıklar.
SearchSemanticSearch

Azure AI Arama hizmetinde anlamsal arama için kullanılabilirlik ve faturalama planını belirtir. Bu yapılandırma yalnızca belirli bölgelerdeki fiyatlandırma katmanları için mevcuttur.
SearchService

Azure AI Search hizmetini ve geçerli durumunu açıklar.
SearchServiceStatus

Arama hizmetinin durumu. Olası değerler şunlardır: 'running': 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. '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, Azure AI Search ekibi temel alınan sorunu etkin bir şekilde araştırıyor demektir. Bu durumlardaki ayrılmış hizmetler, sağlanan arama birimi sayısına göre ücretlendirilebilir.
SharedPrivateLinkResource

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

Azure AI Search hizmeti tarafından yönetilen mevcut bir 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 Tamamlanmamış değerleridir.
SharedPrivateLinkResourceStatus

Paylaşılan özel bağlantı kaynağının durumu. Geçerli değerler Beklemede, Onaylandı, Reddedildi veya Bağlantısı Kesildi.
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ğaltmaya sahip ayrılmış hizmet. 'standard': 12 bölüme ve 12 çoğaltmaya kadar 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 2TB desteği, 12 bölüme kadar olabilir. 'sunucusuz': Otomatik ölçeklendirme özelliklerine sahip sunucusuz katman.
systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
UpgradeAvailable

Özel arama hizmetinin bir yükseltmesi olup olmadığını gösterir.
UserAssignedIdentity

Kullanıcı tarafından atanan kimlik özellikleri

AadAuthFailureMode

Numaralandırma

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.

Değer Description
http403

Başarısız kimlik doğrulaması isteklerinin 403 (Yasak) HTTP durum koduyla sunulması gerektiğini gösterir.
http401WithBearerChallenge

Başarısız kimlik doğrulaması isteklerine 401 (Yetkisiz) HTTP durum kodu sunulması ve Taşıyıcı Sınaması sunulması gerektiğini gösterir.

CloudError

Nesne

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

Nesne

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 yerleştirilmiş 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ı).

ComputeType

Numaralandırma

Bu özelliği, Varsayılan İşlem veya Azure Gizli İşlem'i kullanarak arama hizmetini destekleyecek şekilde yapılandırın.

Değer Description
Default

Varsayılan İşlem ile hizmeti oluşturun.
Confidential

Azure Confidential Compute ile özel hizmeti oluşturun.

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer Description
User
Application
ManagedIdentity
Key

DataPlaneAadOrApiKeyAuthOption

Nesne

Kimlik doğrulaması için API anahtarının veya Microsoft Entra Id kiracısından 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 göndereceği yanıtı açıklar.

DataPlaneAuthOptions

Nesne

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ısından bir erişim belirtecinin kullanılabileceğini gösterir.
apiKeyOnly

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

EncryptionWithCmk

Nesne

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

Arama hizmetinin müşteri tarafından yönetilen anahtarla şifrelenmemiş nesneleri bulması durumunda uyumluluğu nasıl zorunlu kılması gerektiğini açıklar.

HostingMode

Numaralandırma

Yalnızca standart3 SKU için geçerlidir. Bu özelliği, diğer tüm SKU'lar için izin verilen en fazla dizinden çok daha yüksek olan 1000'e kadar dizine izin veren en fazla 3 yüksek yoğunluklu bölümü etkinleştirecek şekilde ayarlayabilirsiniz. standard3 SKU'su için değer 'Varsayılan' veya 'HighDensity' olur. Diğer tüm SKU'lar için bu değer 'Varsayılan' olmalıdır.

Değer Description
Default

Endekslerin maksimum sınırı, SKU veya fiyatlandırma seviyesine göre belirlenir.
HighDensity

Yalnızca Standard3 (S3) SKU'su için geçerlidir; arama hizmetleri 1.000'e kadar indekse sahip olabilir.

Identity

Nesne

Arama hizmeti kimliği hakkındaki ayrıntılar. Null değer, arama hizmetinin atanmış 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 bir kimlik kümesini içerir. 'Hiçbiri' türü hizmetten tüm kimlikleri kaldırır.
userAssignedIdentities

<string,  UserAssignedIdentity>

Kaynakla ilişkili 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

Numaralandırma

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.

Değer Description
None

Arama hizmetiyle ilişkili tüm kimliklerin kaldırılması gerektiğini gösterir.
SystemAssigned

Arama hizmeti için sistem tarafından atanan kimliğin etkinleştirileceğini gösterir.
UserAssigned

Bir veya daha fazla kullanıcı tarafından atanan kimliklerin arama hizmetine atanacağını gösterir.
SystemAssigned, UserAssigned

Arama hizmeti için sistem tarafından atanan kimliğin, kullanıcı tarafından atanan bir veya daha fazla kimlik atamasıyla birlikte etkinleştirileceğini gösterir.

IpRule

Nesne

Azure AI Search hizmetinin 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

Nesne

Azure AI Search hizmetine nasıl ulaşılabileceğ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'i '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.

PrivateEndpointConnection

Nesne

Azure AI Search hizmetine yönelik mevcut bir özel uç nokta bağlantısını açıklar.

Name Tür Description
id

string (arm-id)

Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name

string

Kaynağın adı
properties

PrivateEndpointConnectionProperties

Azure AI Search hizmetine var olan özel uç nokta bağlantısının özelliklerini açıklar.
systemData

systemData

createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
type

string

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

PrivateEndpointConnectionProperties

Nesne

Arama hizmetine var olan ö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

PrivateEndpointConnectionPropertiesPrivateEndpoint

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

PrivateEndpointConnectionPropertiesPrivateLinkServiceConnectionState

Ö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ı, Tamamlanmamış veya İptal Edildi değerleridir.

PrivateEndpointConnectionPropertiesPrivateEndpoint

Nesne

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.

PrivateEndpointConnectionPropertiesPrivateLinkServiceConnectionState

Nesne

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

PrivateLinkServiceConnectionProvisioningState

Numaralandırma

Ö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ı, Tamamlanmamış veya İptal Edildi değerleridir.

Değer Description
Updating

Özel bağlantı hizmeti bağlantısı, tamamen işlevsel olması için diğer kaynaklarla birlikte oluşturulma sürecindedir.
Deleting

Özel bağlantı hizmeti bağlantısı siliniyor.
Failed

Özel bağlantı hizmeti bağlantısı sağlanamadı veya silinemedi.
Succeeded

Özel bağlantı hizmeti bağlantısı sağlamayı tamamladı ve onay için hazır.
Incomplete

Özel bağlantı hizmeti bağlantı kaynağı için sağlama isteği kabul edildi, ancak oluşturma işlemi henüz başlamadı.
Canceled

Özel bağlantı hizmeti bağlantı kaynağı için sağlama isteği iptal edildi.

PrivateLinkServiceConnectionStatus

Numaralandırma

Özel bağlantı hizmeti bağlantısının durumu. Geçerli değerler Beklemede, Onaylandı, Reddedildi veya Bağlantısı Kesildi şeklindedir.

Değer Description
Pending

Özel uç nokta bağlantısı oluşturuldu ve onay bekliyor.
Approved

Özel uç nokta bağlantısı onaylandı ve kullanıma hazır.
Rejected

Özel uç nokta bağlantısı reddedildi ve kullanılamaz.
Disconnected

Özel uç nokta bağlantısı hizmetten kaldırıldı.

ProvisioningState

Numaralandırma

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

Değer Description
succeeded

Son sağlama işlemi başarıyla tamamlandı.
provisioning

Arama hizmeti sağlanıyor veya ölçeği artırılıyor veya azaltılıyor. Sadece özel arama hizmetleri için.
failed

Son sağlama işlemi başarısız oldu.

PublicNetworkAccess

Numaralandırma

Bu değer, mevcut müşteri kaynakları ve şablonlarında hataya neden olan değişiklikleri önlemek için '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 olur.

Değer Description
Enabled

Arama hizmetine genel İnternet'ten kaynaklanan trafikten erişilebilir.
Disabled

Arama hizmetine genel İnternet'ten kaynaklanan trafikten erişilemez. Erişime yalnızca onaylanan özel uç nokta bağlantıları üzerinden izin verilir.
SecuredByPerimeter

Ağ güvenliği çevresi yapılandırma kuralları, kaynağa genel ağ erişimine izin verir veya izin vermez. Bağlantılı bir ağ güvenlik çevresi gerektirir.

SearchBypass

Numaralandırma

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

Değer Description
None

Hiçbir kaynağın 'ipRules' bölümünde tanımlanan kuralları atlayabileceğini gösterir. Varsayılan değer budur.
AzureServices

Azure güvenilen hizmetlerinden gelen isteklerin 'ipRules' bölümünde tanımlanan kuralları atlayabileceğinizi gösterir.

SearchDataExfiltrationProtection

Numaralandırma

Hizmet için devre dışı bırakılmış belirli bir veri tahrip senaryosu.

Değer Description
BlockAll

Tüm veri sızdırma senaryolarının devre dışı bırakıldığını gösterir.

SearchEncryptionComplianceStatus

Numaralandırma

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.

Değer Description
Compliant

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

Arama hizmetinin birden fazla CMK ile şifrelenmemiş nesnesi olduğunu gösterir.

SearchEncryptionWithCmk

Numaralandırma

Arama hizmetinin müşteri tarafından yönetilen anahtarla şifrelenmemiş nesneleri bulması durumunda uyumluluğu nasıl zorunlu kılması gerektiğini açıklar.

Değer Description
Disabled

Müşteri tarafından yönetilen anahtar şifrelemesi uygulanmaz. Yalnızca yerleşik hizmet tarafından yönetilen şifreleme kullanılır.
Enabled

Bir veya daha fazla nesne müşteri tarafından yönetilen bir anahtarla şifrelenmemişse arama hizmeti uyumsuz olarak işaretlenir.
Unspecified

Zorlama ilkesi açıkça belirtilmez ve davranış 'Devre Dışı' olarak ayarlanmış gibi olur.

SearchSemanticSearch

Numaralandırma

Azure AI Arama hizmetinde anlamsal arama için kullanılabilirlik ve faturalama planını belirtir. Bu yapılandırma yalnızca belirli bölgelerdeki fiyatlandırma katmanları için mevcuttur.

Değer Description
disabled

Anlamsal reranker'ın arama hizmeti için devre dışı bırakıldığını gösterir.
free

Bir arama hizmetinde anlamsal yeniden ayarlamayı etkinleştirir ve ücretsiz planın sınırları içinde kullanılacağını belirtir. Ücretsiz plan semantik derecelendirme isteklerinin hacmini kapsatır ve ek ücret ödemeden sunulur. Bu, yeni sağlanan arama hizmetleri için varsayılandır. Varsayılan değer budur.
standard

Ücretsiz kota tükendikten sonra arama hizmetinde semantik yeniden sıralamayı faturalandırılabilir bir özellik olarak etkinleştirir, daha yüksek verimlilik ve anlamsal olarak yeniden sıralanmış sorgu hacmi sağlar.

SearchService

Nesne

Azure AI Search hizmetini ve geçerli durumunu açıklar.

Name Tür Default value Description
id

string (arm-id)

Kaynağın tam kaynak kimliği. Örneğin, "/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.computeType

ComputeType

Bu özelliği, Varsayılan İşlem veya Azure Gizli İşlem'i kullanarak arama hizmetini destekleyecek şekilde yapılandırın.
properties.dataExfiltrationProtections

SearchDataExfiltrationProtection[]

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

Arama hizmetindeki müşteri yöneticisi anahtarlarını kullanarak kaynakların (dizinler gibi) şifrelenmesiyle ilgili tüm ilkeleri belirtir.
properties.endpoint

string (uri)

Azure AI Search hizmetinin uç noktası.
properties.hostingMode

HostingMode

Default

Yalnızca standart3 SKU için geçerlidir. Bu özelliği, diğer tüm SKU'lar için izin verilen en fazla dizinden çok daha yüksek olan 1000'e kadar dizine izin veren en fazla 3 yüksek yoğunluklu bölümü etkinleştirecek şekilde ayarlayabilirsiniz. standard3 SKU'su için değer 'Varsayılan' veya 'HighDensity' olur. Diğer tüm SKU'lar için bu değer 'Varsayılan' olmalıdır.
properties.networkRuleSet

NetworkRuleSet

Azure AI Search hizmetine nasıl ulaşılabileceğini belirleyen ağa özgü kurallar.
properties.partitionCount

integer (int32)

minimum: 1
maximum: 12 		1

Özel 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 AI Search hizmetine ö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 Hizmeti 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

Bu değer, mevcut müşteri kaynakları ve şablonlarında hataya neden olan değişiklikleri önlemek için '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 olur.
properties.replicaCount

integer (int32)

minimum: 1
maximum: 12 		1

Özel arama hizmetindeki replika sayısı. Belirtilirse, standart SKU'lar için 1 ile 12 arasında veya temel SKU'lar için 1 ile 3 arasında bir değer olmalıdır.
properties.semanticSearch

SearchSemanticSearch

Azure AI Arama hizmetinde anlamsal arama için kullanılabilirlik ve faturalama planını belirtir. Bu yapılandırma yalnızca belirli bölgelerdeki fiyatlandırma katmanları için mevcuttur.
properties.serviceUpgradedAt

string (date-time)

Arama hizmetinin en son yükseltildiği tarih ve saat. Hizmet ilk kez yükseltilene kadar bu alan null olur.
properties.sharedPrivateLinkResources

SharedPrivateLinkResource[]

Azure AI Search 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 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. '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, Azure AI Search ekibi temel alınan sorunu etkin bir şekilde araştırıyor demektir. Bu durumlardaki ayrılmış hizmetler, sağlanan arama birimi sayısına göre ücretlendirilebilir.
properties.statusDetails

string

Arama hizmeti durumunun ayrıntıları.
properties.upgradeAvailable

UpgradeAvailable

Arama hizmetinin kullanılabilir bir yükseltmesi olup olmadığını gösterir.
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.
systemData

systemData

createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
tags

object

Kaynak etiketleri.
type

string

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

SearchServiceStatus

Numaralandırma

Arama hizmetinin durumu. Olası değerler şunlardır: 'running': 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. '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, Azure AI Search ekibi temel alınan sorunu etkin bir şekilde araştırıyor demektir. Bu durumlardaki ayrılmış hizmetler, sağlanan arama birimi sayısına göre ücretlendirilebilir.

Değer Description
running

Arama hizmeti çalışıyor ve hiçbir sağlama işlemi devam ediyor.
provisioning

Arama hizmeti sağlanıyor veya ölçeği artırılıyor veya azaltılıyor.
deleting

Arama hizmeti siliniyor.
degraded

Temel alınan arama birimleri iyi durumda olmadığından arama hizmetinin düzeyi düşürüldü.
disabled

Arama hizmeti devre dışı bırakılır ve tüm API istekleri reddedilir.
error

Arama hizmeti hata durumundadır ve sağlama veya silme işleminin başarısız olduğunu gösterir.
stopped

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

SharedPrivateLinkResource

Nesne

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

Name Tür Description
id

string (arm-id)

Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name

string

Kaynağın adı
properties

SharedPrivateLinkResourceProperties

Azure AI Search hizmeti tarafından yönetilen paylaşılan özel bağlantı kaynağının özelliklerini açıklar.
systemData

systemData

createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
type

string

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

SharedPrivateLinkResourceProperties

Nesne

Azure AI Search 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

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 Tamamlanmamış değerleridir.
requestMessage

string

Paylaşılan özel bağlantı kaynağının onaylanmasını isteme iletisi.
resourceRegion

string

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

SharedPrivateLinkResourceProvisioningState

Numaralandırma

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 Tamamlanmamış değerleridir.

Değer Description
Updating

Paylaşılan özel bağlantı kaynağı, tamamen işlevsel olması için diğer kaynaklarla birlikte oluşturulma sürecindedir.
Deleting

Paylaşılan özel bağlantı kaynağı siliniyor.
Failed

Paylaşılan özel bağlantı kaynağı sağlanamadı veya silinemedi.
Succeeded

Paylaşılan özel bağlantı kaynağı sağlamayı tamamladı ve onay için hazır.
Incomplete

Paylaşılan özel bağlantı kaynağı için sağlama isteği kabul edildi, ancak oluşturma işlemi henüz başlamadı.

SharedPrivateLinkResourceStatus

Numaralandırma

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

Değer Description
Pending

Paylaşılan özel bağlantı kaynağı oluşturuldu ve onay bekliyor.
Approved

Paylaşılan özel bağlantı kaynağı onaylanır ve kullanıma hazırdır.
Rejected

Paylaşılan özel bağlantı kaynağı reddedildi ve kullanılamaz.
Disconnected

Paylaşılan özel bağlantı kaynağı hizmetten kaldırıldı.

Sku

Nesne

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': En fazla 3 çoğaltmaya sahip ayrılmış hizmet. 'standard': 12 bölüme ve 12 çoğaltmaya kadar 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 2TB desteği, 12 bölüme kadar olabilir. 'sunucusuz': Otomatik ölçeklendirme özelliklerine sahip sunucusuz katman.

SkuName

Numaralandırma

Arama hizmetinin SKU'su. Geçerli değerler şunlardır: 'free': Paylaşılan hizmet. 'basic': En fazla 3 çoğaltmaya sahip ayrılmış hizmet. 'standard': 12 bölüme ve 12 çoğaltmaya kadar 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 2TB desteği, 12 bölüme kadar olabilir. 'sunucusuz': Otomatik ölçeklendirme özelliklerine sahip sunucusuz katman.

Değer Description
free

Ücretsiz katman, SLA garantisi olmadan ve faturalanabilir katmanlarda sunulan özelliklerin bir alt kümesiyle.
basic

En fazla 3 çoğaltmaya sahip ayrılmış bir hizmet için faturalanabilir katman.
standard

En fazla 12 bölüme ve 12 çoğaltmaya sahip ayrılmış bir hizmet için faturalanabilir katman.
standard2

'standart'a benzer, ancak arama birimi başına daha fazla kapasiteye sahiptir.
standard3

En fazla 12 bölüm ve 12 çoğaltması olan en büyük Standart teklif (veya hostingMode özelliğini 'highDensity' olarak ayarladıysanız daha fazla dizine sahip en fazla 3 bölüm).
storage_optimized_l1

Bölüm başına en fazla 12 bölüm olmak üzere 1 TB'yi destekleyen ayrılmış bir hizmet için faturalanabilir katman.
storage_optimized_l2

Bölüm başına en fazla 12 bölüm olmak üzere 2 TB'yi destekleyen ayrılmış bir hizmet için faturalanabilir katman.

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name Tür Description
createdAt

string (date-time)

Kaynak oluşturma (UTC) zaman damgası.
createdBy

string

Kaynağı oluşturan kimlik.
createdByType

createdByType

Kaynağı oluşturan kimliğin türü.
lastModifiedAt

string (date-time)

Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy

string

Kaynağı en son değiştiren kimlik.
lastModifiedByType

createdByType

Kaynağı en son değiştiren kimlik türü.

UpgradeAvailable

Numaralandırma

Özel arama hizmetinin bir yükseltmesi olup olmadığını gösterir.

Değer Description
notAvailable

Özel hizmet için şu anda yükseltme mevcut değil.
available

Özel hizmet için bir yükseltme mevcuttur.

UserAssignedIdentity

Nesne

Kullanıcı tarafından atanan kimlik özellikleri

Name Tür Description
clientId

string (uuid)

Atanan kimliğin istemci kimliği.
principalId

string (uuid)

Atanan kimliğin asıl kimliği.