Microsoft.Search searchServices 2020-03-13

Artigo
02/27/2025

Definição de recurso do Bicep

O tipo de recurso searchServices pode ser implantado com operações de destino:

Grupos de recursos - Consulte comandos de implantação do grupo de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Search/searchServices, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.Search/searchServices@2020-03-13' = {
  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'
  }
}

Valores de propriedade

Identidade

Nome	Descrição	Valor
tipo	O tipo de identidade.	'None' 'SystemAssigned' (obrigatório)

IpRule

Nome	Descrição	Valor
valor	Valor correspondente a um único endereço IPv4 (por exemplo, 123.1.2.3) ou um intervalo de IP no formato CIDR (por exemplo, 123.1.2.3/24) a ser permitido.	corda

Microsoft.Search/searchServices

Nome	Descrição	Valor
identidade	A identidade do recurso.	Identity
localização	A localização geográfica do recurso. Essa deve ser uma das Regiões Geográficas do Azure com suporte e registradas (por exemplo, Oeste dos EUA, Leste dos EUA, Sudeste Asiático e assim por diante). Essa propriedade é necessária ao criar um novo recurso.	corda
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	Propriedades do serviço De pesquisa.	SearchServiceProperties
Sku	A SKU do Serviço de Pesquisa, que determina o tipo de preço e os limites de capacidade. Essa propriedade é necessária ao criar um novo Serviço de Pesquisa.	de SKU
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos

NetworkRuleSet

Nome	Descrição	Valor
ipRules	Uma lista de regras de restrição de IP que define as redes de entrada com a permissão de acesso ao ponto de extremidade do serviço de pesquisa. Enquanto isso, todas as outras redes DE IP públicas são bloqueadas pelo firewall. Essas regras de restrição são aplicadas somente quando o 'publicNetworkAccess' do serviço de pesquisa está 'habilitado'; caso contrário, o tráfego pela interface pública não é permitido mesmo com nenhuma regra de IP pública, e as conexões de ponto de extremidade privado seriam o método de acesso exclusivo.	IpRule[]

ResourceTags

Nome	Descrição	Valor

SearchServiceProperties

Nome	Descrição	Valor
hostingMode	Aplicável somente para o SKU standard3. Você pode definir essa propriedade para habilitar até 3 partições de alta densidade que permitem até 1000 índices, o que é muito maior do que os índices máximos permitidos para qualquer outra SKU. Para o SKU standard3, o valor é "padrão" ou "highDensity". Para todos os outros SKUs, esse valor deve ser "padrão".	'default' 'highDensity'
networkRuleSet	Regras específicas de rede que determinam como o serviço do Azure Cognitive Search pode ser atingido.	NetworkRuleSet
partitionCount	O número de partições no serviço De pesquisa; se especificado, pode ser 1, 2, 3, 4, 6 ou 12. Valores maiores que 1 são válidos apenas para SKUs padrão. Para serviços 'standard3' com hostingMode definido como 'highDensity', os valores permitidos estão entre 1 e 3.	int Restrições: Valor mínimo = 1 Valor máximo = 12
publicNetworkAccess	Esse valor pode ser definido como "habilitado" para evitar alterações significativas em modelos e recursos de clientes existentes. Se definido como "desabilitado", o tráfego pela interface pública não será permitido e as conexões de ponto de extremidade privado serão o método de acesso exclusivo.	'desabilitado' 'habilitado'
replicaCount	O número de réplicas no serviço De pesquisa. Se especificado, ele deve ser um valor entre 1 e 12, inclusive para SKUs padrão ou entre 1 e 3, inclusive para SKU básica.	int Restrições: Valor mínimo = 1 Valor máximo = 12

Sku

Nome	Descrição	Valor
nome	A SKU do serviço de Pesquisa. Os valores válidos incluem: 'gratuito': serviço compartilhado. 'basic': serviço dedicado com até 3 réplicas. 'standard': serviço dedicado com até 12 partições e 12 réplicas. 'standard2': semelhante ao padrão, mas com mais capacidade por unidade de pesquisa. 'standard3': a maior oferta Standard com até 12 partições e 12 réplicas (ou até 3 partições com mais índices se você também definir a propriedade hostingMode como 'highDensity'). 'storage_optimized_l1': dá suporte a 1 TB por partição, até 12 partições. 'storage_optimized_l2': dá suporte a 2 TB por partição, até 12 partições.	'básico' 'gratuito' 'standard' 'standard2' 'standard3' 'storage_optimized_l1' 'storage_optimized_l2'

Exemplos de uso

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Módulo	Descrição
do Serviço de Pesquisa	Módulo de recurso da AVM para o Serviço de Pesquisa

Exemplos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep	Descrição
restrito de rede do Azure AI Studio	Esse conjunto de modelos demonstra como configurar o Azure AI Studio com o link privado e a saída desabilitados, usando chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
serviço do Azure Cognitive Search	Este modelo cria um serviço do Azure Cognitive Search
agente protegido de rede com de identidade gerenciada pelo usuário	Esse conjunto de modelos demonstra como configurar o Serviço de Agente de IA do Azure com isolamento de rede virtual usando a autenticação de Identidade Gerenciada do Usuário para a conexão serviço de IA/AOAI e links de rede privada para conectar o agente aos seus dados seguros.
de instalação do agente padrão	Esse conjunto de modelos demonstra como configurar o Serviço de Agente de IA do Azure com a configuração padrão, ou seja, com a autenticação de identidade gerenciada para conexões de projeto/hub e acesso público à Internet habilitado. Os agentes usam recursos de pesquisa e armazenamento de locatário único de propriedade do cliente. Com essa configuração, você tem controle total e visibilidade sobre esses recursos, mas incorrerá em custos com base em seu uso.

Definição de recurso de modelo do ARM

O tipo de recurso searchServices pode ser implantado com operações de destino:

Grupos de recursos - Consulte comandos de implantação do grupo de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Search/searchServices, adicione o JSON a seguir ao seu modelo.

{
  "type": "Microsoft.Search/searchServices",
  "apiVersion": "2020-03-13",
  "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"
  }
}

Valores de propriedade

Identidade

Nome	Descrição	Valor
tipo	O tipo de identidade.	'None' 'SystemAssigned' (obrigatório)

IpRule

Nome	Descrição	Valor
valor	Valor correspondente a um único endereço IPv4 (por exemplo, 123.1.2.3) ou um intervalo de IP no formato CIDR (por exemplo, 123.1.2.3/24) a ser permitido.	corda

Microsoft.Search/searchServices

Nome	Descrição	Valor
apiVersion	A versão da API	'2020-03-13'
identidade	A identidade do recurso.	Identity
localização	A localização geográfica do recurso. Essa deve ser uma das Regiões Geográficas do Azure com suporte e registradas (por exemplo, Oeste dos EUA, Leste dos EUA, Sudeste Asiático e assim por diante). Essa propriedade é necessária ao criar um novo recurso.	corda
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	Propriedades do serviço De pesquisa.	SearchServiceProperties
Sku	A SKU do Serviço de Pesquisa, que determina o tipo de preço e os limites de capacidade. Essa propriedade é necessária ao criar um novo Serviço de Pesquisa.	de SKU
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo	O tipo de recurso	'Microsoft.Search/searchServices'

NetworkRuleSet

Nome	Descrição	Valor
ipRules	Uma lista de regras de restrição de IP que define as redes de entrada com a permissão de acesso ao ponto de extremidade do serviço de pesquisa. Enquanto isso, todas as outras redes DE IP públicas são bloqueadas pelo firewall. Essas regras de restrição são aplicadas somente quando o 'publicNetworkAccess' do serviço de pesquisa está 'habilitado'; caso contrário, o tráfego pela interface pública não é permitido mesmo com nenhuma regra de IP pública, e as conexões de ponto de extremidade privado seriam o método de acesso exclusivo.	IpRule[]

ResourceTags

Nome	Descrição	Valor

SearchServiceProperties

Nome	Descrição	Valor
hostingMode	Aplicável somente para o SKU standard3. Você pode definir essa propriedade para habilitar até 3 partições de alta densidade que permitem até 1000 índices, o que é muito maior do que os índices máximos permitidos para qualquer outra SKU. Para o SKU standard3, o valor é "padrão" ou "highDensity". Para todos os outros SKUs, esse valor deve ser "padrão".	'default' 'highDensity'
networkRuleSet	Regras específicas de rede que determinam como o serviço do Azure Cognitive Search pode ser atingido.	NetworkRuleSet
partitionCount	O número de partições no serviço De pesquisa; se especificado, pode ser 1, 2, 3, 4, 6 ou 12. Valores maiores que 1 são válidos apenas para SKUs padrão. Para serviços 'standard3' com hostingMode definido como 'highDensity', os valores permitidos estão entre 1 e 3.	int Restrições: Valor mínimo = 1 Valor máximo = 12
publicNetworkAccess	Esse valor pode ser definido como "habilitado" para evitar alterações significativas em modelos e recursos de clientes existentes. Se definido como "desabilitado", o tráfego pela interface pública não será permitido e as conexões de ponto de extremidade privado serão o método de acesso exclusivo.	'desabilitado' 'habilitado'
replicaCount	O número de réplicas no serviço De pesquisa. Se especificado, ele deve ser um valor entre 1 e 12, inclusive para SKUs padrão ou entre 1 e 3, inclusive para SKU básica.	int Restrições: Valor mínimo = 1 Valor máximo = 12

Sku

Nome	Descrição	Valor
nome	A SKU do serviço de Pesquisa. Os valores válidos incluem: 'gratuito': serviço compartilhado. 'basic': serviço dedicado com até 3 réplicas. 'standard': serviço dedicado com até 12 partições e 12 réplicas. 'standard2': semelhante ao padrão, mas com mais capacidade por unidade de pesquisa. 'standard3': a maior oferta Standard com até 12 partições e 12 réplicas (ou até 3 partições com mais índices se você também definir a propriedade hostingMode como 'highDensity'). 'storage_optimized_l1': dá suporte a 1 TB por partição, até 12 partições. 'storage_optimized_l2': dá suporte a 2 TB por partição, até 12 partições.	'básico' 'gratuito' 'standard' 'standard2' 'standard3' 'storage_optimized_l1' 'storage_optimized_l2'

Exemplos de uso

Modelos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Modelo	Descrição
restrito de rede do Azure AI Studio	Esse conjunto de modelos demonstra como configurar o Azure AI Studio com o link privado e a saída desabilitados, usando chaves gerenciadas pela Microsoft para criptografia e configuração de identidade gerenciada pela Microsoft para o recurso de IA.
serviço do Azure Cognitive Search	Este modelo cria um serviço do Azure Cognitive Search
serviço do Azure Cognitive Search com de ponto de extremidade privado	Esse modelo cria um serviço do Azure Cognitive Search com um ponto de extremidade privado.
agente protegido de rede com de identidade gerenciada pelo usuário	Esse conjunto de modelos demonstra como configurar o Serviço de Agente de IA do Azure com isolamento de rede virtual usando a autenticação de Identidade Gerenciada do Usuário para a conexão serviço de IA/AOAI e links de rede privada para conectar o agente aos seus dados seguros.
de instalação do agente padrão	Esse conjunto de modelos demonstra como configurar o Serviço de Agente de IA do Azure com a configuração padrão, ou seja, com a autenticação de identidade gerenciada para conexões de projeto/hub e acesso público à Internet habilitado. Os agentes usam recursos de pesquisa e armazenamento de locatário único de propriedade do cliente. Com essa configuração, você tem controle total e visibilidade sobre esses recursos, mas incorrerá em custos com base em seu uso.
Aplicativo Web com um Banco de Dados SQL, Azure Cosmos DB, Azure Search	Esse modelo provisiona um Aplicativo Web, um Banco de Dados SQL, o Azure Cosmos DB, o Azure Search e o Application Insights.

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso searchServices pode ser implantado com operações de destino:

grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Search/searchServices, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Search/searchServices@2020-03-13"
  name = "string"
  identity = {
    type = "string"
  }
  location = "string"
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      hostingMode = "string"
      networkRuleSet = {
        ipRules = [
          {
            value = "string"
          }
        ]
      }
      partitionCount = int
      publicNetworkAccess = "string"
      replicaCount = int
    }
  })
}

Valores de propriedade

Identidade

Nome	Descrição	Valor
tipo	O tipo de identidade.	'None' 'SystemAssigned' (obrigatório)

IpRule

Nome	Descrição	Valor
valor	Valor correspondente a um único endereço IPv4 (por exemplo, 123.1.2.3) ou um intervalo de IP no formato CIDR (por exemplo, 123.1.2.3/24) a ser permitido.	corda

Microsoft.Search/searchServices

Nome	Descrição	Valor
identidade	A identidade do recurso.	Identity
localização	A localização geográfica do recurso. Essa deve ser uma das Regiões Geográficas do Azure com suporte e registradas (por exemplo, Oeste dos EUA, Leste dos EUA, Sudeste Asiático e assim por diante). Essa propriedade é necessária ao criar um novo recurso.	corda
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	Propriedades do serviço De pesquisa.	SearchServiceProperties
Sku	A SKU do Serviço de Pesquisa, que determina o tipo de preço e os limites de capacidade. Essa propriedade é necessária ao criar um novo Serviço de Pesquisa.	de SKU
Tags	Marcas de recurso	Dicionário de nomes e valores de marca.
tipo	O tipo de recurso	"Microsoft.Search/searchServices@2020-03-13"

NetworkRuleSet

Nome	Descrição	Valor
ipRules	Uma lista de regras de restrição de IP que define as redes de entrada com a permissão de acesso ao ponto de extremidade do serviço de pesquisa. Enquanto isso, todas as outras redes DE IP públicas são bloqueadas pelo firewall. Essas regras de restrição são aplicadas somente quando o 'publicNetworkAccess' do serviço de pesquisa está 'habilitado'; caso contrário, o tráfego pela interface pública não é permitido mesmo com nenhuma regra de IP pública, e as conexões de ponto de extremidade privado seriam o método de acesso exclusivo.	IpRule[]

ResourceTags

Nome	Descrição	Valor

SearchServiceProperties

Nome	Descrição	Valor
hostingMode	Aplicável somente para o SKU standard3. Você pode definir essa propriedade para habilitar até 3 partições de alta densidade que permitem até 1000 índices, o que é muito maior do que os índices máximos permitidos para qualquer outra SKU. Para o SKU standard3, o valor é "padrão" ou "highDensity". Para todos os outros SKUs, esse valor deve ser "padrão".	'default' 'highDensity'
networkRuleSet	Regras específicas de rede que determinam como o serviço do Azure Cognitive Search pode ser atingido.	NetworkRuleSet
partitionCount	O número de partições no serviço De pesquisa; se especificado, pode ser 1, 2, 3, 4, 6 ou 12. Valores maiores que 1 são válidos apenas para SKUs padrão. Para serviços 'standard3' com hostingMode definido como 'highDensity', os valores permitidos estão entre 1 e 3.	int Restrições: Valor mínimo = 1 Valor máximo = 12
publicNetworkAccess	Esse valor pode ser definido como "habilitado" para evitar alterações significativas em modelos e recursos de clientes existentes. Se definido como "desabilitado", o tráfego pela interface pública não será permitido e as conexões de ponto de extremidade privado serão o método de acesso exclusivo.	'desabilitado' 'habilitado'
replicaCount	O número de réplicas no serviço De pesquisa. Se especificado, ele deve ser um valor entre 1 e 12, inclusive para SKUs padrão ou entre 1 e 3, inclusive para SKU básica.	int Restrições: Valor mínimo = 1 Valor máximo = 12

Sku

Nome	Descrição	Valor
nome	A SKU do serviço de Pesquisa. Os valores válidos incluem: 'gratuito': serviço compartilhado. 'basic': serviço dedicado com até 3 réplicas. 'standard': serviço dedicado com até 12 partições e 12 réplicas. 'standard2': semelhante ao padrão, mas com mais capacidade por unidade de pesquisa. 'standard3': a maior oferta Standard com até 12 partições e 12 réplicas (ou até 3 partições com mais índices se você também definir a propriedade hostingMode como 'highDensity'). 'storage_optimized_l1': dá suporte a 1 TB por partição, até 12 partições. 'storage_optimized_l2': dá suporte a 2 TB por partição, até 12 partições.	'básico' 'gratuito' 'standard' 'standard2' 'standard3' 'storage_optimized_l1' 'storage_optimized_l2'

Exemplos de uso

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Módulo	Descrição
do Serviço de Pesquisa	Módulo de recurso da AVM para o Serviço de Pesquisa

Compartilhar via

Microsoft.Search searchServices 2020-03-13

Definição de recurso do Bicep

Formato de recurso

Valores de propriedade

Identidade

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

ResourceTags

SearchServiceProperties

Sku

Exemplos de uso

Módulos verificados do Azure

Exemplos de Início Rápido do Azure

Definição de recurso de modelo do ARM

Formato de recurso

Valores de propriedade

Identidade

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

ResourceTags

SearchServiceProperties

Sku

Exemplos de uso

Modelos de Início Rápido do Azure

Definição de recurso do Terraform (provedor de AzAPI)

Formato de recurso

Valores de propriedade

Identidade

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

ResourceTags

SearchServiceProperties

Sku

Exemplos de uso

Módulos verificados do Azure

Comentários

Recursos adicionais