Microsoft. Recherche searchServices 2022-09-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@2022-09-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
sku: {
name: 'string'
}
identity: {
type: 'string'
}
properties: {
authOptions: {
aadOrApiKey: {
aadAuthFailureMode: 'string'
}
apiKeyOnly: any()
}
disableLocalAuth: bool
encryptionWithCmk: {
enforcement: 'string'
}
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 |
|---|---|---|
| authOptions | Définit les options pour la façon dont l’API de plan de données d’un service de recherche authentifie les demandes. Cette valeur ne peut pas être définie si « disableLocalAuth » a la valeur true. | DataPlaneAuthOptions |
| disableLocalAuth | Lorsque la valeur est true, les appels au service de recherche ne sont pas autorisés à utiliser des clés API pour l’authentification. Cette valeur ne peut pas être définie sur true si « dataPlaneAuthOptions » est défini. | bool |
| encryptionWithCmk | Spécifie toute stratégie concernant le chiffrement des ressources (comme les index) à l’aide de clés customer manager au sein d’un service de recherche. | EncryptionWithCmk |
| 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 |
DataPlaneAuthOptions
| Nom | Description | Valeur |
|---|---|---|
| aadOrApiKey | Indique que la clé API ou un jeton d’accès d’Azure Active Directory peut être utilisé pour l’authentification. | DataPlaneAadOrApiKeyAuthOption |
| apiKeyOnly | Indique que seule la clé API doit être utilisée pour l’authentification. | Pour Bicep, vous pouvez utiliser la fonction any(). |
DataPlaneAadOrApiKeyAuthOption
| Nom | Description | Valeur |
|---|---|---|
| aadAuthFailureMode | Décrit la réponse que l’API du plan de données d’un service Search enverrait pour les demandes ayant échoué à l’authentification. | 'http401WithBearerChallenge' 'http403' |
EncryptionWithCmk
| Nom | Description | Valeur |
|---|---|---|
| Application | Décrit comment un service de recherche doit appliquer le fait d’avoir une ou plusieurs ressources non chiffrées par le client. | 'Désactivé' 'Enabled' 'Non spécifié' |
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 d’adresses 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é. « de base » : 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 » : offre Standard la plus grande 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. » | '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 provisionne une application web, un 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 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/la ressource searchServices, ajoutez le code JSON suivant à votre modèle.
{
"type": "Microsoft.Search/searchServices",
"apiVersion": "2022-09-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"sku": {
"name": "string"
},
"identity": {
"type": "string"
},
"properties": {
"authOptions": {
"aadOrApiKey": {
"aadAuthFailureMode": "string"
},
"apiKeyOnly": {}
},
"disableLocalAuth": "bool",
"encryptionWithCmk": {
"enforcement": "string"
},
"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 | '2022-09-01' |
| 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 |
|---|---|---|
| authOptions | Définit les options pour la façon dont l’API de plan de données d’un service de recherche authentifie les demandes. Cette valeur ne peut pas être définie si « disableLocalAuth » a la valeur true. | DataPlaneAuthOptions |
| disableLocalAuth | Lorsque la valeur est true, les appels au service de recherche ne sont pas autorisés à utiliser des clés API pour l’authentification. Cette valeur ne peut pas être définie sur true si « dataPlaneAuthOptions » est défini. | bool |
| encryptionWithCmk | Spécifie toute stratégie concernant le chiffrement des ressources (comme les index) à l’aide de clés customer manager au sein d’un service de recherche. | EncryptionWithCmk |
| 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 |
DataPlaneAuthOptions
| Nom | Description | Valeur |
|---|---|---|
| aadOrApiKey | Indique que la clé API ou un jeton d’accès d’Azure Active Directory peut être utilisé pour l’authentification. | DataPlaneAadOrApiKeyAuthOption |
| apiKeyOnly | Indique que seule la clé API doit être utilisée pour l’authentification. |
DataPlaneAadOrApiKeyAuthOption
| Nom | Description | Valeur |
|---|---|---|
| aadAuthFailureMode | Décrit la réponse que l’API du plan de données d’un service Search enverrait pour les demandes ayant échoué à l’authentification. | 'http401WithBearerChallenge' 'http403' |
EncryptionWithCmk
| Nom | Description | Valeur |
|---|---|---|
| Application | Décrit comment un service de recherche doit appliquer le fait d’avoir une ou plusieurs ressources non chiffrées par le client. | 'Désactivé' 'Enabled' 'Non spécifié' |
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 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@2022-09-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "SystemAssigned"
}
body = jsonencode({
properties = {
authOptions = {
aadOrApiKey = {
aadAuthFailureMode = "string"
}
}
disableLocalAuth = bool
encryptionWithCmk = {
enforcement = "string"
}
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@2022-09-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 |
|---|---|---|
| authOptions | Définit les options pour la façon dont l’API de plan de données d’un service de recherche authentifie les demandes. Cette valeur ne peut pas être définie si « disableLocalAuth » a la valeur true. | DataPlaneAuthOptions |
| disableLocalAuth | Lorsqu’il est défini sur true, les appels au service de recherche ne sont pas autorisés à utiliser des clés API pour l’authentification. Cette valeur ne peut pas être définie sur true si « dataPlaneAuthOptions » est définie. | bool |
| encryptionWithCmk | Spécifie toute stratégie concernant le chiffrement des ressources (telles que les index) à l’aide de clés customer Manager au sein d’un service de recherche. | EncryptionWithCmk |
| 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 |
DataPlaneAuthOptions
| Nom | Description | Valeur |
|---|---|---|
| aadOrApiKey | Indique que la clé API ou un jeton d’accès d’Azure Active Directory peuvent être utilisés pour l’authentification. | DataPlaneAadOrApiKeyAuthOption |
| apiKeyOnly | Indique que seule la clé API doit être utilisée pour l’authentification. |
DataPlaneAadOrApiKeyAuthOption
| Nom | Description | Valeur |
|---|---|---|
| aadAuthFailureMode | Décrit la réponse que l’API de plan de données d’un service Search enverrait pour les demandes ayant échoué à l’authentification. | « http401WithBearerChallenge » « http403 » |
EncryptionWithCmk
| Nom | Description | Valeur |
|---|---|---|
| Application | Décrit comment un service de recherche doit appliquer une ou plusieurs ressources chiffrées non client. | « Désactivé » « Activé » « Non spécifié » |
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 » |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour