Leggere in inglese

Condividi tramite


Microsoft.Search searchServices 2023-11-01

Scegliere una lingua di distribuzione

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@2023-11-01' = {
  identity: {
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    authOptions: {
      aadOrApiKey: {
        aadAuthFailureMode: 'string'
      }
      apiKeyOnly: any(Azure.Bicep.Types.Concrete.AnyType)
    }
    disableLocalAuth: bool
    encryptionWithCmk: {
      enforcement: 'string'
    }
    hostingMode: 'string'
    networkRuleSet: {
      ipRules: [
        {
          value: 'string'
        }
      ]
    }
    partitionCount: int
    publicNetworkAccess: 'string'
    replicaCount: int
    semanticSearch: 'string'
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valori delle proprietà

DataPlaneAadOrApiKeyAuthOption

Nome Descrizione Valore
aadAuthFailureMode Descrive la risposta inviata dall'API del piano dati di un servizio di ricerca per le richieste che hanno avuto esito negativo. 'http401WithBearerChallenge'
'http403'

DataPlaneAuthOptions

Nome Descrizione Valore
aadOrApiKey Indica che è possibile usare la chiave API o un token di accesso da un tenant di Microsoft Entra ID per l'autenticazione. DataPlaneAadOrApiKeyAuthOption
apiKeyOnly Indica che solo la chiave API può essere usata per l'autenticazione. qualunque

EncryptionWithCmk

Nome Descrizione Valore
rinforzo Descrive in che modo un servizio di ricerca deve applicare la presenza di una o più risorse non crittografate dal cliente. 'Disabilitato'
'Enabled'
'Non specificato'

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 i limiti di fatturazione e 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 usate per un firewall IP. Gli indirizzi IP che non corrispondono alle regole vengono bloccati dal firewall. Queste regole vengono applicate solo quando il "publicNetworkAccess" del servizio di ricerca è "abilitato". IpRule []

SearchServiceProperties

Nome Descrizione Valore
authOptions Definisce le opzioni per il modo in cui l'API del piano dati di un servizio di ricerca autentica le richieste. Non è possibile impostare questa impostazione se 'disableLocalAuth' è impostato su true. DataPlaneAuthOptions
disableLocalAuth Se impostato su true, le chiamate al servizio di ricerca non saranno autorizzate a usare le chiavi API per l'autenticazione. Non è possibile impostare su true se è definito 'dataPlaneAuthOptions'. Bool
encryptionWithCmk Specifica i criteri relativi alla crittografia delle risorse (ad esempio gli indici) usando le chiavi di Customer Manager all'interno di un servizio di ricerca. EncryptionWithCmk
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 la modalità di raggiungimento del servizio di ricerca. 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
semanticSearch Imposta le opzioni che controllano la disponibilità della ricerca semantica. Questa configurazione è possibile solo per determinati SKU di ricerca in determinate posizioni. 'disabled'
'free'
'standard'

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 avvio rapido

Gli esempi di avvio rapido seguenti distribuiscono 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

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": "2023-11-01",
  "name": "string",
  "identity": {
    "type": "string"
  },
  "location": "string",
  "properties": {
    "authOptions": {
      "aadOrApiKey": {
        "aadAuthFailureMode": "string"
      },
      "apiKeyOnly": {}
    },
    "disableLocalAuth": "bool",
    "encryptionWithCmk": {
      "enforcement": "string"
    },
    "hostingMode": "string",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "string"
        }
      ]
    },
    "partitionCount": "int",
    "publicNetworkAccess": "string",
    "replicaCount": "int",
    "semanticSearch": "string"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valori delle proprietà

DataPlaneAadOrApiKeyAuthOption

Nome Descrizione Valore
aadAuthFailureMode Descrive la risposta inviata dall'API del piano dati di un servizio di ricerca per le richieste che hanno avuto esito negativo. 'http401WithBearerChallenge'
'http403'

DataPlaneAuthOptions

Nome Descrizione Valore
aadOrApiKey Indica che è possibile usare la chiave API o un token di accesso da un tenant di Microsoft Entra ID per l'autenticazione. DataPlaneAadOrApiKeyAuthOption
apiKeyOnly Indica che solo la chiave API può essere usata per l'autenticazione. qualunque

EncryptionWithCmk

Nome Descrizione Valore
rinforzo Descrive in che modo un servizio di ricerca deve applicare la presenza di una o più risorse non crittografate dal cliente. 'Disabilitato'
'Enabled'
'Non specificato'

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 '2023-11-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 i limiti di fatturazione e 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 usate per un firewall IP. Gli indirizzi IP che non corrispondono alle regole vengono bloccati dal firewall. Queste regole vengono applicate solo quando il "publicNetworkAccess" del servizio di ricerca è "abilitato". IpRule []

SearchServiceProperties

Nome Descrizione Valore
authOptions Definisce le opzioni per il modo in cui l'API del piano dati di un servizio di ricerca autentica le richieste. Non è possibile impostare questa impostazione se 'disableLocalAuth' è impostato su true. DataPlaneAuthOptions
disableLocalAuth Se impostato su true, le chiamate al servizio di ricerca non saranno autorizzate a usare le chiavi API per l'autenticazione. Non è possibile impostare su true se è definito 'dataPlaneAuthOptions'. Bool
encryptionWithCmk Specifica i criteri relativi alla crittografia delle risorse (ad esempio gli indici) usando le chiavi di Customer Manager all'interno di un servizio di ricerca. EncryptionWithCmk
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 la modalità di raggiungimento del servizio di ricerca. 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
semanticSearch Imposta le opzioni che controllano la disponibilità della ricerca semantica. Questa configurazione è possibile solo per determinati SKU di ricerca in determinate posizioni. 'disabled'
'free'
'standard'

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

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Sagoma Descrizione
con restrizioni di rete di Azure AI Studio

Distribuire in Azure
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

Distribuire in Azure
Questo modello crea un servizio Ricerca cognitiva di Azure
servizio Ricerca cognitiva di Azure con endpoint privato

Distribuire in Azure
Questo modello crea un servizio Ricerca cognitiva di Azure con un endpoint privato.
'app Web con un database SQL, Azure Cosmos DB, Ricerca di Azure

Distribuire in 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@2023-11-01"
  name = "string"
  identity = {
    type = "string"
  }
  location = "string"
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      authOptions = {
        aadOrApiKey = {
          aadAuthFailureMode = "string"
        }
        apiKeyOnly = ?
      }
      disableLocalAuth = bool
      encryptionWithCmk = {
        enforcement = "string"
      }
      hostingMode = "string"
      networkRuleSet = {
        ipRules = [
          {
            value = "string"
          }
        ]
      }
      partitionCount = int
      publicNetworkAccess = "string"
      replicaCount = int
      semanticSearch = "string"
    }
  })
}

Valori delle proprietà

DataPlaneAadOrApiKeyAuthOption

Nome Descrizione Valore
aadAuthFailureMode Descrive la risposta inviata dall'API del piano dati di un servizio di ricerca per le richieste che hanno avuto esito negativo. 'http401WithBearerChallenge'
'http403'

DataPlaneAuthOptions

Nome Descrizione Valore
aadOrApiKey Indica che è possibile usare la chiave API o un token di accesso da un tenant di Microsoft Entra ID per l'autenticazione. DataPlaneAadOrApiKeyAuthOption
apiKeyOnly Indica che solo la chiave API può essere usata per l'autenticazione. qualunque

EncryptionWithCmk

Nome Descrizione Valore
rinforzo Descrive in che modo un servizio di ricerca deve applicare la presenza di una o più risorse non crittografate dal cliente. 'Disabilitato'
'Enabled'
'Non specificato'

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 i limiti di fatturazione e 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@2023-11-01"

NetworkRuleSet

Nome Descrizione Valore
ipRules Elenco di regole di restrizione IP usate per un firewall IP. Gli indirizzi IP che non corrispondono alle regole vengono bloccati dal firewall. Queste regole vengono applicate solo quando il "publicNetworkAccess" del servizio di ricerca è "abilitato". IpRule []

SearchServiceProperties

Nome Descrizione Valore
authOptions Definisce le opzioni per il modo in cui l'API del piano dati di un servizio di ricerca autentica le richieste. Non è possibile impostare questa impostazione se 'disableLocalAuth' è impostato su true. DataPlaneAuthOptions
disableLocalAuth Se impostato su true, le chiamate al servizio di ricerca non saranno autorizzate a usare le chiavi API per l'autenticazione. Non è possibile impostare su true se è definito 'dataPlaneAuthOptions'. Bool
encryptionWithCmk Specifica i criteri relativi alla crittografia delle risorse (ad esempio gli indici) usando le chiavi di Customer Manager all'interno di un servizio di ricerca. EncryptionWithCmk
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 la modalità di raggiungimento del servizio di ricerca. 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
semanticSearch Imposta le opzioni che controllano la disponibilità della ricerca semantica. Questa configurazione è possibile solo per determinati SKU di ricerca in determinate posizioni. 'disabled'
'free'
'standard'

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