Microsoft.Search searchServices
Bicep 리소스 정의
searchServices 리소스 종류는 다음을 대상으로 하는 작업과 함께 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령을 참조하세요.
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.Search/searchServices 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.Search/searchServices@2023-11-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
semanticSearch: 'string'
}
}
속성 값
searchServices
| Name | Description | 값 |
|---|---|---|
| name | 리소스 이름 | string(필수) |
| 위치 | 리소스가 있는 지리적 위치 | string(필수) |
| tags | 리소스 태그. | 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요. |
| sku | 청구 속도 및 용량 제한을 결정하는 검색 서비스의 SKU입니다. 이 속성은 새 검색 서비스를 만들 때 필요합니다. | Sku |
| identity | 리소스의 ID입니다. | ID |
| properties | 검색 서비스의 속성입니다. | SearchServiceProperties |
ID
| 이름 | Description | 값 |
|---|---|---|
| 형식 | ID 형식입니다. | 'None' 'SystemAssigned'(필수) |
SearchServiceProperties
| Name | Description | 값 |
|---|---|---|
| authOptions | 검색 서비스의 데이터 평면 API가 요청을 인증하는 방법에 대한 옵션을 정의합니다. 'disableLocalAuth'가 true로 설정된 경우에는 설정할 수 없습니다. | DataPlaneAuthOptions |
| disableLocalAuth | true로 설정하면 검색 서비스에 대한 호출이 인증에 API 키를 사용하는 것이 허용되지 않습니다. 'dataPlaneAuthOptions'가 정의된 경우 true로 설정할 수 없습니다. | bool |
| encryptionWithCmk | 검색 서비스 내에서 고객 관리자 키를 사용하여 리소스 암호화(예: 인덱스)에 대한 정책을 지정합니다. | EncryptionWithCmk |
| hostingMode | standard3 SKU에만 적용됩니다. 이 속성을 설정하여 최대 1,000개의 인덱스를 허용하는 최대 3개의 고밀도 파티션을 사용하도록 설정할 수 있습니다. 이는 다른 SKU에 허용되는 최대 인덱스보다 훨씬 높습니다. standard3 SKU의 경우 값은 'default' 또는 'highDensity'입니다. 다른 모든 SKU의 경우 이 값은 'default'여야 합니다. | 'default' 'highDensity' |
| networkRuleSet | 검색 서비스에 도달하는 방법을 결정하는 네트워크별 규칙입니다. | NetworkRuleSet |
| partitionCount | 검색 서비스의 파티션 수입니다. 지정된 경우 1, 2, 3, 4, 6 또는 12일 수 있습니다. 1보다 큰 값은 표준 SKU에만 유효합니다. hostingMode가 'highDensity'로 설정된 'standard3' 서비스의 경우 허용되는 값은 1에서 3 사이입니다. | int 제약 조건: 최소값 = 1 최대값 = 12 |
| publicNetworkAccess | 이 값은 기존 고객 리소스 및 템플릿의 호환성이 손상되는 변경을 방지하기 위해 '사용'으로 설정할 수 있습니다. '사용 안 함'으로 설정하면 공용 인터페이스를 통해 트래픽이 허용되지 않으며 프라이빗 엔드포인트 연결이 단독 액세스 방법이 됩니다. | 'disabled' 'enabled' |
| replicaCount | 검색 서비스의 복제본 수입니다. 지정된 경우 표준 SKU의 경우 1에서 12 사이의 값이거나 기본 SKU의 경우 1에서 3 사이여야 합니다. | int 제약 조건: 최소값 = 1 최대값 = 12 |
| semanticSearch | 의미 체계 검색의 가용성을 제어하는 옵션을 설정합니다. 이 구성은 특정 위치의 특정 검색 SKU에 대해서만 가능합니다. | 'disabled' 'free' 'standard' |
DataPlaneAuthOptions
| Name | Description | 값 |
|---|---|---|
| aadOrApiKey | Microsoft Entra ID 테넌트에서 API 키 또는 액세스 토큰을 인증에 사용할 수 있음을 나타냅니다. | DataPlaneAadOrApiKeyAuthOption |
| apiKeyOnly | API 키만 인증에 사용할 수 있음을 나타냅니다. | Bicep의 경우 any() 함수를 사용할 수 있습니다. |
DataPlaneAadOrApiKeyAuthOption
| Name | Description | 값 |
|---|---|---|
| aadAuthFailureMode | 인증에 실패한 요청에 대해 검색 서비스의 데이터 평면 API가 보낼 응답에 대해 설명합니다. | 'http401WithBearerChallenge' 'http403' |
EncryptionWithCmk
| Name | Description | 값 |
|---|---|---|
| 집행 | 검색 서비스에서 고객이 암호화하지 않은 리소스를 하나 이상 적용하는 방법을 설명합니다. | 'Disabled' 'Enabled' '지정되지 않음' |
NetworkRuleSet
| Name | Description | 값 |
|---|---|---|
| ipRules | IP 방화벽에 사용되는 IP 제한 규칙 목록입니다. 규칙과 일치하지 않는 모든 IP는 방화벽에 의해 차단됩니다. 이러한 규칙은 검색 서비스의 'publicNetworkAccess'가 '사용'인 경우에만 적용됩니다. | IpRule[] |
IpRule
| Name | Description | 값 |
|---|---|---|
| 값 | 단일 IPv4 주소(예: 123.1.2.3) 또는 CIDR 형식의 IP 범위(예: 123.1.2.3/24)에 해당하는 값입니다. | 문자열 |
SKU
| Name | Description | 값 |
|---|---|---|
| name | 검색 서비스의 SKU입니다. 유효한 값은 'free': 공유 서비스입니다. 'basic': 최대 3개의 복제본이 있는 전용 서비스입니다. '표준': 최대 12개의 파티션과 12개의 복제본이 있는 전용 서비스입니다. 'standard2': 표준과 비슷하지만 검색 단위당 용량이 더 높습니다. 'standard3': 최대 12개의 파티션과 12개의 복제본이 있는 가장 큰 표준 제품입니다(또는 hostingMode 속성을 'highDensity'로 설정한 경우 인덱스가 더 많은 파티션은 최대 3개). 'storage_optimized_l1': 파티션당 최대 12개의 파티션을 지원합니다. 'storage_optimized_l2': 파티션당 최대 12개의 파티션당 2TB를 지원합니다. | 'basic' 'free' 'standard' 'standard2' 'standard3' 'storage_optimized_l1' 'storage_optimized_l2' |
빠른 시작 템플릿
다음 빠른 시작 템플릿은 이 리소스 종류를 배포합니다.
| 템플릿 | Description |
|---|---|
SQL Database, Azure Cosmos DB, Azure Search를 사용하는 웹앱 |
이 템플릿은 웹앱, SQL Database, Azure Cosmos DB, Azure Search 및 Application Insights를 프로비전합니다. |
| Azure Cognitive Search 서비스 |
이 템플릿은 Azure Cognitive Search 서비스를 만듭니다. |
| 프라이빗 엔드포인트를 사용하여 서비스 Azure Cognitive Search |
이 템플릿은 프라이빗 엔드포인트를 사용하여 Azure Cognitive Search 서비스를 만듭니다. |
ARM 템플릿 리소스 정의
searchServices 리소스 종류는 다음을 대상으로 하는 작업과 함께 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령을 참조하세요.
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.Search/searchServices 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"type": "Microsoft.Search/searchServices",
"apiVersion": "2023-11-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",
"semanticSearch": "string"
}
}
속성 값
searchServices
| Name | Description | 값 |
|---|---|---|
| 형식 | 리소스 종류 | 'Microsoft.Search/searchServices' |
| apiVersion | 리소스 api 버전 | '2023-11-01' |
| name | 리소스 이름 | string(필수) |
| 위치 | 리소스가 있는 지리적 위치 | string(필수) |
| tags | 리소스 태그. | 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요. |
| sku | 청구 속도 및 용량 제한을 결정하는 검색 서비스의 SKU입니다. 이 속성은 새 검색 서비스를 만들 때 필요합니다. | Sku |
| identity | 리소스의 ID입니다. | ID |
| properties | 검색 서비스의 속성입니다. | SearchServiceProperties |
ID
| 이름 | Description | 값 |
|---|---|---|
| 형식 | ID 형식입니다. | 'None' 'SystemAssigned'(필수) |
SearchServiceProperties
| Name | Description | 값 |
|---|---|---|
| authOptions | 검색 서비스의 데이터 평면 API가 요청을 인증하는 방법에 대한 옵션을 정의합니다. 'disableLocalAuth'가 true로 설정된 경우에는 설정할 수 없습니다. | DataPlaneAuthOptions |
| disableLocalAuth | true로 설정하면 검색 서비스에 대한 호출이 인증에 API 키를 사용하는 것이 허용되지 않습니다. 'dataPlaneAuthOptions'가 정의된 경우 true로 설정할 수 없습니다. | bool |
| encryptionWithCmk | 검색 서비스 내에서 고객 관리자 키를 사용하여 리소스 암호화(예: 인덱스)에 대한 정책을 지정합니다. | EncryptionWithCmk |
| hostingMode | standard3 SKU에만 적용됩니다. 이 속성을 설정하여 최대 1,000개의 인덱스를 허용하는 최대 3개의 고밀도 파티션을 사용하도록 설정할 수 있습니다. 이는 다른 SKU에 허용되는 최대 인덱스보다 훨씬 높습니다. standard3 SKU의 경우 값은 'default' 또는 'highDensity'입니다. 다른 모든 SKU의 경우 이 값은 'default'여야 합니다. | 'default' 'highDensity' |
| networkRuleSet | 검색 서비스에 도달하는 방법을 결정하는 네트워크별 규칙입니다. | NetworkRuleSet |
| partitionCount | 검색 서비스의 파티션 수입니다. 지정된 경우 1, 2, 3, 4, 6 또는 12일 수 있습니다. 1보다 큰 값은 표준 SKU에만 유효합니다. hostingMode가 'highDensity'로 설정된 'standard3' 서비스의 경우 허용되는 값은 1에서 3 사이입니다. | int 제약 조건: 최소값 = 1 최대값 = 12 |
| publicNetworkAccess | 이 값은 기존 고객 리소스 및 템플릿의 호환성이 손상되는 변경을 방지하기 위해 '사용'으로 설정할 수 있습니다. '사용 안 함'으로 설정하면 공용 인터페이스를 통해 트래픽이 허용되지 않으며 프라이빗 엔드포인트 연결이 단독 액세스 방법이 됩니다. | 'disabled' 'enabled' |
| replicaCount | 검색 서비스의 복제본 수입니다. 지정된 경우 표준 SKU의 경우 1에서 12 사이의 값이거나 기본 SKU의 경우 1에서 3 사이여야 합니다. | int 제약 조건: 최소값 = 1 최대값 = 12 |
| semanticSearch | 의미 체계 검색의 가용성을 제어하는 옵션을 설정합니다. 이 구성은 특정 위치의 특정 검색 SKU에 대해서만 가능합니다. | 'disabled' 'free' 'standard' |
DataPlaneAuthOptions
| Name | Description | 값 |
|---|---|---|
| aadOrApiKey | Microsoft Entra ID 테넌트에서 API 키 또는 액세스 토큰을 인증에 사용할 수 있음을 나타냅니다. | DataPlaneAadOrApiKeyAuthOption |
| apiKeyOnly | API 키만 인증에 사용할 수 있음을 나타냅니다. |
DataPlaneAadOrApiKeyAuthOption
| Name | Description | 값 |
|---|---|---|
| aadAuthFailureMode | 인증에 실패한 요청에 대해 검색 서비스의 데이터 평면 API가 보낼 응답에 대해 설명합니다. | 'http401WithBearerChallenge' 'http403' |
EncryptionWithCmk
| Name | Description | 값 |
|---|---|---|
| 집행 | 검색 서비스에서 고객이 암호화하지 않은 리소스를 하나 이상 적용하는 방법을 설명합니다. | 'Disabled' '사용' '지정되지 않음' |
NetworkRuleSet
| Name | Description | 값 |
|---|---|---|
| ipRules | IP 방화벽에 사용되는 IP 제한 규칙 목록입니다. 규칙과 일치하지 않는 IP는 방화벽에 의해 차단됩니다. 이러한 규칙은 검색 서비스의 'publicNetworkAccess'가 '사용'인 경우에만 적용됩니다. | IpRule[] |
IpRule
| Name | Description | 값 |
|---|---|---|
| 값 | 단일 IPv4 주소(예: 123.1.2.3) 또는 CIDR 형식의 IP 범위(예: 123.1.2.3/24)에 해당하는 값입니다. | 문자열 |
SKU
| Name | Description | 값 |
|---|---|---|
| name | 검색 서비스의 SKU입니다. 유효한 값은 'free': 공유 서비스입니다. 'basic': 최대 3개의 복제본이 있는 전용 서비스입니다. '표준': 최대 12개의 파티션과 12개의 복제본이 있는 전용 서비스입니다. 'standard2': 표준과 비슷하지만 검색 단위당 용량이 더 높습니다. 'standard3': 최대 12개의 파티션과 12개의 복제본이 있는 가장 큰 표준 제품입니다(또는 hostingMode 속성을 'highDensity'로 설정하는 경우 인덱스가 더 많은 파티션 최대 3개). 'storage_optimized_l1': 파티션당 최대 12개의 파티션을 지원합니다. 'storage_optimized_l2': 파티션당 최대 12개 파티션당 2TB를 지원합니다.' | 'basic' '무료' 'standard' 'standard2' 'standard3' 'storage_optimized_l1' 'storage_optimized_l2' |
빠른 시작 템플릿
다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.
| 템플릿 | Description |
|---|---|
| SQL Database, Azure Cosmos DB, Azure Search가 있는 웹앱 |
이 템플릿은 웹앱, SQL Database, Azure Cosmos DB, Azure Search 및 Application Insights를 프로비전합니다. |
| Azure Cognitive Search 서비스 |
이 템플릿은 Azure Cognitive Search 서비스를 만듭니다. |
| 프라이빗 엔드포인트를 사용하여 서비스 Azure Cognitive Search |
이 템플릿은 프라이빗 엔드포인트를 사용하여 Azure Cognitive Search 서비스를 만듭니다. |
Terraform(AzAPI 공급자) 리소스 정의
searchServices 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.Search/searchServices 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Search/searchServices@2023-11-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
semanticSearch = "string"
}
sku = {
name = "string"
}
})
}
속성 값
searchServices
| Name | Description | 값 |
|---|---|---|
| 형식 | 리소스 종류 | "Microsoft.Search/searchServices@2023-11-01" |
| name | 리소스 이름 | string(필수) |
| 위치 | 리소스가 있는 지리적 위치 | string(필수) |
| parent_id | 리소스 그룹에 배포하려면 해당 리소스 그룹의 ID를 사용합니다. | string(필수) |
| tags | 리소스 태그. | 태그 이름 및 값의 사전입니다. |
| sku | 청구 속도 및 용량 제한을 결정하는 검색 서비스의 SKU입니다. 이 속성은 새 검색 서비스를 만들 때 필요합니다. | Sku |
| identity | 리소스의 ID입니다. | ID |
| properties | 검색 서비스의 속성입니다. | SearchServiceProperties |
ID
| 이름 | Description | 값 |
|---|---|---|
| 형식 | ID 유형입니다. | "SystemAssigned"(필수) |
SearchServiceProperties
| Name | Description | 값 |
|---|---|---|
| authOptions | 검색 서비스의 데이터 평면 API가 요청을 인증하는 방법에 대한 옵션을 정의합니다. 'disableLocalAuth'가 true로 설정된 경우 설정할 수 없습니다. | DataPlaneAuthOptions |
| disableLocalAuth | true로 설정하면 검색 서비스에 대한 호출이 인증을 위해 API 키를 활용하는 것이 허용되지 않습니다. 'dataPlaneAuthOptions'가 정의된 경우 true로 설정할 수 없습니다. | bool |
| encryptionWithCmk | 검색 서비스 내에서 고객 관리자 키를 사용하여 리소스 암호화(예: 인덱스)에 대한 정책을 지정합니다. | EncryptionWithCmk |
| hostingMode | standard3 SKU에만 적용됩니다. 최대 1,000개의 인덱스를 허용하는 최대 3개의 고밀도 파티션을 사용하도록 이 속성을 설정할 수 있습니다. 이는 다른 SKU에 허용되는 최대 인덱스보다 훨씬 높습니다. standard3 SKU의 경우 값은 'default' 또는 'highDensity'입니다. 다른 모든 SKU의 경우 이 값은 'default'여야 합니다. | "default" "highDensity" |
| networkRuleSet | 검색 서비스에 도달하는 방법을 결정하는 네트워크별 규칙입니다. | NetworkRuleSet |
| partitionCount | 검색 서비스의 파티션 수입니다. 지정된 경우 1, 2, 3, 4, 6 또는 12일 수 있습니다. 1보다 큰 값은 표준 SKU에만 유효합니다. hostingMode가 'highDensity'로 설정된 'standard3' 서비스의 경우 허용되는 값은 1에서 3 사이입니다. | int 제약 조건: 최소값 = 1 최대값 = 12 |
| publicNetworkAccess | 이 값은 기존 고객 리소스 및 템플릿의 호환성이 손상되는 변경을 방지하기 위해 '사용'으로 설정할 수 있습니다. 'disabled'로 설정하면 공용 인터페이스를 통해 트래픽이 허용되지 않으며 프라이빗 엔드포인트 연결은 배타적 액세스 방법이 됩니다. | "disabled" "enabled" |
| replicaCount | 검색 서비스의 복제본 수입니다. 지정된 경우 표준 SKU의 경우 1에서 12 사이의 값이거나 기본 SKU의 경우 1에서 3 사이의 값이어야 합니다. | int 제약 조건: 최소값 = 1 최대값 = 12 |
| semanticSearch | 의미 체계 검색의 가용성을 제어하는 옵션을 설정합니다. 이 구성은 특정 위치의 특정 검색 SKU에 대해서만 가능합니다. | "disabled" "무료" "표준" |
DataPlaneAuthOptions
| Name | Description | 값 |
|---|---|---|
| aadOrApiKey | Microsoft Entra ID 테넌트에서 API 키 또는 액세스 토큰을 인증에 사용할 수 있음을 나타냅니다. | DataPlaneAadOrApiKeyAuthOption |
| apiKeyOnly | API 키만 인증에 사용할 수 있음을 나타냅니다. |
DataPlaneAadOrApiKeyAuthOption
| Name | Description | 값 |
|---|---|---|
| aadAuthFailureMode | 인증에 실패한 요청에 대해 검색 서비스의 데이터 평면 API가 보내는 응답에 대해 설명합니다. | "http401WithBearerChallenge" "http403" |
EncryptionWithCmk
| Name | Description | 값 |
|---|---|---|
| 집행 | 검색 서비스에서 고객이 암호화하지 않은 리소스를 하나 이상 보유하는 방법을 설명합니다. | "사용 안 함" "사용" "지정되지 않음" |
NetworkRuleSet
| Name | Description | 값 |
|---|---|---|
| ipRules | IP 방화벽에 사용되는 IP 제한 규칙 목록입니다. 규칙과 일치하지 않는 IP는 방화벽에 의해 차단됩니다. 이러한 규칙은 검색 서비스의 'publicNetworkAccess'가 '사용'인 경우에만 적용됩니다. | IpRule[] |
IpRule
| Name | Description | 값 |
|---|---|---|
| 값 | 단일 IPv4 주소(예: 123.1.2.3) 또는 CIDR 형식의 IP 범위(예: 123.1.2.3/24)에 해당하는 값입니다. | 문자열 |
SKU
| Name | Description | 값 |
|---|---|---|
| name | 검색 서비스의 SKU입니다. 유효한 값은 'free': 공유 서비스입니다. 'basic': 최대 3개의 복제본이 있는 전용 서비스입니다. '표준': 최대 12개의 파티션과 12개의 복제본이 있는 전용 서비스입니다. 'standard2': 표준과 비슷하지만 검색 단위당 용량이 더 높습니다. 'standard3': 최대 12개의 파티션과 12개의 복제본이 있는 가장 큰 표준 제품입니다(또는 hostingMode 속성을 'highDensity'로 설정하는 경우 인덱스가 더 많은 파티션 최대 3개). 'storage_optimized_l1': 파티션당 최대 12개의 파티션을 지원합니다. 'storage_optimized_l2': 파티션당 최대 12개 파티션당 2TB를 지원합니다.' | "basic" "free" "standard" "standard2" "standard3" "storage_optimized_l1" "storage_optimized_l2" |
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기