Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
- senaste
- 2026-11-01
- 2026-09-01-förhandsvisning
- 2026-03-01-förhandsvisning
- 2025-05-01
- Förhandsversion 2025-02-01
- Förhandsversion 2024-06-01
- 2024-03-01 – förhandsversion
- 2023-11-01
- 2022-09-01
- 2021-04-01-preview
- 2020-08-01
- Förhandsversion 2020-08-01
- 2020-03-13
- Förhandsversion 2019-10-01
- 2015-08-19
- 2015-02-28
Bicep-resursdefinition
Resurstypen searchServices kan distribueras med åtgärder som mål:
- Resursgrupper – Se resursgruppsdistributionskommandon
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Användningsexempel
Bicep-exempel
Ett grundläggande exempel på distribution av söktjänsten.
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-verifierade moduler
Följande Azure-verifierade moduler kan användas för att distribuera den här resurstypen.
| Modul | Beskrivning |
|---|---|
| Söktjänst | AVM-resursmodul för söktjänsten |
Azure-snabbstartsexempel
Följande Azure-snabbstartsmallar innehålla Bicep-exempel för distribution av den här resurstypen.
| Bicep-fil | Beskrivning |
|---|---|
| Azure AI Foundry Nätverk begränsat | Den här uppsättningen mallar visar hur du konfigurerar Azure AI Foundry med privat länk och utgående trafik inaktiverat, med hjälp av Microsoft-hanterade nycklar för kryptering och Microsoft-hanterad identitetskonfiguration för AI-resursen. |
| Azure Cognitive Search-tjänsten | Den här mallen skapar en Azure Cognitive Search-tjänst |
| nätverkssäkrad agent med användarhanterad identitet | Den här uppsättningen mallar visar hur du konfigurerar Azure AI Agent Service med virtuell nätverksisolering med hjälp av användarhanterad identitetsautentisering för AI Service/AOAI-anslutningen och privata nätverkslänkar för att ansluta agenten till dina säkra data. |
| Standardagentkonfiguration | Den här uppsättningen mallar visar hur du konfigurerar Azure AI Agent Service med standardkonfigurationen, vilket innebär att hanterad identitetsautentisering för projekt-/hubbanslutningar och offentlig Internetåtkomst är aktiverat. Agenter använder kundägda sök- och lagringsresurser för en enda klientorganisation. Med den här konfigurationen har du fullständig kontroll och insyn över dessa resurser, men du kommer att medföra kostnader baserat på din användning. |
Resursformat
Om du vill skapa en Microsoft.Search/searchServices-resurs lägger du till följande Bicep i mallen.
resource symbolicname 'Microsoft.Search/searchServices@2020-08-01' = {
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'
}
}
Egenskapsvärden
Microsoft.Search/searchServices
| Namn | Beskrivning | Värde |
|---|---|---|
| identitet | Resursens identitet. | identitet |
| plats | Den geo-plats där resursen finns | sträng (krävs) |
| Namn | Resursnamnet | sträng (krävs) |
| Egenskaper | Egenskaper för söktjänsten. | SearchServiceProperties (på engelska) |
| Sku | SKU:n för söktjänsten, som avgör prisnivå och kapacitetsgränser. Den här egenskapen krävs när du skapar en ny söktjänst. | Sku |
| Taggar | Resurstaggar | Ordlista med taggnamn och värden. Se taggar i mallar |
Identitet
| Namn | Beskrivning | Värde |
|---|---|---|
| typ | Identitetstypen. | "Ingen" "SystemAssigned" (krävs) |
IpRule (på engelska)
| Namn | Beskrivning | Värde |
|---|---|---|
| värde | Värde som motsvarar en enskild IPv4-adress (t.ex. 123.1.2.3) eller ett IP-intervall i CIDR-format (t.ex. 123.1.2.3/24) som ska tillåtas. | sträng |
NetworkRuleSet (på engelska)
| Namn | Beskrivning | Värde |
|---|---|---|
| ipRegler | En lista över IP-begränsningsregler som definierar inkommande nätverk med åtkomst till söktjänstens slutpunkt. Under tiden blockeras alla andra offentliga IP-nätverk av brandväggen. Dessa begränsningsregler tillämpas endast när "publicNetworkAccess" för söktjänsten är "aktiverad". Annars tillåts inte trafik via det offentliga gränssnittet ens med några offentliga IP-regler, och privata slutpunktsanslutningar skulle vara den exklusiva åtkomstmetoden. | IpRule[] |
SearchServiceProperties (på engelska)
| Namn | Beskrivning | Värde |
|---|---|---|
| hostingMode (värdläge) | Gäller endast för standard3 SKU. Du kan ställa in den här egenskapen för att aktivera upp till 3 partitioner med hög densitet som tillåter upp till 1 000 index, vilket är mycket högre än de högsta index som tillåts för andra SKU:er. För SKU:n standard3 är värdet antingen "default" eller "highDensity". För alla andra SKU:er måste det här värdet vara "standard". | "standard" "highDensity" |
| networkRuleSet | Nätverksspecifika regler som avgör hur Azure Cognitive Search-tjänsten kan nås. | NetworkRuleSet (på engelska) |
| antal partitioner | Antalet partitioner i söktjänsten. Om det anges kan det vara 1, 2, 3, 4, 6 eller 12. Värden som är större än 1 är endast giltiga för standard-SKU:er. För "standard3"-tjänster med hostingMode inställt på "highDensity" är de tillåtna värdena mellan 1 och 3. | Int Begränsningar: Minsta värde = 1 Maxvärde = 12 |
| publicNetworkAccess (publicNetworkÅtkomst) | Det här värdet kan anges till "aktiverat" för att undvika icke-bakåtkompatibla ändringar av befintliga kundresurser och mallar. Om inställningen är "inaktiverad" tillåts inte trafik via det offentliga gränssnittet och privata slutpunktsanslutningar är den exklusiva åtkomstmetoden. | "inaktiverad" "aktiverad" |
| antal repliker | Antalet repliker i söktjänsten. Om det anges måste det vara ett värde mellan 1 och 12 inklusive för standard-SKU:er eller mellan 1 och 3 inklusive för grundläggande SKU. | Int Begränsningar: Minsta värde = 1 Maxvärde = 12 |
Sku
| Namn | Beskrivning | Värde |
|---|---|---|
| Namn | SKU:n för söktjänsten. Giltiga värden är: "kostnadsfri": Delad tjänst. "basic": Dedikerad tjänst med upp till 3 repliker. Standard: Dedikerad tjänst med upp till 12 partitioner och 12 repliker. "standard2": Liknar standard, men med mer kapacitet per sökenhet. "standard3": Det största standarderbjudandet med upp till 12 partitioner och 12 repliker (eller upp till 3 partitioner med fler index om du också ställer in egenskapen hostingMode till "highDensity"). "storage_optimized_l1": Stöder 1 TB per partition, upp till 12 partitioner. "storage_optimized_l2": Stöder 2 TB per partition, upp till 12 partitioner. | "grundläggande" "gratis" "standard" "standard2" "standard3" "storage_optimized_l1" "storage_optimized_l2" |
Spårade resurstaggar
| Namn | Beskrivning | Värde |
|---|
Resursdefinition för ARM-mall
Resurstypen searchServices kan distribueras med åtgärder som mål:
- Resursgrupper – Se resursgruppsutplaceringskommandon För en lista över ändrade egenskaper i varje API-version, se förändringslogg.
Användningsexempel
Azure-snabbstartsmallar
Följande Azure-snabbstartsmallar distribuera den här resurstypen.
| Mall | Beskrivning |
|---|---|
|
Azure AI Foundry Nätverk begränsat |
Den här uppsättningen mallar visar hur du konfigurerar Azure AI Foundry med privat länk och utgående trafik inaktiverat, med hjälp av Microsoft-hanterade nycklar för kryptering och Microsoft-hanterad identitetskonfiguration för AI-resursen. |
|
Azure Cognitive Search-tjänsten |
Den här mallen skapar en Azure Cognitive Search-tjänst |
|
Azure Cognitive Search-tjänsten med privat slutpunkt |
Den här mallen skapar en Azure Cognitive Search-tjänst med en privat slutpunkt. |
|
nätverkssäkrad agent med användarhanterad identitet |
Den här uppsättningen mallar visar hur du konfigurerar Azure AI Agent Service med virtuell nätverksisolering med hjälp av användarhanterad identitetsautentisering för AI Service/AOAI-anslutningen och privata nätverkslänkar för att ansluta agenten till dina säkra data. |
|
Standardagentkonfiguration |
Den här uppsättningen mallar visar hur du konfigurerar Azure AI Agent Service med standardkonfigurationen, vilket innebär att hanterad identitetsautentisering för projekt-/hubbanslutningar och offentlig Internetåtkomst är aktiverat. Agenter använder kundägda sök- och lagringsresurser för en enda klientorganisation. Med den här konfigurationen har du fullständig kontroll och insyn över dessa resurser, men du kommer att medföra kostnader baserat på din användning. |
|
webbapp med en SQL Database, Azure Cosmos DB, Azure Search |
Den här mallen etablerar en webbapp, en SQL Database, Azure Cosmos DB, Azure Search och Application Insights. |
Resursformat
Om du vill skapa en Microsoft.Search/searchServices-resurs lägger du till följande JSON i mallen.
{
"type": "Microsoft.Search/searchServices",
"apiVersion": "2020-08-01",
"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"
}
}
Egenskapsvärden
Microsoft.Search/searchServices
| Namn | Beskrivning | Värde |
|---|---|---|
| apiVersion | API-versionen | '2020-08-01' |
| identitet | Resursens identitet. | identitet |
| plats | Den geo-plats där resursen finns | sträng (krävs) |
| Namn | Resursnamnet | sträng (krävs) |
| Egenskaper | Egenskaper för söktjänsten. | SearchServiceProperties (på engelska) |
| Sku | SKU:n för söktjänsten, som avgör prisnivå och kapacitetsgränser. Den här egenskapen krävs när du skapar en ny söktjänst. | Sku |
| Taggar | Resurstaggar | Ordlista med taggnamn och värden. Se taggar i mallar |
| typ | Resurstypen | "Microsoft.Search/searchServices" |
Identitet
| Namn | Beskrivning | Värde |
|---|---|---|
| typ | Identitetstypen. | "Ingen" "SystemAssigned" (krävs) |
IpRule (på engelska)
| Namn | Beskrivning | Värde |
|---|---|---|
| värde | Värde som motsvarar en enskild IPv4-adress (t.ex. 123.1.2.3) eller ett IP-intervall i CIDR-format (t.ex. 123.1.2.3/24) som ska tillåtas. | sträng |
NetworkRuleSet (på engelska)
| Namn | Beskrivning | Värde |
|---|---|---|
| ipRegler | En lista över IP-begränsningsregler som definierar inkommande nätverk med åtkomst till söktjänstens slutpunkt. Under tiden blockeras alla andra offentliga IP-nätverk av brandväggen. Dessa begränsningsregler tillämpas endast när "publicNetworkAccess" för söktjänsten är "aktiverad". Annars tillåts inte trafik via det offentliga gränssnittet ens med några offentliga IP-regler, och privata slutpunktsanslutningar skulle vara den exklusiva åtkomstmetoden. | IpRule[] |
SearchServiceProperties (på engelska)
| Namn | Beskrivning | Värde |
|---|---|---|
| hostingMode (värdläge) | Gäller endast för standard3 SKU. Du kan ställa in den här egenskapen för att aktivera upp till 3 partitioner med hög densitet som tillåter upp till 1 000 index, vilket är mycket högre än de högsta index som tillåts för andra SKU:er. För SKU:n standard3 är värdet antingen "default" eller "highDensity". För alla andra SKU:er måste det här värdet vara "standard". | "standard" "highDensity" |
| networkRuleSet | Nätverksspecifika regler som avgör hur Azure Cognitive Search-tjänsten kan nås. | NetworkRuleSet (på engelska) |
| antal partitioner | Antalet partitioner i söktjänsten. Om det anges kan det vara 1, 2, 3, 4, 6 eller 12. Värden som är större än 1 är endast giltiga för standard-SKU:er. För "standard3"-tjänster med hostingMode inställt på "highDensity" är de tillåtna värdena mellan 1 och 3. | Int Begränsningar: Minsta värde = 1 Maxvärde = 12 |
| publicNetworkAccess (publicNetworkÅtkomst) | Det här värdet kan anges till "aktiverat" för att undvika icke-bakåtkompatibla ändringar av befintliga kundresurser och mallar. Om inställningen är "inaktiverad" tillåts inte trafik via det offentliga gränssnittet och privata slutpunktsanslutningar är den exklusiva åtkomstmetoden. | "inaktiverad" "aktiverad" |
| antal repliker | Antalet repliker i söktjänsten. Om det anges måste det vara ett värde mellan 1 och 12 inklusive för standard-SKU:er eller mellan 1 och 3 inklusive för grundläggande SKU. | Int Begränsningar: Minsta värde = 1 Maxvärde = 12 |
Sku
| Namn | Beskrivning | Värde |
|---|---|---|
| Namn | SKU:n för söktjänsten. Giltiga värden är: "kostnadsfri": Delad tjänst. "basic": Dedikerad tjänst med upp till 3 repliker. Standard: Dedikerad tjänst med upp till 12 partitioner och 12 repliker. "standard2": Liknar standard, men med mer kapacitet per sökenhet. "standard3": Det största standarderbjudandet med upp till 12 partitioner och 12 repliker (eller upp till 3 partitioner med fler index om du också ställer in egenskapen hostingMode till "highDensity"). "storage_optimized_l1": Stöder 1 TB per partition, upp till 12 partitioner. "storage_optimized_l2": Stöder 2 TB per partition, upp till 12 partitioner. | "grundläggande" "gratis" "standard" "standard2" "standard3" "storage_optimized_l1" "storage_optimized_l2" |
Spårade resurstaggar
| Namn | Beskrivning | Värde |
|---|
Resursdefinition för Terraform (AzAPI-provider)
Resurstypen searchServices kan distribueras med åtgärder som mål:
- Resursgrupper För en lista över ändrade egenskaper i varje API-version, se ändringslogg.
Användningsexempel
Terraform-exempel
Ett grundläggande exempel på distribution av söktjänsten.
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-verifierade moduler
Följande Azure-verifierade moduler kan användas för att distribuera den här resurstypen.
| Modul | Beskrivning |
|---|---|
| Söktjänst | AVM-resursmodul för söktjänsten |
Resursformat
Om du vill skapa en Microsoft.Search/searchServices-resurs lägger du till följande Terraform i mallen.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Search/searchServices@2020-08-01"
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"
}
}
}
Egenskapsvärden
Microsoft.Search/searchServices
| Namn | Beskrivning | Värde |
|---|---|---|
| identitet | Resursens identitet. | identitet |
| plats | Den geo-plats där resursen finns | sträng (krävs) |
| Namn | Resursnamnet | sträng (krävs) |
| Egenskaper | Egenskaper för söktjänsten. | SearchServiceProperties (på engelska) |
| Sku | SKU:n för söktjänsten, som avgör prisnivå och kapacitetsgränser. Den här egenskapen krävs när du skapar en ny söktjänst. | Sku |
| Taggar | Resurstaggar | Ordlista med taggnamn och värden. |
| typ | Resurstypen | "Microsoft.Search/searchServices@2020-08-01" |
Identitet
| Namn | Beskrivning | Värde |
|---|---|---|
| typ | Identitetstypen. | "Ingen" "SystemAssigned" (krävs) |
IpRule (på engelska)
| Namn | Beskrivning | Värde |
|---|---|---|
| värde | Värde som motsvarar en enskild IPv4-adress (t.ex. 123.1.2.3) eller ett IP-intervall i CIDR-format (t.ex. 123.1.2.3/24) som ska tillåtas. | sträng |
NetworkRuleSet (på engelska)
| Namn | Beskrivning | Värde |
|---|---|---|
| ipRegler | En lista över IP-begränsningsregler som definierar inkommande nätverk med åtkomst till söktjänstens slutpunkt. Under tiden blockeras alla andra offentliga IP-nätverk av brandväggen. Dessa begränsningsregler tillämpas endast när "publicNetworkAccess" för söktjänsten är "aktiverad". Annars tillåts inte trafik via det offentliga gränssnittet ens med några offentliga IP-regler, och privata slutpunktsanslutningar skulle vara den exklusiva åtkomstmetoden. | IpRule[] |
SearchServiceProperties (på engelska)
| Namn | Beskrivning | Värde |
|---|---|---|
| hostingMode (värdläge) | Gäller endast för standard3 SKU. Du kan ställa in den här egenskapen för att aktivera upp till 3 partitioner med hög densitet som tillåter upp till 1 000 index, vilket är mycket högre än de högsta index som tillåts för andra SKU:er. För SKU:n standard3 är värdet antingen "default" eller "highDensity". För alla andra SKU:er måste det här värdet vara "standard". | "standard" "highDensity" |
| networkRuleSet | Nätverksspecifika regler som avgör hur Azure Cognitive Search-tjänsten kan nås. | NetworkRuleSet (på engelska) |
| antal partitioner | Antalet partitioner i söktjänsten. Om det anges kan det vara 1, 2, 3, 4, 6 eller 12. Värden som är större än 1 är endast giltiga för standard-SKU:er. För "standard3"-tjänster med hostingMode inställt på "highDensity" är de tillåtna värdena mellan 1 och 3. | Int Begränsningar: Minsta värde = 1 Maxvärde = 12 |
| publicNetworkAccess (publicNetworkÅtkomst) | Det här värdet kan anges till "aktiverat" för att undvika icke-bakåtkompatibla ändringar av befintliga kundresurser och mallar. Om inställningen är "inaktiverad" tillåts inte trafik via det offentliga gränssnittet och privata slutpunktsanslutningar är den exklusiva åtkomstmetoden. | "inaktiverad" "aktiverad" |
| antal repliker | Antalet repliker i söktjänsten. Om det anges måste det vara ett värde mellan 1 och 12 inklusive för standard-SKU:er eller mellan 1 och 3 inklusive för grundläggande SKU. | Int Begränsningar: Minsta värde = 1 Maxvärde = 12 |
Sku
| Namn | Beskrivning | Värde |
|---|---|---|
| Namn | SKU:n för söktjänsten. Giltiga värden är: "kostnadsfri": Delad tjänst. "basic": Dedikerad tjänst med upp till 3 repliker. Standard: Dedikerad tjänst med upp till 12 partitioner och 12 repliker. "standard2": Liknar standard, men med mer kapacitet per sökenhet. "standard3": Det största standarderbjudandet med upp till 12 partitioner och 12 repliker (eller upp till 3 partitioner med fler index om du också ställer in egenskapen hostingMode till "highDensity"). "storage_optimized_l1": Stöder 1 TB per partition, upp till 12 partitioner. "storage_optimized_l2": Stöder 2 TB per partition, upp till 12 partitioner. | "grundläggande" "gratis" "standard" "standard2" "standard3" "storage_optimized_l1" "storage_optimized_l2" |
Spårade resurstaggar
| Namn | Beskrivning | Värde |
|---|