Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Bicep-erőforrásdefiníció
A searchServices erőforrástípus üzembe helyezhető olyan műveletekkel, amelyek a következő célokat célják:
- Erőforráscsoportok – Lásd erőforráscsoport üzembe helyezési parancsaival
Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.
Használati példák
Bicep-minták
Alapvető példa a Search Service üzembe helyezésére.
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'
}
}
Azure-ból ellenőrzött modulok
Az alábbi Azure Verified Modules használható az erőforrástípus üzembe helyezéséhez.
| Modul | Leírás |
|---|---|
| Keresési szolgáltatás | Keresési szolgáltatás AVM-erőforrásmodulja |
Azure gyorsútmutató-minták
Az alábbi Azure rövid útmutatósablonok bicep-mintákat tartalmaznak az erőforrástípus üzembe helyezéséhez.
| Bicep-fájl | Leírás |
|---|---|
| Az Azure AI Foundry hálózata korlátozott | Ez a sablonkészlet bemutatja, hogyan állíthatja be az Azure AI Foundryt letiltott privát kapcsolattal és kimenő forgalommal, a Microsoft által felügyelt kulcsok használatával a titkosításhoz és a Microsoft által felügyelt identitáskonfigurációhoz az AI-erőforráshoz. |
| Azure Cognitive Search szolgáltatás | Ez a sablon létrehoz egy Azure Cognitive Search-szolgáltatást |
| hálózat által védett ügynök felhasználói felügyelt identitással | Ez a sablonkészlet bemutatja, hogyan állíthatja be az Azure AI Agent Service-t virtuális hálózatelkülönítéssel az AI-szolgáltatás/AOAI-kapcsolat és a magánhálózati kapcsolatok felhasználói felügyelt identitásának hitelesítésével az ügynök biztonságos adatokhoz való csatlakoztatásához. |
| standard ügynök beállítási | Ez a sablonkészlet bemutatja, hogyan állíthatja be az Azure AI Agent Service-t a standard beállítással, azaz a projekt-/központkapcsolatok felügyelt identitáshitelesítésével és a nyilvános internetkapcsolat engedélyezésével. Az ügynökök az ügyfél tulajdonában lévő, egybérlős keresési és tárolási erőforrásokat használják. Ezzel a beállítással teljes mértékben szabályozhatja és áttekintheti ezeket az erőforrásokat, de a használat alapján költségekkel kell számolnia. |
Erőforrás formátuma
Microsoft.Search/searchServices-erőforrás létrehozásához adja hozzá a következő Bicep-et a sablonhoz.
resource symbolicname 'Microsoft.Search/searchServices@2024-06-01-preview' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
authOptions: {
aadOrApiKey: {
aadAuthFailureMode: 'string'
}
apiKeyOnly: any(...)
}
disabledDataExfiltrationOptions: [
'string'
]
disableLocalAuth: bool
encryptionWithCmk: {
enforcement: 'string'
}
hostingMode: 'string'
networkRuleSet: {
bypass: 'string'
ipRules: [
{
value: 'string'
}
]
}
partitionCount: int
publicNetworkAccess: 'string'
replicaCount: int
semanticSearch: 'string'
}
sku: {
name: 'string'
}
tags: {
{customized property}: 'string'
}
}
Tulajdonságértékek
Microsoft.Keresés/keresésiSzolgáltatások
| Név | Leírás | Érték |
|---|---|---|
| identitás | Az erőforrás identitása. | Identitás |
| hely | Az a földrajzi hely, ahol az erőforrás él | sztring (kötelező) |
| név | Az erőforrás neve | sztring (kötelező) |
| kellékek | A keresési szolgáltatás tulajdonságai. | SearchServiceProperties |
| Sku | A keresési szolgáltatás termékváltozata, amely meghatározza az árszintet és a kapacitáskorlátokat. Ez a tulajdonság új keresési szolgáltatás létrehozásakor szükséges. | termékváltozat |
| Címkék | Erőforráscímkék | Címkenevek és -értékek szótára. sablonok címkéinek megtekintése |
DataPlaneAadOrApiKeyAuthOption
| Név | Leírás | Érték |
|---|---|---|
| aadAuthFailureMode | Azt ismerteti, hogy a keresési szolgáltatás adatsík API-ja milyen választ küld a sikertelen hitelesítést igénylő kérelmekre. | 'http401WithBearerChallenge' "http403" |
DataPlaneAuthOptions
| Név | Leírás | Érték |
|---|---|---|
| aadOrApiKey | Azt jelzi, hogy az API-kulcs vagy a Microsoft Entra ID-bérlőből származó hozzáférési jogkivonat használható a hitelesítéshez. | DataPlaneAadOrApiKeyAuthOption |
| apiKeyOnly | Azt jelzi, hogy csak az API-kulcs használható a hitelesítéshez. | bármely |
Titkosítás cmk-val
| Név | Leírás | Érték |
|---|---|---|
| kikényszerítés | Azt ismerteti, hogy a keresési szolgáltatásnak hogyan kell kikényszerítenie a megfelelőséget, ha olyan objektumokat talál, amelyek nincsenek titkosítva az ügyfél által felügyelt kulccsal. | "Letiltva" "Engedélyezve" "Meghatározatlan" |
Azonosság
| Név | Leírás | Érték |
|---|---|---|
| típus | Az erőforráshoz használt identitás típusa. A "SystemAssigned, UserAssigned" típus magában foglalja a rendszer által létrehozott identitást és a felhasználó által hozzárendelt identitások készletét is. A "Nincs" típus eltávolítja az összes identitást a szolgáltatásból. | "Nincs" "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" (kötelező) |
| felhasználóhozzárendeltAzonosítók | Az erőforráshoz társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai a következő formában jelennek meg: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | UserAssignedManagedIdentities |
IP-szabály
| Név | Leírás | Érték |
|---|---|---|
| érték | Engedélyezhető egyetlen IPv4-címnek (pl. 123.1.2.3) vagy CIDR formátumú IP-címtartománynak (pl. 123.1.2.3/24) megfelelő érték. | karakterlánc |
Hálózati szabálykészlet
| Név | Leírás | Érték |
|---|---|---|
| Kitérő | A bejövő forgalom lehetséges eredetei, amelyek megkerülhetik az "ipRules" szakaszban meghatározott szabályokat. | "AzurePortal" "AzureServices" "Nincs" |
| ipRules | Azon IP-korlátozási szabályok listája, amelyek meghatározzák a bejövő hálózat(ok)t, és lehetővé teszik a keresési szolgáltatásvégponthoz való hozzáférést. Addig is a tűzfal blokkolja az összes többi nyilvános IP-hálózatot. Ezeket a korlátozási szabályokat csak akkor alkalmazza a rendszer, ha a keresési szolgáltatás "publicNetworkAccess" tulajdonsága engedélyezve van; ellenkező esetben a nyilvános interfészen keresztüli forgalom még nyilvános IP-szabályokkal sem engedélyezett, és a privát végpontkapcsolatok lennének a kizárólagos hozzáférési módszer. | IP-szabály[] |
SearchServiceProperties
| Név | Leírás | Érték |
|---|---|---|
| authOptions | Meghatározza, hogy a keresési szolgáltatás adatsík API-ja hogyan hitelesíti a kéréseket. Ez nem állítható be, ha a "disableLocalAuth" értéke igaz. | DataPlaneAuthOptions |
| disabledDataExfiltrationOptions | A keresési szolgáltatásra kifejezetten nem engedélyezett adatkiszivárgási forgatókönyvek listája. Jelenleg az egyetlen támogatott érték az "Összes" az összes lehetséges adatexportálási forgatókönyv letiltásához a jövőben tervezett részletesebb vezérlőkkel. | Sztringtömb, amely a következők bármelyikét tartalmazza: "Minden" |
| disableLocalAuth | Ha igaz értékre van állítva, a keresési szolgáltatás hívásai nem használhatják az API-kulcsokat a hitelesítéshez. Ez nem állítható be igaz értékre, ha a "dataPlaneAuthOptions" definiálva van. | Bool |
| titkosításCmk-val | Megadja az erőforrások (például indexek) ügyfélmenedzser-kulcsokkal történő titkosítására vonatkozó szabályzatokat a keresési szolgáltatáson belül. | Titkosítás cmk-val |
| tárhely mód | Csak a standard3 termékváltozatra alkalmazható. Ezt a tulajdonságot úgy állíthatja be, hogy legfeljebb 3 nagy sűrűségű partíciót engedélyezzen, amelyek legfeljebb 1000 indexet tesznek lehetővé, ami sokkal magasabb, mint bármely más termékváltozat esetében engedélyezett maximális indexek száma. A standard3 termékváltozat esetében az érték "alapértelmezett" vagy "highDensity". Az összes többi termékváltozat esetében ennek az értéknek "alapértelmezettnek" kell lennie. | 'alapértelmezett' "highDensity" |
| networkRuleSet | Az Azure AI Keresés szolgáltatás elérésének módját meghatározó hálózatspecifikus szabályok. | Hálózati szabálykészlet |
| partíciók száma | A keresési szolgáltatás partícióinak száma; ha meg van adva, az 1, 2, 3, 4, 6 vagy 12 lehet. Az 1-nél nagyobb értékek csak a standard termékváltozatokra érvényesek. A "standard3" szolgáltatások esetében a hostingMode értéke "highDensity", az engedélyezett értékek 1 és 3 között vannak. | Int Korlátok: Minimális érték = 1 Maximális érték = 12 |
| nyilvános hálózati hozzáférés | Ez az érték "engedélyezve" értékre állítható a meglévő ügyfélerőforrások és sablonok kompatibilitástörő változásainak elkerülése érdekében. Ha a "letiltva" értékre van állítva, a nyilvános interfészen keresztüli forgalom nem engedélyezett, és a privát végpontkapcsolatok kizárólagos hozzáférési módszerként használhatók. | "letiltva" "engedélyezve" |
| replikák száma | A keresési szolgáltatás replikáinak száma. Ha meg van adva, akkor 1 és 12 közötti értéknek kell lennie a standard termékváltozatok esetében, vagy az alapszintű termékváltozat esetében 1 és 3 közötti értéknek kell lennie. | Int Korlátok: Minimális érték = 1 Maximális érték = 12 |
| szemanticSearch | Beállítja a szemantikai keresés elérhetőségét szabályozó beállításokat. Ez a konfiguráció csak bizonyos Azure AI Keresés-termékváltozatok esetében lehetséges bizonyos helyeken. | "letiltva" "ingyenes" "standard" |
termékazonosító (SKU)
| Név | Leírás | Érték |
|---|---|---|
| név | A keresési szolgáltatás termékváltozata. Az érvényes értékek a következők: "ingyenes": Megosztott szolgáltatás. "alapszintű": Dedikált szolgáltatás legfeljebb 3 replikával. "standard": Dedikált szolgáltatás legfeljebb 12 partícióval és 12 replikával. 'standard2': Hasonló a standardhoz, de keresési egységenként több kapacitással. "standard3": A legnagyobb standard ajánlat legfeljebb 12 partícióval és 12 replikával (vagy akár 3 partícióval, több indexkel, ha a hostingMode tulajdonságot is "highDensity" értékre állítja). "storage_optimized_l1": Partíciónként 1 TB-ot támogat, legfeljebb 12 partíciót. "storage_optimized_l2": Partíciónként 2 TB-ot támogat, legfeljebb 12 partíciót." | "alapszintű" "ingyenes" "standard" "standard2" "standard3" "storage_optimized_l1" "storage_optimized_l2" |
TrackedResourceTags
| Név | Leírás | Érték |
|---|
UserAssignedManagedIdentities
| Név | Leírás | Érték |
|---|
UserAssignedManagedIdentity
| Név | Leírás | Érték |
|---|
ARM-sablon erőforrásdefiníciója
A searchServices erőforrástípus üzembe helyezhető olyan műveletekkel, amelyek a következő célokat célják:
- Erőforráscsoportok – Lásd az erőforráscsoport telepítési parancsokat Az API verziók megváltoztatott tulajdonságainak listájáért lásd a változásnaplót.
Használati példák
Azure gyorsútmutató-sablonok
Az alábbi Azure rövid útmutatósablonok üzembe helyezni ezt az erőforrástípust.
| Sablon | Leírás |
|---|---|
|
Az Azure AI Foundry hálózata korlátozott |
Ez a sablonkészlet bemutatja, hogyan állíthatja be az Azure AI Foundryt letiltott privát kapcsolattal és kimenő forgalommal, a Microsoft által felügyelt kulcsok használatával a titkosításhoz és a Microsoft által felügyelt identitáskonfigurációhoz az AI-erőforráshoz. |
|
Azure Cognitive Search szolgáltatás |
Ez a sablon létrehoz egy Azure Cognitive Search-szolgáltatást |
|
Azure Cognitive Search szolgáltatás privát végponttal |
Ez a sablon létrehoz egy Azure Cognitive Search-szolgáltatást egy privát végponttal. |
|
hálózat által védett ügynök felhasználói felügyelt identitással |
Ez a sablonkészlet bemutatja, hogyan állíthatja be az Azure AI Agent Service-t virtuális hálózatelkülönítéssel az AI-szolgáltatás/AOAI-kapcsolat és a magánhálózati kapcsolatok felhasználói felügyelt identitásának hitelesítésével az ügynök biztonságos adatokhoz való csatlakoztatásához. |
|
standard ügynök beállítási |
Ez a sablonkészlet bemutatja, hogyan állíthatja be az Azure AI Agent Service-t a standard beállítással, azaz a projekt-/központkapcsolatok felügyelt identitáshitelesítésével és a nyilvános internetkapcsolat engedélyezésével. Az ügynökök az ügyfél tulajdonában lévő, egybérlős keresési és tárolási erőforrásokat használják. Ezzel a beállítással teljes mértékben szabályozhatja és áttekintheti ezeket az erőforrásokat, de a használat alapján költségekkel kell számolnia. |
|
webalkalmazás SQL Database, Azure Cosmos DB, Azure Search |
Ez a sablon kiépít egy webalkalmazást, egy SQL Database-t, az Azure Cosmos DB-t, az Azure Search-t és az Application Insightst. |
Erőforrás formátuma
Microsoft.Search/searchServices-erőforrás létrehozásához adja hozzá a következő JSON-t a sablonhoz.
{
"type": "Microsoft.Search/searchServices",
"apiVersion": "2024-06-01-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"authOptions": {
"aadOrApiKey": {
"aadAuthFailureMode": "string"
},
"apiKeyOnly": {}
},
"disabledDataExfiltrationOptions": [ "string" ],
"disableLocalAuth": "bool",
"encryptionWithCmk": {
"enforcement": "string"
},
"hostingMode": "string",
"networkRuleSet": {
"bypass": "string",
"ipRules": [
{
"value": "string"
}
]
},
"partitionCount": "int",
"publicNetworkAccess": "string",
"replicaCount": "int",
"semanticSearch": "string"
},
"sku": {
"name": "string"
},
"tags": {
"{customized property}": "string"
}
}
Tulajdonságértékek
Microsoft.Keresés/keresésiSzolgáltatások
| Név | Leírás | Érték |
|---|---|---|
| apiVersion | Az API verziója | '2024-06-01-preview" |
| identitás | Az erőforrás identitása. | Identitás |
| hely | Az a földrajzi hely, ahol az erőforrás él | sztring (kötelező) |
| név | Az erőforrás neve | sztring (kötelező) |
| kellékek | A keresési szolgáltatás tulajdonságai. | SearchServiceProperties |
| Sku | A keresési szolgáltatás termékváltozata, amely meghatározza az árszintet és a kapacitáskorlátokat. Ez a tulajdonság új keresési szolgáltatás létrehozásakor szükséges. | termékváltozat |
| Címkék | Erőforráscímkék | Címkenevek és -értékek szótára. sablonok címkéinek megtekintése |
| típus | Az erőforrás típusa | "Microsoft.Search/searchServices" |
DataPlaneAadOrApiKeyAuthOption
| Név | Leírás | Érték |
|---|---|---|
| aadAuthFailureMode | Azt ismerteti, hogy a keresési szolgáltatás adatsík API-ja milyen választ küld a sikertelen hitelesítést igénylő kérelmekre. | 'http401WithBearerChallenge' "http403" |
DataPlaneAuthOptions
| Név | Leírás | Érték |
|---|---|---|
| aadOrApiKey | Azt jelzi, hogy az API-kulcs vagy a Microsoft Entra ID-bérlőből származó hozzáférési jogkivonat használható a hitelesítéshez. | DataPlaneAadOrApiKeyAuthOption |
| apiKeyOnly | Azt jelzi, hogy csak az API-kulcs használható a hitelesítéshez. | bármely |
Titkosítás cmk-val
| Név | Leírás | Érték |
|---|---|---|
| kikényszerítés | Azt ismerteti, hogy a keresési szolgáltatásnak hogyan kell kikényszerítenie a megfelelőséget, ha olyan objektumokat talál, amelyek nincsenek titkosítva az ügyfél által felügyelt kulccsal. | "Letiltva" "Engedélyezve" "Meghatározatlan" |
Azonosság
| Név | Leírás | Érték |
|---|---|---|
| típus | Az erőforráshoz használt identitás típusa. A "SystemAssigned, UserAssigned" típus magában foglalja a rendszer által létrehozott identitást és a felhasználó által hozzárendelt identitások készletét is. A "Nincs" típus eltávolítja az összes identitást a szolgáltatásból. | "Nincs" "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" (kötelező) |
| felhasználóhozzárendeltAzonosítók | Az erőforráshoz társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai a következő formában jelennek meg: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | UserAssignedManagedIdentities |
IP-szabály
| Név | Leírás | Érték |
|---|---|---|
| érték | Engedélyezhető egyetlen IPv4-címnek (pl. 123.1.2.3) vagy CIDR formátumú IP-címtartománynak (pl. 123.1.2.3/24) megfelelő érték. | karakterlánc |
Hálózati szabálykészlet
| Név | Leírás | Érték |
|---|---|---|
| Kitérő | A bejövő forgalom lehetséges eredetei, amelyek megkerülhetik az "ipRules" szakaszban meghatározott szabályokat. | "AzurePortal" "AzureServices" "Nincs" |
| ipRules | Azon IP-korlátozási szabályok listája, amelyek meghatározzák a bejövő hálózat(ok)t, és lehetővé teszik a keresési szolgáltatásvégponthoz való hozzáférést. Addig is a tűzfal blokkolja az összes többi nyilvános IP-hálózatot. Ezeket a korlátozási szabályokat csak akkor alkalmazza a rendszer, ha a keresési szolgáltatás "publicNetworkAccess" tulajdonsága engedélyezve van; ellenkező esetben a nyilvános interfészen keresztüli forgalom még nyilvános IP-szabályokkal sem engedélyezett, és a privát végpontkapcsolatok lennének a kizárólagos hozzáférési módszer. | IP-szabály[] |
SearchServiceProperties
| Név | Leírás | Érték |
|---|---|---|
| authOptions | Meghatározza, hogy a keresési szolgáltatás adatsík API-ja hogyan hitelesíti a kéréseket. Ez nem állítható be, ha a "disableLocalAuth" értéke igaz. | DataPlaneAuthOptions |
| disabledDataExfiltrationOptions | A keresési szolgáltatásra kifejezetten nem engedélyezett adatkiszivárgási forgatókönyvek listája. Jelenleg az egyetlen támogatott érték az "Összes" az összes lehetséges adatexportálási forgatókönyv letiltásához a jövőben tervezett részletesebb vezérlőkkel. | Sztringtömb, amely a következők bármelyikét tartalmazza: "Minden" |
| disableLocalAuth | Ha igaz értékre van állítva, a keresési szolgáltatás hívásai nem használhatják az API-kulcsokat a hitelesítéshez. Ez nem állítható be igaz értékre, ha a "dataPlaneAuthOptions" definiálva van. | Bool |
| titkosításCmk-val | Megadja az erőforrások (például indexek) ügyfélmenedzser-kulcsokkal történő titkosítására vonatkozó szabályzatokat a keresési szolgáltatáson belül. | Titkosítás cmk-val |
| tárhely mód | Csak a standard3 termékváltozatra alkalmazható. Ezt a tulajdonságot úgy állíthatja be, hogy legfeljebb 3 nagy sűrűségű partíciót engedélyezzen, amelyek legfeljebb 1000 indexet tesznek lehetővé, ami sokkal magasabb, mint bármely más termékváltozat esetében engedélyezett maximális indexek száma. A standard3 termékváltozat esetében az érték "alapértelmezett" vagy "highDensity". Az összes többi termékváltozat esetében ennek az értéknek "alapértelmezettnek" kell lennie. | 'alapértelmezett' "highDensity" |
| networkRuleSet | Az Azure AI Keresés szolgáltatás elérésének módját meghatározó hálózatspecifikus szabályok. | Hálózati szabálykészlet |
| partíciók száma | A keresési szolgáltatás partícióinak száma; ha meg van adva, az 1, 2, 3, 4, 6 vagy 12 lehet. Az 1-nél nagyobb értékek csak a standard termékváltozatokra érvényesek. A "standard3" szolgáltatások esetében a hostingMode értéke "highDensity", az engedélyezett értékek 1 és 3 között vannak. | Int Korlátok: Minimális érték = 1 Maximális érték = 12 |
| nyilvános hálózati hozzáférés | Ez az érték "engedélyezve" értékre állítható a meglévő ügyfélerőforrások és sablonok kompatibilitástörő változásainak elkerülése érdekében. Ha a "letiltva" értékre van állítva, a nyilvános interfészen keresztüli forgalom nem engedélyezett, és a privát végpontkapcsolatok kizárólagos hozzáférési módszerként használhatók. | "letiltva" "engedélyezve" |
| replikák száma | A keresési szolgáltatás replikáinak száma. Ha meg van adva, akkor 1 és 12 közötti értéknek kell lennie a standard termékváltozatok esetében, vagy az alapszintű termékváltozat esetében 1 és 3 közötti értéknek kell lennie. | Int Korlátok: Minimális érték = 1 Maximális érték = 12 |
| szemanticSearch | Beállítja a szemantikai keresés elérhetőségét szabályozó beállításokat. Ez a konfiguráció csak bizonyos Azure AI Keresés-termékváltozatok esetében lehetséges bizonyos helyeken. | "letiltva" "ingyenes" "standard" |
termékazonosító (SKU)
| Név | Leírás | Érték |
|---|---|---|
| név | A keresési szolgáltatás termékváltozata. Az érvényes értékek a következők: "ingyenes": Megosztott szolgáltatás. "alapszintű": Dedikált szolgáltatás legfeljebb 3 replikával. "standard": Dedikált szolgáltatás legfeljebb 12 partícióval és 12 replikával. 'standard2': Hasonló a standardhoz, de keresési egységenként több kapacitással. "standard3": A legnagyobb standard ajánlat legfeljebb 12 partícióval és 12 replikával (vagy akár 3 partícióval, több indexkel, ha a hostingMode tulajdonságot is "highDensity" értékre állítja). "storage_optimized_l1": Partíciónként 1 TB-ot támogat, legfeljebb 12 partíciót. "storage_optimized_l2": Partíciónként 2 TB-ot támogat, legfeljebb 12 partíciót." | "alapszintű" "ingyenes" "standard" "standard2" "standard3" "storage_optimized_l1" "storage_optimized_l2" |
TrackedResourceTags
| Név | Leírás | Érték |
|---|
UserAssignedManagedIdentities
| Név | Leírás | Érték |
|---|
UserAssignedManagedIdentity
| Név | Leírás | Érték |
|---|
Terraform (AzAPI-szolgáltató) erőforrásdefiníciója
A searchServices erőforrástípus üzembe helyezhető olyan műveletekkel, amelyek a következő célokat célják:
- Erőforráscsoportok Az API verziók megváltoztatott tulajdonságainak listájáért lásd: Változásnapló.
Használati példák
Terraform minták
Alapvető példa a Search Service üzembe helyezésére.
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 = ["*"]
}
Azure-ból ellenőrzött modulok
Az alábbi Azure Verified Modules használható az erőforrástípus üzembe helyezéséhez.
| Modul | Leírás |
|---|---|
| Keresési szolgáltatás | Keresési szolgáltatás AVM-erőforrásmodulja |
Erőforrás formátuma
Microsoft.Search/searchServices-erőforrás létrehozásához adja hozzá a következő Terraformot a sablonhoz.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Search/searchServices@2024-06-01-preview"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
authOptions = {
aadOrApiKey = {
aadAuthFailureMode = "string"
}
apiKeyOnly = ?
}
disabledDataExfiltrationOptions = [
"string"
]
disableLocalAuth = bool
encryptionWithCmk = {
enforcement = "string"
}
hostingMode = "string"
networkRuleSet = {
bypass = "string"
ipRules = [
{
value = "string"
}
]
}
partitionCount = int
publicNetworkAccess = "string"
replicaCount = int
semanticSearch = "string"
}
sku = {
name = "string"
}
}
}
Tulajdonságértékek
Microsoft.Keresés/keresésiSzolgáltatások
| Név | Leírás | Érték |
|---|---|---|
| identitás | Az erőforrás identitása. | Identitás |
| hely | Az a földrajzi hely, ahol az erőforrás él | sztring (kötelező) |
| név | Az erőforrás neve | sztring (kötelező) |
| kellékek | A keresési szolgáltatás tulajdonságai. | SearchServiceProperties |
| Sku | A keresési szolgáltatás termékváltozata, amely meghatározza az árszintet és a kapacitáskorlátokat. Ez a tulajdonság új keresési szolgáltatás létrehozásakor szükséges. | termékváltozat |
| Címkék | Erőforráscímkék | Címkenevek és -értékek szótára. |
| típus | Az erőforrás típusa | "Microsoft.Search/searchServices@2024-06-01-preview" |
DataPlaneAadOrApiKeyAuthOption
| Név | Leírás | Érték |
|---|---|---|
| aadAuthFailureMode | Azt ismerteti, hogy a keresési szolgáltatás adatsík API-ja milyen választ küld a sikertelen hitelesítést igénylő kérelmekre. | 'http401WithBearerChallenge' "http403" |
DataPlaneAuthOptions
| Név | Leírás | Érték |
|---|---|---|
| aadOrApiKey | Azt jelzi, hogy az API-kulcs vagy a Microsoft Entra ID-bérlőből származó hozzáférési jogkivonat használható a hitelesítéshez. | DataPlaneAadOrApiKeyAuthOption |
| apiKeyOnly | Azt jelzi, hogy csak az API-kulcs használható a hitelesítéshez. | bármely |
Titkosítás cmk-val
| Név | Leírás | Érték |
|---|---|---|
| kikényszerítés | Azt ismerteti, hogy a keresési szolgáltatásnak hogyan kell kikényszerítenie a megfelelőséget, ha olyan objektumokat talál, amelyek nincsenek titkosítva az ügyfél által felügyelt kulccsal. | "Letiltva" "Engedélyezve" "Meghatározatlan" |
Azonosság
| Név | Leírás | Érték |
|---|---|---|
| típus | Az erőforráshoz használt identitás típusa. A "SystemAssigned, UserAssigned" típus magában foglalja a rendszer által létrehozott identitást és a felhasználó által hozzárendelt identitások készletét is. A "Nincs" típus eltávolítja az összes identitást a szolgáltatásból. | "Nincs" "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" (kötelező) |
| felhasználóhozzárendeltAzonosítók | Az erőforráshoz társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai a következő formában jelennek meg: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | UserAssignedManagedIdentities |
IP-szabály
| Név | Leírás | Érték |
|---|---|---|
| érték | Engedélyezhető egyetlen IPv4-címnek (pl. 123.1.2.3) vagy CIDR formátumú IP-címtartománynak (pl. 123.1.2.3/24) megfelelő érték. | karakterlánc |
Hálózati szabálykészlet
| Név | Leírás | Érték |
|---|---|---|
| Kitérő | A bejövő forgalom lehetséges eredetei, amelyek megkerülhetik az "ipRules" szakaszban meghatározott szabályokat. | "AzurePortal" "AzureServices" "Nincs" |
| ipRules | Azon IP-korlátozási szabályok listája, amelyek meghatározzák a bejövő hálózat(ok)t, és lehetővé teszik a keresési szolgáltatásvégponthoz való hozzáférést. Addig is a tűzfal blokkolja az összes többi nyilvános IP-hálózatot. Ezeket a korlátozási szabályokat csak akkor alkalmazza a rendszer, ha a keresési szolgáltatás "publicNetworkAccess" tulajdonsága engedélyezve van; ellenkező esetben a nyilvános interfészen keresztüli forgalom még nyilvános IP-szabályokkal sem engedélyezett, és a privát végpontkapcsolatok lennének a kizárólagos hozzáférési módszer. | IP-szabály[] |
SearchServiceProperties
| Név | Leírás | Érték |
|---|---|---|
| authOptions | Meghatározza, hogy a keresési szolgáltatás adatsík API-ja hogyan hitelesíti a kéréseket. Ez nem állítható be, ha a "disableLocalAuth" értéke igaz. | DataPlaneAuthOptions |
| disabledDataExfiltrationOptions | A keresési szolgáltatásra kifejezetten nem engedélyezett adatkiszivárgási forgatókönyvek listája. Jelenleg az egyetlen támogatott érték az "Összes" az összes lehetséges adatexportálási forgatókönyv letiltásához a jövőben tervezett részletesebb vezérlőkkel. | Sztringtömb, amely a következők bármelyikét tartalmazza: "Minden" |
| disableLocalAuth | Ha igaz értékre van állítva, a keresési szolgáltatás hívásai nem használhatják az API-kulcsokat a hitelesítéshez. Ez nem állítható be igaz értékre, ha a "dataPlaneAuthOptions" definiálva van. | Bool |
| titkosításCmk-val | Megadja az erőforrások (például indexek) ügyfélmenedzser-kulcsokkal történő titkosítására vonatkozó szabályzatokat a keresési szolgáltatáson belül. | Titkosítás cmk-val |
| tárhely mód | Csak a standard3 termékváltozatra alkalmazható. Ezt a tulajdonságot úgy állíthatja be, hogy legfeljebb 3 nagy sűrűségű partíciót engedélyezzen, amelyek legfeljebb 1000 indexet tesznek lehetővé, ami sokkal magasabb, mint bármely más termékváltozat esetében engedélyezett maximális indexek száma. A standard3 termékváltozat esetében az érték "alapértelmezett" vagy "highDensity". Az összes többi termékváltozat esetében ennek az értéknek "alapértelmezettnek" kell lennie. | 'alapértelmezett' "highDensity" |
| networkRuleSet | Az Azure AI Keresés szolgáltatás elérésének módját meghatározó hálózatspecifikus szabályok. | Hálózati szabálykészlet |
| partíciók száma | A keresési szolgáltatás partícióinak száma; ha meg van adva, az 1, 2, 3, 4, 6 vagy 12 lehet. Az 1-nél nagyobb értékek csak a standard termékváltozatokra érvényesek. A "standard3" szolgáltatások esetében a hostingMode értéke "highDensity", az engedélyezett értékek 1 és 3 között vannak. | Int Korlátok: Minimális érték = 1 Maximális érték = 12 |
| nyilvános hálózati hozzáférés | Ez az érték "engedélyezve" értékre állítható a meglévő ügyfélerőforrások és sablonok kompatibilitástörő változásainak elkerülése érdekében. Ha a "letiltva" értékre van állítva, a nyilvános interfészen keresztüli forgalom nem engedélyezett, és a privát végpontkapcsolatok kizárólagos hozzáférési módszerként használhatók. | "letiltva" "engedélyezve" |
| replikák száma | A keresési szolgáltatás replikáinak száma. Ha meg van adva, akkor 1 és 12 közötti értéknek kell lennie a standard termékváltozatok esetében, vagy az alapszintű termékváltozat esetében 1 és 3 közötti értéknek kell lennie. | Int Korlátok: Minimális érték = 1 Maximális érték = 12 |
| szemanticSearch | Beállítja a szemantikai keresés elérhetőségét szabályozó beállításokat. Ez a konfiguráció csak bizonyos Azure AI Keresés-termékváltozatok esetében lehetséges bizonyos helyeken. | "letiltva" "ingyenes" "standard" |
termékazonosító (SKU)
| Név | Leírás | Érték |
|---|---|---|
| név | A keresési szolgáltatás termékváltozata. Az érvényes értékek a következők: "ingyenes": Megosztott szolgáltatás. "alapszintű": Dedikált szolgáltatás legfeljebb 3 replikával. "standard": Dedikált szolgáltatás legfeljebb 12 partícióval és 12 replikával. 'standard2': Hasonló a standardhoz, de keresési egységenként több kapacitással. "standard3": A legnagyobb standard ajánlat legfeljebb 12 partícióval és 12 replikával (vagy akár 3 partícióval, több indexkel, ha a hostingMode tulajdonságot is "highDensity" értékre állítja). "storage_optimized_l1": Partíciónként 1 TB-ot támogat, legfeljebb 12 partíciót. "storage_optimized_l2": Partíciónként 2 TB-ot támogat, legfeljebb 12 partíciót." | "alapszintű" "ingyenes" "standard" "standard2" "standard3" "storage_optimized_l1" "storage_optimized_l2" |
TrackedResourceTags
| Név | Leírás | Érték |
|---|
UserAssignedManagedIdentities
| Név | Leírás | Érték |
|---|
UserAssignedManagedIdentity
| Név | Leírás | Érték |
|---|