Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Définition de ressource Bicep
Le type de ressource searchServices peut être déployé avec des opérations qui ciblent :
- groupes de ressources - Consultez commandes de déploiement de groupes de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Exemples d’utilisation
Exemples Bicep
Exemple de base de déploiement du service de recherche.
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'
}
}
Modules vérifiés Azure
Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.
| Module | Descriptif |
|---|---|
| service de recherche | Module de ressources AVM pour le service de recherche |
Exemples de démarrage rapide Azure
Les modèles de démarrage rapide Azure suivants contiennent des exemples Bicep pour le déploiement de ce type de ressource.
| Fichier Bicep | Descriptif |
|---|---|
| Réseau Azure AI Foundry restreint | Cet ensemble de modèles montre comment configurer Azure AI Foundry avec la liaison privée et la sortie désactivées, à l’aide de clés gérées par Microsoft pour le chiffrement et de la configuration d’identité gérée par Microsoft pour la ressource IA. |
| service Recherche cognitive Azure | Ce modèle crée un service Recherche cognitive Azure |
| Agent sécurisé réseau avec d’identité managée par l’utilisateur | Cet ensemble de modèles montre comment configurer azure AI Agent Service avec isolation de réseau virtuel à l’aide de l’authentification d’identité managée par l’utilisateur pour la connexion AI Service/AOAI et les liens de réseau privé pour connecter l’agent à vos données sécurisées. |
| configuration de l’agent standard | Cet ensemble de modèles montre comment configurer azure AI Agent Service avec la configuration standard, ce qui signifie qu’avec l’authentification d’identité managée pour les connexions project/hub et l’accès à Internet public activé. Les agents utilisent des ressources de stockage et de recherche à locataire unique appartenant au client. Avec cette configuration, vous disposez d’un contrôle total et d’une visibilité sur ces ressources, mais vous entraînez des coûts en fonction de votre utilisation. |
Format de ressource
Pour créer une ressource Microsoft.Search/searchServices, ajoutez le bicep suivant à votre modèle.
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'
}
}
Valeurs de propriété
Microsoft.Search/searchServices
| Nom | Descriptif | Valeur |
|---|---|---|
| identité | Identité de la ressource. | Identité |
| emplacement | Emplacement géographique où réside la ressource | chaîne (obligatoire) |
| nom | Nom de la ressource | chaîne (obligatoire) |
| Propriétés | Propriétés du service de recherche. | SearchServiceProperties |
| Sku | Référence SKU du service de recherche, qui détermine le niveau tarifaire et les limites de capacité. Cette propriété est requise lors de la création d’un service de recherche. | référence SKU |
| étiquettes | Balises de ressource | Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles |
Identité
| Nom | Descriptif | Valeur |
|---|---|---|
| type | Type d’identité. | « Aucun » 'SystemAssigned' (obligatoire) |
IpRule
| Nom | Descriptif | Valeur |
|---|---|---|
| valeur | Valeur correspondant à une seule adresse IPv4 (par exemple, 123.1.2.3) ou à une plage IP au format CIDR (par exemple, 123.1.2.3/24) à autoriser. | corde |
NetworkRuleSet
SearchServiceProperties
| Nom | Descriptif | Valeur |
|---|---|---|
| mode d’hébergement | Applicable uniquement pour la référence SKU standard3. Vous pouvez définir cette propriété pour activer jusqu’à 3 partitions à haute densité qui autorisent jusqu’à 1 000 index, ce qui est beaucoup plus élevé que les index maximum autorisés pour toute autre référence SKU. Pour la référence SKU standard3, la valeur est « default » ou « highDensity ». Pour toutes les autres références SKU, cette valeur doit être « par défaut ». | « Par défaut » « Haute Densité » |
| networkRuleSet | Règles spécifiques au réseau qui déterminent la façon dont le service Recherche cognitive Azure peut être atteint. | NetworkRuleSet |
| nombre de partitions | Nombre de partitions dans le service de recherche ; si spécifié, il peut s’agir de 1, 2, 3, 4, 6 ou 12. Les valeurs supérieures à 1 sont valides uniquement pour les références SKU standard. Pour les services « standard3 » avec hostingMode défini sur « highDensity », les valeurs autorisées sont comprises entre 1 et 3. | Int Contraintes: Valeur minimale = 1 Valeur maximale = 12 |
| publicNetworkAccess | Cette valeur peut être définie sur « activé » pour éviter les modifications cassants sur les ressources et les modèles clients existants. Si la valeur est « désactivée », le trafic sur l’interface publique n’est pas autorisé et les connexions de point de terminaison privé sont la méthode d’accès exclusive. | « Handicapé » « Activé » |
| replicaCount | Nombre de réplicas dans le service de recherche. S’il est spécifié, il doit s’agir d’une valeur comprise entre 1 et 12 inclus pour les références SKU standard ou comprises entre 1 et 3 pour la référence SKU de base. | Int Contraintes: Valeur minimale = 1 Valeur maximale = 12 |
Sku
| Nom | Descriptif | Valeur |
|---|---|---|
| nom | Référence SKU du service de recherche. Les valeurs valides sont les suivantes : « gratuit » : service partagé. « de base » : service dédié avec jusqu’à 3 réplicas. « standard » : service dédié avec jusqu’à 12 partitions et 12 réplicas. « standard2 » : similaire à la norme, mais avec plus de capacité par unité de recherche. « standard3 » : la plus grande offre Standard avec jusqu’à 12 partitions et 12 réplicas (ou jusqu’à 3 partitions avec plus d’index si vous définissez également la propriété hostingMode sur « highDensity »). 'storage_optimized_l1' : prend en charge 1 To par partition, jusqu’à 12 partitions. 'storage_optimized_l2' : prend en charge 2 To par partition, jusqu’à 12 partitions. | « Basique » « Libre » « Standard » 'Norme 2' 'Norme 3' 'storage_optimized_l1' 'storage_optimized_l2' |
TrackedResourceTags
| Nom | Descriptif | Valeur |
|---|
Définition de ressource de modèle ARM
Le type de ressource searchServices peut être déployé avec des opérations qui ciblent :
- Groupes de ressources - Voir commandes de déploiement des groupes de ressources Pour une liste des propriétés modifiées dans chaque version d’API, voir journal des changements.
Exemples d’utilisation
Modèles de démarrage rapide Azure
Les modèles de démarrage rapide Azure suivants déployer ce type de ressource.
| Modèle | Descriptif |
|---|---|
|
Réseau Azure AI Foundry restreint |
Cet ensemble de modèles montre comment configurer Azure AI Foundry avec la liaison privée et la sortie désactivées, à l’aide de clés gérées par Microsoft pour le chiffrement et de la configuration d’identité gérée par Microsoft pour la ressource IA. |
|
service Recherche cognitive Azure |
Ce modèle crée un service Recherche cognitive Azure |
|
service Recherche cognitive Azure avec de point de terminaison privé |
Ce modèle crée un service Recherche cognitive Azure avec un point de terminaison privé. |
|
Agent sécurisé réseau avec d’identité managée par l’utilisateur |
Cet ensemble de modèles montre comment configurer azure AI Agent Service avec isolation de réseau virtuel à l’aide de l’authentification d’identité managée par l’utilisateur pour la connexion AI Service/AOAI et les liens de réseau privé pour connecter l’agent à vos données sécurisées. |
|
configuration de l’agent standard |
Cet ensemble de modèles montre comment configurer azure AI Agent Service avec la configuration standard, ce qui signifie qu’avec l’authentification d’identité managée pour les connexions project/hub et l’accès à Internet public activé. Les agents utilisent des ressources de stockage et de recherche à locataire unique appartenant au client. Avec cette configuration, vous disposez d’un contrôle total et d’une visibilité sur ces ressources, mais vous entraînez des coûts en fonction de votre utilisation. |
|
Application web avec une base de données SQL, Azure Cosmos DB, azure Search |
Ce modèle provisionne une application web, une base de données SQL, Azure Cosmos DB, Azure Search et Application Insights. |
Format de ressource
Pour créer une ressource Microsoft.Search/searchServices, ajoutez le code JSON suivant à votre modèle.
{
"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"
}
}
Valeurs de propriété
Microsoft.Search/searchServices
| Nom | Descriptif | Valeur |
|---|---|---|
| apiVersion | Version de l’API | '2020-08-01' |
| identité | Identité de la ressource. | Identité |
| emplacement | Emplacement géographique où réside la ressource | chaîne (obligatoire) |
| nom | Nom de la ressource | chaîne (obligatoire) |
| Propriétés | Propriétés du service de recherche. | SearchServiceProperties |
| Sku | Référence SKU du service de recherche, qui détermine le niveau tarifaire et les limites de capacité. Cette propriété est requise lors de la création d’un service de recherche. | référence SKU |
| étiquettes | Balises de ressource | Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles |
| type | Type de ressource | 'Microsoft.Search/searchServices' |
Identité
| Nom | Descriptif | Valeur |
|---|---|---|
| type | Type d’identité. | « Aucun » 'SystemAssigned' (obligatoire) |
IpRule
| Nom | Descriptif | Valeur |
|---|---|---|
| valeur | Valeur correspondant à une seule adresse IPv4 (par exemple, 123.1.2.3) ou à une plage IP au format CIDR (par exemple, 123.1.2.3/24) à autoriser. | corde |
NetworkRuleSet
SearchServiceProperties
| Nom | Descriptif | Valeur |
|---|---|---|
| mode d’hébergement | Applicable uniquement pour la référence SKU standard3. Vous pouvez définir cette propriété pour activer jusqu’à 3 partitions à haute densité qui autorisent jusqu’à 1 000 index, ce qui est beaucoup plus élevé que les index maximum autorisés pour toute autre référence SKU. Pour la référence SKU standard3, la valeur est « default » ou « highDensity ». Pour toutes les autres références SKU, cette valeur doit être « par défaut ». | « Par défaut » « Haute Densité » |
| networkRuleSet | Règles spécifiques au réseau qui déterminent la façon dont le service Recherche cognitive Azure peut être atteint. | NetworkRuleSet |
| nombre de partitions | Nombre de partitions dans le service de recherche ; si spécifié, il peut s’agir de 1, 2, 3, 4, 6 ou 12. Les valeurs supérieures à 1 sont valides uniquement pour les références SKU standard. Pour les services « standard3 » avec hostingMode défini sur « highDensity », les valeurs autorisées sont comprises entre 1 et 3. | Int Contraintes: Valeur minimale = 1 Valeur maximale = 12 |
| publicNetworkAccess | Cette valeur peut être définie sur « activé » pour éviter les modifications cassants sur les ressources et les modèles clients existants. Si la valeur est « désactivée », le trafic sur l’interface publique n’est pas autorisé et les connexions de point de terminaison privé sont la méthode d’accès exclusive. | « Handicapé » « Activé » |
| replicaCount | Nombre de réplicas dans le service de recherche. S’il est spécifié, il doit s’agir d’une valeur comprise entre 1 et 12 inclus pour les références SKU standard ou comprises entre 1 et 3 pour la référence SKU de base. | Int Contraintes: Valeur minimale = 1 Valeur maximale = 12 |
Sku
| Nom | Descriptif | Valeur |
|---|---|---|
| nom | Référence SKU du service de recherche. Les valeurs valides sont les suivantes : « gratuit » : service partagé. « de base » : service dédié avec jusqu’à 3 réplicas. « standard » : service dédié avec jusqu’à 12 partitions et 12 réplicas. « standard2 » : similaire à la norme, mais avec plus de capacité par unité de recherche. « standard3 » : la plus grande offre Standard avec jusqu’à 12 partitions et 12 réplicas (ou jusqu’à 3 partitions avec plus d’index si vous définissez également la propriété hostingMode sur « highDensity »). 'storage_optimized_l1' : prend en charge 1 To par partition, jusqu’à 12 partitions. 'storage_optimized_l2' : prend en charge 2 To par partition, jusqu’à 12 partitions. | « Basique » « Libre » « Standard » 'Norme 2' 'Norme 3' 'storage_optimized_l1' 'storage_optimized_l2' |
TrackedResourceTags
| Nom | Descriptif | Valeur |
|---|
Définition de ressource Terraform (fournisseur AzAPI)
Le type de ressource searchServices peut être déployé avec des opérations qui ciblent :
- Groupes de ressources Pour une liste des propriétés modifiées dans chaque version d’API, voir journal des modifications.
Exemples d’utilisation
Échantillons Terraform
Exemple de base de déploiement du service de recherche.
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 = ["*"]
}
Modules vérifiés Azure
Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.
| Module | Descriptif |
|---|---|
| service de recherche | Module de ressources AVM pour le service de recherche |
Format de ressource
Pour créer une ressource Microsoft.Search/searchServices, ajoutez terraform suivant à votre modèle.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Search/searchServices@2020-08-01"
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"
}
}
}
Valeurs de propriété
Microsoft.Search/searchServices
| Nom | Descriptif | Valeur |
|---|---|---|
| identité | Identité de la ressource. | Identité |
| emplacement | Emplacement géographique où réside la ressource | chaîne (obligatoire) |
| nom | Nom de la ressource | chaîne (obligatoire) |
| Propriétés | Propriétés du service de recherche. | SearchServiceProperties |
| Sku | Référence SKU du service de recherche, qui détermine le niveau tarifaire et les limites de capacité. Cette propriété est requise lors de la création d’un service de recherche. | référence SKU |
| étiquettes | Balises de ressource | Dictionnaire de noms et de valeurs d’étiquettes. |
| type | Type de ressource | « Microsoft.Search/searchServices@2020-08-01 » |
Identité
| Nom | Descriptif | Valeur |
|---|---|---|
| type | Type d’identité. | « Aucun » 'SystemAssigned' (obligatoire) |
IpRule
| Nom | Descriptif | Valeur |
|---|---|---|
| valeur | Valeur correspondant à une seule adresse IPv4 (par exemple, 123.1.2.3) ou à une plage IP au format CIDR (par exemple, 123.1.2.3/24) à autoriser. | corde |
NetworkRuleSet
SearchServiceProperties
| Nom | Descriptif | Valeur |
|---|---|---|
| mode d’hébergement | Applicable uniquement pour la référence SKU standard3. Vous pouvez définir cette propriété pour activer jusqu’à 3 partitions à haute densité qui autorisent jusqu’à 1 000 index, ce qui est beaucoup plus élevé que les index maximum autorisés pour toute autre référence SKU. Pour la référence SKU standard3, la valeur est « default » ou « highDensity ». Pour toutes les autres références SKU, cette valeur doit être « par défaut ». | « Par défaut » « Haute Densité » |
| networkRuleSet | Règles spécifiques au réseau qui déterminent la façon dont le service Recherche cognitive Azure peut être atteint. | NetworkRuleSet |
| nombre de partitions | Nombre de partitions dans le service de recherche ; si spécifié, il peut s’agir de 1, 2, 3, 4, 6 ou 12. Les valeurs supérieures à 1 sont valides uniquement pour les références SKU standard. Pour les services « standard3 » avec hostingMode défini sur « highDensity », les valeurs autorisées sont comprises entre 1 et 3. | Int Contraintes: Valeur minimale = 1 Valeur maximale = 12 |
| publicNetworkAccess | Cette valeur peut être définie sur « activé » pour éviter les modifications cassants sur les ressources et les modèles clients existants. Si la valeur est « désactivée », le trafic sur l’interface publique n’est pas autorisé et les connexions de point de terminaison privé sont la méthode d’accès exclusive. | « Handicapé » « Activé » |
| replicaCount | Nombre de réplicas dans le service de recherche. S’il est spécifié, il doit s’agir d’une valeur comprise entre 1 et 12 inclus pour les références SKU standard ou comprises entre 1 et 3 pour la référence SKU de base. | Int Contraintes: Valeur minimale = 1 Valeur maximale = 12 |
Sku
| Nom | Descriptif | Valeur |
|---|---|---|
| nom | Référence SKU du service de recherche. Les valeurs valides sont les suivantes : « gratuit » : service partagé. « de base » : service dédié avec jusqu’à 3 réplicas. « standard » : service dédié avec jusqu’à 12 partitions et 12 réplicas. « standard2 » : similaire à la norme, mais avec plus de capacité par unité de recherche. « standard3 » : la plus grande offre Standard avec jusqu’à 12 partitions et 12 réplicas (ou jusqu’à 3 partitions avec plus d’index si vous définissez également la propriété hostingMode sur « highDensity »). 'storage_optimized_l1' : prend en charge 1 To par partition, jusqu’à 12 partitions. 'storage_optimized_l2' : prend en charge 2 To par partition, jusqu’à 12 partitions. | « Basique » « Libre » « Standard » 'Norme 2' 'Norme 3' 'storage_optimized_l1' 'storage_optimized_l2' |
TrackedResourceTags
| Nom | Descriptif | Valeur |
|---|