Share via


Microsoft. Keresés searchServices 2022-09-01

Bicep-erőforrásdefiníció

A searchServices erőforrástípus üzembe helyezhető a következő célműveletekkel:

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplóban találja.

Erőforrás formátuma

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

resource symbolicname 'Microsoft.Search/searchServices@2022-09-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
  }
  identity: {
    type: 'string'
  }
  properties: {
    authOptions: {
      aadOrApiKey: {
        aadAuthFailureMode: 'string'
      }
      apiKeyOnly: any()
    }
    disableLocalAuth: bool
    encryptionWithCmk: {
      enforcement: 'string'
    }
    hostingMode: 'string'
    networkRuleSet: {
      ipRules: [
        {
          value: 'string'
        }
      ]
    }
    partitionCount: int
    publicNetworkAccess: 'string'
    replicaCount: int
  }
}

Tulajdonságértékek

searchServices

Név Leírás Érték
name Az erőforrás neve sztring (kötelező)
location A földrajzi hely, ahol az erőforrás él sztring (kötelező)
tags Erőforráscímkék. Címkenevek és -értékek szótára. Címkék megtekintése sablonokban
Sku A Keresés szolgáltatás termékváltozata, amely meghatározza az árszintet és a kapacitáskorlátokat. Ez a tulajdonság új Keresés szolgáltatás létrehozásakor szükséges. Sku
identity Az erőforrás identitása. Identitás
properties A keresési szolgáltatás tulajdonságai. SearchServiceProperties

Identitás

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

SearchServiceProperties

Név Leírás Érték
authOptions Meghatározza, hogy a keresési szolgáltatás adatsík API-ja hogyan hitelesítse a kéréseket. Ez nem állítható be, ha a disableLocalAuth értéke igaz. DataPlaneAuthOptions
disableLocalAuth Ha true (igaz) értékre van állítva, a keresési szolgáltatás hívásai nem használhatnak API-kulcsokat a hitelesítéshez. Ez nem állítható true értékre, ha a "dataPlaneAuthOptions" definiálva van. logikai
encryptionWithCmk 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. EncryptionWithCmk
hostingMode Csak a standard3 termékváltozatra vonatkozik. Ezt a tulajdonságot beállíthatja úgy, hogy legfeljebb 3 nagy sűrűségű partíciót engedélyezzen, amelyek akár 1000 indexet is lehetővé tesznek, ami sokkal nagyobb, mint bármely más termékváltozat esetében engedélyezett maximális index. 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 Hálózatspecifikus szabályok, amelyek meghatározzák, hogyan lehet elérni a Azure Cognitive Search szolgáltatást. NetworkRuleSet
partitionCount A keresési szolgáltatás partícióinak száma; ha meg van adva, ez lehet 1, 2, 3, 4, 6 vagy 12. Az 1-nél nagyobb értékek csak 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ő változásait. Ha "letiltva" értékre van állítva, a nyilvános felületen keresztüli forgalom nem engedélyezett, és a privát végponti kapcsolatok a kizárólagos hozzáférési módszer. "letiltva"
"engedélyezve"
replicaCount A keresési szolgáltatás replikáinak száma. Ha meg van adva, akkor az értéknek 1 és 12 közöttinek kell lennie a standard termékváltozatok esetében, vagy 1 és 3 közötti értéknek kell lennie, amely az alapszintű termékváltozatot is magában foglalja. int

Korlátok:
Minimális érték = 1
Maximális érték = 12

DataPlaneAuthOptions

Név Leírás Érték
aadOrApiKey Azt jelzi, hogy az API-kulcs vagy az Azure Active Directoryból származó hozzáférési jogkivonat használható a hitelesítéshez. DataPlaneAadOrApiKeyAuthOption
apiKeyOnly Azt jelzi, hogy csak az API-kulcsot kell használni a hitelesítéshez. A Bicep esetében használhatja az any() függvényt.

DataPlaneAadOrApiKeyAuthOption

Név Leírás Érték
aadAuthFailureMode Ez a cikk azt ismerteti, hogy egy Search szolgáltatás adatsík API-ja milyen választ küld a sikertelen hitelesítést igénylő kérésekre. 'http401WithBearerChallenge'
"http403"

EncryptionWithCmk

Név Leírás Érték
Végrehajtási Ez a cikk azt ismerteti, hogy a keresési szolgáltatásnak hogyan kell kikényszerítenie egy vagy több nem ügyfél által titkosított erőforrás használatát. "Letiltva"
"Engedélyezve"
"Meghatározatlan"

NetworkRuleSet

Név Leírás Érték
ipRules Ip-korlátozási szabályok listája, amelyek meghatározzák a bejövő hálózat(ok)t a keresési szolgáltatásvégponthoz való hozzáférés engedélyezésével. 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égponti kapcsolatok lennének a kizárólagos hozzáférési módszer. IpRule[]

IpRule

Név Leírás Érték
érték Engedélyezhető egyetlen IPv4-címnek (például 123.1.2.3) vagy CIDR formátumú IP-címtartománynak (pl. 123.1.2.3/24) megfelelő érték. sztring

SKU

Név Leírás Érték
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 a keresési egységenként nagyobb kapacitással. "standard3": A legnagyobb standard ajánlat, amely legfeljebb 12 partícióval és 12 replikával (vagy akár 3 olyan partícióval, amely több indexet biztosít, 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"

Gyorssablonok

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

Sablon Description
Webalkalmazás SQL Database, Azure Cosmos DB, Azure Keresés

Üzembe helyezés az Azure-ban
Ez a sablon kiépít egy webalkalmazást, egy SQL Database, az Azure Cosmos DB-t, az Azure Keresés-t és az Application Insightsot.
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 privát végponttal rendelkező Azure Cognitive Search szolgáltatást.

ARM-sablon erőforrás-definíciója

A searchServices erőforrástípus üzembe helyezhető a következő célműveletekkel:

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplóban találja.

Erőforrás formátuma

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

{
  "type": "Microsoft.Search/searchServices",
  "apiVersion": "2022-09-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string"
  },
  "identity": {
    "type": "string"
  },
  "properties": {
    "authOptions": {
      "aadOrApiKey": {
        "aadAuthFailureMode": "string"
      },
      "apiKeyOnly": {}
    },
    "disableLocalAuth": "bool",
    "encryptionWithCmk": {
      "enforcement": "string"
    },
    "hostingMode": "string",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "string"
        }
      ]
    },
    "partitionCount": "int",
    "publicNetworkAccess": "string",
    "replicaCount": "int"
  }
}

Tulajdonságértékek

searchServices

Név Leírás Érték
típus Az erőforrás típusa "Microsoft. Keresés/searchServices'
apiVersion Az erőforrás API-verziója '2022-09-01'
name Az erőforrás neve sztring (kötelező)
location A földrajzi hely, ahol az erőforrás él sztring (kötelező)
tags Erőforráscímkék. Címkenevek és -értékek szótára. Címkék megtekintése sablonokban
Sku A Keresés szolgáltatás termékváltozata, amely meghatározza az árszintet és a kapacitáskorlátokat. Ez a tulajdonság új Keresés szolgáltatás létrehozásakor szükséges. Sku
identity Az erőforrás identitása. Identitás
properties A keresési szolgáltatás tulajdonságai. SearchServiceProperties

Identitás

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

SearchServiceProperties

Név Leírás Érték
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
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ó igaz értékre, ha a "dataPlaneAuthOptions" definiálva van. logikai
encryptionWithCmk Meghatározza az erőforrások (például indexek) ügyfélkezelői kulcsokkal történő titkosítására vonatkozó szabályzatokat a keresési szolgáltatáson belül. EncryptionWithCmk
hostingMode Csak a standard3 termékváltozatra alkalmazható. Ezt a tulajdonságot beállíthatja úgy, 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. 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 Hálózatspecifikus szabályok, amelyek meghatározzák, hogyan érhető el a Azure Cognitive Search szolgáltatás. NetworkRuleSet
partitionCount A keresési szolgáltatás partícióinak száma; ha meg van adva, 1, 2, 3, 4, 6 vagy 12 lehet. Az 1-nél nagyobb értékek csak 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ő változásait. Ha a "letiltva" értékre van állítva, a nyilvános adapteren keresztüli forgalom nem engedélyezett, és a privát végponti kapcsolatok a kizárólagos hozzáférési módszer. "letiltva"
"engedélyezve"
replicaCount A keresési szolgáltatás replikáinak száma. Ha meg van adva, akkor a standard termékváltozatok esetében 1 és 12 közötti, alapszintű termékváltozat esetén 1 és 3 közötti értéknek kell lennie. int

Korlátok:
Minimális érték = 1
Maximális érték = 12

DataPlaneAuthOptions

Név Leírás Érték
aadOrApiKey Azt jelzi, hogy az API-kulcs vagy az Azure Active Directoryból származó hozzáférési jogkivonat használható a hitelesítéshez. DataPlaneAadOrApiKeyAuthOption
apiKeyOnly Azt jelzi, hogy csak az API-kulcsot kell használni a hitelesítéshez.

DataPlaneAadOrApiKeyAuthOption

Név Leírás Érték
aadAuthFailureMode Leírja, hogy egy Search szolgáltatás adatsík API-ja milyen választ küld a sikertelen hitelesítést igénylő kérésekre. 'http401WithBearerChallenge'
"http403"

EncryptionWithCmk

Név Leírás Érték
Végrehajtási Ismerteti, hogy a keresési szolgáltatásnak hogyan kell kikényszerítenie egy vagy több nem ügyfél által titkosított erőforrás használatát. "Letiltva"
"Engedélyezve"
"Meghatározatlan"

NetworkRuleSet

Név Leírás Érték
ipRules A keresési szolgáltatásvégponthoz való hozzáférés engedélyezésével rendelkező bejövő hálózatot(ok) meghatározó IP-korlátozási szabályok listája. 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égponti kapcsolatok a kizárólagos hozzáférési módszer. IpRule[]

IpRule

Név Leírás Érték
érték Egyetlen IPv4-címnek (például 123.1.2.3) vagy CIDR formátumú IP-címtartománynak (pl. 123.1.2.3/24) megfelelő érték engedélyezhető. sztring

SKU

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

Gyorssablonok

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

Sablon Description
Webalkalmazás SQL Database, Azure Cosmos DB, Azure Keresés

Üzembe helyezés az Azure-ban
Ez a sablon kiépít egy webalkalmazást, egy SQL Database, az Azure Cosmos DB-t, az Azure Keresés-t és az Application Insightst.
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 egy privát végponttal rendelkező Azure Cognitive Search szolgáltatást hoz létre.

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

A searchServices erőforrástípus üzembe helyezhető a következő célműveletekkel:

  • Erőforráscsoportok

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplóban találja.

Erőforrás formátuma

Microsoft létrehozása. Keresés/searchServices erőforráshoz adja hozzá a következő Terraformot a sablonhoz.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Search/searchServices@2022-09-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type =  "SystemAssigned"
  }
  body = jsonencode({
    properties = {
      authOptions = {
        aadOrApiKey = {
          aadAuthFailureMode = "string"
        }
      }
      disableLocalAuth = bool
      encryptionWithCmk = {
        enforcement = "string"
      }
      hostingMode = "string"
      networkRuleSet = {
        ipRules = [
          {
            value = "string"
          }
        ]
      }
      partitionCount = int
      publicNetworkAccess = "string"
      replicaCount = int
    }
    sku = {
      name = "string"
    }
  })
}

Tulajdonságértékek

searchServices

Név Leírás Érték
típus Az erőforrás típusa "Microsoft. Keresés/searchServices@2022-09-01"
name Az erőforrás neve sztring (kötelező)
location Az a földrajzi hely, ahol az erőforrás él sztring (kötelező)
parent_id Az erőforráscsoportban való üzembe helyezéshez használja az adott erőforráscsoport azonosítóját. sztring (kötelező)
tags Erőforráscímkék. Címkenevek és -értékek szótára.
Sku A Keresés szolgáltatás termékváltozata, amely meghatározza az árszintet és a kapacitáskorlátokat. Ez a tulajdonság új Keresés szolgáltatás létrehozásakor szükséges. Sku
identity Az erőforrás identitása. Identitás
properties A keresési szolgáltatás tulajdonságai. SearchServiceProperties

Identitás

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

SearchServiceProperties

Név Leírás Érték
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
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ó igaz értékre, ha a "dataPlaneAuthOptions" definiálva van. logikai
encryptionWithCmk Meghatározza az erőforrások (például indexek) ügyfélkezelői kulcsokkal történő titkosítására vonatkozó szabályzatokat a keresési szolgáltatáson belül. EncryptionWithCmk
hostingMode Csak a standard3 termékváltozatra alkalmazható. Ezt a tulajdonságot beállíthatja úgy, hogy legfeljebb 3 nagy sűrűségű partíciót engedélyezzen, amelyek akár 1000 indexet is lehetővé tesznek, ami sokkal nagyobb, mint bármely más termékváltozat esetében engedélyezett maximális index. 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 Hálózatspecifikus szabályok, amelyek meghatározzák, hogyan lehet elérni a Azure Cognitive Search szolgáltatást. NetworkRuleSet
partitionCount A keresési szolgáltatás partícióinak száma; ha meg van adva, ez lehet 1, 2, 3, 4, 6 vagy 12. Az 1-nél nagyobb értékek csak 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ő változásait. Ha "letiltva" értékre van állítva, a nyilvános felületen keresztüli forgalom nem engedélyezett, és a privát végponti kapcsolatok a kizárólagos hozzáférési módszer. "letiltva"
"engedélyezve"
replicaCount A keresési szolgáltatás replikáinak száma. Ha meg van adva, akkor az értéknek 1 és 12 közöttinek kell lennie a standard termékváltozatok esetében, vagy 1 és 3 közötti értéknek kell lennie, amely az alapszintű termékváltozatot is magában foglalja. int

Korlátok:
Minimális érték = 1
Maximális érték = 12

DataPlaneAuthOptions

Név Leírás Érték
aadOrApiKey Azt jelzi, hogy az API-kulcs vagy az Azure Active Directoryból származó hozzáférési jogkivonat használható a hitelesítéshez. DataPlaneAadOrApiKeyAuthOption
apiKeyOnly Azt jelzi, hogy csak az API-kulcsot kell használni a hitelesítéshez.

DataPlaneAadOrApiKeyAuthOption

Név Leírás Érték
aadAuthFailureMode Ez a cikk azt ismerteti, hogy egy Search szolgáltatás adatsík API-ja milyen választ küld a sikertelen hitelesítést igénylő kérésekre. "http401WithBearerChallenge"
"http403"

EncryptionWithCmk

Név Leírás Érték
Végrehajtási Ez a cikk azt ismerteti, hogy a keresési szolgáltatásnak hogyan kell kikényszerítenie egy vagy több nem ügyfél által titkosított erőforrás használatát. "Letiltva"
"Engedélyezve"
"Meghatározatlan"

NetworkRuleSet

Név Leírás Érték
ipRules Ip-korlátozási szabályok listája, amelyek meghatározzák a bejövő hálózat(ok)t a keresési szolgáltatásvégponthoz való hozzáférés engedélyezésével. 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égponti kapcsolatok lennének a kizárólagos hozzáférési módszer. IpRule[]

IpRule

Név Leírás Érték
érték Engedélyezhető egyetlen IPv4-címnek (például 123.1.2.3) vagy CIDR formátumú IP-címtartománynak (pl. 123.1.2.3/24) megfelelő érték. sztring

SKU

Név Leírás Érték
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 a keresési egységenként nagyobb kapacitással. "standard3": A legnagyobb standard ajánlat, amely legfeljebb 12 partícióval és 12 replikával (vagy akár 3 olyan partícióval, amely több indexet biztosít, 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"