Microsoft.Search searchServices 2019-10-01-preview

Artículo
02/23/2025

Definición de recursos de Bicep

El tipo de recurso searchServices se puede implementar con operaciones que tienen como destino:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Search/searchServices, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Search/searchServices@2019-10-01-preview' = {
  identity: {
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    hostingMode: 'string'
    networkRuleSet: {
      endpointAccess: 'string'
      ipRules: [
        {
          value: 'string'
        }
      ]
    }
    partitionCount: int
    replicaCount: int
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propiedad

Identidad

Nombre	Descripción	Valor
tipo	Tipo de identidad.	'Ninguno' 'SystemAssigned' (obligatorio)

IpRule

Nombre	Descripción	Valor
valor	Valor correspondiente a una sola dirección IPv4 (por ejemplo, 123.1.2.3) o a un intervalo IP en formato CIDR (por ejemplo, 123.1.2.3/24) que se permitirá.	cuerda

Microsoft.Search/searchServices

Nombre	Descripción	Valor
identidad	Identidad del recurso.	Identity
ubicación	Ubicación geográfica del recurso. Debe ser una de las regiones geográficas de Azure admitidas y registradas (por ejemplo, Oeste de EE. UU., Este de EE. UU., Sudeste de Asia, etc.). Esta propiedad es necesaria al crear un nuevo recurso.	cuerda
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Propiedades del servicio de búsqueda.	SearchServiceProperties
Sku	SKU del servicio de búsqueda, que determina los límites de nivel de precio y capacidad. Esta propiedad es necesaria al crear un nuevo servicio de búsqueda.	Sku de
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

NetworkRuleSet

Nombre	Descripción	Valor
endpointAccess	Nivel de acceso al punto de conexión del servicio de búsqueda. Público, se puede acceder al punto de conexión del servicio de búsqueda desde Internet. Privado, solo se puede acceder al punto de conexión del servicio de búsqueda a través de puntos de conexión privados. El valor predeterminado es Público.	"Privado" 'Público'
ipRules	Lista de reglas de restricción de IP que definen el acceso de red entrante al punto de conexión del servicio de búsqueda. Estas reglas de restricción solo se aplican cuando EndpointAccess del servicio de búsqueda es Público.	ipRule[]

ResourceTags

Nombre	Descripción	Valor

SearchServiceProperties

Nombre	Descripción	Valor
hostingMode	Solo se aplica a la SKU estándar3. Puede establecer esta propiedad para habilitar hasta 3 particiones de alta densidad que permitan hasta 1000 índices, que es mucho mayor que los índices máximos permitidos para cualquier otra SKU. Para la SKU estándar3, el valor es "default" o "highDensity". Para todas las demás SKU, este valor debe ser "predeterminado".	'default' 'highDensity'
networkRuleSet	Reglas específicas de red que determinan cómo se puede acceder al servicio Azure Cognitive Search.	NetworkRuleSet
partitionCount	Número de particiones en el servicio de búsqueda; si se especifica, puede ser 1, 2, 3, 4, 6 o 12. Los valores mayores que 1 solo son válidos para las SKU estándar. Para los servicios "standard3" con hostingMode establecido en "highDensity", los valores permitidos están comprendidos entre 1 y 3.	Int Restricciones: Valor mínimo = 1 Valor máximo = 12
replicaCount	Número de réplicas en el servicio de búsqueda. Si se especifica, debe ser un valor entre 1 y 12 inclusive para las SKU estándar o entre 1 y 3 inclusive para la SKU básica.	Int Restricciones: Valor mínimo = 1 Valor máximo = 12

Sku

Nombre	Descripción	Valor
nombre	SKU del servicio de búsqueda. Entre los valores válidos se incluyen: "gratis": servicio compartido. 'basic': servicio dedicado con hasta 3 réplicas. 'estándar': servicio dedicado con hasta 12 particiones y 12 réplicas. 'standard2': similar al estándar, pero con más capacidad por unidad de búsqueda. 'standard3': la oferta estándar más grande con hasta 12 particiones y 12 réplicas (o hasta 3 particiones con más índices si también establece la propiedad hostingMode en 'highDensity'). 'storage_optimized_l1': admite 1 TB por partición, hasta 12 particiones. "storage_optimized_l2": admite 2 TB por partición, hasta 12 particiones".	'basic' 'gratis' 'estándar' 'standard2' 'standard3' "storage_optimized_l1" "storage_optimized_l2"

Ejemplos de uso

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Módulo	Descripción
Search Service	Módulo de recursos de AVM para Search Service

Ejemplos de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.

Archivo de Bicep	Descripción
red restringida de Azure AI Studio Network	Este conjunto de plantillas muestra cómo configurar Azure AI Studio con vínculo privado y salida deshabilitados, mediante claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
del servicio Azure Cognitive Search	Esta plantilla crea un servicio Azure Cognitive Search
Agente protegido por red con identidad administrada de usuario	Este conjunto de plantillas muestra cómo configurar el servicio agente de Azure AI con aislamiento de red virtual mediante autenticación de identidad administrada de usuario para la conexión del servicio de IA/AOAI y vínculos de red privada para conectar el agente a los datos seguros.
de configuración del agente estándar	Este conjunto de plantillas muestra cómo configurar el servicio agente de Azure AI con la configuración estándar, lo que significa que con la autenticación de identidad administrada para conexiones de proyecto/centro y acceso a Internet público habilitado. Los agentes usan recursos de almacenamiento y búsqueda de un solo inquilino propiedad del cliente. Con esta configuración, tiene control total y visibilidad sobre estos recursos, pero incurrirá en costos en función del uso.

Definición de recursos de plantilla de ARM

El tipo de recurso searchServices se puede implementar con operaciones que tienen como destino:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Search/searchServices, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Search/searchServices",
  "apiVersion": "2019-10-01-preview",
  "name": "string",
  "identity": {
    "type": "string"
  },
  "location": "string",
  "properties": {
    "hostingMode": "string",
    "networkRuleSet": {
      "endpointAccess": "string",
      "ipRules": [
        {
          "value": "string"
        }
      ]
    },
    "partitionCount": "int",
    "replicaCount": "int"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propiedad

Identidad

Nombre	Descripción	Valor
tipo	Tipo de identidad.	'Ninguno' 'SystemAssigned' (obligatorio)

IpRule

Nombre	Descripción	Valor
valor	Valor correspondiente a una sola dirección IPv4 (por ejemplo, 123.1.2.3) o a un intervalo IP en formato CIDR (por ejemplo, 123.1.2.3/24) que se permitirá.	cuerda

Microsoft.Search/searchServices

Nombre	Descripción	Valor
apiVersion	La versión de api	'2019-10-01-preview'
identidad	Identidad del recurso.	Identity
ubicación	Ubicación geográfica del recurso. Debe ser una de las regiones geográficas de Azure admitidas y registradas (por ejemplo, Oeste de EE. UU., Este de EE. UU., Sudeste de Asia, etc.). Esta propiedad es necesaria al crear un nuevo recurso.	cuerda
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Propiedades del servicio de búsqueda.	SearchServiceProperties
Sku	SKU del servicio de búsqueda, que determina los límites de nivel de precio y capacidad. Esta propiedad es necesaria al crear un nuevo servicio de búsqueda.	Sku de
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo	El tipo de recurso	'Microsoft.Search/searchServices'

NetworkRuleSet

Nombre	Descripción	Valor
endpointAccess	Nivel de acceso al punto de conexión del servicio de búsqueda. Público, se puede acceder al punto de conexión del servicio de búsqueda desde Internet. Privado, solo se puede acceder al punto de conexión del servicio de búsqueda a través de puntos de conexión privados. El valor predeterminado es Público.	"Privado" 'Público'
ipRules	Lista de reglas de restricción de IP que definen el acceso de red entrante al punto de conexión del servicio de búsqueda. Estas reglas de restricción solo se aplican cuando EndpointAccess del servicio de búsqueda es Público.	ipRule[]

ResourceTags

Nombre	Descripción	Valor

SearchServiceProperties

Nombre	Descripción	Valor
hostingMode	Solo se aplica a la SKU estándar3. Puede establecer esta propiedad para habilitar hasta 3 particiones de alta densidad que permitan hasta 1000 índices, que es mucho mayor que los índices máximos permitidos para cualquier otra SKU. Para la SKU estándar3, el valor es "default" o "highDensity". Para todas las demás SKU, este valor debe ser "predeterminado".	'default' 'highDensity'
networkRuleSet	Reglas específicas de red que determinan cómo se puede acceder al servicio Azure Cognitive Search.	NetworkRuleSet
partitionCount	Número de particiones en el servicio de búsqueda; si se especifica, puede ser 1, 2, 3, 4, 6 o 12. Los valores mayores que 1 solo son válidos para las SKU estándar. Para los servicios "standard3" con hostingMode establecido en "highDensity", los valores permitidos están comprendidos entre 1 y 3.	Int Restricciones: Valor mínimo = 1 Valor máximo = 12
replicaCount	Número de réplicas en el servicio de búsqueda. Si se especifica, debe ser un valor entre 1 y 12 inclusive para las SKU estándar o entre 1 y 3 inclusive para la SKU básica.	Int Restricciones: Valor mínimo = 1 Valor máximo = 12

Sku

Nombre	Descripción	Valor
nombre	SKU del servicio de búsqueda. Entre los valores válidos se incluyen: "gratis": servicio compartido. 'basic': servicio dedicado con hasta 3 réplicas. 'estándar': servicio dedicado con hasta 12 particiones y 12 réplicas. 'standard2': similar al estándar, pero con más capacidad por unidad de búsqueda. 'standard3': la oferta estándar más grande con hasta 12 particiones y 12 réplicas (o hasta 3 particiones con más índices si también establece la propiedad hostingMode en 'highDensity'). 'storage_optimized_l1': admite 1 TB por partición, hasta 12 particiones. "storage_optimized_l2": admite 2 TB por partición, hasta 12 particiones".	'basic' 'gratis' 'estándar' 'standard2' 'standard3' "storage_optimized_l1" "storage_optimized_l2"

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Plantilla	Descripción
red restringida de Azure AI Studio Network	Este conjunto de plantillas muestra cómo configurar Azure AI Studio con vínculo privado y salida deshabilitados, mediante claves administradas por Microsoft para el cifrado y la configuración de identidad administrada por Microsoft para el recurso de IA.
del servicio Azure Cognitive Search	Esta plantilla crea un servicio Azure Cognitive Search
servicio Azure Cognitive Search con de punto de conexión privado	Esta plantilla crea un servicio azure Cognitive Search con un punto de conexión privado.
Agente protegido por red con identidad administrada de usuario	Este conjunto de plantillas muestra cómo configurar el servicio agente de Azure AI con aislamiento de red virtual mediante autenticación de identidad administrada de usuario para la conexión del servicio de IA/AOAI y vínculos de red privada para conectar el agente a los datos seguros.
de configuración del agente estándar	Este conjunto de plantillas muestra cómo configurar el servicio agente de Azure AI con la configuración estándar, lo que significa que con la autenticación de identidad administrada para conexiones de proyecto/centro y acceso a Internet público habilitado. Los agentes usan recursos de almacenamiento y búsqueda de un solo inquilino propiedad del cliente. Con esta configuración, tiene control total y visibilidad sobre estos recursos, pero incurrirá en costos en función del uso.
Aplicación web con una instancia de SQL Database, Azure Cosmos DB, Azure Search	Esta plantilla aprovisiona una aplicación web, una instancia de SQL Database, Azure Cosmos DB, Azure Search y Application Insights.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso searchServices se puede implementar con operaciones que tienen como destino:

grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Search/searchServices, agregue el siguiente Terraform a la plantilla.

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

Valores de propiedad

Identidad

Nombre	Descripción	Valor
tipo	Tipo de identidad.	'Ninguno' 'SystemAssigned' (obligatorio)

IpRule

Nombre	Descripción	Valor
valor	Valor correspondiente a una sola dirección IPv4 (por ejemplo, 123.1.2.3) o a un intervalo IP en formato CIDR (por ejemplo, 123.1.2.3/24) que se permitirá.	cuerda

Microsoft.Search/searchServices

Nombre	Descripción	Valor
identidad	Identidad del recurso.	Identity
ubicación	Ubicación geográfica del recurso. Debe ser una de las regiones geográficas de Azure admitidas y registradas (por ejemplo, Oeste de EE. UU., Este de EE. UU., Sudeste de Asia, etc.). Esta propiedad es necesaria al crear un nuevo recurso.	cuerda
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Propiedades del servicio de búsqueda.	SearchServiceProperties
Sku	SKU del servicio de búsqueda, que determina los límites de nivel de precio y capacidad. Esta propiedad es necesaria al crear un nuevo servicio de búsqueda.	Sku de
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta.
tipo	El tipo de recurso	"Microsoft.Search/searchServices@2019-10-01-preview"

NetworkRuleSet

Nombre	Descripción	Valor
endpointAccess	Nivel de acceso al punto de conexión del servicio de búsqueda. Público, se puede acceder al punto de conexión del servicio de búsqueda desde Internet. Privado, solo se puede acceder al punto de conexión del servicio de búsqueda a través de puntos de conexión privados. El valor predeterminado es Público.	"Privado" 'Público'
ipRules	Lista de reglas de restricción de IP que definen el acceso de red entrante al punto de conexión del servicio de búsqueda. Estas reglas de restricción solo se aplican cuando EndpointAccess del servicio de búsqueda es Público.	ipRule[]

ResourceTags

Nombre	Descripción	Valor

SearchServiceProperties

Nombre	Descripción	Valor
hostingMode	Solo se aplica a la SKU estándar3. Puede establecer esta propiedad para habilitar hasta 3 particiones de alta densidad que permitan hasta 1000 índices, que es mucho mayor que los índices máximos permitidos para cualquier otra SKU. Para la SKU estándar3, el valor es "default" o "highDensity". Para todas las demás SKU, este valor debe ser "predeterminado".	'default' 'highDensity'
networkRuleSet	Reglas específicas de red que determinan cómo se puede acceder al servicio Azure Cognitive Search.	NetworkRuleSet
partitionCount	Número de particiones en el servicio de búsqueda; si se especifica, puede ser 1, 2, 3, 4, 6 o 12. Los valores mayores que 1 solo son válidos para las SKU estándar. Para los servicios "standard3" con hostingMode establecido en "highDensity", los valores permitidos están comprendidos entre 1 y 3.	Int Restricciones: Valor mínimo = 1 Valor máximo = 12
replicaCount	Número de réplicas en el servicio de búsqueda. Si se especifica, debe ser un valor entre 1 y 12 inclusive para las SKU estándar o entre 1 y 3 inclusive para la SKU básica.	Int Restricciones: Valor mínimo = 1 Valor máximo = 12

Sku

Nombre	Descripción	Valor
nombre	SKU del servicio de búsqueda. Entre los valores válidos se incluyen: "gratis": servicio compartido. 'basic': servicio dedicado con hasta 3 réplicas. 'estándar': servicio dedicado con hasta 12 particiones y 12 réplicas. 'standard2': similar al estándar, pero con más capacidad por unidad de búsqueda. 'standard3': la oferta estándar más grande con hasta 12 particiones y 12 réplicas (o hasta 3 particiones con más índices si también establece la propiedad hostingMode en 'highDensity'). 'storage_optimized_l1': admite 1 TB por partición, hasta 12 particiones. "storage_optimized_l2": admite 2 TB por partición, hasta 12 particiones".	'basic' 'gratis' 'estándar' 'standard2' 'standard3' "storage_optimized_l1" "storage_optimized_l2"

Ejemplos de uso

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Módulo	Descripción
Search Service	Módulo de recursos de AVM para Search Service

Compartir a través de

Microsoft.Search searchServices 2019-10-01-preview

Definición de recursos de Bicep

Formato de recurso

Valores de propiedad

Identidad

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

ResourceTags

SearchServiceProperties

Sku

Ejemplos de uso

Módulos comprobados de Azure

Ejemplos de inicio rápido de Azure

Definición de recursos de plantilla de ARM

Formato de recurso

Valores de propiedad

Identidad

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

ResourceTags

SearchServiceProperties

Sku

Ejemplos de uso

Plantillas de inicio rápido de Azure

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Valores de propiedad

Identidad

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

ResourceTags

SearchServiceProperties

Sku

Ejemplos de uso

Módulos comprobados de Azure

Comentarios

Recursos adicionales