Microsoft. Search searchServices 2020-03-13

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 Leírás
Keresési szolgáltatás Keresési szolgáltatás AVM-erőforrásmodulja

Azure gyorsútmutató-minták

Az alábbi Azure rövid útmutatósablonok bicep-mintákat tartalmaznak az erőforrástípus üzembe helyezéséhez.

Bicep-fájl Leírás
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@2020-03-13' = {
  identity: {
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    hostingMode: 'string'
    networkRuleSet: {
      ipRules: [
        {
          value: 'string'
        }
      ]
    }
    partitionCount: int
    publicNetworkAccess: 'string'
    replicaCount: int
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Tulajdonságértékek

Microsoft.Keresés/keresésiSzolgáltatások

Név Leírás Érték
identitás Az erőforrás identitása. Identitás
hely Az erőforrás földrajzi helye. Ennek a támogatott és regisztrált Azure Geo-régiók egyikének kell lennie (például az USA nyugati régiója, az USA keleti régiója, Délkelet-Ázsia stb.). Ez a tulajdonság új erőforrás létrehozásakor szükséges. karakterlánc
név Az erőforrás neve sztring (kötelező)
kellékek 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. termékváltozat
Címkék Erőforráscímkék Címkenevek és -értékek szótára. sablonok címkéinek megtekintése

Azonosság

Név Leírás Érték
típus Az identitás típusa. "Nincs"
"SystemAssigned" (kötelező)

IP-szabály

Név Leírás Érték
érték 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

Név Leírás Érték
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[]

Erőforrás címkék

Név Leírás Érték

SearchServiceProperties

Név Leírás Érték
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. 'alapértelmezett'
"highDensity"
networkRuleSet Az Azure Cognitive Search szolgáltatás elérésének módját meghatározó hálózatspecifikus szabályok. Hálózati szabálykészlet
partíciók száma A keresési szolgáltatás partícióinak száma; ha meg van adva, az 1, 2, 3, 4, 6 vagy 12 lehet. 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
nyilvános hálózati hozzáférés Ez az érték "engedélyezve" értékre állítható a meglévő ügyfélerőforrások és sablonok kompatibilitástörő változásainak elkerülése érdekében. Ha a "letiltva" értékre van állítva, a nyilvános interfészen keresztüli forgalom nem engedélyezett, és a privát végpontkapcsolatok kizárólagos hozzáférési módszerként használhatók. "letiltva"
"engedélyezve"
replikák száma A keresési szolgáltatás replikáinak 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

termékazonosító (SKU)

Név Leírás Érték
név 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": Partíciónként 2 TB-ot támogat, legfeljebb 12 partíciót." "alapszintű"
"ingyenes"
"standard"
"standard2"
"standard3"
"storage_optimized_l1"
"storage_optimized_l2"

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 gyorsútmutató-sablonok

Az alábbi Azure rövid útmutatósablonok üzembe helyezni ezt az erőforrástípust.

Sablon Leírás
Az Azure AI Foundry hálózata korlátozott

Üzembe helyezés az Azure
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
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
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
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
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
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": "2020-03-13",
  "name": "string",
  "identity": {
    "type": "string"
  },
  "location": "string",
  "properties": {
    "hostingMode": "string",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "string"
        }
      ]
    },
    "partitionCount": "int",
    "publicNetworkAccess": "string",
    "replicaCount": "int"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Tulajdonságértékek

Microsoft.Keresés/keresésiSzolgáltatások

Név Leírás Érték
apiVersion Az API verziója '2020-03-13'
identitás Az erőforrás identitása. Identitás
hely Az erőforrás földrajzi helye. Ennek a támogatott és regisztrált Azure Geo-régiók egyikének kell lennie (például az USA nyugati régiója, az USA keleti régiója, Délkelet-Ázsia stb.). Ez a tulajdonság új erőforrás létrehozásakor szükséges. karakterlánc
név Az erőforrás neve sztring (kötelező)
kellékek 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. termékváltozat
Címkék 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"

Azonosság

Név Leírás Érték
típus Az identitás típusa. "Nincs"
"SystemAssigned" (kötelező)

IP-szabály

Név Leírás Érték
érték 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

Név Leírás Érték
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[]

Erőforrás címkék

Név Leírás Érték

SearchServiceProperties

Név Leírás Érték
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. 'alapértelmezett'
"highDensity"
networkRuleSet Az Azure Cognitive Search szolgáltatás elérésének módját meghatározó hálózatspecifikus szabályok. Hálózati szabálykészlet
partíciók száma A keresési szolgáltatás partícióinak száma; ha meg van adva, az 1, 2, 3, 4, 6 vagy 12 lehet. 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
nyilvános hálózati hozzáférés Ez az érték "engedélyezve" értékre állítható a meglévő ügyfélerőforrások és sablonok kompatibilitástörő változásainak elkerülése érdekében. Ha a "letiltva" értékre van állítva, a nyilvános interfészen keresztüli forgalom nem engedélyezett, és a privát végpontkapcsolatok kizárólagos hozzáférési módszerként használhatók. "letiltva"
"engedélyezve"
replikák száma A keresési szolgáltatás replikáinak 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

termékazonosító (SKU)

Név Leírás Érték
név 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": Partíciónként 2 TB-ot támogat, legfeljebb 12 partíciót." "alapszintű"
"ingyenes"
"standard"
"standard2"
"standard3"
"storage_optimized_l1"
"storage_optimized_l2"

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 Leírás
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@2020-03-13"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      hostingMode = "string"
      networkRuleSet = {
        ipRules = [
          {
            value = "string"
          }
        ]
      }
      partitionCount = int
      publicNetworkAccess = "string"
      replicaCount = int
    }
    sku = {
      name = "string"
    }
  }
}

Tulajdonságértékek

Microsoft.Keresés/keresésiSzolgáltatások

Név Leírás Érték
identitás Az erőforrás identitása. Identitás
hely Az erőforrás földrajzi helye. Ennek a támogatott és regisztrált Azure Geo-régiók egyikének kell lennie (például az USA nyugati régiója, az USA keleti régiója, Délkelet-Ázsia stb.). Ez a tulajdonság új erőforrás létrehozásakor szükséges. karakterlánc
név Az erőforrás neve sztring (kötelező)
kellékek 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. termékváltozat
Címkék Erőforráscímkék Címkenevek és -értékek szótára.
típus Az erőforrás típusa "Microsoft.Search/searchServices@2020-03-13"

Azonosság

Név Leírás Érték
típus Az identitás típusa. "Nincs"
"SystemAssigned" (kötelező)

IP-szabály

Név Leírás Érték
érték 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

Név Leírás Érték
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[]

Erőforrás címkék

Név Leírás Érték

SearchServiceProperties

Név Leírás Érték
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. 'alapértelmezett'
"highDensity"
networkRuleSet Az Azure Cognitive Search szolgáltatás elérésének módját meghatározó hálózatspecifikus szabályok. Hálózati szabálykészlet
partíciók száma A keresési szolgáltatás partícióinak száma; ha meg van adva, az 1, 2, 3, 4, 6 vagy 12 lehet. 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
nyilvános hálózati hozzáférés Ez az érték "engedélyezve" értékre állítható a meglévő ügyfélerőforrások és sablonok kompatibilitástörő változásainak elkerülése érdekében. Ha a "letiltva" értékre van állítva, a nyilvános interfészen keresztüli forgalom nem engedélyezett, és a privát végpontkapcsolatok kizárólagos hozzáférési módszerként használhatók. "letiltva"
"engedélyezve"
replikák száma A keresési szolgáltatás replikáinak 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

termékazonosító (SKU)

Név Leírás Érték
név 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": Partíciónként 2 TB-ot támogat, legfeljebb 12 partíciót." "alapszintű"
"ingyenes"
"standard"
"standard2"
"standard3"
"storage_optimized_l1"
"storage_optimized_l2"