Microsoft. Vyhledávání Služby 2026-09-01-náhled

Definice prostředku Bicep

Typ prostředku searchServices je možné nasadit s operacemi, které cílí:

• skupiny prostředků – viz příkazy nasazení skupiny prostředků

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Příklady použití

ukázky Bicep

Základní příklad nasazení vyhledávací služby.

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

Ověřené moduly Azure

K nasazení tohoto typu prostředku je možné použít následující ověřené moduly Azure.

Ukázky rychlého startu Azure

Následující šablony Azure pro rychlý start obsahují ukázky Bicep pro nasazení tohoto typu prostředku.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Search/searchServices, přidejte do šablony následující bicep.

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

Objekty DataIdentity

Nastavte vlastnost @odata.type pro určení typu objektu.

Pro #Microsoft.Azure.Search.DataNoneIdentity použijte:

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

Pro #Microsoft.Azure.Search.DataUserAssignedIdentity použijte:

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

Hodnoty vlastností

Microsoft.Search/searchServices

AzureActiveDirectoryApplicationCredentials

Datová identita

Identifikátor DataNoneIdentity

DataPlaneAaadOrApiKeyAuthOption

Možnosti datové roviny

Přiřazená identita uživatele DataUser

EncryptionWithCmk

Identity

IdentityUserAssignedIdentities

Pravidlo protokolu IpRule

Sada pravidel sítě

Klíč šifrování zdrojů

Vlastnosti služby SearchService

Sku

TrackedResourceTags

UserAssignedIdentity

Definice prostředku šablony ARM

Typ prostředku searchServices je možné nasadit s operacemi, které cílí:

• Skupiny zdrojů – viz příkazy pro nasazení skupin zdrojů Pro seznam změněných vlastností v každé verzi API viz log změn.

Příklady použití

šablony pro rychlý start pro Azure

Následující šablony Azure Pro rychlý start nasadit tento typ prostředku.

Template	Description
Síť Azure AI Foundry je omezena	Tato sada šablon ukazuje, jak nastavit Azure AI Foundry se zakázaným privátním propojením a výstupním přenosem pomocí klíčů spravovaných Microsoftem pro šifrování a konfigurace identity spravované Microsoftem pro prostředek AI.
služby Azure Cognitive Search	Tato šablona vytvoří službu Azure Cognitive Search.
služby Azure Cognitive Search s privátním koncovým bodem	Tato šablona vytvoří službu Azure Cognitive Search s privátním koncovým bodem.
agenta zabezpečeného sítí s identitou spravovanou uživatelem	Tato sada šablon ukazuje, jak nastavit službu agenta Azure AI s izolací virtuální sítě pomocí autetika identity spravované uživatelem pro připojení a AI Service/AOAI a privátní síťové propojení pro připojení agenta k zabezpečeným datům.
nastavení standardního agenta	Tato sada šablon ukazuje, jak nastavit službu agenta Azure AI se standardním nastavením, což znamená ověřování spravovaných identit pro připojení k projektu nebo centru a povolený veřejný přístup k internetu. Agenti používají prostředky vyhledávání a úložiště vlastněné zákazníky s jedním tenantem. Díky tomuto nastavení máte plnou kontrolu a přehled o těchto prostředcích, ale na základě využití vám budou účtovány náklady.
webovou aplikaci se službou SQL Database, Azure Cosmos DB, službou Azure Search	Tato šablona zřídí webovou aplikaci, službu SQL Database, Azure Cosmos DB, Azure Search a Application Insights.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Search/searchServices, přidejte do šablony následující JSON.

{
  "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"
  }
}

Objekty DataIdentity

Nastavte vlastnost @odata.type pro určení typu objektu.

Pro #Microsoft.Azure.Search.DataNoneIdentity použijte:

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

Pro #Microsoft.Azure.Search.DataUserAssignedIdentity použijte:

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

Hodnoty vlastností

Microsoft.Search/searchServices

AzureActiveDirectoryApplicationCredentials

Datová identita

Identifikátor DataNoneIdentity

DataPlaneAaadOrApiKeyAuthOption

Možnosti datové roviny

Přiřazená identita uživatele DataUser

EncryptionWithCmk

Identity

IdentityUserAssignedIdentities

Pravidlo protokolu IpRule

Sada pravidel sítě

Klíč šifrování zdrojů

Vlastnosti služby SearchService

Sku

TrackedResourceTags

UserAssignedIdentity

Definice prostředku Terraformu (poskytovatel AzAPI)

Typ prostředku searchServices je možné nasadit s operacemi, které cílí:

• Skupiny zdrojů Pro seznam změněných vlastností v každé verzi API viz log změn.

Příklady použití

Ukázky Terraformu

Základní příklad nasazení vyhledávací služby.

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

Ověřené moduly Azure

K nasazení tohoto typu prostředku je možné použít následující ověřené moduly Azure.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Search/searchServices, přidejte do šablony následující Terraform.

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

Objekty DataIdentity

Nastavte vlastnost @odata.type pro určení typu objektu.

Pro #Microsoft.Azure.Search.DataNoneIdentity použijte:

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

Pro #Microsoft.Azure.Search.DataUserAssignedIdentity použijte:

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

Hodnoty vlastností

Microsoft.Search/searchServices

AzureActiveDirectoryApplicationCredentials

Datová identita

Identifikátor DataNoneIdentity

DataPlaneAaadOrApiKeyAuthOption

Možnosti datové roviny

Přiřazená identita uživatele DataUser

EncryptionWithCmk

Identity

IdentityUserAssignedIdentities

Pravidlo protokolu IpRule

Sada pravidel sítě

Klíč šifrování zdrojů

Vlastnosti služby SearchService

Sku

TrackedResourceTags

UserAssignedIdentity