Microsoft. Recherche searchServices 2020-08-01
Définition de ressource Bicep
Le type de ressource searchServices peut être déployé avec des opérations qui ciblent :
- Groupes de ressources - Voir commandes de déploiement de groupe de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.
Format des ressources
Pour créer un Microsoft. Recherche/searchServices, ajoutez le Bicep suivant à votre modèle.
resource symbolicname 'Microsoft.Search/searchServices@2020-08-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
sku: {
name: 'string'
}
identity: {
type: 'string'
}
properties: {
hostingMode: 'string'
networkRuleSet: {
ipRules: [
{
value: 'string'
}
]
}
partitionCount: int
publicNetworkAccess: 'string'
replicaCount: int
}
}
Valeurs de propriétés
searchServices
| Nom | Description | Valeur |
|---|---|---|
| name | Nom de la ressource | string (obligatoire) |
| location | Emplacement géographique où réside la ressource | string (obligatoire) |
| tags | Balises de ressource. | Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles |
| sku | Référence SKU du service Recherche, qui détermine le niveau de prix et les limites de capacité. Cette propriété est requise lors de la création d’un service Recherche. | Sku |
| identité | Identité de la ressource. | Identité |
| properties | Propriétés du service de recherche. | SearchServiceProperties |
Identité
| Nom | Description | Valeur |
|---|---|---|
| type | Type d’identité. | 'None' 'SystemAssigned' (obligatoire) |
SearchServiceProperties
| Nom | Description | Valeur |
|---|---|---|
| hostingMode | Applicable uniquement à 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 « default ». | 'default' 'highDensity' |
| networkRuleSet | Règles spécifiques au réseau qui déterminent la façon dont le service Recherche cognitive Azure peut être atteint. | NetworkRuleSet |
| partitionCount | Nombre de partitions dans le service de recherche ; s’il est spécifié, il peut s’agir de 1, 2, 3, 4, 6 ou 12. Les valeurs supérieures à 1 sont uniquement valides 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 « enabled » pour éviter les changements cassants sur les modèles et les ressources 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é constituent la méthode d’accès exclusif. | 'disabled' 'enabled' |
| replicaCount | Nombre de réplicas dans le service de recherche. Si elle est spécifiée, il doit s’agir d’une valeur comprise entre 1 et 12 inclusive pour les références SKU standard ou comprise entre 1 et 3 inclus pour la référence SKU de base. | int Contraintes : Valeur minimale = 1 Valeur maximale = 12 |
NetworkRuleSet
| Nom | Description | Valeur |
|---|---|---|
| ipRules | Liste des règles de restriction IP qui définit le ou les réseaux entrants avec l’autorisation d’accès au point de terminaison du service de recherche. En attendant, tous les autres réseaux IP publics sont bloqués par le pare-feu. Ces règles de restriction sont appliquées uniquement lorsque « publicNetworkAccess » du service de recherche est « activé » ; sinon, le trafic via l’interface publique n’est pas autorisé même avec des règles d’adresse IP publique, et les connexions de point de terminaison privé seraient la méthode d’accès exclusif. | IpRule[] |
IpRule
| Nom | Description | Valeur |
|---|---|---|
| value | Valeur correspondant à une adresse IPv4 unique (par exemple, 123.1.2.3) ou à une plage IP au format CIDR (par exemple, 123.1.2.3/24) à autoriser. | string |
Sku
| Nom | Description | Valeur |
|---|---|---|
| name | Référence SKU du service de recherche. Les valeurs valides sont les suivantes : « free » : service partagé. « basic » : service dédié avec jusqu’à 3 réplicas. « standard » : service dédié avec jusqu’à 12 partitions et 12 réplicas. « standard2 » : similaire à standard, 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 davantage 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. » | 'basic' 'free' 'standard' 'standard2' 'standard3' 'storage_optimized_l1' 'storage_optimized_l2' |
Modèles de démarrage rapide
Les modèles de démarrage rapide suivants déploient ce type de ressource.
| Modèle | Description |
|---|---|
Application web avec un SQL Database, Azure Cosmos DB, Azure Recherche
|
Ce modèle approvisionne une application web, une SQL Database, Azure Cosmos DB, Azure Recherche et Application Insights. |
|
Service Recherche cognitive Azure
|
Ce modèle crée un service Recherche cognitive Azure |
|
Recherche cognitive Azure service avec point de terminaison privé
|
Ce modèle crée un service Recherche cognitive Azure avec un point de terminaison privé. |
Définition de ressources 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 de groupes de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Format des ressources
Pour créer un Microsoft. Recherche/searchServices ressource, ajoutez le code JSON suivant à votre modèle.
{
"type": "Microsoft.Search/searchServices",
"apiVersion": "2020-08-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"sku": {
"name": "string"
},
"identity": {
"type": "string"
},
"properties": {
"hostingMode": "string",
"networkRuleSet": {
"ipRules": [
{
"value": "string"
}
]
},
"partitionCount": "int",
"publicNetworkAccess": "string",
"replicaCount": "int"
}
}
Valeurs de propriétés
searchServices
| Nom | Description | Valeur |
|---|---|---|
| type | Type de ressource | 'Microsoft. Recherche/searchServices' |
| apiVersion | Version de l’API de ressource | '2020-08-01' |
| name | Nom de la ressource | chaîne (obligatoire) |
| location | Emplacement géographique où réside la ressource | chaîne (obligatoire) |
| tags | Balises de ressource. | Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles |
| sku | Référence SKU du service Recherche, qui détermine le niveau de prix et les limites de capacité. Cette propriété est requise lors de la création d’un service Recherche. | Sku |
| identité | Identité de la ressource. | Identité |
| properties | Propriétés du service de recherche. | SearchServiceProperties |
Identité
| Nom | Description | Valeur |
|---|---|---|
| type | Type d’identité. | 'None' 'SystemAssigned' (obligatoire) |
SearchServiceProperties
| Nom | Description | Valeur |
|---|---|---|
| hostingMode | 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 « default ». | 'default' 'highDensity' |
| networkRuleSet | Règles spécifiques au réseau qui déterminent la façon dont le service Recherche cognitive Azure peut être atteint. | NetworkRuleSet |
| partitionCount | 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 ne sont valides que 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 « enabled » pour éviter les modifications cassants sur les modèles et les ressources client existants. Si la valeur est « disabled », le trafic sur l’interface publique n’est pas autorisé et les connexions de point de terminaison privé constituent la méthode d’accès exclusif. | 'disabled' 'enabled' |
| replicaCount | Nombre de réplicas dans le service de recherche. Si elle est spécifiée, il doit s’agir d’une valeur comprise entre 1 et 12 inclus pour les références SKU standard ou comprise entre 1 et 3 inclus pour la référence SKU de base. | int Contraintes : Valeur minimale = 1 Valeur maximale = 12 |
NetworkRuleSet
| Nom | Description | Valeur |
|---|---|---|
| ipRules | Liste de règles de restriction IP qui définit le ou les réseaux entrants avec autorisation d’accès au point de terminaison du service de recherche. Entre-temps, tous les autres réseaux IP publics sont bloqués par le pare-feu. Ces règles de restriction ne sont appliquées que lorsque le « publicNetworkAccess » du service de recherche est « activé » ; sinon, le trafic sur l’interface publique n’est pas autorisé, même avec des règles IP publiques, et les connexions de point de terminaison privé constituent la méthode d’accès exclusif. | IpRule[] |
IpRule
| Nom | Description | Valeur |
|---|---|---|
| value | Valeur correspondant à une adresse IPv4 unique (par exemple, 123.1.2.3) ou à une plage IP au format CIDR (par exemple, 123.1.2.3/24) à autoriser. | string |
Sku
| Nom | Description | Valeur |
|---|---|---|
| name | Référence SKU du service de recherche. Les valeurs valides sont les suivantes : « free » : service partagé. « basic » : service dédié avec jusqu’à 3 réplicas. « standard » : service dédié avec jusqu’à 12 partitions et 12 réplicas. « standard2 » : similaire à standard, 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 davantage 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. » | 'basic' 'free' 'standard' 'standard2' 'standard3' 'storage_optimized_l1' 'storage_optimized_l2' |
Modèles de démarrage rapide
Les modèles de démarrage rapide suivants déploient ce type de ressource.
| Modèle | Description |
|---|---|
|
Application web avec un SQL Database, Azure Cosmos DB, Azure Recherche
|
Ce modèle approvisionne une application web, une SQL Database, Azure Cosmos DB, Azure Recherche et Application Insights. |
|
Service Recherche cognitive Azure
|
Ce modèle crée un service Recherche cognitive Azure |
|
Recherche cognitive Azure service avec point de terminaison privé
|
Ce modèle crée un service Recherche cognitive Azure avec un point de terminaison privé. |
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 obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Format des ressources
Pour créer un Microsoft. Recherche/searchServices, ajoutez le Terraform suivant à votre modèle.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Search/searchServices@2020-08-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "SystemAssigned"
}
body = jsonencode({
properties = {
hostingMode = "string"
networkRuleSet = {
ipRules = [
{
value = "string"
}
]
}
partitionCount = int
publicNetworkAccess = "string"
replicaCount = int
}
sku = {
name = "string"
}
})
}
Valeurs de propriétés
searchServices
| Nom | Description | Valeur |
|---|---|---|
| type | Type de ressource | « Microsoft. Recherche/searchServices@2020-08-01" |
| name | Nom de la ressource | chaîne (obligatoire) |
| location | Emplacement géographique où réside la ressource | chaîne (obligatoire) |
| parent_id | Pour effectuer un déploiement sur un groupe de ressources, utilisez l’ID de ce groupe de ressources. | chaîne (obligatoire) |
| tags | Balises de ressource. | Dictionnaire de noms et de valeurs d’étiquettes. |
| sku | Référence SKU du service Recherche, qui détermine le niveau de prix et les limites de capacité. Cette propriété est requise lors de la création d’un service Recherche. | Sku |
| identité | Identité de la ressource. | Identité |
| properties | Propriétés du service de recherche. | SearchServiceProperties |
Identité
| Nom | Description | Valeur |
|---|---|---|
| type | Type d’identité. | « SystemAssigned » (obligatoire) |
SearchServiceProperties
| Nom | Description | Valeur |
|---|---|---|
| hostingMode | 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 « default ». | « valeur par défaut » « highDensity » |
| networkRuleSet | Règles spécifiques au réseau qui déterminent la façon dont le service Recherche cognitive Azure peut être atteint. | NetworkRuleSet |
| partitionCount | 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 ne sont valides que 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 « enabled » pour éviter les modifications cassants sur les modèles et les ressources client existants. Si la valeur est « disabled », le trafic sur l’interface publique n’est pas autorisé et les connexions de point de terminaison privé constituent la méthode d’accès exclusif. | "disabled" (désactivé) "enabled" (activé) |
| replicaCount | Nombre de réplicas dans le service de recherche. Si elle est spécifiée, il doit s’agir d’une valeur comprise entre 1 et 12 inclus pour les références SKU standard ou comprise entre 1 et 3 inclus pour la référence SKU de base. | int Contraintes : Valeur minimale = 1 Valeur maximale = 12 |
NetworkRuleSet
| Nom | Description | Valeur |
|---|---|---|
| ipRules | Liste de règles de restriction IP qui définit le ou les réseaux entrants avec autorisation d’accès au point de terminaison du service de recherche. Entre-temps, tous les autres réseaux IP publics sont bloqués par le pare-feu. Ces règles de restriction ne sont appliquées que lorsque le « publicNetworkAccess » du service de recherche est « activé » ; sinon, le trafic sur l’interface publique n’est pas autorisé, même avec des règles IP publiques, et les connexions de point de terminaison privé constituent la méthode d’accès exclusif. | IpRule[] |
IpRule
| Nom | Description | Valeur |
|---|---|---|
| value | Valeur correspondant à une adresse IPv4 unique (par exemple, 123.1.2.3) ou à une plage IP au format CIDR (par exemple, 123.1.2.3/24) à autoriser. | string |
Sku
| Nom | Description | Valeur |
|---|---|---|
| name | Référence SKU du service de recherche. Les valeurs valides sont les suivantes : « free » : service partagé. « basic » : service dédié avec jusqu’à 3 réplicas. « standard » : service dédié avec jusqu’à 12 partitions et 12 réplicas. « standard2 » : similaire à standard, 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 davantage 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. » | « de base » « gratuit » « standard » « standard2 » « standard3 » « storage_optimized_l1 » « storage_optimized_l2 » |