Службы поиска Microsoft.Search

Определение ресурсов Bicep

Тип ресурса searchServices можно развернуть с помощью операций, целевых:

• группы ресурсов . См. команды развертывания группы ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Примеры использования

Примеры Bicep

Простой пример развертывания службы поиска.

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

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.

Примеры быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.

Формат ресурса

Чтобы создать ресурс Microsoft.Search/searchServices, добавьте следующий 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'
  }
}

Объекты DataIdentity

Задайте свойство @odata.type, чтобы указать тип объекта.

Для #Microsoft.Azure.Search.DataNoneIdentity используйте:

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

Для #Microsoft.Azure.Search.DataUserAssignedIdentity используйте:

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

Значения свойств

Microsoft.Search/searchServices

AzureActiveDirectoryApplicationCredentials

Идентификация данных

ДанныеНеидентификация

DataPlaneAadOrApiKeyAuthOption

Параметры DataPlaneAuthOptions

Идентификатор DataUserAssignedIdentity

EncryptionWithCmk (ШифрованиеWithCmk)

Тождество

IdentityUserAssignedIdentities

Правило IpRule

Набор сетевых правил

SearchResourceEncryptionKey (Ключ шифрования)

SearchServiceProperties (Свойства SearchService)

Артикул

Отслеживаемые Ресурсные Теги

Пользовательская назначенная идентичность

Определение ресурса шаблона ARM

Тип ресурса searchServices можно развернуть с помощью операций, целевых:

• Группы ресурсов — см. команды развертывания групп ресурсов Для списка изменённых свойств в каждой версии API см. журнал изменений.

Примеры использования

Шаблоны быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.

Шаблон	Описание
Ограниченная сеть Azure AI Foundry развертывание	В этом наборе шаблонов показано, как настроить Azure AI Foundry с отключенным приватным каналом и исходящим трафиком, используя ключи, управляемые корпорацией Майкрософт, для шифрования и конфигурацию удостоверений, управляемую корпорацией Майкрософт для ресурса ИИ.
службы когнитивного поиска Azure развертывание	Этот шаблон создает службу Когнитивного поиска Azure
Службе Когнитивного поиска Azure с частной конечной точкой развертывание	Этот шаблон создает службу Когнитивного поиска Azure с частной конечной точкой.
агент с управляемым удостоверением пользователя развертывание	Этот набор шаблонов демонстрирует настройку службы агента ИИ Azure с изоляцией виртуальной сети с помощью проверки подлинности управляемого удостоверения пользователей для подключения службы ИИ/AOAI и частных сетевых каналов для подключения агента к защищенным данным.
настройка стандартного агента развертывание	В этом наборе шаблонов показано, как настроить службу агента ИИ Azure со стандартной настройкой, то есть с проверкой подлинности управляемого удостоверения для подключений к проекту или концентратору и общедоступного доступа к Интернету. Агенты используют ресурсы поиска и хранилища с одним клиентом. С помощью этой настройки вы можете полностью контролировать и просматривать эти ресурсы, но вы будете нести расходы на основе использования.
веб-приложение с базой данных SQL, Azure Cosmos DB, поиском Azure развертывание	Этот шаблон подготавливает веб-приложение, базу данных SQL, Azure Cosmos DB, поиск Azure и Application Insights.

Формат ресурса

Чтобы создать ресурс Microsoft.Search/searchServices, добавьте следующий код 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"
  }
}

Объекты DataIdentity

Задайте свойство @odata.type, чтобы указать тип объекта.

Для #Microsoft.Azure.Search.DataNoneIdentity используйте:

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

Для #Microsoft.Azure.Search.DataUserAssignedIdentity используйте:

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

Значения свойств

Microsoft.Search/searchServices

AzureActiveDirectoryApplicationCredentials

Идентификация данных

ДанныеНеидентификация

DataPlaneAadOrApiKeyAuthOption

Параметры DataPlaneAuthOptions

Идентификатор DataUserAssignedIdentity

EncryptionWithCmk (ШифрованиеWithCmk)

Тождество

IdentityUserAssignedIdentities

Правило IpRule

Набор сетевых правил

SearchResourceEncryptionKey (Ключ шифрования)

SearchServiceProperties (Свойства SearchService)

Артикул

Отслеживаемые Ресурсные Теги

Пользовательская назначенная идентичность

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса searchServices можно развернуть с помощью операций, целевых:

• Группы ресурсов Список изменённых свойств в каждой версии API см. журнал изменений.

Примеры использования

Примеры Terraform

Простой пример развертывания службы поиска.

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

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.

Формат ресурса

Чтобы создать ресурс Microsoft.Search/searchServices, добавьте следующий объект 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"
    }
  }
}

Объекты DataIdentity

Задайте свойство @odata.type, чтобы указать тип объекта.

Для #Microsoft.Azure.Search.DataNoneIdentity используйте:

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

Для #Microsoft.Azure.Search.DataUserAssignedIdentity используйте:

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

Значения свойств

Microsoft.Search/searchServices

AzureActiveDirectoryApplicationCredentials

Идентификация данных

ДанныеНеидентификация

DataPlaneAadOrApiKeyAuthOption

Параметры DataPlaneAuthOptions

Идентификатор DataUserAssignedIdentity

EncryptionWithCmk (ШифрованиеWithCmk)

Тождество

IdentityUserAssignedIdentities

Правило IpRule

Набор сетевых правил

SearchResourceEncryptionKey (Ключ шифрования)

SearchServiceProperties (Свойства SearchService)

Артикул

Отслеживаемые Ресурсные Теги

Пользовательская назначенная идентичность