Microsoft. Keresés a searchServices 2026-11-01

Bicep-erőforrásdefiníció

A searchServices erőforrástípus üzembe helyezhető olyan műveletekkel, amelyek a következő célokat célják:

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.

Használati példák

Bicep minták

Alapvető példa a Search Service üzembe helyezésére.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource searchService 'Microsoft.Search/searchServices@2022-09-01' = {
  name: resourceName
  location: location
  sku: {
    name: 'standard'
  }
  properties: {
    authOptions: {
      apiKeyOnly: {}
    }
    disableLocalAuth: false
    encryptionWithCmk: {
      enforcement: 'Disabled'
    }
    hostingMode: 'default'
    networkRuleSet: {
      ipRules: []
    }
    partitionCount: 1
    publicNetworkAccess: 'Enabled'
    replicaCount: 1
  }
  tags: {
    environment: 'staging'
  }
}

Azure-ból ellenőrzött modulok

Az alábbi Azure Verified Modules használható az erőforrástípus üzembe helyezéséhez.

Modul Description
Keresési szolgáltatás Keresési szolgáltatás AVM-erőforrásmodulja

Azure gyorsútmutató-minták

A következő Azure Gyorsindítás sablonok Bicep mintát tartalmaznak ennek az erőforrástípusnak a telepítéséhez.

Bicep-fájl Description
Az Azure AI Foundry hálózata korlátozott Ez a sablonkészlet bemutatja, hogyan állíthatja be az Azure AI Foundryt letiltott privát kapcsolattal és kimenő forgalommal, a Microsoft által felügyelt kulcsok használatával a titkosításhoz és a Microsoft által felügyelt identitáskonfigurációhoz az AI-erőforráshoz.
Azure Cognitive Search szolgáltatás Ez a sablon létrehoz egy Azure Cognitive Search-szolgáltatást
hálózat által védett ügynök felhasználói felügyelt identitással Ez a sablonkészlet bemutatja, hogyan állíthatja be az Azure AI Agent Service-t virtuális hálózatelkülönítéssel az AI-szolgáltatás/AOAI-kapcsolat és a magánhálózati kapcsolatok felhasználói felügyelt identitásának hitelesítésével az ügynök biztonságos adatokhoz való csatlakoztatásához.
standard ügynök beállítási Ez a sablonkészlet bemutatja, hogyan állíthatja be az Azure AI Agent Service-t a standard beállítással, azaz a projekt-/központkapcsolatok felügyelt identitáshitelesítésével és a nyilvános internetkapcsolat engedélyezésével. Az ügynökök az ügyfél tulajdonában lévő, egybérlős keresési és tárolási erőforrásokat használják. Ezzel a beállítással teljes mértékben szabályozhatja és áttekintheti ezeket az erőforrásokat, de a használat alapján költségekkel kell számolnia.

Erőforrás formátuma

Microsoft.Search/searchServices-erőforrás létrehozásához adja hozzá a következő Bicep-et a sablonhoz.

resource symbolicname 'Microsoft.Search/searchServices@2026-11-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    authOptions: {
      aadOrApiKey: {
        aadAuthFailureMode: 'string'
      }
      apiKeyOnly: any(...)
    }
    computeType: 'string'
    dataExfiltrationProtections: [
      'string'
    ]
    disableLocalAuth: bool
    encryptionWithCmk: {
      enforcement: 'string'
    }
    endpoint: 'string'
    hostingMode: 'string'
    knowledgeRetrieval: 'string'
    networkRuleSet: {
      bypass: 'string'
      ipRules: [
        {
          value: 'string'
        }
      ]
    }
    partitionCount: int
    publicNetworkAccess: 'string'
    replicaCount: int
    semanticSearch: 'string'
    upgradeAvailable: 'string'
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Tulajdonságértékek

Microsoft.Search/searchServices

Name Description Value
identitás Az erőforrás identitása. Identitás
hely Az a földrajzi hely, ahol az erőforrás él string (kötelező)
name Az erőforrás neve string

Korlátok:
Minta = ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$ (kötelező)
properties A keresési szolgáltatás tulajdonságai. SearchServiceProperties
sku A keresési szolgáltatás termékváltozata, amely meghatározza az árszintet és a kapacitáskorlátokat. Ez a tulajdonság új keresési szolgáltatás létrehozásakor szükséges. Sku
tags Erőforráscímkék Címkenevek és -értékek szótára. sablonok címkéinek megtekintése

DataPlaneAadOrApiKeyAuthOption

Name Description Value
aadAuthFailureMode Azt ismerteti, hogy a keresési szolgáltatás adatsík API-ja milyen választ küld a sikertelen hitelesítést igénylő kérelmekre. 'http401WithBearerChallenge'
"http403"

DataPlaneAuthOptions

Name Description Value
aadOrApiKey Azt jelzi, hogy az API-kulcs vagy a Microsoft Entra ID-bérlőből származó hozzáférési jogkivonat használható a hitelesítéshez. DataPlaneAadOrApiKeyAuthOption
apiKeyOnly Azt jelzi, hogy csak az API-kulcs használható a hitelesítéshez. any

Titkosítás cmk-val

Name Description Value
végrehajtás Azt ismerteti, hogy a keresési szolgáltatásnak hogyan kell kikényszerítenie a megfelelőséget, ha olyan objektumokat talál, amelyek nincsenek titkosítva az ügyfél által felügyelt kulccsal. 'Disabled'
'Enabled'
"Meghatározatlan"

Identity

Name Description Value
típus Az erőforráshoz használt identitás típusa. A "SystemAssigned, UserAssigned" típus magában foglalja a rendszer által létrehozott identitást és a felhasználó által hozzárendelt identitások készletét is. A "Nincs" típus eltávolítja az összes identitást a szolgáltatásból. "Nincs"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned" (kötelező)
userAssignedIdentities Az erőforráshoz társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai a következő formában jelennek meg: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Name Description Value

IP-szabály

Name Description Value
value Engedélyezhető egyetlen IPv4-címnek (pl. 123.1.2.3) vagy CIDR formátumú IP-címtartománynak (pl. 123.1.2.3/24) megfelelő érték. karakterlánc

Hálózati szabálykészlet

Name Description Value
Kitérő A bejövő forgalom lehetséges eredetei, amelyek megkerülhetik az "ipRules" szakaszban meghatározott szabályokat. "AzureServices"
"Nincs"
ipRules Azon IP-korlátozási szabályok listája, amelyek meghatározzák a bejövő hálózat(ok)t, és lehetővé teszik a keresési szolgáltatásvégponthoz való hozzáférést. Addig is a tűzfal blokkolja az összes többi nyilvános IP-hálózatot. Ezeket a korlátozási szabályokat csak akkor alkalmazza a rendszer, ha a keresési szolgáltatás "publicNetworkAccess" tulajdonsága engedélyezve van; ellenkező esetben a nyilvános interfészen keresztüli forgalom még nyilvános IP-szabályokkal sem engedélyezett, és a privát végpontkapcsolatok lennének a kizárólagos hozzáférési módszer. IP-szabály[]

SearchServiceProperties

Name Description Value
authOptions Meghatározza, hogy a keresési szolgáltatás adatsík API-ja hogyan hitelesíti a kéréseket. Ez nem állítható be, ha a "disableLocalAuth" értéke igaz. DataPlaneAuthOptions
computeType Konfigurálja ezt a tulajdonságot úgy, hogy támogassa a keresési szolgáltatást az Alapértelmezett számítási vagy az Azure Confidential Compute használatával. "Bizalmas"
'Default'
dataExfiltrationProtections A keresési szolgáltatásra kifejezetten nem engedélyezett adatkiszivárgási forgatókönyvek listája. Jelenleg az egyetlen támogatott érték az "Összes" az összes lehetséges adatexportálási forgatókönyv letiltásához a jövőben tervezett részletesebb vezérlőkkel. Sztringtömb, amely a következők bármelyikét tartalmazza:
"BlockAll"
disableLocalAuth Ha igaz értékre van állítva, a keresési szolgáltatás hívásai nem használhatják az API-kulcsokat a hitelesítéshez. Ez nem állítható be igaz értékre, ha a "dataPlaneAuthOptions" definiálva van. bool
titkosításCmk-val Megadja az erőforrások (például indexek) ügyfélmenedzser-kulcsokkal történő titkosítására vonatkozó szabályzatokat a keresési szolgáltatáson belül. Titkosítás cmk-val
végpont Az Azure AI Keresés szolgáltatás végpontja. karakterlánc
tárhely mód Csak a standard3 termékváltozatra alkalmazható. Ezt a tulajdonságot úgy állíthatja be, hogy legfeljebb 3 nagy sűrűségű partíciót engedélyezzen, amelyek legfeljebb 1000 indexet tesznek lehetővé, ami sokkal magasabb, mint bármely más termékváltozat esetében engedélyezett maximális indexek száma. A standard3 termékváltozat esetében az érték "Alapértelmezett" vagy "HighDensity". Az összes többi termékváltozat esetében ennek az értéknek "Alapértelmezettnek" kell lennie. 'Default'
"Nagy sűrűségű"
knowledgeRetrieval Megadja az Azure AI Keresés szolgáltatás ügynöki lekérdezésének számlázási tervet. Ez a konfiguráció csak bizonyos árszintekre érhető el bizonyos régiókban. "ingyenes"
"standard"
networkRuleSet Az Azure AI Keresés szolgáltatás elérésének módját meghatározó hálózatspecifikus szabályok. Hálózati szabálykészlet
partitionCount A dedikált keresőszolgáltatásban lévő partíciók száma; ha meg van jelölve, lehet 1, 2, 3, 4, 6 vagy 12. Az 1-nél nagyobb értékek csak a standard termékváltozatokra érvényesek. A "standard3" szolgáltatások esetében a hostingMode értéke "highDensity", az engedélyezett értékek 1 és 3 között vannak. int

Korlátok:
Minimális érték = 1
Maximális érték = 12
publicNetworkAccess Ez az érték "Engedélyezve" értékre állítható, hogy elkerülje a meglévő ügyfélerőforrások és sablonok kompatibilitástörő módosításait. Ha a "Letiltva" értékre van állítva, a nyilvános felületen keresztüli forgalom nem engedélyezett, és a privát végponti kapcsolatok lesznek a kizárólagos hozzáférési módszerek. 'Disabled'
'Enabled'
"SecuredByPerimeter"
replicaCount A dedikált keresőszolgálatban lévő replikák száma. Ha meg van adva, akkor 1 és 12 közötti értéknek kell lennie a standard termékváltozatok esetében, vagy az alapszintű termékváltozat esetében 1 és 3 közötti értéknek kell lennie. int

Korlátok:
Minimális érték = 1
Maximális érték = 12
szemanticSearch Megadja az Azure AI Keresés szolgáltatás szemantikai keresésének elérhetőségét és számlázási tervét. Ez a konfiguráció csak bizonyos árszintekre érhető el bizonyos régiókban. "letiltva"
"ingyenes"
"standard"
upgradeElérhető Azt jelzi, hogy a keresési szolgáltatás rendelkezik-e elérhető frissítéssel. "elérhető"
"notAvailable"

Sku

Name Description Value
name A keresési szolgáltatás termékváltozata. Az érvényes értékek a következők: "ingyenes": Megosztott szolgáltatás. "alapszintű": Dedikált szolgáltatás legfeljebb 3 replikával. "standard": Dedikált szolgáltatás legfeljebb 12 partícióval és 12 replikával. 'standard2': Hasonló a standardhoz, de keresési egységenként több kapacitással. "standard3": A legnagyobb standard ajánlat legfeljebb 12 partícióval és 12 replikával (vagy akár 3 partícióval, több indexkel, ha a hostingMode tulajdonságot is "highDensity" értékre állítja). "storage_optimized_l1": Partíciónként 1 TB-ot támogat, legfeljebb 12 partíciót. 'storage_optimized_l2': Támogatja 2TB partíciónként, legfeljebb 12 partíciót. 'szerver nélküli': Szerver nélküli szint automatikus skálázási lehetőséggel. "alapszintű"
"ingyenes"
'szerver nélküli'
"standard"
"standard2"
"standard3"
"storage_optimized_l1"
"storage_optimized_l2"

TrackedResourceTags

Name Description Value

UserAssignedIdentity

Name Description Value

ARM-sablon erőforrásdefiníciója

A searchServices erőforrástípus üzembe helyezhető olyan műveletekkel, amelyek a következő célokat célják:

Használati példák

Azure gyorsindító sablonok

A következő Azure Gyorsindítás sablonok telepítik ezt az erőforrás-típust.

Template Description
Az Azure AI Foundry hálózata korlátozott

Üzembe helyezés az Azure-ban
Ez a sablonkészlet bemutatja, hogyan állíthatja be az Azure AI Foundryt letiltott privát kapcsolattal és kimenő forgalommal, a Microsoft által felügyelt kulcsok használatával a titkosításhoz és a Microsoft által felügyelt identitáskonfigurációhoz az AI-erőforráshoz.
Azure Cognitive Search szolgáltatás

Üzembe helyezés az Azure-ban
Ez a sablon létrehoz egy Azure Cognitive Search-szolgáltatást
Azure Cognitive Search szolgáltatás privát végponttal

Üzembe helyezés az Azure-ban
Ez a sablon létrehoz egy Azure Cognitive Search-szolgáltatást egy privát végponttal.
hálózat által védett ügynök felhasználói felügyelt identitással

Üzembe helyezés az Azure-ban
Ez a sablonkészlet bemutatja, hogyan állíthatja be az Azure AI Agent Service-t virtuális hálózatelkülönítéssel az AI-szolgáltatás/AOAI-kapcsolat és a magánhálózati kapcsolatok felhasználói felügyelt identitásának hitelesítésével az ügynök biztonságos adatokhoz való csatlakoztatásához.
standard ügynök beállítási

Üzembe helyezés az Azure-ban
Ez a sablonkészlet bemutatja, hogyan állíthatja be az Azure AI Agent Service-t a standard beállítással, azaz a projekt-/központkapcsolatok felügyelt identitáshitelesítésével és a nyilvános internetkapcsolat engedélyezésével. Az ügynökök az ügyfél tulajdonában lévő, egybérlős keresési és tárolási erőforrásokat használják. Ezzel a beállítással teljes mértékben szabályozhatja és áttekintheti ezeket az erőforrásokat, de a használat alapján költségekkel kell számolnia.
webalkalmazás SQL Database, Azure Cosmos DB, Azure Search

Üzembe helyezés az Azure-ban
Ez a sablon kiépít egy webalkalmazást, egy SQL Database-t, az Azure Cosmos DB-t, az Azure Search-t és az Application Insightst.

Erőforrás formátuma

Microsoft.Search/searchServices-erőforrás létrehozásához adja hozzá a következő JSON-t a sablonhoz.

{
  "type": "Microsoft.Search/searchServices",
  "apiVersion": "2026-11-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "authOptions": {
      "aadOrApiKey": {
        "aadAuthFailureMode": "string"
      },
      "apiKeyOnly": {}
    },
    "computeType": "string",
    "dataExfiltrationProtections": [ "string" ],
    "disableLocalAuth": "bool",
    "encryptionWithCmk": {
      "enforcement": "string"
    },
    "endpoint": "string",
    "hostingMode": "string",
    "knowledgeRetrieval": "string",
    "networkRuleSet": {
      "bypass": "string",
      "ipRules": [
        {
          "value": "string"
        }
      ]
    },
    "partitionCount": "int",
    "publicNetworkAccess": "string",
    "replicaCount": "int",
    "semanticSearch": "string",
    "upgradeAvailable": "string"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Tulajdonságértékek

Microsoft.Search/searchServices

Name Description Value
apiVersion Az API verziója '2026-11-01'
identitás Az erőforrás identitása. Identitás
hely Az a földrajzi hely, ahol az erőforrás él string (kötelező)
name Az erőforrás neve string

Korlátok:
Minta = ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$ (kötelező)
properties A keresési szolgáltatás tulajdonságai. SearchServiceProperties
sku A keresési szolgáltatás termékváltozata, amely meghatározza az árszintet és a kapacitáskorlátokat. Ez a tulajdonság új keresési szolgáltatás létrehozásakor szükséges. Sku
tags Erőforráscímkék Címkenevek és -értékek szótára. sablonok címkéinek megtekintése
típus Az erőforrás típusa "Microsoft.Search/searchServices"

DataPlaneAadOrApiKeyAuthOption

Name Description Value
aadAuthFailureMode Azt ismerteti, hogy a keresési szolgáltatás adatsík API-ja milyen választ küld a sikertelen hitelesítést igénylő kérelmekre. 'http401WithBearerChallenge'
"http403"

DataPlaneAuthOptions

Name Description Value
aadOrApiKey Azt jelzi, hogy az API-kulcs vagy a Microsoft Entra ID-bérlőből származó hozzáférési jogkivonat használható a hitelesítéshez. DataPlaneAadOrApiKeyAuthOption
apiKeyOnly Azt jelzi, hogy csak az API-kulcs használható a hitelesítéshez. any

Titkosítás cmk-val

Name Description Value
végrehajtás Azt ismerteti, hogy a keresési szolgáltatásnak hogyan kell kikényszerítenie a megfelelőséget, ha olyan objektumokat talál, amelyek nincsenek titkosítva az ügyfél által felügyelt kulccsal. 'Disabled'
'Enabled'
"Meghatározatlan"

Identity

Name Description Value
típus Az erőforráshoz használt identitás típusa. A "SystemAssigned, UserAssigned" típus magában foglalja a rendszer által létrehozott identitást és a felhasználó által hozzárendelt identitások készletét is. A "Nincs" típus eltávolítja az összes identitást a szolgáltatásból. "Nincs"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned" (kötelező)
userAssignedIdentities Az erőforráshoz társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai a következő formában jelennek meg: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Name Description Value

IP-szabály

Name Description Value
value Engedélyezhető egyetlen IPv4-címnek (pl. 123.1.2.3) vagy CIDR formátumú IP-címtartománynak (pl. 123.1.2.3/24) megfelelő érték. karakterlánc

Hálózati szabálykészlet

Name Description Value
Kitérő A bejövő forgalom lehetséges eredetei, amelyek megkerülhetik az "ipRules" szakaszban meghatározott szabályokat. "AzureServices"
"Nincs"
ipRules Azon IP-korlátozási szabályok listája, amelyek meghatározzák a bejövő hálózat(ok)t, és lehetővé teszik a keresési szolgáltatásvégponthoz való hozzáférést. Addig is a tűzfal blokkolja az összes többi nyilvános IP-hálózatot. Ezeket a korlátozási szabályokat csak akkor alkalmazza a rendszer, ha a keresési szolgáltatás "publicNetworkAccess" tulajdonsága engedélyezve van; ellenkező esetben a nyilvános interfészen keresztüli forgalom még nyilvános IP-szabályokkal sem engedélyezett, és a privát végpontkapcsolatok lennének a kizárólagos hozzáférési módszer. IP-szabály[]

SearchServiceProperties

Name Description Value
authOptions Meghatározza, hogy a keresési szolgáltatás adatsík API-ja hogyan hitelesíti a kéréseket. Ez nem állítható be, ha a "disableLocalAuth" értéke igaz. DataPlaneAuthOptions
computeType Konfigurálja ezt a tulajdonságot úgy, hogy támogassa a keresési szolgáltatást az Alapértelmezett számítási vagy az Azure Confidential Compute használatával. "Bizalmas"
'Default'
dataExfiltrationProtections A keresési szolgáltatásra kifejezetten nem engedélyezett adatkiszivárgási forgatókönyvek listája. Jelenleg az egyetlen támogatott érték az "Összes" az összes lehetséges adatexportálási forgatókönyv letiltásához a jövőben tervezett részletesebb vezérlőkkel. Sztringtömb, amely a következők bármelyikét tartalmazza:
"BlockAll"
disableLocalAuth Ha igaz értékre van állítva, a keresési szolgáltatás hívásai nem használhatják az API-kulcsokat a hitelesítéshez. Ez nem állítható be igaz értékre, ha a "dataPlaneAuthOptions" definiálva van. bool
titkosításCmk-val Megadja az erőforrások (például indexek) ügyfélmenedzser-kulcsokkal történő titkosítására vonatkozó szabályzatokat a keresési szolgáltatáson belül. Titkosítás cmk-val
végpont Az Azure AI Keresés szolgáltatás végpontja. karakterlánc
tárhely mód Csak a standard3 termékváltozatra alkalmazható. Ezt a tulajdonságot úgy állíthatja be, hogy legfeljebb 3 nagy sűrűségű partíciót engedélyezzen, amelyek legfeljebb 1000 indexet tesznek lehetővé, ami sokkal magasabb, mint bármely más termékváltozat esetében engedélyezett maximális indexek száma. A standard3 termékváltozat esetében az érték "Alapértelmezett" vagy "HighDensity". Az összes többi termékváltozat esetében ennek az értéknek "Alapértelmezettnek" kell lennie. 'Default'
"Nagy sűrűségű"
knowledgeRetrieval Megadja az Azure AI Keresés szolgáltatás ügynöki lekérdezésének számlázási tervet. Ez a konfiguráció csak bizonyos árszintekre érhető el bizonyos régiókban. "ingyenes"
"standard"
networkRuleSet Az Azure AI Keresés szolgáltatás elérésének módját meghatározó hálózatspecifikus szabályok. Hálózati szabálykészlet
partitionCount A dedikált keresőszolgáltatásban lévő partíciók száma; ha meg van jelölve, lehet 1, 2, 3, 4, 6 vagy 12. Az 1-nél nagyobb értékek csak a standard termékváltozatokra érvényesek. A "standard3" szolgáltatások esetében a hostingMode értéke "highDensity", az engedélyezett értékek 1 és 3 között vannak. int

Korlátok:
Minimális érték = 1
Maximális érték = 12
publicNetworkAccess Ez az érték "Engedélyezve" értékre állítható, hogy elkerülje a meglévő ügyfélerőforrások és sablonok kompatibilitástörő módosításait. Ha a "Letiltva" értékre van állítva, a nyilvános felületen keresztüli forgalom nem engedélyezett, és a privát végponti kapcsolatok lesznek a kizárólagos hozzáférési módszerek. 'Disabled'
'Enabled'
"SecuredByPerimeter"
replicaCount A dedikált keresőszolgálatban lévő replikák száma. Ha meg van adva, akkor 1 és 12 közötti értéknek kell lennie a standard termékváltozatok esetében, vagy az alapszintű termékváltozat esetében 1 és 3 közötti értéknek kell lennie. int

Korlátok:
Minimális érték = 1
Maximális érték = 12
szemanticSearch Megadja az Azure AI Keresés szolgáltatás szemantikai keresésének elérhetőségét és számlázási tervét. Ez a konfiguráció csak bizonyos árszintekre érhető el bizonyos régiókban. "letiltva"
"ingyenes"
"standard"
upgradeElérhető Azt jelzi, hogy a keresési szolgáltatás rendelkezik-e elérhető frissítéssel. "elérhető"
"notAvailable"

Sku

Name Description Value
name A keresési szolgáltatás termékváltozata. Az érvényes értékek a következők: "ingyenes": Megosztott szolgáltatás. "alapszintű": Dedikált szolgáltatás legfeljebb 3 replikával. "standard": Dedikált szolgáltatás legfeljebb 12 partícióval és 12 replikával. 'standard2': Hasonló a standardhoz, de keresési egységenként több kapacitással. "standard3": A legnagyobb standard ajánlat legfeljebb 12 partícióval és 12 replikával (vagy akár 3 partícióval, több indexkel, ha a hostingMode tulajdonságot is "highDensity" értékre állítja). "storage_optimized_l1": Partíciónként 1 TB-ot támogat, legfeljebb 12 partíciót. 'storage_optimized_l2': Támogatja 2TB partíciónként, legfeljebb 12 partíciót. 'szerver nélküli': Szerver nélküli szint automatikus skálázási lehetőséggel. "alapszintű"
"ingyenes"
'szerver nélküli'
"standard"
"standard2"
"standard3"
"storage_optimized_l1"
"storage_optimized_l2"

TrackedResourceTags

Name Description Value

UserAssignedIdentity

Name Description Value

Terraform (AzAPI-szolgáltató) erőforrásdefiníciója

A searchServices erőforrástípus üzembe helyezhető olyan műveletekkel, amelyek a következő célokat célják:

  • Erőforráscsoportok Az API verziók megváltoztatott tulajdonságainak listájáért lásd: Változásnapló.

Használati példák

Terraform minták

Alapvető példa a Search Service üzembe helyezésére.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "searchService" {
  type      = "Microsoft.Search/searchServices@2022-09-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      authOptions = {
        apiKeyOnly = {
        }
      }
      disableLocalAuth = false
      encryptionWithCmk = {
        enforcement = "Disabled"
      }
      hostingMode = "default"
      networkRuleSet = {
        ipRules = [
        ]
      }
      partitionCount      = 1
      publicNetworkAccess = "Enabled"
      replicaCount        = 1
    }
    sku = {
      name = "standard"
    }
    tags = {
      environment = "staging"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Azure-ból ellenőrzött modulok

Az alábbi Azure Verified Modules használható az erőforrástípus üzembe helyezéséhez.

Modul Description
Keresési szolgáltatás Keresési szolgáltatás AVM-erőforrásmodulja

Erőforrás formátuma

Microsoft.Search/searchServices-erőforrás létrehozásához adja hozzá a következő Terraformot a sablonhoz.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Search/searchServices@2026-11-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      authOptions = {
        aadOrApiKey = {
          aadAuthFailureMode = "string"
        }
        apiKeyOnly = ?
      }
      computeType = "string"
      dataExfiltrationProtections = [
        "string"
      ]
      disableLocalAuth = bool
      encryptionWithCmk = {
        enforcement = "string"
      }
      endpoint = "string"
      hostingMode = "string"
      knowledgeRetrieval = "string"
      networkRuleSet = {
        bypass = "string"
        ipRules = [
          {
            value = "string"
          }
        ]
      }
      partitionCount = int
      publicNetworkAccess = "string"
      replicaCount = int
      semanticSearch = "string"
      upgradeAvailable = "string"
    }
    sku = {
      name = "string"
    }
  }
}

Tulajdonságértékek

Microsoft.Search/searchServices

Name Description Value
identitás Az erőforrás identitása. Identitás
hely Az a földrajzi hely, ahol az erőforrás él string (kötelező)
name Az erőforrás neve string

Korlátok:
Minta = ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$ (kötelező)
properties A keresési szolgáltatás tulajdonságai. SearchServiceProperties
sku A keresési szolgáltatás termékváltozata, amely meghatározza az árszintet és a kapacitáskorlátokat. Ez a tulajdonság új keresési szolgáltatás létrehozásakor szükséges. Sku
tags Erőforráscímkék Címkenevek és -értékek szótára.
típus Az erőforrás típusa "Microsoft. Keresés/searchServices@2026-11-01"

DataPlaneAadOrApiKeyAuthOption

Name Description Value
aadAuthFailureMode Azt ismerteti, hogy a keresési szolgáltatás adatsík API-ja milyen választ küld a sikertelen hitelesítést igénylő kérelmekre. 'http401WithBearerChallenge'
"http403"

DataPlaneAuthOptions

Name Description Value
aadOrApiKey Azt jelzi, hogy az API-kulcs vagy a Microsoft Entra ID-bérlőből származó hozzáférési jogkivonat használható a hitelesítéshez. DataPlaneAadOrApiKeyAuthOption
apiKeyOnly Azt jelzi, hogy csak az API-kulcs használható a hitelesítéshez. any

Titkosítás cmk-val

Name Description Value
végrehajtás Azt ismerteti, hogy a keresési szolgáltatásnak hogyan kell kikényszerítenie a megfelelőséget, ha olyan objektumokat talál, amelyek nincsenek titkosítva az ügyfél által felügyelt kulccsal. 'Disabled'
'Enabled'
"Meghatározatlan"

Identity

Name Description Value
típus Az erőforráshoz használt identitás típusa. A "SystemAssigned, UserAssigned" típus magában foglalja a rendszer által létrehozott identitást és a felhasználó által hozzárendelt identitások készletét is. A "Nincs" típus eltávolítja az összes identitást a szolgáltatásból. "Nincs"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned" (kötelező)
userAssignedIdentities Az erőforráshoz társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai a következő formában jelennek meg: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Name Description Value

IP-szabály

Name Description Value
value Engedélyezhető egyetlen IPv4-címnek (pl. 123.1.2.3) vagy CIDR formátumú IP-címtartománynak (pl. 123.1.2.3/24) megfelelő érték. karakterlánc

Hálózati szabálykészlet

Name Description Value
Kitérő A bejövő forgalom lehetséges eredetei, amelyek megkerülhetik az "ipRules" szakaszban meghatározott szabályokat. "AzureServices"
"Nincs"
ipRules Azon IP-korlátozási szabályok listája, amelyek meghatározzák a bejövő hálózat(ok)t, és lehetővé teszik a keresési szolgáltatásvégponthoz való hozzáférést. Addig is a tűzfal blokkolja az összes többi nyilvános IP-hálózatot. Ezeket a korlátozási szabályokat csak akkor alkalmazza a rendszer, ha a keresési szolgáltatás "publicNetworkAccess" tulajdonsága engedélyezve van; ellenkező esetben a nyilvános interfészen keresztüli forgalom még nyilvános IP-szabályokkal sem engedélyezett, és a privát végpontkapcsolatok lennének a kizárólagos hozzáférési módszer. IP-szabály[]

SearchServiceProperties

Name Description Value
authOptions Meghatározza, hogy a keresési szolgáltatás adatsík API-ja hogyan hitelesíti a kéréseket. Ez nem állítható be, ha a "disableLocalAuth" értéke igaz. DataPlaneAuthOptions
computeType Konfigurálja ezt a tulajdonságot úgy, hogy támogassa a keresési szolgáltatást az Alapértelmezett számítási vagy az Azure Confidential Compute használatával. "Bizalmas"
'Default'
dataExfiltrationProtections A keresési szolgáltatásra kifejezetten nem engedélyezett adatkiszivárgási forgatókönyvek listája. Jelenleg az egyetlen támogatott érték az "Összes" az összes lehetséges adatexportálási forgatókönyv letiltásához a jövőben tervezett részletesebb vezérlőkkel. Sztringtömb, amely a következők bármelyikét tartalmazza:
"BlockAll"
disableLocalAuth Ha igaz értékre van állítva, a keresési szolgáltatás hívásai nem használhatják az API-kulcsokat a hitelesítéshez. Ez nem állítható be igaz értékre, ha a "dataPlaneAuthOptions" definiálva van. bool
titkosításCmk-val Megadja az erőforrások (például indexek) ügyfélmenedzser-kulcsokkal történő titkosítására vonatkozó szabályzatokat a keresési szolgáltatáson belül. Titkosítás cmk-val
végpont Az Azure AI Keresés szolgáltatás végpontja. karakterlánc
tárhely mód Csak a standard3 termékváltozatra alkalmazható. Ezt a tulajdonságot úgy állíthatja be, hogy legfeljebb 3 nagy sűrűségű partíciót engedélyezzen, amelyek legfeljebb 1000 indexet tesznek lehetővé, ami sokkal magasabb, mint bármely más termékváltozat esetében engedélyezett maximális indexek száma. A standard3 termékváltozat esetében az érték "Alapértelmezett" vagy "HighDensity". Az összes többi termékváltozat esetében ennek az értéknek "Alapértelmezettnek" kell lennie. 'Default'
"Nagy sűrűségű"
knowledgeRetrieval Megadja az Azure AI Keresés szolgáltatás ügynöki lekérdezésének számlázási tervet. Ez a konfiguráció csak bizonyos árszintekre érhető el bizonyos régiókban. "ingyenes"
"standard"
networkRuleSet Az Azure AI Keresés szolgáltatás elérésének módját meghatározó hálózatspecifikus szabályok. Hálózati szabálykészlet
partitionCount A dedikált keresőszolgáltatásban lévő partíciók száma; ha meg van jelölve, lehet 1, 2, 3, 4, 6 vagy 12. Az 1-nél nagyobb értékek csak a standard termékváltozatokra érvényesek. A "standard3" szolgáltatások esetében a hostingMode értéke "highDensity", az engedélyezett értékek 1 és 3 között vannak. int

Korlátok:
Minimális érték = 1
Maximális érték = 12
publicNetworkAccess Ez az érték "Engedélyezve" értékre állítható, hogy elkerülje a meglévő ügyfélerőforrások és sablonok kompatibilitástörő módosításait. Ha a "Letiltva" értékre van állítva, a nyilvános felületen keresztüli forgalom nem engedélyezett, és a privát végponti kapcsolatok lesznek a kizárólagos hozzáférési módszerek. 'Disabled'
'Enabled'
"SecuredByPerimeter"
replicaCount A dedikált keresőszolgálatban lévő replikák száma. Ha meg van adva, akkor 1 és 12 közötti értéknek kell lennie a standard termékváltozatok esetében, vagy az alapszintű termékváltozat esetében 1 és 3 közötti értéknek kell lennie. int

Korlátok:
Minimális érték = 1
Maximális érték = 12
szemanticSearch Megadja az Azure AI Keresés szolgáltatás szemantikai keresésének elérhetőségét és számlázási tervét. Ez a konfiguráció csak bizonyos árszintekre érhető el bizonyos régiókban. "letiltva"
"ingyenes"
"standard"
upgradeElérhető Azt jelzi, hogy a keresési szolgáltatás rendelkezik-e elérhető frissítéssel. "elérhető"
"notAvailable"

Sku

Name Description Value
name A keresési szolgáltatás termékváltozata. Az érvényes értékek a következők: "ingyenes": Megosztott szolgáltatás. "alapszintű": Dedikált szolgáltatás legfeljebb 3 replikával. "standard": Dedikált szolgáltatás legfeljebb 12 partícióval és 12 replikával. 'standard2': Hasonló a standardhoz, de keresési egységenként több kapacitással. "standard3": A legnagyobb standard ajánlat legfeljebb 12 partícióval és 12 replikával (vagy akár 3 partícióval, több indexkel, ha a hostingMode tulajdonságot is "highDensity" értékre állítja). "storage_optimized_l1": Partíciónként 1 TB-ot támogat, legfeljebb 12 partíciót. 'storage_optimized_l2': Támogatja 2TB partíciónként, legfeljebb 12 partíciót. 'szerver nélküli': Szerver nélküli szint automatikus skálázási lehetőséggel. "alapszintű"
"ingyenes"
'szerver nélküli'
"standard"
"standard2"
"standard3"
"storage_optimized_l1"
"storage_optimized_l2"

TrackedResourceTags

Name Description Value

UserAssignedIdentity

Name Description Value