Microsoft.Search searchServices 2020-08-01
Definição de recurso do Bicep
O tipo de recurso searchServices pode ser implementado com operações que visam:
- Grupos de recursos – veja os comandos de implementação do grupo de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.Search/searchServices, adicione o seguinte Bicep ao seu modelo.
resource symbolicname 'Microsoft.Search/searchServices@2020-08-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
sku: {
name: 'string'
}
identity: {
type: 'string'
}
properties: {
hostingMode: 'string'
networkRuleSet: {
ipRules: [
{
value: 'string'
}
]
}
partitionCount: int
publicNetworkAccess: 'string'
replicaCount: int
}
}
Valores de propriedade
searchServices
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso | cadeia (obrigatório) |
| localização | A localização geográfica onde reside o recurso | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| sku | O SKU do Serviço de Pesquisa, que determina o escalão de preço e os limites de capacidade. Esta propriedade é necessária ao criar um novo Serviço de Pesquisa. | SKU |
| identidade | A identidade do recurso. | Identidade |
| propriedades | Propriedades do serviço de pesquisa. | SearchServiceProperties |
Identidade
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de identidade. | "Nenhum" "SystemAssigned" (obrigatório) |
SearchServiceProperties
| Nome | Descrição | Valor |
|---|---|---|
| hostingMode | Aplicável apenas para o SKU standard3. Pode definir esta propriedade para ativar até 3 partições de alta densidade que permitem até 1000 índices, o que é muito superior aos índices máximos permitidos para qualquer outro SKU. Para o SKU standard3, o valor é "predefinido" ou "highDensity". Para todos os outros SKUs, este valor tem de ser "predefinido". | "predefinição" 'highDensity' |
| networkRuleSet | Regras específicas de rede que determinam a forma como o serviço Azure Cognitive Search pode ser alcançado. | NetworkRuleSet |
| partitionCount | O número de partições no serviço de pesquisa; Se especificado, pode ser 1, 2, 3, 4, 6 ou 12. Os valores superiores a 1 só são válidos 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 | Este valor pode ser definido como "ativado" para evitar alterações interruptivas nos modelos e recursos de cliente existentes. Se estiver definido como "desativado", o tráfego através da interface pública não é permitido e as ligações de ponto final privado seriam o método de acesso exclusivo. | "desativado" "ativado" |
| replicaCount | O número de réplicas no serviço de pesquisa. Se especificado, tem de ser um valor entre 1 e 12 inclusive para SKUs padrão ou entre 1 e 3, inclusive para sKU básico. | int Restrições: Valor mínimo = 1 Valor máximo = 12 |
NetworkRuleSet
| Nome | Descrição | Valor |
|---|---|---|
| ipRules | Uma lista de regras de restrição de IP que define as redes de entrada ao permitir o acesso ao ponto final do serviço de pesquisa. Entretanto, todas as outras redes IP públicas são bloqueadas pela firewall. Estas regras de restrição só são aplicadas quando o "publicNetworkAccess" do serviço de pesquisa está "ativado"; caso contrário, o tráfego através da interface pública não é permitido, mesmo com quaisquer regras de IP públicos, e as ligações de ponto final privado seriam o método de acesso exclusivo. | IpRule[] |
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. | string |
Sku
| Nome | Descrição | Valor |
|---|---|---|
| name | O SKU do serviço de pesquisa. Os valores válidos incluem: "gratuito": Serviço partilhado. "básico": 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 também definir a propriedade hostingMode como "highDensity"). 'storage_optimized_l1': suporta 1 TB por partição, até 12 partições. "storage_optimized_l2": suporta 2 TB por partição, até 12 partições." | "básico" 'gratuito' "standard" "standard2" 'standard3' 'storage_optimized_l1' 'storage_optimized_l2' |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
Aplicação Web com um Base de Dados SQL, Azure Cosmos DB, Azure Search |
Este modelo aprovisiona uma Aplicação Web, uma Base de Dados SQL, o Azure Cosmos DB, o Azure Search e o Application Insights. |
| serviço Azure Cognitive Search |
Este modelo cria um serviço Azure Cognitive Search |
| Azure Cognitive Search serviço com ponto final privado |
Este modelo cria um serviço Azure Cognitive Search com um ponto final privado. |
Definição de recurso do modelo arm
O tipo de recurso searchServices pode ser implementado com operações que visam:
- Grupos de recursos – veja os comandos de implementação do grupo de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.Search/searchServices, adicione o seguinte JSON ao seu modelo.
{
"type": "Microsoft.Search/searchServices",
"apiVersion": "2020-08-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"sku": {
"name": "string"
},
"identity": {
"type": "string"
},
"properties": {
"hostingMode": "string",
"networkRuleSet": {
"ipRules": [
{
"value": "string"
}
]
},
"partitionCount": "int",
"publicNetworkAccess": "string",
"replicaCount": "int"
}
}
Valores de propriedade
searchServices
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.Search/searchServices" |
| apiVersion | A versão da API de recursos | '2020-08-01' |
| name | O nome do recurso | cadeia (obrigatório) |
| localização | A localização geográfica onde reside o recurso | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| sku | O SKU do Serviço de Pesquisa, que determina o escalão de preço e os limites de capacidade. Esta propriedade é necessária ao criar um novo Serviço de Pesquisa. | SKU |
| identidade | A identidade do recurso. | Identidade |
| propriedades | Propriedades do serviço de pesquisa. | SearchServiceProperties |
Identidade
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de identidade. | "Nenhum" "SystemAssigned" (obrigatório) |
SearchServiceProperties
| Nome | Descrição | Valor |
|---|---|---|
| hostingMode | Aplicável apenas para o SKU standard3. Pode definir esta propriedade para ativar até 3 partições de alta densidade que permitem até 1000 índices, o que é muito superior aos índices máximos permitidos para qualquer outro SKU. Para o SKU standard3, o valor é "predefinido" ou "highDensity". Para todos os outros SKUs, este valor tem de ser "predefinido". | "predefinição" 'highDensity' |
| networkRuleSet | Regras específicas de rede que determinam a forma como o serviço Azure Cognitive Search pode ser alcançado. | NetworkRuleSet |
| partitionCount | O número de partições no serviço de pesquisa; Se especificado, pode ser 1, 2, 3, 4, 6 ou 12. Os valores superiores a 1 só são válidos 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 | Este valor pode ser definido como "ativado" para evitar alterações interruptivas nos recursos e modelos de clientes existentes. Se estiver definido como "desativado", o tráfego através da interface pública não é permitido e as ligações de ponto final privado seriam o método de acesso exclusivo. | "desativado" "ativado" |
| replicaCount | O número de réplicas no serviço de pesquisa. Se especificado, tem de ser um valor entre 1 e 12 skUs padrão ou entre 1 e 3 inclusive para sKU básico. | int Restrições: Valor mínimo = 1 Valor máximo = 12 |
NetworkRuleSet
| Nome | Descrição | Valor |
|---|---|---|
| ipRules | Uma lista de regras de restrição de IP que define as redes de entrada ao permitir o acesso ao ponto final do serviço de pesquisa. Entretanto, todas as outras redes IP públicas são bloqueadas pela firewall. Estas regras de restrição só são aplicadas quando a "publicNetworkAccess" do serviço de pesquisa está "ativada"; caso contrário, o tráfego através da interface pública não é permitido mesmo com quaisquer regras de IP públicas e as ligações de ponto final privado seriam o método de acesso exclusivo. | IpRule[] |
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. | string |
Sku
| Nome | Descrição | Valor |
|---|---|---|
| name | O SKU do serviço de pesquisa. Os valores válidos incluem: "gratuito": Serviço partilhado. "básico": 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 também definir a propriedade hostingMode como "highDensity"). "storage_optimized_l1": suporta 1 TB por partição, até 12 partições. "storage_optimized_l2": suporta 2 TB por partição, até 12 partições." | "básico" 'gratuito' "standard" "standard2" "standard3" 'storage_optimized_l1' 'storage_optimized_l2' |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
| Aplicação Web com um Base de Dados SQL, Azure Cosmos DB, Azure Search |
Este modelo aprovisiona uma Aplicação Web, uma Base de Dados SQL, o Azure Cosmos DB, o Azure Search e o Application Insights. |
| serviço Azure Cognitive Search |
Este modelo cria um serviço de Azure Cognitive Search |
| Azure Cognitive Search serviço com ponto final privado |
Este modelo cria um serviço Azure Cognitive Search com um ponto final privado. |
Definição de recurso do Terraform (fornecedor AzAPI)
O tipo de recurso searchServices pode ser implementado com operações que visam:
- Grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.Search/searchServices, adicione o seguinte Terraform ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Search/searchServices@2020-08-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "SystemAssigned"
}
body = jsonencode({
properties = {
hostingMode = "string"
networkRuleSet = {
ipRules = [
{
value = "string"
}
]
}
partitionCount = int
publicNetworkAccess = "string"
replicaCount = int
}
sku = {
name = "string"
}
})
}
Valores de propriedade
searchServices
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.Search/searchServices@2020-08-01" |
| name | O nome do recurso | cadeia (obrigatório) |
| localização | A localização geográfica onde o recurso se encontra | cadeia (obrigatório) |
| parent_id | Para implementar num grupo de recursos, utilize o ID desse grupo de recursos. | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. |
| sku | O SKU do Serviço de Pesquisa, que determina o escalão de preço e os limites de capacidade. Esta propriedade é necessária ao criar um novo Serviço de Pesquisa. | SKU |
| identidade | A identidade do recurso. | Identidade |
| propriedades | Propriedades do serviço de pesquisa. | SearchServiceProperties |
Identidade
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de identidade. | "SystemAssigned" (obrigatório) |
SearchServiceProperties
| Nome | Descrição | Valor |
|---|---|---|
| hostingMode | Aplicável apenas para o SKU standard3. Pode definir esta propriedade para ativar até 3 partições de alta densidade que permitem até 1000 índices, o que é muito superior aos índices máximos permitidos para qualquer outro SKU. Para o SKU standard3, o valor é "predefinido" ou "highDensity". Para todos os outros SKUs, este valor tem de ser "predefinido". | "predefinição" "highDensity" |
| networkRuleSet | Regras específicas da rede que determinam a forma como o serviço Azure Cognitive Search pode ser alcançado. | NetworkRuleSet |
| partitionCount | O número de partições no serviço de pesquisa; se especificado, pode ser 1, 2, 3, 4, 6 ou 12. Os valores superiores a 1 só são válidos 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 | Este valor pode ser definido como "ativado" para evitar alterações interruptivas nos recursos e modelos de clientes existentes. Se estiver definido como "desativado", o tráfego através da interface pública não é permitido e as ligações de ponto final privado seriam o método de acesso exclusivo. | "desativado" "ativado" |
| replicaCount | O número de réplicas no serviço de pesquisa. Se especificado, tem de ser um valor entre 1 e 12 skUs padrão ou entre 1 e 3 inclusive para sKU básico. | int Restrições: Valor mínimo = 1 Valor máximo = 12 |
NetworkRuleSet
| Nome | Descrição | Valor |
|---|---|---|
| ipRules | Uma lista de regras de restrição de IP que define as redes de entrada ao permitir o acesso ao ponto final do serviço de pesquisa. Entretanto, todas as outras redes IP públicas são bloqueadas pela firewall. Estas regras de restrição só são aplicadas quando a "publicNetworkAccess" do serviço de pesquisa está "ativada"; caso contrário, o tráfego através da interface pública não é permitido mesmo com quaisquer regras de IP públicas e as ligações de ponto final privado seriam o método de acesso exclusivo. | IpRule[] |
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. | string |
Sku
| Nome | Descrição | Valor |
|---|---|---|
| name | O SKU do serviço de pesquisa. Os valores válidos incluem: "gratuito": Serviço partilhado. "básico": 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 também definir a propriedade hostingMode como "highDensity"). "storage_optimized_l1": suporta 1 TB por partição, até 12 partições. "storage_optimized_l2": suporta 2 TB por partição, até 12 partições." | "básico" "gratuito" "standard" "standard2" "standard3" "storage_optimized_l1" "storage_optimized_l2" |
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários