Microsoft. Sök sökningTjänster 2026-03-01-förhandsvisning

Bicep-resursdefinition

Resurstypen searchServices kan distribueras med åtgärder som mål:

• Resursgrupper - Se resursgruppsutplaceringskommandon

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

Azure-snabbstartsexempel

Följande Azure-snabbstartsmallar innehålla Bicep-exempel för distribution av den här resurstypen.

Resursformat

Om du vill skapa en Microsoft.Search/searchServices-resurs lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.Search/searchServices@2026-03-01-preview' = {
  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'
      serviceLevelEncryptionKey: {
        accessCredentials: {
          applicationId: 'string'
          applicationSecret: 'string'
        }
        identity: {
          @odata.type: 'string'
          // For remaining properties, see DataIdentity objects
        }
        keyVaultKeyName: 'string'
        keyVaultKeyVersion: 'string'
        keyVaultUri: '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'
  }
}

DataIdentity-objekt

Ange egenskapen @odata.type för att ange typ av objekt.

För #Microsoft.Azure.Search.DataNoneIdentity använder du:

{
  @odata.type: '#Microsoft.Azure.Search.DataNoneIdentity'
}

För #Microsoft.Azure.Search.DataUserAssignedIdentity använder du:

{
  @odata.type: '#Microsoft.Azure.Search.DataUserAssignedIdentity'
  federatedIdentityClientId: 'string'
  userAssignedIdentity: 'string'
}

Egenskapsvärden

Microsoft.Search/searchServices

AzureActiveDirectoryApplicationCredentials

DataIdentity (på engelska)

DataNoneIdentity

DataPlaneAadOrApiKeyAuthOption

DataPlaneAuthOptions (på engelska)

DataUserAssignedIdentity

EncryptionWithCmk (Kryptering med Cmk)

Identitet

IdentityUserAssignedIdentiteter

IpRule (på engelska)

NetworkRuleSet (på engelska)

SearchResourceEncryptionKey (på engelska)

SearchServiceProperties (på engelska)

Sku

Spårade resurstaggar

UserAssignedIdentity

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 Quickstart-mallar distribuerar denna resurstyp.

Template	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-databas, Azure Cosmos DB, Azure Search	Denna mall tillhandahåller en webbapp, en SQL-databas, 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": "2026-03-01-preview",
  "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",
      "serviceLevelEncryptionKey": {
        "accessCredentials": {
          "applicationId": "string",
          "applicationSecret": "string"
        },
        "identity": {
          "@odata.type": "string"
          // For remaining properties, see DataIdentity objects
        },
        "keyVaultKeyName": "string",
        "keyVaultKeyVersion": "string",
        "keyVaultUri": "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"
  }
}

DataIdentity-objekt

Ange egenskapen @odata.type för att ange typ av objekt.

För #Microsoft.Azure.Search.DataNoneIdentity använder du:

{
  "@odata.type": "#Microsoft.Azure.Search.DataNoneIdentity"
}

För #Microsoft.Azure.Search.DataUserAssignedIdentity använder du:

{
  "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
  "federatedIdentityClientId": "string",
  "userAssignedIdentity": "string"
}

Egenskapsvärden

Microsoft.Search/searchServices

AzureActiveDirectoryApplicationCredentials

DataIdentity (på engelska)

DataNoneIdentity

DataPlaneAadOrApiKeyAuthOption

DataPlaneAuthOptions (på engelska)

DataUserAssignedIdentity

EncryptionWithCmk (Kryptering med Cmk)

Identitet

IdentityUserAssignedIdentiteter

IpRule (på engelska)

NetworkRuleSet (på engelska)

SearchResourceEncryptionKey (på engelska)

SearchServiceProperties (på engelska)

Sku

Spårade resurstaggar

UserAssignedIdentity

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

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@2026-03-01-preview"
  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"
        serviceLevelEncryptionKey = {
          accessCredentials = {
            applicationId = "string"
            applicationSecret = "string"
          }
          identity = {
            @odata.type = "string"
            // For remaining properties, see DataIdentity objects
          }
          keyVaultKeyName = "string"
          keyVaultKeyVersion = "string"
          keyVaultUri = "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"
    }
  }
}

DataIdentity-objekt

Ange egenskapen @odata.type för att ange typ av objekt.

För #Microsoft.Azure.Search.DataNoneIdentity använder du:

{
  @odata.type = "#Microsoft.Azure.Search.DataNoneIdentity"
}

För #Microsoft.Azure.Search.DataUserAssignedIdentity använder du:

{
  @odata.type = "#Microsoft.Azure.Search.DataUserAssignedIdentity"
  federatedIdentityClientId = "string"
  userAssignedIdentity = "string"
}

Egenskapsvärden

Microsoft.Search/searchServices

AzureActiveDirectoryApplicationCredentials

DataIdentity (på engelska)

DataNoneIdentity

DataPlaneAadOrApiKeyAuthOption

DataPlaneAuthOptions (på engelska)

DataUserAssignedIdentity

EncryptionWithCmk (Kryptering med Cmk)

Identitet

IdentityUserAssignedIdentiteter

IpRule (på engelska)

NetworkRuleSet (på engelska)

SearchResourceEncryptionKey (på engelska)

SearchServiceProperties (på engelska)

Sku

Spårade resurstaggar

UserAssignedIdentity