Microsoft.Search searchServices 2023-11-01

아티클
12/20/2024

Bicep 리소스 정의

searchServices 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령 참조

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Search/searchServices 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.Search/searchServices@2023-11-01' = {
  identity: {
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    authOptions: {
      aadOrApiKey: {
        aadAuthFailureMode: 'string'
      }
      apiKeyOnly: any(Azure.Bicep.Types.Concrete.AnyType)
    }
    disableLocalAuth: bool
    encryptionWithCmk: {
      enforcement: 'string'
    }
    hostingMode: 'string'
    networkRuleSet: {
      ipRules: [
        {
          value: 'string'
        }
      ]
    }
    partitionCount: int
    publicNetworkAccess: 'string'
    replicaCount: int
    semanticSearch: 'string'
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

속성 값

DataPlaneAadOrApiKeyAuthOption

이름	묘사	값
aadAuthFailureMode	인증에 실패한 요청에 대해 검색 서비스의 데이터 평면 API가 보내는 응답에 대해 설명합니다.	'http401WithBearerChallenge' 'http403'

DataPlaneAuthOptions

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

EncryptionWithCmk

이름	묘사	값
집행	검색 서비스에서 고객 암호화되지 않은 리소스를 하나 이상 적용하는 방법을 설명합니다.	'사용 안 함' 'Enabled' '지정되지 않음'

신원

이름	묘사	값
형	ID 형식입니다.	'None' 'SystemAssigned'(필수)

IpRule

이름	묘사	값
값	단일 IPv4 주소(예: 123.1.2.3) 또는 CIDR 형식의 IP 범위(예: 123.1.2.3/24)에 해당하는 값입니다.	문자열

Microsoft.Search/searchServices

이름	묘사	값
신원	리소스의 ID입니다.	ID
위치	리소스가 있는 지리적 위치	string(필수)
이름	리소스 이름	string(필수)
속성	검색 서비스의 속성입니다.	SearchServiceProperties
sku	청구 속도 및 용량 제한을 결정하는 검색 서비스의 SKU입니다. 이 속성은 새 검색 서비스를 만들 때 필요합니다.	Sku
태그	리소스 태그	태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.

NetworkRuleSet

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

SearchServiceProperties

이름	묘사	값
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' 'free' 'standard'

Sku

이름	묘사	값
이름	검색 서비스의 SKU입니다. 유효한 값은 'free': 공유 서비스입니다. '기본': 최대 3개의 복제본이 있는 전용 서비스입니다. '표준': 최대 12개의 파티션과 12개의 복제본이 있는 전용 서비스입니다. 'standard2': 표준과 비슷하지만 검색 단위당 더 많은 용량이 있습니다. 'standard3': 최대 12개의 파티션과 12개의 복제본이 있는 가장 큰 표준 제품입니다(또는 hostingMode 속성을 'highDensity'로 설정한 경우 인덱스가 더 많은 파티션은 최대 3개). 'storage_optimized_l1': 파티션당 최대 12개의 파티션을 지원합니다. 'storage_optimized_l2': 파티션당 2TB, 최대 12개의 파티션을 지원합니다.'	'basic' 'free' 'standard' 'standard2' 'standard3' 'storage_optimized_l1' 'storage_optimized_l2'

TrackedResourceTags

이름	묘사	값

빠른 시작 샘플

다음 빠른 시작 샘플은 이 리소스 유형을 배포합니다.

Bicep 파일	묘사
Azure AI Studio 네트워크 제한	이 템플릿 집합은 암호화를 위해 Microsoft 관리형 키를 사용하고 AI 리소스에 대한 Microsoft 관리 ID 구성을 사용하여 프라이빗 링크 및 송신을 사용하지 않도록 설정하여 Azure AI Studio를 설정하는 방법을 보여 줍니다.
Azure Cognitive Search 서비스	이 템플릿은 Azure Cognitive Search 서비스를 만듭니다.

ARM 템플릿 리소스 정의

searchServices 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령 참조

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Search/searchServices 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.Search/searchServices",
  "apiVersion": "2023-11-01",
  "name": "string",
  "identity": {
    "type": "string"
  },
  "location": "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"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

속성 값

DataPlaneAadOrApiKeyAuthOption

이름	묘사	값
aadAuthFailureMode	인증에 실패한 요청에 대해 검색 서비스의 데이터 평면 API가 보내는 응답에 대해 설명합니다.	'http401WithBearerChallenge' 'http403'

DataPlaneAuthOptions

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

EncryptionWithCmk

이름	묘사	값
집행	검색 서비스에서 고객 암호화되지 않은 리소스를 하나 이상 적용하는 방법을 설명합니다.	'사용 안 함' 'Enabled' '지정되지 않음'

신원

이름	묘사	값
형	ID 형식입니다.	'None' 'SystemAssigned'(필수)

IpRule

이름	묘사	값
값	단일 IPv4 주소(예: 123.1.2.3) 또는 CIDR 형식의 IP 범위(예: 123.1.2.3/24)에 해당하는 값입니다.	문자열

Microsoft.Search/searchServices

이름	묘사	값
apiVersion	api 버전	'2023-11-01'
신원	리소스의 ID입니다.	ID
위치	리소스가 있는 지리적 위치	string(필수)
이름	리소스 이름	string(필수)
속성	검색 서비스의 속성입니다.	SearchServiceProperties
sku	청구 속도 및 용량 제한을 결정하는 검색 서비스의 SKU입니다. 이 속성은 새 검색 서비스를 만들 때 필요합니다.	Sku
태그	리소스 태그	태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
형	리소스 종류	'Microsoft.Search/searchServices'

NetworkRuleSet

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

SearchServiceProperties

이름	묘사	값
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' 'free' 'standard'

Sku

이름	묘사	값
이름	검색 서비스의 SKU입니다. 유효한 값은 'free': 공유 서비스입니다. '기본': 최대 3개의 복제본이 있는 전용 서비스입니다. '표준': 최대 12개의 파티션과 12개의 복제본이 있는 전용 서비스입니다. 'standard2': 표준과 비슷하지만 검색 단위당 더 많은 용량이 있습니다. 'standard3': 최대 12개의 파티션과 12개의 복제본이 있는 가장 큰 표준 제품입니다(또는 hostingMode 속성을 'highDensity'로 설정한 경우 인덱스가 더 많은 파티션은 최대 3개). 'storage_optimized_l1': 파티션당 최대 12개의 파티션을 지원합니다. 'storage_optimized_l2': 파티션당 2TB, 최대 12개의 파티션을 지원합니다.'	'basic' 'free' 'standard' 'standard2' 'standard3' 'storage_optimized_l1' 'storage_optimized_l2'

TrackedResourceTags

이름	묘사	값

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.

템플렛	묘사
Azure AI Studio 네트워크 제한 Azure 배포	이 템플릿 집합은 암호화를 위해 Microsoft 관리형 키를 사용하고 AI 리소스에 대한 Microsoft 관리 ID 구성을 사용하여 프라이빗 링크 및 송신을 사용하지 않도록 설정하여 Azure AI Studio를 설정하는 방법을 보여 줍니다.
Azure Cognitive Search 서비스 Azure 배포	이 템플릿은 Azure Cognitive Search 서비스를 만듭니다.
프라이빗 엔드포인트 사용하여 Azure Cognitive Search 서비스 Azure 배포	이 템플릿은 프라이빗 엔드포인트를 사용하여 Azure Cognitive Search 서비스를 만듭니다.
SQL Database, Azure Cosmos DB, Azure Search 사용하여 웹앱 Azure 배포	이 템플릿은 웹앱, SQL Database, Azure Cosmos DB, Azure Search 및 Application Insights를 프로비전합니다.

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

searchServices 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.Search/searchServices 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Search/searchServices@2023-11-01"
  name = "string"
  identity = {
    type = "string"
  }
  location = "string"
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    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"
    }
  })
}

속성 값

DataPlaneAadOrApiKeyAuthOption

이름	묘사	값
aadAuthFailureMode	인증에 실패한 요청에 대해 검색 서비스의 데이터 평면 API가 보내는 응답에 대해 설명합니다.	'http401WithBearerChallenge' 'http403'

DataPlaneAuthOptions

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

EncryptionWithCmk

이름	묘사	값
집행	검색 서비스에서 고객 암호화되지 않은 리소스를 하나 이상 적용하는 방법을 설명합니다.	'사용 안 함' 'Enabled' '지정되지 않음'

신원

이름	묘사	값
형	ID 형식입니다.	'None' 'SystemAssigned'(필수)

IpRule

이름	묘사	값
값	단일 IPv4 주소(예: 123.1.2.3) 또는 CIDR 형식의 IP 범위(예: 123.1.2.3/24)에 해당하는 값입니다.	문자열

Microsoft.Search/searchServices

이름	묘사	값
신원	리소스의 ID입니다.	ID
위치	리소스가 있는 지리적 위치	string(필수)
이름	리소스 이름	string(필수)
속성	검색 서비스의 속성입니다.	SearchServiceProperties
sku	청구 속도 및 용량 제한을 결정하는 검색 서비스의 SKU입니다. 이 속성은 새 검색 서비스를 만들 때 필요합니다.	Sku
태그	리소스 태그	태그 이름 및 값의 사전입니다.
형	리소스 종류	"Microsoft.Search/searchServices@2023-11-01"

NetworkRuleSet

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

SearchServiceProperties

이름	묘사	값
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' 'free' 'standard'

Sku

이름	묘사	값
이름	검색 서비스의 SKU입니다. 유효한 값은 'free': 공유 서비스입니다. '기본': 최대 3개의 복제본이 있는 전용 서비스입니다. '표준': 최대 12개의 파티션과 12개의 복제본이 있는 전용 서비스입니다. 'standard2': 표준과 비슷하지만 검색 단위당 더 많은 용량이 있습니다. 'standard3': 최대 12개의 파티션과 12개의 복제본이 있는 가장 큰 표준 제품입니다(또는 hostingMode 속성을 'highDensity'로 설정한 경우 인덱스가 더 많은 파티션은 최대 3개). 'storage_optimized_l1': 파티션당 최대 12개의 파티션을 지원합니다. 'storage_optimized_l2': 파티션당 2TB, 최대 12개의 파티션을 지원합니다.'	'basic' 'free' 'standard' 'standard2' 'standard3' 'storage_optimized_l1' 'storage_optimized_l2'

TrackedResourceTags

이름	묘사	값

다음을 통해 공유

Microsoft.Search searchServices 2023-11-01

Bicep 리소스 정의

리소스 형식

속성 값

DataPlaneAadOrApiKeyAuthOption

DataPlaneAuthOptions

EncryptionWithCmk

신원

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

SearchServiceProperties

Sku

TrackedResourceTags

빠른 시작 샘플

ARM 템플릿 리소스 정의

리소스 형식

속성 값

DataPlaneAadOrApiKeyAuthOption

DataPlaneAuthOptions

EncryptionWithCmk

신원

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

SearchServiceProperties

Sku

TrackedResourceTags

빠른 시작 템플릿

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

리소스 형식

속성 값

DataPlaneAadOrApiKeyAuthOption

DataPlaneAuthOptions

EncryptionWithCmk

신원

IpRule

Microsoft.Search/searchServices

NetworkRuleSet

SearchServiceProperties

Sku

TrackedResourceTags

피드백

추가 리소스