Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Definizione di risorsa Bicep
Il tipo di risorsa searchServices può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Esempi di utilizzo
Esempi bicep
Esempio di base di distribuzione del servizio di ricerca.
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'
}
}
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.
| File bicipite | Descrizione |
|---|---|
| Rete di fonderia di intelligenza artificiale di Azure con restrizioni | Questo set di modelli illustra come configurare Azure AI Foundry con il collegamento privato e l'uscita disabilitati, usando le chiavi gestite da Microsoft per la crittografia e la configurazione dell'identità gestita 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. |
Formato risorsa
Per creare una risorsa Microsoft.Search/searchServices, aggiungere il bicep seguente al modello.
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'
}
}
Valori delle proprietà
Microsoft.Search/servizi di ricerca
| Nome | Descrizione | Valore |
|---|---|---|
| identità | Identità della risorsa. | identity |
| ubicazione | Posizione geografica della risorsa. Deve trattarsi di una delle aree geografiche di Azure supportate e registrate, ad esempio Stati Uniti occidentali, Stati Uniti orientali, Asia sud-orientale e così via. Questa proprietà è necessaria quando si crea una nuova risorsa. | corda |
| nome | Nome della risorsa | stringa (obbligatorio) |
| proprietà | Proprietà del servizio di ricerca. | Proprietà SearchService |
| 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 |
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 |
Set di regole di rete
Etichette delle risorse
| Nome | Descrizione | Valore |
|---|
Proprietà SearchService
| Nome | Descrizione | Valore |
|---|---|---|
| Modalità di hosting | 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'. | 'predefinito' 'alta densità' |
| networkRuleSet | Regole specifiche della rete che determinano il modo in cui è possibile raggiungere il servizio Ricerca cognitiva di Azure. | Set di regole di rete |
| numero di partizioni | 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 |
| pubblicoAccesso alla rete | 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. | 'disabilitato' 'abilitato' |
| 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. | 'di base' 'libero' 'standard' 'standard2' 'standard3' 'storage_optimized_l1' 'storage_optimized_l2' |
Definizione di risorsa del modello di Resource Manager
Il tipo di risorsa searchServices può essere distribuito con operazioni destinate a:
- Gruppi di risorse - Vedi comandi di distribuzione dei gruppi di risorse Per un elenco delle proprietà modificate in ciascuna versione API, vedi registro delle modifiche.
Esempi di utilizzo
Modelli di avvio rapido di Azure
I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.
| Sagoma | Descrizione |
|---|---|
|
Rete di fonderia di intelligenza artificiale di Azure con restrizioni |
Questo set di modelli illustra come configurare Azure AI Foundry con il collegamento privato e l'uscita disabilitati, usando le chiavi gestite da Microsoft per la crittografia e la configurazione dell'identità gestita 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. |
Formato risorsa
Per creare una risorsa Microsoft.Search/searchServices, aggiungere il codice JSON seguente al modello.
{
"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"
}
}
Valori delle proprietà
Microsoft.Search/servizi di ricerca
| Nome | Descrizione | Valore |
|---|---|---|
| versione dell'API | Versione dell'API | '2020-03-13' |
| identità | Identità della risorsa. | identity |
| ubicazione | Posizione geografica della risorsa. Deve trattarsi di una delle aree geografiche di Azure supportate e registrate, ad esempio Stati Uniti occidentali, Stati Uniti orientali, Asia sud-orientale e così via. Questa proprietà è necessaria quando si crea una nuova risorsa. | corda |
| nome | Nome della risorsa | stringa (obbligatorio) |
| proprietà | Proprietà del servizio di ricerca. | Proprietà SearchService |
| 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' |
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 |
Set di regole di rete
Etichette delle risorse
| Nome | Descrizione | Valore |
|---|
Proprietà SearchService
| Nome | Descrizione | Valore |
|---|---|---|
| Modalità di hosting | 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'. | 'predefinito' 'alta densità' |
| networkRuleSet | Regole specifiche della rete che determinano il modo in cui è possibile raggiungere il servizio Ricerca cognitiva di Azure. | Set di regole di rete |
| numero di partizioni | 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 |
| pubblicoAccesso alla rete | 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. | 'disabilitato' 'abilitato' |
| 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. | 'di base' 'libero' 'standard' 'standard2' 'standard3' 'storage_optimized_l1' 'storage_optimized_l2' |
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, vedi il registro modifiche.
Esempi di utilizzo
Esempi di Terraform
Esempio di base di distribuzione del servizio di ricerca.
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 = ["*"]
}
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 |
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-03-13"
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"
}
}
}
Valori delle proprietà
Microsoft.Search/servizi di ricerca
| Nome | Descrizione | Valore |
|---|---|---|
| identità | Identità della risorsa. | identity |
| ubicazione | Posizione geografica della risorsa. Deve trattarsi di una delle aree geografiche di Azure supportate e registrate, ad esempio Stati Uniti occidentali, Stati Uniti orientali, Asia sud-orientale e così via. Questa proprietà è necessaria quando si crea una nuova risorsa. | corda |
| nome | Nome della risorsa | stringa (obbligatorio) |
| proprietà | Proprietà del servizio di ricerca. | Proprietà SearchService |
| 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-03-13" |
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 |
Set di regole di rete
Etichette delle risorse
| Nome | Descrizione | Valore |
|---|
Proprietà SearchService
| Nome | Descrizione | Valore |
|---|---|---|
| Modalità di hosting | 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'. | 'predefinito' 'alta densità' |
| networkRuleSet | Regole specifiche della rete che determinano il modo in cui è possibile raggiungere il servizio Ricerca cognitiva di Azure. | Set di regole di rete |
| numero di partizioni | 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 |
| pubblicoAccesso alla rete | 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. | 'disabilitato' 'abilitato' |
| 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. | 'di base' 'libero' 'standard' 'standard2' 'standard3' 'storage_optimized_l1' 'storage_optimized_l2' |