Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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.
Exemplos de uso
Exemplos do Bicep
Um exemplo básico de implantação do Serviço de Pesquisa.
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'
}
}
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 |
|---|---|
| Rede do Fábrica de IA do Azure restrita | Este conjunto de modelos demonstra como configurar o Fábrica de IA do Azure com link privado e 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. |
Formato de recurso
Para criar um recurso Microsoft.Search/searchServices, adicione o Bicep a seguir ao seu modelo.
resource symbolicname 'Microsoft.Search/searchServices@2020-08-01' = {
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
Microsoft.Search/searchServices
| Nome | Descrição | Valor |
|---|---|---|
| identidade | A identidade do recurso. | Identidade |
| local | A localização geográfica onde o recurso reside | cadeia de caracteres (obrigatório) |
| nome | O nome do recurso | cadeia de caracteres (obrigatório) |
| Propriedades | Propriedades do serviço de pesquisa. | Propriedades do serviço de pesquisa |
| 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 |
Identidade
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de identidade. | 'Nenhum' 'SystemAssigned' (obrigatório) |
Regra de IP
| 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. | cadeia |
Conjunto de regras de rede
| 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. | Regra de Ip |
Propriedades do serviço de pesquisa
| 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". | 'padrão' 'highDensity' |
| networkRuleSet | Regras específicas de rede que determinam como o serviço do Azure Cognitive Search pode ser atingido. | |
| 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 |
| públicoAcessoRedeAcesso | 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' |
| contagem de réplicas | 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' 'padrão' 'padrão2' 'padrão 3' 'storage_optimized_l1' 'storage_optimized_l2' |
TrackedResourceTags
| Nome | Descrição | Valor |
|---|
Definição de recurso de modelo do ARM
O tipo de recurso searchServices pode ser implantado com operações de destino:
- Grupos de recursos - Veja comandos de implantação de grupos de recursos Para uma lista de propriedades alteradas em cada versão da API, veja registro de alterações.
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 |
|---|---|
|
Rede do Fábrica de IA do Azure restrita |
Este conjunto de modelos demonstra como configurar o Fábrica de IA do Azure com link privado e 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. |
Formato de recurso
Para criar um recurso Microsoft.Search/searchServices, adicione o JSON a seguir ao seu modelo.
{
"type": "Microsoft.Search/searchServices",
"apiVersion": "2020-08-01",
"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
Microsoft.Search/searchServices
| Nome | Descrição | Valor |
|---|---|---|
| apiVersion | A versão da API | '2020-08-01' |
| identidade | A identidade do recurso. | Identidade |
| local | A localização geográfica onde o recurso reside | cadeia de caracteres (obrigatório) |
| nome | O nome do recurso | cadeia de caracteres (obrigatório) |
| Propriedades | Propriedades do serviço de pesquisa. | Propriedades do serviço de pesquisa |
| 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' |
Identidade
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de identidade. | 'Nenhum' 'SystemAssigned' (obrigatório) |
Regra de IP
| 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. | cadeia |
Conjunto de regras de rede
| 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. | Regra de Ip |
Propriedades do serviço de pesquisa
| 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". | 'padrão' 'highDensity' |
| networkRuleSet | Regras específicas de rede que determinam como o serviço do Azure Cognitive Search pode ser atingido. | |
| 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 |
| públicoAcessoRedeAcesso | 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' |
| contagem de réplicas | 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' 'padrão' 'padrão2' 'padrão 3' 'storage_optimized_l1' 'storage_optimized_l2' |
TrackedResourceTags
| Nome | Descrição | Valor |
|---|
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 uma lista das propriedades alteradas em cada versão da API, veja o registro de alterações.
Exemplos de uso
Exemplos do Terraform
Um exemplo básico de implantação do Serviço de Pesquisa.
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 = ["*"]
}
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 |
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-08-01"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
hostingMode = "string"
networkRuleSet = {
ipRules = [
{
value = "string"
}
]
}
partitionCount = int
publicNetworkAccess = "string"
replicaCount = int
}
sku = {
name = "string"
}
}
}
Valores de propriedade
Microsoft.Search/searchServices
| Nome | Descrição | Valor |
|---|---|---|
| identidade | A identidade do recurso. | Identidade |
| local | A localização geográfica onde o recurso reside | cadeia de caracteres (obrigatório) |
| nome | O nome do recurso | cadeia de caracteres (obrigatório) |
| Propriedades | Propriedades do serviço de pesquisa. | Propriedades do serviço de pesquisa |
| 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-08-01" |
Identidade
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de identidade. | 'Nenhum' 'SystemAssigned' (obrigatório) |
Regra de IP
| 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. | cadeia |
Conjunto de regras de rede
| 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. | Regra de Ip |
Propriedades do serviço de pesquisa
| 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". | 'padrão' 'highDensity' |
| networkRuleSet | Regras específicas de rede que determinam como o serviço do Azure Cognitive Search pode ser atingido. | |
| 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 |
| públicoAcessoRedeAcesso | 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' |
| contagem de réplicas | 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' 'padrão' 'padrão2' 'padrão 3' 'storage_optimized_l1' 'storage_optimized_l2' |
TrackedResourceTags
| Nome | Descrição | Valor |
|---|