Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
- Terbaru
- Pratinjau 2026-09-01
- Pratinjau 2026-03-01
- 2025-05-01
- pratinjau 2025-02-01
- pratinjau 2024-06-01
- pratinjau 2024-03-01
- 2023-11-01
- 2022-09-01
- pratinjau 2021-04-01
- 2020-08-01
- pratinjau 2020-08-01
- 2020-03-13
- pratinjau 2019-10-01
- 2015-08-19
- 2015-02-28
Definisi sumber daya Bicep
Jenis sumber daya searchServices dapat disebarkan dengan operasi yang menargetkan:
- Grup sumber daya
- Lihat perintah penyebaran grup sumber daya
Untuk daftar properti yang diubah di setiap versi API, lihat mengubah log.
Contoh Penggunaan
Sampel Bicep
Contoh dasar penerapan Search Service.
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'
}
}
Modul Terverifikasi Azure
Modul Terverifikasi Azure berikut dapat digunakan untuk menyebarkan jenis sumber daya ini.
| Modul | Deskripsi |
|---|---|
| Layanan Pencarian | Modul Sumber Daya AVM untuk Layanan Pencarian |
Sampel Mulai Cepat Azure
Templat Mulai Cepat Azure berikut ini berisi sampel Bicep untuk menyebarkan jenis sumber daya ini.
| File Bisep | Deskripsi |
|---|---|
| Jaringan Azure AI Foundry Dibatasi | Kumpulan templat ini menunjukkan cara menyiapkan Azure AI Foundry dengan tautan privat dan keluar dinonaktifkan, menggunakan kunci yang dikelola Microsoft untuk enkripsi dan konfigurasi identitas yang dikelola Microsoft untuk sumber daya AI. |
| layanan Azure Cognitive Search | Templat ini membuat layanan Azure Cognitive Search |
| Network Secured Agent dengan Identitas Terkelola Pengguna | Kumpulan templat ini menunjukkan cara menyiapkan Azure AI Agent Service dengan isolasi jaringan virtual menggunakan autentikasi Identitas Terkelola Pengguna untuk koneksi AI Service/AOAI dan tautan jaringan privat untuk menghubungkan agen ke data aman Anda. |
| Penyiapan Agen Standar | Kumpulan templat ini menunjukkan cara menyiapkan Azure AI Agent Service dengan penyiapan standar, yang berarti dengan autentikasi identitas terkelola untuk koneksi proyek/hub dan akses internet publik diaktifkan. Agen menggunakan sumber daya pencarian dan penyimpanan penyewa tunggal milik pelanggan. Dengan penyiapan ini, Anda memiliki kontrol dan visibilitas penuh atas sumber daya ini, tetapi Anda akan dikenakan biaya berdasarkan penggunaan Anda. |
Format sumber daya
Untuk membuat sumber daya Microsoft.Search/searchServices, tambahkan Bicep berikut ke templat Anda.
resource symbolicname 'Microsoft.Search/searchServices@2025-02-01-preview' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
authOptions: {
aadOrApiKey: {
aadAuthFailureMode: 'string'
}
apiKeyOnly: any(...)
}
computeType: 'string'
disabledDataExfiltrationOptions: [
'string'
]
disableLocalAuth: bool
encryptionWithCmk: {
enforcement: 'string'
}
endpoint: 'string'
hostingMode: 'string'
networkRuleSet: {
bypass: 'string'
ipRules: [
{
value: 'string'
}
]
}
partitionCount: int
publicNetworkAccess: 'string'
replicaCount: int
semanticSearch: 'string'
}
sku: {
name: 'string'
}
tags: {
{customized property}: 'string'
}
}
Nilai Properti
Microsoft.Search/searchServices
| Nama | Deskripsi | Nilai |
|---|---|---|
| identitas | Identitas sumber daya. | Identitas |
| lokasi | Lokasi geografis tempat sumber daya berada | string (diperlukan) |
| Nama | Nama sumber daya | string (diperlukan) |
| Properti | Properti layanan pencarian. | SearchServiceProperties |
| Sku | SKU layanan pencarian, yang menentukan tingkat harga dan batas kapasitas. Properti ini diperlukan saat membuat layanan pencarian baru. | Sku |
| Tags | Tag sumber daya | Kamus nama dan nilai tag. Lihat Tag dalam templat |
DataPlaneAadOrApiKeyAuthOption
| Nama | Deskripsi | Nilai |
|---|---|---|
| aadAuthFailureMode | Menjelaskan respons apa yang akan dikirim api sarana data dari layanan pencarian untuk permintaan yang gagal autentikasi. | 'http401WithBearerChallenge' 'http403' |
DataPlaneAuthOptions
| Nama | Deskripsi | Nilai |
|---|---|---|
| aadOrApiKey | Menunjukkan bahwa kunci API atau token akses dari penyewa ID Microsoft Entra dapat digunakan untuk autentikasi. | DataPlaneAadOrApiKeyAuthOption |
| apiKeyOnly | Menunjukkan bahwa hanya kunci API yang dapat digunakan untuk autentikasi. | apa pun |
EnkripsiDenganCmk
| Nama | Deskripsi | Nilai |
|---|---|---|
| Penegakan | Menjelaskan bagaimana layanan pencarian harus memberlakukan kepatuhan jika menemukan objek yang tidak dienkripsi dengan kunci yang dikelola pelanggan. | 'Dinonaktifkan' 'Diaktifkan' 'Tidak ditentukan' |
Identitas
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis identitas yang digunakan untuk sumber daya. Jenis 'SystemAssigned, UserAssigned' mencakup identitas yang dibuat oleh sistem dan sekumpulan identitas yang ditetapkan pengguna. Jenis 'None' akan menghapus semua identitas dari layanan. | 'Tidak Ada' 'SistemDitetapkan' 'SystemAssigned, UserAssigned' 'UserAssigned' (diperlukan) |
| identitasYangDitetapkanPengguna | Daftar identitas pengguna yang terkait dengan sumber daya. Referensi kunci kamus identitas pengguna akan berupa ID sumber daya ARM dalam formulir: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | userAssignedManagedIdentities |
Aturan Ip
| Nama | Deskripsi | Nilai |
|---|---|---|
| nilai | Nilai yang sesuai dengan satu alamat IPv4 (misalnya, 123.1.2.3) atau rentang IP dalam format CIDR (misalnya, 123.1.2.3/24) untuk diizinkan. | string |
Rangkaian Aturan
SearchServiceProperties
| Nama | Deskripsi | Nilai |
|---|---|---|
| autentiOpsi | Menentukan opsi tentang cara API sarana data layanan pencarian mengautentikasi permintaan. Ini tidak dapat diatur jika 'disableLocalAuth' diatur ke true. | DataPlaneAuthOptions |
| computeType | Konfigurasikan properti ini untuk mendukung layanan pencarian menggunakan komputasi default atau Azure Confidential Compute. | 'Rahasia' 'default' |
| dinonaktifkanDataEksfiltrasiOpsi | Daftar skenario penyelundupan data yang secara eksplisit tidak diizinkan untuk layanan pencarian. Saat ini, satu-satunya nilai yang didukung adalah 'Semua' untuk menonaktifkan semua kemungkinan skenario ekspor data dengan kontrol yang lebih halus yang direncanakan untuk masa depan. | Array string yang berisi salah satu dari: 'Semua' |
| nonaktifkanLocalAuth | Ketika diatur ke true, panggilan ke layanan pencarian tidak akan diizinkan untuk menggunakan kunci API untuk autentikasi. Ini tidak dapat diatur ke true jika 'dataPlaneAuthOptions' ditentukan. | bool |
| enkripsiDenganCmk | Menentukan kebijakan apa pun mengenai enkripsi sumber daya (seperti indeks) menggunakan kunci manajer pelanggan dalam layanan pencarian. | EnkripsiDenganCmk |
| titik akhir | Titik akhir layanan Pencarian Azure AI. | string |
| hostingMode | Hanya berlaku untuk SKU standar3. Anda dapat mengatur properti ini untuk mengaktifkan hingga 3 partisi kepadatan tinggi yang memungkinkan hingga 1000 indeks, yang jauh lebih tinggi dari indeks maksimum yang diizinkan untuk SKU lainnya. Untuk SKU standar3, nilainya adalah 'default' atau 'highDensity'. Untuk semua SKU lainnya, nilai ini harus 'default'. | 'default' 'HighDensity' |
| networkRuleSet | Aturan khusus jaringan yang menentukan bagaimana layanan Pencarian Azure AI dapat dicapai. | NetworkRuleSet |
| jumlah partisi | Jumlah partisi dalam layanan pencarian; jika ditentukan, bisa 1, 2, 3, 4, 6, atau 12. Nilai yang lebih besar dari 1 hanya berlaku untuk SKU standar. Untuk layanan 'standard3' dengan hostingMode yang diatur ke 'highDensity', nilai yang diizinkan adalah antara 1 dan 3. | Int Kendala: Nilai min = 1 Nilai maks = 12 |
| publikAkses Jaringan | Nilai ini dapat diatur ke 'diaktifkan' untuk menghindari perubahan yang melanggar pada sumber daya dan templat pelanggan yang ada. Jika diatur ke 'dinonaktifkan', lalu lintas melalui antarmuka publik tidak diizinkan, dan koneksi titik akhir privat akan menjadi metode akses eksklusif. | 'dinonaktifkan' 'diaktifkan' |
| Jumlah replika | Jumlah replika dalam layanan pencarian. Jika ditentukan, nilainya harus antara 1 dan 12 inklusif untuk SKU standar atau antara 1 dan 3 inklusif untuk SKU dasar. | Int Kendala: Nilai min = 1 Nilai maks = 12 |
| semantikPencarian | Mengatur opsi yang mengontrol ketersediaan pencarian semantik. Konfigurasi ini hanya dimungkinkan untuk SKU Pencarian Azure AI tertentu di lokasi tertentu. | 'dinonaktifkan' 'gratis' 'standar' |
SKU (Kode Barang)
| Nama | Deskripsi | Nilai |
|---|---|---|
| Nama | SKU layanan pencarian. Nilai yang valid meliputi: 'gratis': Layanan bersama. 'basic': Layanan khusus dengan hingga 3 replika. 'standar': Layanan khusus dengan hingga 12 partisi dan 12 replika. 'standard2': Mirip dengan standar, tetapi dengan lebih banyak kapasitas per unit pencarian. 'standard3': Penawaran Standar terbesar dengan hingga 12 partisi dan 12 replika (atau hingga 3 partisi dengan lebih banyak indeks jika Anda juga mengatur properti hostingMode ke 'highDensity'). 'storage_optimized_l1': Mendukung 1 TB per partisi, hingga 12 partisi. 'storage_optimized_l2': Mendukung 2TB per partisi, hingga 12 partisi.' | 'dasar' 'gratis' 'standar' 'standar2' 'standar3' 'storage_optimized_l1' 'storage_optimized_l2' |
TrackedResourceTags
| Nama | Deskripsi | Nilai |
|---|
UserAssignedManagedIdentities
| Nama | Deskripsi | Nilai |
|---|
UserAssignedManagedIdentity
| Nama | Deskripsi | Nilai |
|---|
Definisi sumber daya templat ARM
Jenis sumber daya searchServices dapat disebarkan dengan operasi yang menargetkan:
- Grup sumber daya - Lihat perintah penyebaran grup sumber daya Untuk daftar properti yang diubah di setiap versi API, lihat log perubahan.
Contoh Penggunaan
Templat Quickstart Azure
Templat Mulai Cepat Azure berikut ini menyebarkan jenis sumber daya ini.
| Templat | Deskripsi |
|---|---|
|
Jaringan Azure AI Foundry Dibatasi |
Kumpulan templat ini menunjukkan cara menyiapkan Azure AI Foundry dengan tautan privat dan keluar dinonaktifkan, menggunakan kunci yang dikelola Microsoft untuk enkripsi dan konfigurasi identitas yang dikelola Microsoft untuk sumber daya AI. |
|
layanan Azure Cognitive Search |
Templat ini membuat layanan Azure Cognitive Search |
|
layanan Azure Cognitive Search dengan titik akhir privat |
Templat ini membuat layanan Azure Cognitive Search dengan titik akhir privat. |
|
Network Secured Agent dengan Identitas Terkelola Pengguna |
Kumpulan templat ini menunjukkan cara menyiapkan Azure AI Agent Service dengan isolasi jaringan virtual menggunakan autentikasi Identitas Terkelola Pengguna untuk koneksi AI Service/AOAI dan tautan jaringan privat untuk menghubungkan agen ke data aman Anda. |
|
Penyiapan Agen Standar |
Kumpulan templat ini menunjukkan cara menyiapkan Azure AI Agent Service dengan penyiapan standar, yang berarti dengan autentikasi identitas terkelola untuk koneksi proyek/hub dan akses internet publik diaktifkan. Agen menggunakan sumber daya pencarian dan penyimpanan penyewa tunggal milik pelanggan. Dengan penyiapan ini, Anda memiliki kontrol dan visibilitas penuh atas sumber daya ini, tetapi Anda akan dikenakan biaya berdasarkan penggunaan Anda. |
|
Web App dengan SQL Database, Azure Cosmos DB, Azure Search |
Templat ini menyediakan Aplikasi Web, SQL Database, Azure Cosmos DB, Azure Search, dan Application Insights. |
Format sumber daya
Untuk membuat sumber daya Microsoft.Search/searchServices, tambahkan JSON berikut ke templat Anda.
{
"type": "Microsoft.Search/searchServices",
"apiVersion": "2025-02-01-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"authOptions": {
"aadOrApiKey": {
"aadAuthFailureMode": "string"
},
"apiKeyOnly": {}
},
"computeType": "string",
"disabledDataExfiltrationOptions": [ "string" ],
"disableLocalAuth": "bool",
"encryptionWithCmk": {
"enforcement": "string"
},
"endpoint": "string",
"hostingMode": "string",
"networkRuleSet": {
"bypass": "string",
"ipRules": [
{
"value": "string"
}
]
},
"partitionCount": "int",
"publicNetworkAccess": "string",
"replicaCount": "int",
"semanticSearch": "string"
},
"sku": {
"name": "string"
},
"tags": {
"{customized property}": "string"
}
}
Nilai Properti
Microsoft.Search/searchServices
| Nama | Deskripsi | Nilai |
|---|---|---|
| apiVersi | Versi api | 'Pratinjau 2025-02-01' |
| identitas | Identitas sumber daya. | Identitas |
| lokasi | Lokasi geografis tempat sumber daya berada | string (diperlukan) |
| Nama | Nama sumber daya | string (diperlukan) |
| Properti | Properti layanan pencarian. | SearchServiceProperties |
| Sku | SKU layanan pencarian, yang menentukan tingkat harga dan batas kapasitas. Properti ini diperlukan saat membuat layanan pencarian baru. | Sku |
| Tags | Tag sumber daya | Kamus nama dan nilai tag. Lihat Tag dalam templat |
| jenis | Jenis sumber daya | 'Microsoft.Search/searchServices' |
DataPlaneAadOrApiKeyAuthOption
| Nama | Deskripsi | Nilai |
|---|---|---|
| aadAuthFailureMode | Menjelaskan respons apa yang akan dikirim api sarana data dari layanan pencarian untuk permintaan yang gagal autentikasi. | 'http401WithBearerChallenge' 'http403' |
DataPlaneAuthOptions
| Nama | Deskripsi | Nilai |
|---|---|---|
| aadOrApiKey | Menunjukkan bahwa kunci API atau token akses dari penyewa ID Microsoft Entra dapat digunakan untuk autentikasi. | DataPlaneAadOrApiKeyAuthOption |
| apiKeyOnly | Menunjukkan bahwa hanya kunci API yang dapat digunakan untuk autentikasi. | apa pun |
EnkripsiDenganCmk
| Nama | Deskripsi | Nilai |
|---|---|---|
| Penegakan | Menjelaskan bagaimana layanan pencarian harus memberlakukan kepatuhan jika menemukan objek yang tidak dienkripsi dengan kunci yang dikelola pelanggan. | 'Dinonaktifkan' 'Diaktifkan' 'Tidak ditentukan' |
Identitas
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis identitas yang digunakan untuk sumber daya. Jenis 'SystemAssigned, UserAssigned' mencakup identitas yang dibuat oleh sistem dan sekumpulan identitas yang ditetapkan pengguna. Jenis 'None' akan menghapus semua identitas dari layanan. | 'Tidak Ada' 'SistemDitetapkan' 'SystemAssigned, UserAssigned' 'UserAssigned' (diperlukan) |
| identitasYangDitetapkanPengguna | Daftar identitas pengguna yang terkait dengan sumber daya. Referensi kunci kamus identitas pengguna akan berupa ID sumber daya ARM dalam formulir: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | userAssignedManagedIdentities |
Aturan Ip
| Nama | Deskripsi | Nilai |
|---|---|---|
| nilai | Nilai yang sesuai dengan satu alamat IPv4 (misalnya, 123.1.2.3) atau rentang IP dalam format CIDR (misalnya, 123.1.2.3/24) untuk diizinkan. | string |
Rangkaian Aturan
SearchServiceProperties
| Nama | Deskripsi | Nilai |
|---|---|---|
| autentiOpsi | Menentukan opsi tentang cara API sarana data layanan pencarian mengautentikasi permintaan. Ini tidak dapat diatur jika 'disableLocalAuth' diatur ke true. | DataPlaneAuthOptions |
| computeType | Konfigurasikan properti ini untuk mendukung layanan pencarian menggunakan komputasi default atau Azure Confidential Compute. | 'Rahasia' 'default' |
| dinonaktifkanDataEksfiltrasiOpsi | Daftar skenario penyelundupan data yang secara eksplisit tidak diizinkan untuk layanan pencarian. Saat ini, satu-satunya nilai yang didukung adalah 'Semua' untuk menonaktifkan semua kemungkinan skenario ekspor data dengan kontrol yang lebih halus yang direncanakan untuk masa depan. | Array string yang berisi salah satu dari: 'Semua' |
| nonaktifkanLocalAuth | Ketika diatur ke true, panggilan ke layanan pencarian tidak akan diizinkan untuk menggunakan kunci API untuk autentikasi. Ini tidak dapat diatur ke true jika 'dataPlaneAuthOptions' ditentukan. | bool |
| enkripsiDenganCmk | Menentukan kebijakan apa pun mengenai enkripsi sumber daya (seperti indeks) menggunakan kunci manajer pelanggan dalam layanan pencarian. | EnkripsiDenganCmk |
| titik akhir | Titik akhir layanan Pencarian Azure AI. | string |
| hostingMode | Hanya berlaku untuk SKU standar3. Anda dapat mengatur properti ini untuk mengaktifkan hingga 3 partisi kepadatan tinggi yang memungkinkan hingga 1000 indeks, yang jauh lebih tinggi dari indeks maksimum yang diizinkan untuk SKU lainnya. Untuk SKU standar3, nilainya adalah 'default' atau 'highDensity'. Untuk semua SKU lainnya, nilai ini harus 'default'. | 'default' 'HighDensity' |
| networkRuleSet | Aturan khusus jaringan yang menentukan bagaimana layanan Pencarian Azure AI dapat dicapai. | NetworkRuleSet |
| jumlah partisi | Jumlah partisi dalam layanan pencarian; jika ditentukan, bisa 1, 2, 3, 4, 6, atau 12. Nilai yang lebih besar dari 1 hanya berlaku untuk SKU standar. Untuk layanan 'standard3' dengan hostingMode yang diatur ke 'highDensity', nilai yang diizinkan adalah antara 1 dan 3. | Int Kendala: Nilai min = 1 Nilai maks = 12 |
| publikAkses Jaringan | Nilai ini dapat diatur ke 'diaktifkan' untuk menghindari perubahan yang melanggar pada sumber daya dan templat pelanggan yang ada. Jika diatur ke 'dinonaktifkan', lalu lintas melalui antarmuka publik tidak diizinkan, dan koneksi titik akhir privat akan menjadi metode akses eksklusif. | 'dinonaktifkan' 'diaktifkan' |
| Jumlah replika | Jumlah replika dalam layanan pencarian. Jika ditentukan, nilainya harus antara 1 dan 12 inklusif untuk SKU standar atau antara 1 dan 3 inklusif untuk SKU dasar. | Int Kendala: Nilai min = 1 Nilai maks = 12 |
| semantikPencarian | Mengatur opsi yang mengontrol ketersediaan pencarian semantik. Konfigurasi ini hanya dimungkinkan untuk SKU Pencarian Azure AI tertentu di lokasi tertentu. | 'dinonaktifkan' 'gratis' 'standar' |
SKU (Kode Barang)
| Nama | Deskripsi | Nilai |
|---|---|---|
| Nama | SKU layanan pencarian. Nilai yang valid meliputi: 'gratis': Layanan bersama. 'basic': Layanan khusus dengan hingga 3 replika. 'standar': Layanan khusus dengan hingga 12 partisi dan 12 replika. 'standard2': Mirip dengan standar, tetapi dengan lebih banyak kapasitas per unit pencarian. 'standard3': Penawaran Standar terbesar dengan hingga 12 partisi dan 12 replika (atau hingga 3 partisi dengan lebih banyak indeks jika Anda juga mengatur properti hostingMode ke 'highDensity'). 'storage_optimized_l1': Mendukung 1 TB per partisi, hingga 12 partisi. 'storage_optimized_l2': Mendukung 2TB per partisi, hingga 12 partisi.' | 'dasar' 'gratis' 'standar' 'standar2' 'standar3' 'storage_optimized_l1' 'storage_optimized_l2' |
TrackedResourceTags
| Nama | Deskripsi | Nilai |
|---|
UserAssignedManagedIdentities
| Nama | Deskripsi | Nilai |
|---|
UserAssignedManagedIdentity
| Nama | Deskripsi | Nilai |
|---|
Definisi sumber daya Terraform (penyedia AzAPI)
Jenis sumber daya searchServices dapat disebarkan dengan operasi yang menargetkan:
- Grup sumber daya Untuk daftar properti yang diubah di setiap versi API, lihat log perubahan.
Contoh Penggunaan
Sampel Terraform
Contoh dasar penerapan Search Service.
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 = ["*"]
}
Modul Terverifikasi Azure
Modul Terverifikasi Azure berikut dapat digunakan untuk menyebarkan jenis sumber daya ini.
| Modul | Deskripsi |
|---|---|
| Layanan Pencarian | Modul Sumber Daya AVM untuk Layanan Pencarian |
Format sumber daya
Untuk membuat sumber daya Microsoft.Search/searchServices, tambahkan Terraform berikut ke templat Anda.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Search/searchServices@2025-02-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 = ?
}
computeType = "string"
disabledDataExfiltrationOptions = [
"string"
]
disableLocalAuth = bool
encryptionWithCmk = {
enforcement = "string"
}
endpoint = "string"
hostingMode = "string"
networkRuleSet = {
bypass = "string"
ipRules = [
{
value = "string"
}
]
}
partitionCount = int
publicNetworkAccess = "string"
replicaCount = int
semanticSearch = "string"
}
sku = {
name = "string"
}
}
}
Nilai Properti
Microsoft.Search/searchServices
| Nama | Deskripsi | Nilai |
|---|---|---|
| identitas | Identitas sumber daya. | Identitas |
| lokasi | Lokasi geografis tempat sumber daya berada | string (diperlukan) |
| Nama | Nama sumber daya | string (diperlukan) |
| Properti | Properti layanan pencarian. | SearchServiceProperties |
| Sku | SKU layanan pencarian, yang menentukan tingkat harga dan batas kapasitas. Properti ini diperlukan saat membuat layanan pencarian baru. | Sku |
| Tags | Tag sumber daya | Kamus nama dan nilai tag. |
| jenis | Jenis sumber daya | "Microsoft.Search/searchServices@2025-02-01-preview" |
DataPlaneAadOrApiKeyAuthOption
| Nama | Deskripsi | Nilai |
|---|---|---|
| aadAuthFailureMode | Menjelaskan respons apa yang akan dikirim api sarana data dari layanan pencarian untuk permintaan yang gagal autentikasi. | 'http401WithBearerChallenge' 'http403' |
DataPlaneAuthOptions
| Nama | Deskripsi | Nilai |
|---|---|---|
| aadOrApiKey | Menunjukkan bahwa kunci API atau token akses dari penyewa ID Microsoft Entra dapat digunakan untuk autentikasi. | DataPlaneAadOrApiKeyAuthOption |
| apiKeyOnly | Menunjukkan bahwa hanya kunci API yang dapat digunakan untuk autentikasi. | apa pun |
EnkripsiDenganCmk
| Nama | Deskripsi | Nilai |
|---|---|---|
| Penegakan | Menjelaskan bagaimana layanan pencarian harus memberlakukan kepatuhan jika menemukan objek yang tidak dienkripsi dengan kunci yang dikelola pelanggan. | 'Dinonaktifkan' 'Diaktifkan' 'Tidak ditentukan' |
Identitas
| Nama | Deskripsi | Nilai |
|---|---|---|
| jenis | Jenis identitas yang digunakan untuk sumber daya. Jenis 'SystemAssigned, UserAssigned' mencakup identitas yang dibuat oleh sistem dan sekumpulan identitas yang ditetapkan pengguna. Jenis 'None' akan menghapus semua identitas dari layanan. | 'Tidak Ada' 'SistemDitetapkan' 'SystemAssigned, UserAssigned' 'UserAssigned' (diperlukan) |
| identitasYangDitetapkanPengguna | Daftar identitas pengguna yang terkait dengan sumber daya. Referensi kunci kamus identitas pengguna akan berupa ID sumber daya ARM dalam formulir: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | userAssignedManagedIdentities |
Aturan Ip
| Nama | Deskripsi | Nilai |
|---|---|---|
| nilai | Nilai yang sesuai dengan satu alamat IPv4 (misalnya, 123.1.2.3) atau rentang IP dalam format CIDR (misalnya, 123.1.2.3/24) untuk diizinkan. | string |
Rangkaian Aturan
SearchServiceProperties
| Nama | Deskripsi | Nilai |
|---|---|---|
| autentiOpsi | Menentukan opsi tentang cara API sarana data layanan pencarian mengautentikasi permintaan. Ini tidak dapat diatur jika 'disableLocalAuth' diatur ke true. | DataPlaneAuthOptions |
| computeType | Konfigurasikan properti ini untuk mendukung layanan pencarian menggunakan komputasi default atau Azure Confidential Compute. | 'Rahasia' 'default' |
| dinonaktifkanDataEksfiltrasiOpsi | Daftar skenario penyelundupan data yang secara eksplisit tidak diizinkan untuk layanan pencarian. Saat ini, satu-satunya nilai yang didukung adalah 'Semua' untuk menonaktifkan semua kemungkinan skenario ekspor data dengan kontrol yang lebih halus yang direncanakan untuk masa depan. | Array string yang berisi salah satu dari: 'Semua' |
| nonaktifkanLocalAuth | Ketika diatur ke true, panggilan ke layanan pencarian tidak akan diizinkan untuk menggunakan kunci API untuk autentikasi. Ini tidak dapat diatur ke true jika 'dataPlaneAuthOptions' ditentukan. | bool |
| enkripsiDenganCmk | Menentukan kebijakan apa pun mengenai enkripsi sumber daya (seperti indeks) menggunakan kunci manajer pelanggan dalam layanan pencarian. | EnkripsiDenganCmk |
| titik akhir | Titik akhir layanan Pencarian Azure AI. | string |
| hostingMode | Hanya berlaku untuk SKU standar3. Anda dapat mengatur properti ini untuk mengaktifkan hingga 3 partisi kepadatan tinggi yang memungkinkan hingga 1000 indeks, yang jauh lebih tinggi dari indeks maksimum yang diizinkan untuk SKU lainnya. Untuk SKU standar3, nilainya adalah 'default' atau 'highDensity'. Untuk semua SKU lainnya, nilai ini harus 'default'. | 'default' 'HighDensity' |
| networkRuleSet | Aturan khusus jaringan yang menentukan bagaimana layanan Pencarian Azure AI dapat dicapai. | NetworkRuleSet |
| jumlah partisi | Jumlah partisi dalam layanan pencarian; jika ditentukan, bisa 1, 2, 3, 4, 6, atau 12. Nilai yang lebih besar dari 1 hanya berlaku untuk SKU standar. Untuk layanan 'standard3' dengan hostingMode yang diatur ke 'highDensity', nilai yang diizinkan adalah antara 1 dan 3. | Int Kendala: Nilai min = 1 Nilai maks = 12 |
| publikAkses Jaringan | Nilai ini dapat diatur ke 'diaktifkan' untuk menghindari perubahan yang melanggar pada sumber daya dan templat pelanggan yang ada. Jika diatur ke 'dinonaktifkan', lalu lintas melalui antarmuka publik tidak diizinkan, dan koneksi titik akhir privat akan menjadi metode akses eksklusif. | 'dinonaktifkan' 'diaktifkan' |
| Jumlah replika | Jumlah replika dalam layanan pencarian. Jika ditentukan, nilainya harus antara 1 dan 12 inklusif untuk SKU standar atau antara 1 dan 3 inklusif untuk SKU dasar. | Int Kendala: Nilai min = 1 Nilai maks = 12 |
| semantikPencarian | Mengatur opsi yang mengontrol ketersediaan pencarian semantik. Konfigurasi ini hanya dimungkinkan untuk SKU Pencarian Azure AI tertentu di lokasi tertentu. | 'dinonaktifkan' 'gratis' 'standar' |
SKU (Kode Barang)
| Nama | Deskripsi | Nilai |
|---|---|---|
| Nama | SKU layanan pencarian. Nilai yang valid meliputi: 'gratis': Layanan bersama. 'basic': Layanan khusus dengan hingga 3 replika. 'standar': Layanan khusus dengan hingga 12 partisi dan 12 replika. 'standard2': Mirip dengan standar, tetapi dengan lebih banyak kapasitas per unit pencarian. 'standard3': Penawaran Standar terbesar dengan hingga 12 partisi dan 12 replika (atau hingga 3 partisi dengan lebih banyak indeks jika Anda juga mengatur properti hostingMode ke 'highDensity'). 'storage_optimized_l1': Mendukung 1 TB per partisi, hingga 12 partisi. 'storage_optimized_l2': Mendukung 2TB per partisi, hingga 12 partisi.' | 'dasar' 'gratis' 'standar' 'standar2' 'standar3' 'storage_optimized_l1' 'storage_optimized_l2' |
TrackedResourceTags
| Nama | Deskripsi | Nilai |
|---|
UserAssignedManagedIdentities
| Nama | Deskripsi | Nilai |
|---|
UserAssignedManagedIdentity
| Nama | Deskripsi | Nilai |
|---|