Microsoft.Search searchServices 2022-09-01

Articolo
12/20/2024

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@2022-09-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
  }
  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 Azure Active Directory per l'autenticazione.	DataPlaneAadOrApiKeyAuthOption
apiKeyOnly	Indica che è necessario usare solo la chiave API 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 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
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 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 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": "2022-09-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"
  },
  "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 Azure Active Directory per l'autenticazione.	DataPlaneAadOrApiKeyAuthOption
apiKeyOnly	Indica che è necessario usare solo la chiave API 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	'2022-09-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
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 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

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	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.
'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@2022-09-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
    }
  })
}

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 Azure Active Directory per l'autenticazione.	DataPlaneAadOrApiKeyAuthOption
apiKeyOnly	Indica che è necessario usare solo la chiave API 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 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@2022-09-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
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 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

Condividi tramite

Microsoft.Search searchServices 2022-09-01

Definizione di risorsa Bicep

Formato risorsa

Valori delle proprietà

DataPlaneAadOrApiKeyAuthOption

DataPlaneAuthOptions

EncryptionWithCmk

Identità

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

SearchServiceProperties

Sku

TrackedResourceTags

Esempi di avvio rapido

Definizione di risorsa del modello di Resource Manager

Formato risorsa

Valori delle proprietà

DataPlaneAadOrApiKeyAuthOption

DataPlaneAuthOptions

EncryptionWithCmk

Identità

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

SearchServiceProperties

Sku

TrackedResourceTags

Modelli di avvio rapido

Definizione di risorsa Terraform (provider AzAPI)

Formato risorsa

Valori delle proprietà

DataPlaneAadOrApiKeyAuthOption

DataPlaneAuthOptions

EncryptionWithCmk

Identità

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

SearchServiceProperties

Sku

TrackedResourceTags

Commenti e suggerimenti

Risorse aggiuntive