Bicep 리소스 정의
searchServices 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
사용 예제
Bicep 샘플
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'
}
}
Azure 확인된 모듈
다음 Azure 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.
| 모듈 | 묘사 |
|---|---|
| 검색 서비스 | Search Service용 AVM 리소스 모듈 |
Azure 빠른 시작 샘플
다음 Azure 빠른 시작 템플릿에는 이 리소스 유형을 배포하기 위한 Bicep 샘플이 포함되어 있습니다.
| Bicep 파일 | 묘사 |
|---|---|
| Azure AI 파운드리 네트워크 제한됨 | 이 템플릿 집합은 암호화에 Microsoft 관리형 키를 사용하고 AI 리소스에 대한 Microsoft 관리형 ID 구성을 사용하여 프라이빗 링크 및 송신을 사용하지 않도록 설정된 Azure AI Foundry를 설정하는 방법을 보여 줍니다. |
| Azure Cognitive Search 서비스 |
이 템플릿은 Azure Cognitive Search 서비스를 만듭니다. |
| 사용자 관리 ID 사용하여 네트워크 보안 에이전트 | 이 템플릿 집합은 AI 서비스/AOAI 연결에 대한 사용자 관리 ID 인증을 사용하여 가상 네트워크 격리로 Azure AI 에이전트 서비스를 설정하고 프라이빗 네트워크 링크를 설정하여 에이전트를 보안 데이터에 연결하는 방법을 보여 줍니다. |
| 표준 에이전트 설치 | 이 템플릿 집합은 표준 설정으로 Azure AI 에이전트 서비스를 설정하는 방법을 보여 줍니다. 즉, 프로젝트/허브 연결에 대한 관리 ID 인증 및 공용 인터넷 액세스를 사용하도록 설정했습니다. 에이전트는 고객 소유의 단일 테넌트 검색 및 스토리지 리소스를 사용합니다. 이 설정을 사용하면 이러한 리소스에 대한 모든 권한과 가시성이 있지만 사용량에 따라 비용이 발생합니다. |
리소스 형식
Microsoft.Search/searchServices 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.Search/searchServices@2015-08-19' = {
identity: {
type: 'string'
}
location: 'string'
name: 'string'
properties: {
hostingMode: 'string'
partitionCount: int
replicaCount: int
}
sku: {
name: 'string'
}
tags: {
{customized property}: 'string'
}
}
속성 값
Microsoft.Search/searchServices
| 이름 | 묘사 | 값 |
|---|---|---|
| 신원 | 리소스의 ID입니다. | ID |
| 위치 | 리소스의 지리적 위치입니다. 지원되고 등록된 Azure 지역(예: 미국 서부, 미국 동부, 동남 아시아 등) 중 하나여야 합니다. 이 속성은 새 리소스를 만들 때 필요합니다. | 문자열 |
| 이름 | 리소스 이름 | string(필수) |
| 속성 | Search 서비스의 속성입니다. | SearchServiceProperties |
| SKU (재고 관리 코드) | 가격 계층 및 용량 제한을 결정하는 Search Service의 SKU입니다. 이 속성은 새 Search Service를 만들 때 필요합니다. | 스쿠 |
| 태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. 템플릿 |
신원
| 이름 | 묘사 | 값 |
|---|---|---|
| 형 | ID 형식입니다. | '없음' 'SystemAssigned'(필수) |
리소스태그
| 이름 | 묘사 | 값 |
|---|
SearchServiceProperties
| 이름 | 묘사 | 값 |
|---|---|---|
| 호스팅모드 | standard3 SKU에만 적용됩니다. 최대 1,000개의 인덱스를 허용하는 최대 3개의 고밀도 파티션을 사용하도록 이 속성을 설정할 수 있습니다. 이는 다른 SKU에 허용되는 최대 인덱스보다 훨씬 높습니다. standard3 SKU의 경우 값은 'default' 또는 'highDensity'입니다. 다른 모든 SKU의 경우 이 값은 'default'여야 합니다. | '기본값' '고밀도' |
| 파티션 수 | Search 서비스의 파티션 수입니다. 지정된 경우 1, 2, 3, 4, 6 또는 12일 수 있습니다. 1보다 큰 값은 표준 SKU에만 유효합니다. hostingMode가 'highDensity'로 설정된 'standard3' 서비스의 경우 허용되는 값은 1에서 3 사이입니다. | 정수 제약 조건: 최소값 = 1 최대값 = 12 |
| 복제본 수 | Search 서비스의 복제본 수입니다. 지정된 경우 표준 SKU의 경우 1에서 12 사이의 값이거나 기본 SKU의 경우 1에서 3 사이여야 합니다. | 정수 제약 조건: 최소값 = 1 최대값 = 12 |
SKU (재고 관리 코드)
| 이름 | 묘사 | 값 |
|---|---|---|
| 이름 | Search 서비스의 SKU입니다. 유효한 값은 'free': 공유 서비스입니다. '기본': 최대 3개의 복제본이 있는 전용 서비스입니다. '표준': 최대 12개의 파티션과 12개의 복제본이 있는 전용 서비스입니다. 'standard2': 표준과 비슷하지만 검색 단위당 더 많은 용량이 있습니다. 'standard3': 최대 12개의 파티션과 12개의 복제본이 있는 가장 큰 표준 제품입니다(또는 hostingMode 속성을 'highDensity'로 설정한 경우 인덱스가 더 많은 파티션은 최대 3개). 'storage_optimized_l1': 파티션당 최대 12개의 파티션을 지원합니다. 'storage_optimized_l2': 파티션당 2TB, 최대 12개의 파티션을 지원합니다.' | '기본' '무료' '표준' '표준2' '표준3' 'storage_optimized_l1' 'storage_optimized_l2' |
ARM 템플릿 리소스 정의
searchServices 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 어를 참조하세요. 각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
사용 예제
Azure 빠른 시작 템플릿
다음 Azure 빠른 시작 템플릿은 이 리소스 유형을 배포할 있습니다.
| 템플렛 | 묘사 |
|---|---|
|
Azure AI 파운드리 네트워크 제한됨 Azure 배포 |
이 템플릿 집합은 암호화에 Microsoft 관리형 키를 사용하고 AI 리소스에 대한 Microsoft 관리형 ID 구성을 사용하여 프라이빗 링크 및 송신을 사용하지 않도록 설정된 Azure AI Foundry를 설정하는 방법을 보여 줍니다. |
| Azure Cognitive Search 서비스 Azure |
이 템플릿은 Azure Cognitive Search 서비스를 만듭니다. |
| 프라이빗 엔드포인트 사용하여 Azure Cognitive Search 서비스 Azure |
이 템플릿은 프라이빗 엔드포인트를 사용하여 Azure Cognitive Search 서비스를 만듭니다. |
| 사용자 관리 ID 사용하여 네트워크 보안 에이전트 Azure 배포 |
이 템플릿 집합은 AI 서비스/AOAI 연결에 대한 사용자 관리 ID 인증을 사용하여 가상 네트워크 격리로 Azure AI 에이전트 서비스를 설정하고 프라이빗 네트워크 링크를 설정하여 에이전트를 보안 데이터에 연결하는 방법을 보여 줍니다. |
| 표준 에이전트 설치 Azure 배포 |
이 템플릿 집합은 표준 설정으로 Azure AI 에이전트 서비스를 설정하는 방법을 보여 줍니다. 즉, 프로젝트/허브 연결에 대한 관리 ID 인증 및 공용 인터넷 액세스를 사용하도록 설정했습니다. 에이전트는 고객 소유의 단일 테넌트 검색 및 스토리지 리소스를 사용합니다. 이 설정을 사용하면 이러한 리소스에 대한 모든 권한과 가시성이 있지만 사용량에 따라 비용이 발생합니다. |
| SQL Database, Azure Cosmos DB, Azure Search 사용하여 웹앱 Azure |
이 템플릿은 웹앱, SQL Database, Azure Cosmos DB, Azure Search 및 Application Insights를 프로비전합니다. |
리소스 형식
Microsoft.Search/searchServices 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"type": "Microsoft.Search/searchServices",
"apiVersion": "2015-08-19",
"name": "string",
"identity": {
"type": "string"
},
"location": "string",
"properties": {
"hostingMode": "string",
"partitionCount": "int",
"replicaCount": "int"
},
"sku": {
"name": "string"
},
"tags": {
"{customized property}": "string"
}
}
속성 값
Microsoft.Search/searchServices
| 이름 | 묘사 | 값 |
|---|---|---|
| API버전 | api 버전 | '2015-08-19' |
| 신원 | 리소스의 ID입니다. | ID |
| 위치 | 리소스의 지리적 위치입니다. 지원되고 등록된 Azure 지역(예: 미국 서부, 미국 동부, 동남 아시아 등) 중 하나여야 합니다. 이 속성은 새 리소스를 만들 때 필요합니다. | 문자열 |
| 이름 | 리소스 이름 | string(필수) |
| 속성 | Search 서비스의 속성입니다. | SearchServiceProperties |
| SKU (재고 관리 코드) | 가격 계층 및 용량 제한을 결정하는 Search Service의 SKU입니다. 이 속성은 새 Search Service를 만들 때 필요합니다. | 스쿠 |
| 태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. 템플릿 |
| 형 | 리소스 종류 | 'Microsoft.Search/searchServices' |
신원
| 이름 | 묘사 | 값 |
|---|---|---|
| 형 | ID 형식입니다. | '없음' 'SystemAssigned'(필수) |
리소스태그
| 이름 | 묘사 | 값 |
|---|
SearchServiceProperties
| 이름 | 묘사 | 값 |
|---|---|---|
| 호스팅모드 | standard3 SKU에만 적용됩니다. 최대 1,000개의 인덱스를 허용하는 최대 3개의 고밀도 파티션을 사용하도록 이 속성을 설정할 수 있습니다. 이는 다른 SKU에 허용되는 최대 인덱스보다 훨씬 높습니다. standard3 SKU의 경우 값은 'default' 또는 'highDensity'입니다. 다른 모든 SKU의 경우 이 값은 'default'여야 합니다. | '기본값' '고밀도' |
| 파티션 수 | Search 서비스의 파티션 수입니다. 지정된 경우 1, 2, 3, 4, 6 또는 12일 수 있습니다. 1보다 큰 값은 표준 SKU에만 유효합니다. hostingMode가 'highDensity'로 설정된 'standard3' 서비스의 경우 허용되는 값은 1에서 3 사이입니다. | 정수 제약 조건: 최소값 = 1 최대값 = 12 |
| 복제본 수 | Search 서비스의 복제본 수입니다. 지정된 경우 표준 SKU의 경우 1에서 12 사이의 값이거나 기본 SKU의 경우 1에서 3 사이여야 합니다. | 정수 제약 조건: 최소값 = 1 최대값 = 12 |
SKU (재고 관리 코드)
| 이름 | 묘사 | 값 |
|---|---|---|
| 이름 | Search 서비스의 SKU입니다. 유효한 값은 'free': 공유 서비스입니다. '기본': 최대 3개의 복제본이 있는 전용 서비스입니다. '표준': 최대 12개의 파티션과 12개의 복제본이 있는 전용 서비스입니다. 'standard2': 표준과 비슷하지만 검색 단위당 더 많은 용량이 있습니다. 'standard3': 최대 12개의 파티션과 12개의 복제본이 있는 가장 큰 표준 제품입니다(또는 hostingMode 속성을 'highDensity'로 설정한 경우 인덱스가 더 많은 파티션은 최대 3개). 'storage_optimized_l1': 파티션당 최대 12개의 파티션을 지원합니다. 'storage_optimized_l2': 파티션당 2TB, 최대 12개의 파티션을 지원합니다.' | '기본' '무료' '표준' '표준2' '표준3' 'storage_optimized_l1' 'storage_optimized_l2' |
Terraform(AzAPI 공급자) 리소스 정의
searchServices 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 자원 그룹 각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
사용 예제
Terraform 샘플
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 = ["*"]
}
Azure 확인된 모듈
다음 Azure 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.
| 모듈 | 묘사 |
|---|---|
| 검색 서비스 | Search Service용 AVM 리소스 모듈 |
리소스 형식
Microsoft.Search/searchServices 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Search/searchServices@2015-08-19"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
hostingMode = "string"
partitionCount = int
replicaCount = int
}
sku = {
name = "string"
}
}
}
속성 값
Microsoft.Search/searchServices
| 이름 | 묘사 | 값 |
|---|---|---|
| 신원 | 리소스의 ID입니다. | ID |
| 위치 | 리소스의 지리적 위치입니다. 지원되고 등록된 Azure 지역(예: 미국 서부, 미국 동부, 동남 아시아 등) 중 하나여야 합니다. 이 속성은 새 리소스를 만들 때 필요합니다. | 문자열 |
| 이름 | 리소스 이름 | string(필수) |
| 속성 | Search 서비스의 속성입니다. | SearchServiceProperties |
| SKU (재고 관리 코드) | 가격 계층 및 용량 제한을 결정하는 Search Service의 SKU입니다. 이 속성은 새 Search Service를 만들 때 필요합니다. | 스쿠 |
| 태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. |
| 형 | 리소스 종류 | "Microsoft.Search/searchServices@2015-08-19" |
신원
| 이름 | 묘사 | 값 |
|---|---|---|
| 형 | ID 형식입니다. | '없음' 'SystemAssigned'(필수) |
리소스태그
| 이름 | 묘사 | 값 |
|---|
SearchServiceProperties
| 이름 | 묘사 | 값 |
|---|---|---|
| 호스팅모드 | standard3 SKU에만 적용됩니다. 최대 1,000개의 인덱스를 허용하는 최대 3개의 고밀도 파티션을 사용하도록 이 속성을 설정할 수 있습니다. 이는 다른 SKU에 허용되는 최대 인덱스보다 훨씬 높습니다. standard3 SKU의 경우 값은 'default' 또는 'highDensity'입니다. 다른 모든 SKU의 경우 이 값은 'default'여야 합니다. | '기본값' '고밀도' |
| 파티션 수 | Search 서비스의 파티션 수입니다. 지정된 경우 1, 2, 3, 4, 6 또는 12일 수 있습니다. 1보다 큰 값은 표준 SKU에만 유효합니다. hostingMode가 'highDensity'로 설정된 'standard3' 서비스의 경우 허용되는 값은 1에서 3 사이입니다. | 정수 제약 조건: 최소값 = 1 최대값 = 12 |
| 복제본 수 | Search 서비스의 복제본 수입니다. 지정된 경우 표준 SKU의 경우 1에서 12 사이의 값이거나 기본 SKU의 경우 1에서 3 사이여야 합니다. | 정수 제약 조건: 최소값 = 1 최대값 = 12 |
SKU (재고 관리 코드)
| 이름 | 묘사 | 값 |
|---|---|---|
| 이름 | Search 서비스의 SKU입니다. 유효한 값은 'free': 공유 서비스입니다. '기본': 최대 3개의 복제본이 있는 전용 서비스입니다. '표준': 최대 12개의 파티션과 12개의 복제본이 있는 전용 서비스입니다. 'standard2': 표준과 비슷하지만 검색 단위당 더 많은 용량이 있습니다. 'standard3': 최대 12개의 파티션과 12개의 복제본이 있는 가장 큰 표준 제품입니다(또는 hostingMode 속성을 'highDensity'로 설정한 경우 인덱스가 더 많은 파티션은 최대 3개). 'storage_optimized_l1': 파티션당 최대 12개의 파티션을 지원합니다. 'storage_optimized_l2': 파티션당 2TB, 최대 12개의 파티션을 지원합니다.' | '기본' '무료' '표준' '표준2' '표준3' 'storage_optimized_l1' 'storage_optimized_l2' |