Microsoft. Search searchServices 2023-11-01

아티클
05/07/2024

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' '무료' 'standard'

DataPlaneAuthOptions

Name	Description	값
aadOrApiKey	Microsoft Entra ID 테넌트에서 API 키 또는 액세스 토큰을 인증에 사용할 수 있음을 나타냅니다.	DataPlaneAadOrApiKeyAuthOption
apiKeyOnly	API 키만 인증에 사용할 수 있음을 나타냅니다.	Bicep의 경우 any() 함수를 사용할 수 있습니다.

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' '무료' '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'로 설정하면 공용 인터페이스를 통해 트래픽이 허용되지 않으며 프라이빗 엔드포인트 연결은 배타적 액세스 방법이 됩니다.	'disabled' 'enabled'
replicaCount	검색 서비스의 복제본 수입니다. 지정된 경우 표준 SKU의 경우 1에서 12 사이의 값이거나 기본 SKU의 경우 1에서 3 사이의 값이어야 합니다.	int 제약 조건: 최소값 = 1 최대값 = 12
semanticSearch	의미 체계 검색의 가용성을 제어하는 옵션을 설정합니다. 이 구성은 특정 위치의 특정 검색 SKU에 대해서만 가능합니다.	'disabled' '무료' 'standard'

DataPlaneAuthOptions

Name	Description	값
aadOrApiKey	Microsoft Entra ID 테넌트에서 API 키 또는 액세스 토큰을 인증에 사용할 수 있음을 나타냅니다.	DataPlaneAadOrApiKeyAuthOption
apiKeyOnly	API 키만 인증에 사용할 수 있음을 나타냅니다.

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 서비스를 만듭니다.

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" "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	값
집행	검색 서비스에서 고객이 암호화하지 않은 리소스를 하나 이상 적용하는 방법을 설명합니다.	"사용 안 함" "사용" "지정되지 않음"

NetworkRuleSet

Name	Description	값
ipRules	IP 방화벽에 사용되는 IP 제한 규칙 목록입니다. 규칙과 일치하지 않는 모든 IP는 방화벽에 의해 차단됩니다. 이러한 규칙은 검색 서비스의 'publicNetworkAccess'가 '사용'인 경우에만 적용됩니다.	IpRule[]

IpRule

Name	Description	값
값	단일 IPv4 주소(예: 123.1.2.3) 또는 CIDR 형식의 IP 범위(예: 123.1.2.3/24)에 해당하는 값입니다.	string

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를 지원합니다.'	"기본" "무료" "표준" "standard2" "standard3" "storage_optimized_l1" "storage_optimized_l2"

다음을 통해 공유

Microsoft. Search searchServices 2023-11-01

Bicep 리소스 정의

리소스 형식

속성 값

searchServices

ID

SearchServiceProperties

DataPlaneAuthOptions

DataPlaneAadOrApiKeyAuthOption

EncryptionWithCmk

NetworkRuleSet

IpRule

SKU

빠른 시작 템플릿

ARM 템플릿 리소스 정의

리소스 형식

속성 값

searchServices

ID

SearchServiceProperties

DataPlaneAuthOptions

DataPlaneAadOrApiKeyAuthOption

EncryptionWithCmk

NetworkRuleSet

IpRule

SKU

빠른 시작 템플릿

Terraform(AzAPI 공급자) 리소스 정의

리소스 형식

속성 값

searchServices

ID

SearchServiceProperties

DataPlaneAuthOptions

DataPlaneAadOrApiKeyAuthOption

EncryptionWithCmk

NetworkRuleSet

IpRule

SKU

피드백

추가 리소스