Microsoft. Zoekzoekdiensten 2026-09-01-preview

Bicep-resourcedefinitie

Het resourcetype searchServices kan worden geïmplementeerd met bewerkingen die zijn gericht op:

• Resourcegroepen - Zie opdrachten voor de implementatie van resourcegroepen

Zie wijzigingslogboek voor een lijst met gewijzigde eigenschappen in elke API-versie.

Gebruiksvoorbeelden

Voorbeelden van Bicep

Een eenvoudig voorbeeld van het implementeren van Search Service.

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'
  }
}

Geverifieerde Azure-modules

De volgende azure-geverifieerde modules kunnen worden gebruikt om dit resourcetype te implementeren.

Azure-snelstartvoorbeelden

De volgende Azure-quickstartsjablonen bicep-voorbeelden bevatten voor het implementeren van dit resourcetype.

Resource-indeling

Als u een Microsoft.Search/searchServices-resource wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

resource symbolicname 'Microsoft.Search/searchServices@2026-09-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    authOptions: {
      aadOrApiKey: {
        aadAuthFailureMode: 'string'
      }
      apiKeyOnly: any(...)
    }
    autoGeneratedDomainNameLabelScope: 'string'
    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-objecten

Stel de eigenschap @odata.type in om het type object op te geven.

Gebruik het volgende voor #Microsoft.Azure.Search.DataNoneIdentity:

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

Gebruik voor #Microsoft.Azure.Search.DataUserAssignedIdentity:

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

Eigenschapswaarden

Microsoft.Search/searchServices

AzureActiveDirectoryApplicationCredentials

Data-identiteit

DataGeenIdentiteit

DataPlaneAadOrApiKeyAuthOption

DataPlaneAuthOpties

DataUserAssignedIdentity

EncryptieWithCmk

Identity

IdentityUserAssignedIdentities

IpRegel

Netwerkregelset

SearchResourceEncryptionKey

SearchServiceProperties

Sku

Gevolgde brontags

UserAssignedIdentity

Resourcedefinitie van ARM-sjabloon

Het resourcetype searchServices kan worden geïmplementeerd met bewerkingen die zijn gericht op:

• Resourcegroepen - Zie resource group deployment-commando's Voor een lijst van gewijzigde eigenschappen in elke API-versie, zie wijzigingslogboek.

Gebruiksvoorbeelden

Snelstartsjablonen voor Azure

De volgende Azure-quickstartsjablonen dit resourcetype implementeren.

Template	Description
Azure AI Foundry Network beperkt	In deze set sjablonen wordt gedemonstreerd hoe u Azure AI Foundry instelt met Private Link en Uitgaand verkeer uitgeschakeld, met behulp van door Microsoft beheerde sleutels voor versleuteling en door Microsoft beheerde identiteitsconfiguratie voor de AI-resource.
Azure Cognitive Search-service	Met deze sjabloon maakt u een Azure Cognitive Search-service
Azure Cognitive Search-service met een privé-eindpunt	Met deze sjabloon maakt u een Azure Cognitive Search-service met een privé-eindpunt.
Met netwerk beveiligde agent met door de gebruiker beheerde identiteit	Deze set sjablonen laat zien hoe u Azure AI Agent Service instelt met isolatie van virtuele netwerken met behulp van door de gebruiker beheerde identiteit-authetication voor de AI-service/AOAI-verbinding en privénetwerkkoppelingen om de agent te verbinden met uw beveiligde gegevens.
van de Standard-agent instellen	Deze set sjablonen laat zien hoe u Azure AI Agent Service instelt met de standaardinstallatie, wat betekent dat beheerde identiteitsverificatie wordt uitgevoerd voor project-/hubverbindingen en openbare internettoegang is ingeschakeld. Agents maken gebruik van zoek- en opslagbronnen die eigendom zijn van één tenant. Met deze installatie hebt u volledige controle en zichtbaarheid van deze resources, maar er worden kosten in rekening gebracht op basis van uw gebruik.
web-app met een SQL Database, Azure Cosmos DB, Azure Search-	Deze sjabloon richt een web-app, een SQL Database, Azure Cosmos DB, Azure Search en Application Insights in.

Resource-indeling

Als u een Microsoft.Search/searchServices-resource wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

{
  "type": "Microsoft.Search/searchServices",
  "apiVersion": "2026-09-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "authOptions": {
      "aadOrApiKey": {
        "aadAuthFailureMode": "string"
      },
      "apiKeyOnly": {}
    },
    "autoGeneratedDomainNameLabelScope": "string",
    "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-objecten

Stel de eigenschap @odata.type in om het type object op te geven.

Gebruik het volgende voor #Microsoft.Azure.Search.DataNoneIdentity:

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

Gebruik voor #Microsoft.Azure.Search.DataUserAssignedIdentity:

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

Eigenschapswaarden

Microsoft.Search/searchServices

AzureActiveDirectoryApplicationCredentials

Data-identiteit

DataGeenIdentiteit

DataPlaneAadOrApiKeyAuthOption

DataPlaneAuthOpties

DataUserAssignedIdentity

EncryptieWithCmk

Identity

IdentityUserAssignedIdentities

IpRegel

Netwerkregelset

SearchResourceEncryptionKey

SearchServiceProperties

Sku

Gevolgde brontags

UserAssignedIdentity

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype searchServices kan worden geïmplementeerd met bewerkingen die zijn gericht op:

• Resourcegroepen Voor een lijst van gewijzigde eigenschappen in elke API-versie, zie wijzigingslogboek.

Gebruiksvoorbeelden

Terraform-voorbeelden

Een eenvoudig voorbeeld van het implementeren van Search Service.

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    = ["*"]
}

Geverifieerde Azure-modules

De volgende azure-geverifieerde modules kunnen worden gebruikt om dit resourcetype te implementeren.

Resource-indeling

Als u een Microsoft.Search/searchServices-resource wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Search/searchServices@2026-09-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 = ?
      }
      autoGeneratedDomainNameLabelScope = "string"
      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-objecten

Stel de eigenschap @odata.type in om het type object op te geven.

Gebruik het volgende voor #Microsoft.Azure.Search.DataNoneIdentity:

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

Gebruik voor #Microsoft.Azure.Search.DataUserAssignedIdentity:

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

Eigenschapswaarden

Microsoft.Search/searchServices

AzureActiveDirectoryApplicationCredentials

Data-identiteit

DataGeenIdentiteit

DataPlaneAadOrApiKeyAuthOption

DataPlaneAuthOpties

DataUserAssignedIdentity

EncryptieWithCmk

Identity

IdentityUserAssignedIdentities

IpRegel

Netwerkregelset

SearchResourceEncryptionKey

SearchServiceProperties

Sku

Gevolgde brontags

UserAssignedIdentity