Microsoft.Search searchServices 2020-08-01

Articolo
02/27/2025

Definizione di risorsa Bicep

Il tipo di risorsa searchServices può essere distribuito con operazioni destinate a:

gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Search/searchServices, aggiungere il bicep seguente al modello.

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'
  }
}

Valori delle proprietà

Identità

Nome	Descrizione	Valore
digitare	Tipo di identità.	'Nessuno' 'SystemAssigned' (obbligatorio)

IpRule

Nome	Descrizione	Valore
valore	Valore corrispondente a un singolo indirizzo IPv4 (ad esempio, 123.1.2.3) o a un intervallo IP in formato CIDR (ad esempio, 123.1.2.3/24) da consentire.	corda

Microsoft.Search/searchServices

Nome	Descrizione	Valore
identità	Identità della risorsa.	identity
ubicazione	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
nome	Nome della risorsa	stringa (obbligatorio)
proprietà	Proprietà del servizio di ricerca.	SearchServiceProperties
Sku	SKU del servizio di ricerca, che determina il livello di prezzo e i limiti di capacità. Questa proprietà è necessaria quando si crea un nuovo servizio di ricerca.	sku
Tag	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli

NetworkRuleSet

Nome	Descrizione	Valore
ipRules	Elenco di regole di restrizione IP che definisce le reti in ingresso con l'accesso all'endpoint del servizio di ricerca. Nel frattempo, tutte le altre reti IP pubbliche vengono bloccate dal firewall. Queste regole di restrizione vengono applicate solo quando il "publicNetworkAccess" del servizio di ricerca è "abilitato". in caso contrario, il traffico sull'interfaccia pubblica non è consentito anche con regole IP pubbliche e le connessioni endpoint private sono il metodo di accesso esclusivo.	IpRule []

SearchServiceProperties

Nome	Descrizione	Valore
hostingMode	Applicabile solo per lo SKU Standard3. È possibile impostare questa proprietà per abilitare fino a 3 partizioni ad alta densità che consentono fino a 1000 indici, che è molto più alto rispetto agli indici massimi consentiti per qualsiasi altro SKU. Per lo SKU standard3, il valore è "default" o "highDensity". Per tutti gli altri SKU, questo valore deve essere 'default'.	'default' 'highDensity'
networkRuleSet	Regole specifiche della rete che determinano il modo in cui è possibile raggiungere il servizio Ricerca cognitiva di Azure.	NetworkRuleSet
partitionCount	Numero di partizioni nel servizio di ricerca; se specificato, può essere 1, 2, 3, 4, 6 o 12. I valori maggiori di 1 sono validi solo per gli SKU standard. Per i servizi 'standard3' con hostingMode impostato su 'highDensity', i valori consentiti sono compresi tra 1 e 3.	Int Vincoli: Valore minimo = 1 Valore massimo = 12
publicNetworkAccess	Questo valore può essere impostato su "enabled" per evitare modifiche di rilievo nelle risorse e nei modelli dei clienti esistenti. Se impostato su "disabilitato", il traffico sull'interfaccia pubblica non è consentito e le connessioni endpoint private saranno il metodo di accesso esclusivo.	'disabled' 'enabled'
replicaCount	Numero di repliche nel servizio di ricerca. Se specificato, deve essere un valore compreso tra 1 e 12 inclusi per gli SKU standard o compreso tra 1 e 3 inclusi per lo SKU basic.	Int Vincoli: Valore minimo = 1 Valore massimo = 12

Sku

Nome	Descrizione	Valore
nome	SKU del servizio di ricerca. I valori validi includono: 'free': Servizio condiviso. 'basic': servizio dedicato con un massimo di 3 repliche. 'standard': servizio dedicato con un massimo di 12 partizioni e 12 repliche. 'standard2': simile allo standard, ma con una maggiore capacità per ogni unità di ricerca. 'standard3': la più grande offerta Standard con un massimo di 12 partizioni e 12 repliche (o fino a 3 partizioni con più indici se si imposta anche la proprietà hostingMode su 'highDensity'). 'storage_optimized_l1': supporta 1 TB per partizione, fino a 12 partizioni. 'storage_optimized_l2': supporta 2 TB per partizione, fino a 12 partizioni.	'basic' 'free' 'standard' 'standard2' 'standard3' 'storage_optimized_l1' 'storage_optimized_l2'

TrackedResourceTags

Nome	Descrizione	Valore

Esempi di utilizzo

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Modulo	Descrizione
servizio di ricerca	Modulo di risorse AVM per il servizio di ricerca

Esempi di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.

Bicep File	Descrizione
con restrizioni di rete di Azure AI Studio	Questo set di modelli illustra come configurare Azure AI Studio con collegamento privato e uscita disabilitato, usando chiavi gestite da Microsoft per la crittografia e la configurazione delle identità gestite da Microsoft per la risorsa di intelligenza artificiale.
servizio Ricerca cognitiva di Azure	Questo modello crea un servizio Ricerca cognitiva di Azure
agente protetto dalla rete con identità gestita dall'utente	Questo set di modelli illustra come configurare il servizio Agente di intelligenza artificiale di Azure con isolamento della rete virtuale usando l'autenticazione dell'identità gestita dall'utente per la connessione al servizio di intelligenza artificiale/AOAI e i collegamenti di rete privata per connettere l'agente ai dati sicuri.
configurazione dell'agente standard	Questo set di modelli illustra come configurare il servizio Azure AI Agent con la configurazione standard, ovvero con l'autenticazione dell'identità gestita per le connessioni di progetto/hub e l'accesso a Internet pubblico abilitato. Gli agenti usano risorse di ricerca e archiviazione a tenant singolo di proprietà del cliente. Con questa configurazione, si ha il controllo completo e la visibilità su queste risorse, ma si comportano costi in base all'utilizzo.

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa searchServices può essere distribuito con operazioni destinate a:

gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Search/searchServices, aggiungere il codice JSON seguente al modello.

{
  "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"
  }
}

Valori delle proprietà

Identità

Nome	Descrizione	Valore
digitare	Tipo di identità.	'Nessuno' 'SystemAssigned' (obbligatorio)

IpRule

Nome	Descrizione	Valore
valore	Valore corrispondente a un singolo indirizzo IPv4 (ad esempio, 123.1.2.3) o a un intervallo IP in formato CIDR (ad esempio, 123.1.2.3/24) da consentire.	corda

Microsoft.Search/searchServices

Nome	Descrizione	Valore
apiVersion	Versione dell'API	'2020-08-01'
identità	Identità della risorsa.	identity
ubicazione	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
nome	Nome della risorsa	stringa (obbligatorio)
proprietà	Proprietà del servizio di ricerca.	SearchServiceProperties
Sku	SKU del servizio di ricerca, che determina il livello di prezzo e i limiti di capacità. Questa proprietà è necessaria quando si crea un nuovo servizio di ricerca.	sku
Tag	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare	Tipo di risorsa	'Microsoft.Search/searchServices'

NetworkRuleSet

Nome	Descrizione	Valore
ipRules	Elenco di regole di restrizione IP che definisce le reti in ingresso con l'accesso all'endpoint del servizio di ricerca. Nel frattempo, tutte le altre reti IP pubbliche vengono bloccate dal firewall. Queste regole di restrizione vengono applicate solo quando il "publicNetworkAccess" del servizio di ricerca è "abilitato". in caso contrario, il traffico sull'interfaccia pubblica non è consentito anche con regole IP pubbliche e le connessioni endpoint private sono il metodo di accesso esclusivo.	IpRule []

SearchServiceProperties

Nome	Descrizione	Valore
hostingMode	Applicabile solo per lo SKU Standard3. È possibile impostare questa proprietà per abilitare fino a 3 partizioni ad alta densità che consentono fino a 1000 indici, che è molto più alto rispetto agli indici massimi consentiti per qualsiasi altro SKU. Per lo SKU standard3, il valore è "default" o "highDensity". Per tutti gli altri SKU, questo valore deve essere 'default'.	'default' 'highDensity'
networkRuleSet	Regole specifiche della rete che determinano il modo in cui è possibile raggiungere il servizio Ricerca cognitiva di Azure.	NetworkRuleSet
partitionCount	Numero di partizioni nel servizio di ricerca; se specificato, può essere 1, 2, 3, 4, 6 o 12. I valori maggiori di 1 sono validi solo per gli SKU standard. Per i servizi 'standard3' con hostingMode impostato su 'highDensity', i valori consentiti sono compresi tra 1 e 3.	Int Vincoli: Valore minimo = 1 Valore massimo = 12
publicNetworkAccess	Questo valore può essere impostato su "enabled" per evitare modifiche di rilievo nelle risorse e nei modelli dei clienti esistenti. Se impostato su "disabilitato", il traffico sull'interfaccia pubblica non è consentito e le connessioni endpoint private saranno il metodo di accesso esclusivo.	'disabled' 'enabled'
replicaCount	Numero di repliche nel servizio di ricerca. Se specificato, deve essere un valore compreso tra 1 e 12 inclusi per gli SKU standard o compreso tra 1 e 3 inclusi per lo SKU basic.	Int Vincoli: Valore minimo = 1 Valore massimo = 12

Sku

Nome	Descrizione	Valore
nome	SKU del servizio di ricerca. I valori validi includono: 'free': Servizio condiviso. 'basic': servizio dedicato con un massimo di 3 repliche. 'standard': servizio dedicato con un massimo di 12 partizioni e 12 repliche. 'standard2': simile allo standard, ma con una maggiore capacità per ogni unità di ricerca. 'standard3': la più grande offerta Standard con un massimo di 12 partizioni e 12 repliche (o fino a 3 partizioni con più indici se si imposta anche la proprietà hostingMode su 'highDensity'). 'storage_optimized_l1': supporta 1 TB per partizione, fino a 12 partizioni. 'storage_optimized_l2': supporta 2 TB per partizione, fino a 12 partizioni.	'basic' 'free' 'standard' 'standard2' 'standard3' 'storage_optimized_l1' 'storage_optimized_l2'

TrackedResourceTags

Nome	Descrizione	Valore

Esempi di utilizzo

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Sagoma	Descrizione
con restrizioni di rete di Azure AI Studio	Questo set di modelli illustra come configurare Azure AI Studio con collegamento privato e uscita disabilitato, usando chiavi gestite da Microsoft per la crittografia e la configurazione delle identità gestite da Microsoft per la risorsa di intelligenza artificiale.
servizio Ricerca cognitiva di Azure	Questo modello crea un servizio Ricerca cognitiva di Azure
servizio Ricerca cognitiva di Azure con endpoint privato	Questo modello crea un servizio Ricerca cognitiva di Azure con un endpoint privato.
agente protetto dalla rete con identità gestita dall'utente	Questo set di modelli illustra come configurare il servizio Agente di intelligenza artificiale di Azure con isolamento della rete virtuale usando l'autenticazione dell'identità gestita dall'utente per la connessione al servizio di intelligenza artificiale/AOAI e i collegamenti di rete privata per connettere l'agente ai dati sicuri.
configurazione dell'agente standard	Questo set di modelli illustra come configurare il servizio Azure AI Agent con la configurazione standard, ovvero con l'autenticazione dell'identità gestita per le connessioni di progetto/hub e l'accesso a Internet pubblico abilitato. Gli agenti usano risorse di ricerca e archiviazione a tenant singolo di proprietà del cliente. Con questa configurazione, si ha il controllo completo e la visibilità su queste risorse, ma si comportano costi in base all'utilizzo.
'app Web con un database SQL, Azure Cosmos DB, Ricerca di Azure	Questo modello effettua il provisioning di un'app Web, un database SQL, Azure Cosmos DB, Ricerca di Azure e Application Insights.

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa searchServices può essere distribuito con operazioni destinate a:

gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Search/searchServices, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Search/searchServices@2020-08-01"
  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
    }
  })
}

Valori delle proprietà

Identità

Nome	Descrizione	Valore
digitare	Tipo di identità.	'Nessuno' 'SystemAssigned' (obbligatorio)

IpRule

Nome	Descrizione	Valore
valore	Valore corrispondente a un singolo indirizzo IPv4 (ad esempio, 123.1.2.3) o a un intervallo IP in formato CIDR (ad esempio, 123.1.2.3/24) da consentire.	corda

Microsoft.Search/searchServices

Nome	Descrizione	Valore
identità	Identità della risorsa.	identity
ubicazione	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
nome	Nome della risorsa	stringa (obbligatorio)
proprietà	Proprietà del servizio di ricerca.	SearchServiceProperties
Sku	SKU del servizio di ricerca, che determina il livello di prezzo e i limiti di capacità. Questa proprietà è necessaria quando si crea un nuovo servizio di ricerca.	sku
Tag	Tag delle risorse	Dizionario di nomi e valori di tag.
digitare	Tipo di risorsa	"Microsoft.Search/searchServices@2020-08-01"

NetworkRuleSet

Nome	Descrizione	Valore
ipRules	Elenco di regole di restrizione IP che definisce le reti in ingresso con l'accesso all'endpoint del servizio di ricerca. Nel frattempo, tutte le altre reti IP pubbliche vengono bloccate dal firewall. Queste regole di restrizione vengono applicate solo quando il "publicNetworkAccess" del servizio di ricerca è "abilitato". in caso contrario, il traffico sull'interfaccia pubblica non è consentito anche con regole IP pubbliche e le connessioni endpoint private sono il metodo di accesso esclusivo.	IpRule []

SearchServiceProperties

Nome	Descrizione	Valore
hostingMode	Applicabile solo per lo SKU Standard3. È possibile impostare questa proprietà per abilitare fino a 3 partizioni ad alta densità che consentono fino a 1000 indici, che è molto più alto rispetto agli indici massimi consentiti per qualsiasi altro SKU. Per lo SKU standard3, il valore è "default" o "highDensity". Per tutti gli altri SKU, questo valore deve essere 'default'.	'default' 'highDensity'
networkRuleSet	Regole specifiche della rete che determinano il modo in cui è possibile raggiungere il servizio Ricerca cognitiva di Azure.	NetworkRuleSet
partitionCount	Numero di partizioni nel servizio di ricerca; se specificato, può essere 1, 2, 3, 4, 6 o 12. I valori maggiori di 1 sono validi solo per gli SKU standard. Per i servizi 'standard3' con hostingMode impostato su 'highDensity', i valori consentiti sono compresi tra 1 e 3.	Int Vincoli: Valore minimo = 1 Valore massimo = 12
publicNetworkAccess	Questo valore può essere impostato su "enabled" per evitare modifiche di rilievo nelle risorse e nei modelli dei clienti esistenti. Se impostato su "disabilitato", il traffico sull'interfaccia pubblica non è consentito e le connessioni endpoint private saranno il metodo di accesso esclusivo.	'disabled' 'enabled'
replicaCount	Numero di repliche nel servizio di ricerca. Se specificato, deve essere un valore compreso tra 1 e 12 inclusi per gli SKU standard o compreso tra 1 e 3 inclusi per lo SKU basic.	Int Vincoli: Valore minimo = 1 Valore massimo = 12

Sku

Nome	Descrizione	Valore
nome	SKU del servizio di ricerca. I valori validi includono: 'free': Servizio condiviso. 'basic': servizio dedicato con un massimo di 3 repliche. 'standard': servizio dedicato con un massimo di 12 partizioni e 12 repliche. 'standard2': simile allo standard, ma con una maggiore capacità per ogni unità di ricerca. 'standard3': la più grande offerta Standard con un massimo di 12 partizioni e 12 repliche (o fino a 3 partizioni con più indici se si imposta anche la proprietà hostingMode su 'highDensity'). 'storage_optimized_l1': supporta 1 TB per partizione, fino a 12 partizioni. 'storage_optimized_l2': supporta 2 TB per partizione, fino a 12 partizioni.	'basic' 'free' 'standard' 'standard2' 'standard3' 'storage_optimized_l1' 'storage_optimized_l2'

TrackedResourceTags

Nome	Descrizione	Valore

Esempi di utilizzo

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Modulo	Descrizione
servizio di ricerca	Modulo di risorse AVM per il servizio di ricerca

Condividi tramite

Microsoft.Search searchServices 2020-08-01

Definizione di risorsa Bicep

Formato risorsa

Valori delle proprietà

Identità

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

SearchServiceProperties

Sku

TrackedResourceTags

Esempi di utilizzo

Moduli verificati di Azure

Esempi di avvio rapido di Azure

Definizione di risorsa del modello di Resource Manager

Formato risorsa

Valori delle proprietà

Identità

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

SearchServiceProperties

Sku

TrackedResourceTags

Esempi di utilizzo

Modelli di avvio rapido di Azure

Definizione di risorsa Terraform (provider AzAPI)

Formato risorsa

Valori delle proprietà

Identità

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

SearchServiceProperties

Sku

TrackedResourceTags

Esempi di utilizzo

Moduli verificati di Azure

Commenti e suggerimenti

Risorse aggiuntive