다음을 통해 공유

Services - Get

  • 참조
서비스:
Search Management
API 버전:
2023-11-01

지정된 리소스 그룹에서 지정된 이름의 검색 서비스를 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}?api-version=2023-11-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
resourceGroupName
 path True

string

현재 구독 내의 리소스 그룹 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.
searchServiceName
 path True

string

지정된 리소스 그룹과 연결된 검색 서비스의 이름입니다.
subscriptionId
 path True

string

Microsoft Azure 구독의 고유 식별자입니다. Azure Resource Manager API, 명령줄 도구 또는 포털에서 이 값을 가져올 수 있습니다.
api-version
 query True

string

각 요청에 사용할 API 버전입니다.

요청 헤더

Name 필수 형식 Description
x-ms-client-request-id

string

uuid

이 요청을 식별하는 클라이언트에서 생성한 GUID 값입니다. 지정된 경우 요청을 추적하는 방법으로 응답 정보에 포함됩니다.

응답

Name 형식 Description
200 OK

SearchService

검색 서비스 정의가 성공적으로 검색되었으며 응답에 있습니다. 프로비저닝 또는 크기 조정 작업의 완료를 폴링하는 경우 provisioningState 속성을 통해 상태 검사 수 있습니다.
Other Status Codes

CloudError

HTTP 404(찾을 수 없음): 구독, 리소스 그룹 또는 검색 서비스 이름을 찾을 수 없습니다.

보안

azure_auth

OAuth2 권한 부여 흐름을 Microsoft Entra ID.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

SearchGetService

샘플 요청

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2023-11-01

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice",
  "name": "mysearchservice",
  "location": "westus",
  "type": "Microsoft.Search/searchServices",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "status": "running",
    "statusDetails": "",
    "hostingMode": "default",
    "provisioningState": "succeeded",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": []
    },
    "privateEndpointConnections": []
  }
}

정의

Name Description
AadAuthFailureMode

인증에 실패한 요청에 대해 검색 서비스의 데이터 평면 API가 보낼 응답에 대해 설명합니다.
ApiKeyOnly

API 키만 인증에 사용할 수 있음을 나타냅니다.
CloudError

API 오류에 대한 정보를 포함합니다.
CloudErrorBody

오류 코드와 메시지가 있는 특정 API 오류를 설명합니다.
DataPlaneAadOrApiKeyAuthOption

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

검색 서비스가 데이터 평면 요청을 인증하는 방법에 대한 옵션을 정의합니다. 'disableLocalAuth'가 true로 설정된 경우에는 설정할 수 없습니다.
EncryptionWithCmk

검색 서비스 내의 리소스를 customer=managed key로 암호화하는 방법을 결정하는 정책을 설명합니다.
HostingMode

standard3 SKU에만 적용됩니다. 이 속성을 설정하여 최대 1,000개의 인덱스를 허용하는 최대 3개의 고밀도 파티션을 사용하도록 설정할 수 있습니다. 이는 다른 SKU에 허용되는 최대 인덱스보다 훨씬 높습니다. standard3 SKU의 경우 값은 'default' 또는 'highDensity'입니다. 다른 모든 SKU의 경우 이 값은 'default'여야 합니다.
Identity

리소스의 ID입니다.
IdentityType

ID 형식입니다.
IpRule

검색 서비스의 IP 제한 규칙입니다.
NetworkRuleSet

검색 서비스에 연결할 수 있는 방법을 결정하는 네트워크별 규칙입니다.
PrivateEndpoint

Microsoft.Network 공급자의 프라이빗 엔드포인트 리소스입니다.
PrivateEndpointConnection

검색 서비스에 대한 기존 프라이빗 엔드포인트 연결을 설명합니다.
PrivateEndpointConnectionProperties

검색 서비스에 대한 기존 프라이빗 엔드포인트 연결의 속성을 설명합니다.
PrivateLinkServiceConnectionProvisioningState

프라이빗 링크 서비스 연결의 프로비전 상태입니다. 유효한 값은 업데이트, 삭제, 실패, 성공 또는 불완전
PrivateLinkServiceConnectionState

Azure 프라이빗 엔드포인트에 대한 기존 Private Link Service 연결의 현재 상태를 설명합니다.
PrivateLinkServiceConnectionStatus

프라이빗 링크 서비스 연결의 상태입니다. 유효한 값은 보류 중, 승인됨, 거부됨 또는 연결 끊김입니다.
ProvisioningState

검색 서비스에서 수행된 마지막 프로비전 작업의 상태입니다. 프로비저닝은 서비스 용량을 설정하는 동안 발생하는 중간 상태입니다. 용량이 설정되면 provisioningState가 '성공' 또는 '실패'로 변경됩니다. 클라이언트 애플리케이션은 검색 서비스 가져오기 작업을 사용하여 프로비전 상태 폴링할 수 있습니다(권장 폴링 간격은 30초에서 1분). 무료 서비스를 사용하는 경우 이 값은 검색 서비스 만들기 호출에서 직접 '성공'으로 돌아오는 경향이 있습니다. 이는 무료 서비스가 이미 설정된 용량을 사용하기 때문입니다.
PublicNetworkAccess

이 값은 기존 고객 리소스 및 템플릿의 호환성이 손상되는 변경을 방지하기 위해 '사용'으로 설정할 수 있습니다. '사용 안 함'으로 설정하면 공용 인터페이스를 통해 트래픽이 허용되지 않으며 프라이빗 엔드포인트 연결이 단독 액세스 방법이 됩니다.
SearchEncryptionComplianceStatus

고객이 암호화하지 않은 리소스를 보유하는 것과 관련하여 검색 서비스가 규정을 준수하는지 여부를 설명합니다. 서비스에 고객 암호화되지 않은 리소스가 둘 이상 있고 '적용'이 '사용'인 경우 서비스는 '비규격'으로 표시됩니다.
SearchEncryptionWithCmk

검색 서비스에서 고객이 암호화하지 않은 리소스를 하나 이상 적용하는 방법을 설명합니다.
SearchSemanticSearch

의미 체계 검색의 가용성을 제어하는 옵션을 설정합니다. 이 구성은 특정 위치의 특정 검색 SKU에 대해서만 가능합니다.
SearchService

검색 서비스 및 현재 상태를 설명합니다.
SearchServiceStatus

검색 서비스의 상태. 가능한 값은 다음과 같습니다. '실행 중': 검색 서비스가 실행 중이며 프로비저닝 작업이 진행 중이 아닙니다. '프로비저닝': 검색 서비스가 프로비전되거나 확장 또는 축소되고 있습니다. '삭제 중': 검색 서비스가 삭제되고 있습니다. 'degraded': 검색 서비스가 저하되었습니다. 이 문제는 기본 검색 단위가 정상이 아닌 경우에 발생할 수 있습니다. 검색 서비스가 작동할 가능성이 높지만 성능이 느려지고 일부 요청이 삭제될 수 있습니다. 'disabled': 검색 서비스를 사용할 수 없습니다. 이 상태에서 서비스는 모든 AP 요청을 거부합니다. 'error': 검색 서비스가 오류 상태입니다. 서비스가 성능 저하, 사용 안 함 또는 오류 상태인 경우 Microsoft는 기본 문제를 적극적으로 조사하고 있습니다. 이러한 상태에서도 전용 서비스는 프로비저닝된 검색 단위 수에 따라 여전히 요금을 부과할 수 있습니다.
SharedPrivateLinkResource

검색 서비스에서 관리하는 공유 Private Link 리소스에 대해 설명합니다.
SharedPrivateLinkResourceProperties

검색 서비스에서 관리하는 기존 공유 Private Link 리소스의 속성을 설명합니다.
SharedPrivateLinkResourceProvisioningState

공유 프라이빗 링크 리소스의 프로비저닝 상태입니다. 유효한 값은 업데이트, 삭제, 실패, 성공 또는 불완전입니다.
SharedPrivateLinkResourceStatus

공유 프라이빗 링크 리소스의 상태입니다. 유효한 값은 보류 중, 승인됨, 거부됨 또는 연결 끊김입니다.
Sku

청구 속도 및 용량 제한을 결정하는 검색 서비스의 SKU를 정의합니다.
SkuName

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

AadAuthFailureMode

인증에 실패한 요청에 대해 검색 서비스의 데이터 평면 API가 보낼 응답에 대해 설명합니다.

Name 형식 Description
http401WithBearerChallenge

string

인증에 실패한 요청에 HTTP 상태 코드 401(권한 없음)이 표시되고 전달자 챌린지가 표시되어야 했음을 나타냅니다.
http403

string

인증에 실패한 요청에 HTTP 상태 코드 403(사용할 수 없음)이 표시되어야 했음을 나타냅니다.

ApiKeyOnly

API 키만 인증에 사용할 수 있음을 나타냅니다.

CloudError

API 오류에 대한 정보를 포함합니다.

Name 형식 Description
error

CloudErrorBody

오류 코드와 메시지가 있는 특정 API 오류를 설명합니다.

CloudErrorBody

오류 코드와 메시지가 있는 특정 API 오류를 설명합니다.

Name 형식 Description
code

string

HTTP 상태 코드보다 오류 조건을 보다 정확하게 설명하는 오류 코드입니다. 프로그래밍 방식으로 특정 오류 사례를 처리하는 데 사용할 수 있습니다.
details

CloudErrorBody[]

이 오류와 관련된 중첩된 오류를 포함합니다.
message

string

오류를 자세히 설명하고 디버깅 정보를 제공하는 메시지입니다.
target

string

특정 오류의 대상입니다(예: 오류에 있는 속성의 이름).

DataPlaneAadOrApiKeyAuthOption

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

Name 형식 Description
aadAuthFailureMode

AadAuthFailureMode

인증에 실패한 요청에 대해 검색 서비스의 데이터 평면 API가 보낼 응답에 대해 설명합니다.

DataPlaneAuthOptions

검색 서비스가 데이터 평면 요청을 인증하는 방법에 대한 옵션을 정의합니다. 'disableLocalAuth'가 true로 설정된 경우에는 설정할 수 없습니다.

Name 형식 Description
aadOrApiKey

DataPlaneAadOrApiKeyAuthOption

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

ApiKeyOnly

API 키만 인증에 사용할 수 있음을 나타냅니다.

EncryptionWithCmk

검색 서비스 내의 리소스를 customer=managed key로 암호화하는 방법을 결정하는 정책을 설명합니다.

Name 형식 Description
encryptionComplianceStatus

SearchEncryptionComplianceStatus

고객이 암호화하지 않은 리소스를 보유하는 것과 관련하여 검색 서비스가 규정을 준수하는지 여부를 설명합니다. 서비스에 고객 암호화되지 않은 리소스가 둘 이상 있고 '적용'이 '사용'인 경우 서비스는 '비규격'으로 표시됩니다.
enforcement

SearchEncryptionWithCmk

검색 서비스에서 고객이 암호화하지 않은 리소스를 하나 이상 적용하는 방법을 설명합니다.

HostingMode

standard3 SKU에만 적용됩니다. 이 속성을 설정하여 최대 1,000개의 인덱스를 허용하는 최대 3개의 고밀도 파티션을 사용하도록 설정할 수 있습니다. 이는 다른 SKU에 허용되는 최대 인덱스보다 훨씬 높습니다. standard3 SKU의 경우 값은 'default' 또는 'highDensity'입니다. 다른 모든 SKU의 경우 이 값은 'default'여야 합니다.

Name 형식 Description
default

string

인덱스 수에 대한 제한은 SKU의 기본 제한에 따라 결정됩니다.
highDensity

string

검색 서비스에 최대 1,000개의 인덱스가 있을 수 있는 standard3 SKU에 대한 애플리케이션입니다.

Identity

리소스의 ID입니다.

Name 형식 Description
principalId

string

검색 서비스의 시스템 할당 ID의 보안 주체 ID입니다.
tenantId

string

검색 서비스의 시스템 할당 ID의 테넌트 ID입니다.
type

IdentityType

ID 형식입니다.

IdentityType

ID 형식입니다.

Name 형식 Description
None

string

SystemAssigned

string

IpRule

검색 서비스의 IP 제한 규칙입니다.

Name 형식 Description
value

string

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

NetworkRuleSet

검색 서비스에 연결할 수 있는 방법을 결정하는 네트워크별 규칙입니다.

Name 형식 Description
ipRules

IpRule[]

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

PrivateEndpoint

Microsoft.Network 공급자의 프라이빗 엔드포인트 리소스입니다.

Name 형식 Description
id

string

Microsoft.Network 공급자의 프라이빗 엔드포인트 리소스의 리소스 ID입니다.

PrivateEndpointConnection

검색 서비스에 대한 기존 프라이빗 엔드포인트 연결을 설명합니다.

Name 형식 Description
id

string

리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name

string

리소스의 이름입니다.
properties

PrivateEndpointConnectionProperties

검색 서비스에 대한 기존 프라이빗 엔드포인트 연결의 속성을 설명합니다.
type

string

리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProperties

검색 서비스에 대한 기존 프라이빗 엔드포인트 연결의 속성을 설명합니다.

Name 형식 Description
groupId

string

프라이빗 링크 서비스 연결에 대한 리소스 공급자의 그룹 ID입니다.
privateEndpoint

PrivateEndpoint

Microsoft.Network 공급자의 프라이빗 엔드포인트 리소스입니다.
privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Azure 프라이빗 엔드포인트에 대한 기존 Private Link Service 연결의 현재 상태를 설명합니다.
provisioningState

PrivateLinkServiceConnectionProvisioningState

프라이빗 링크 서비스 연결의 프로비전 상태입니다. 유효한 값은 업데이트, 삭제, 실패, 성공 또는 불완전

PrivateLinkServiceConnectionProvisioningState

프라이빗 링크 서비스 연결의 프로비전 상태입니다. 유효한 값은 업데이트, 삭제, 실패, 성공 또는 불완전

Name 형식 Description
Canceled

string

프라이빗 링크 서비스 연결 리소스에 대한 프로비저닝 요청이 취소되었습니다.
Deleting

string

프라이빗 링크 서비스 연결이 삭제되는 중입니다.
Failed

string

프라이빗 링크 서비스 연결을 프로비전하거나 삭제하지 못했습니다.
Incomplete

string

프라이빗 링크 서비스 연결 리소스에 대한 프로비저닝 요청이 수락되었지만 생성 프로세스가 아직 시작되지 않았습니다.
Succeeded

string

프라이빗 링크 서비스 연결이 프로비저닝을 완료했으며 승인할 준비가 되었습니다.
Updating

string

프라이빗 링크 서비스 연결은 완전히 작동하기 위해 다른 리소스와 함께 생성되는 중입니다.

PrivateLinkServiceConnectionState

Azure 프라이빗 엔드포인트에 대한 기존 Private Link Service 연결의 현재 상태를 설명합니다.

Name 형식 Default value Description
actionsRequired

string

None

필요할 수 있는 추가 작업에 대한 설명입니다.
description

string

프라이빗 링크 서비스 연결 상태에 대한 설명입니다.
status

PrivateLinkServiceConnectionStatus

프라이빗 링크 서비스 연결의 상태입니다. 유효한 값은 보류 중, 승인됨, 거부됨 또는 연결 끊김입니다.

PrivateLinkServiceConnectionStatus

프라이빗 링크 서비스 연결의 상태입니다. 유효한 값은 보류 중, 승인됨, 거부됨 또는 연결 끊김입니다.

Name 형식 Description
Approved

string

프라이빗 엔드포인트 연결이 승인되었으며 사용할 준비가 된 것입니다.
Disconnected

string

프라이빗 엔드포인트 연결이 서비스에서 제거되었습니다.
Pending

string

프라이빗 엔드포인트 연결이 만들어졌으며 승인을 보류 중입니다.
Rejected

string

프라이빗 엔드포인트 연결이 거부되었으며 사용할 수 없습니다.

ProvisioningState

검색 서비스에서 수행된 마지막 프로비전 작업의 상태입니다. 프로비저닝은 서비스 용량을 설정하는 동안 발생하는 중간 상태입니다. 용량이 설정되면 provisioningState가 '성공' 또는 '실패'로 변경됩니다. 클라이언트 애플리케이션은 검색 서비스 가져오기 작업을 사용하여 프로비전 상태 폴링할 수 있습니다(권장 폴링 간격은 30초에서 1분). 무료 서비스를 사용하는 경우 이 값은 검색 서비스 만들기 호출에서 직접 '성공'으로 돌아오는 경향이 있습니다. 이는 무료 서비스가 이미 설정된 용량을 사용하기 때문입니다.

Name 형식 Description
failed

string

마지막 프로비저닝 작업이 실패했습니다.
provisioning

string

검색 서비스가 프로비전되거나 확장 또는 축소되고 있습니다.
succeeded

string

마지막 프로비전 작업이 성공적으로 완료되었습니다.

PublicNetworkAccess

이 값은 기존 고객 리소스 및 템플릿의 호환성이 손상되는 변경을 방지하기 위해 '사용'으로 설정할 수 있습니다. '사용 안 함'으로 설정하면 공용 인터페이스를 통해 트래픽이 허용되지 않으며 프라이빗 엔드포인트 연결이 단독 액세스 방법이 됩니다.

Name 형식 Description
disabled

string

enabled

string

SearchEncryptionComplianceStatus

고객이 암호화하지 않은 리소스를 보유하는 것과 관련하여 검색 서비스가 규정을 준수하는지 여부를 설명합니다. 서비스에 고객 암호화되지 않은 리소스가 둘 이상 있고 '적용'이 '사용'인 경우 서비스는 '비규격'으로 표시됩니다.

Name 형식 Description
Compliant

string

고객이 암호화하지 않은 리소스 수가 0이거나 적용이 비활성화되어 검색 서비스가 규정을 준수함을 나타냅니다.
NonCompliant

string

검색 서비스에 고객 암호화되지 않은 리소스가 둘 이상 있음을 나타냅니다.

SearchEncryptionWithCmk

검색 서비스에서 고객이 암호화하지 않은 리소스를 하나 이상 적용하는 방법을 설명합니다.

Name 형식 Description
Disabled

string

적용되지 않으며 검색 서비스에는 고객이 암호화되지 않은 리소스가 있을 수 있습니다.
Enabled

string

고객 암호화되지 않은 리소스가 하나 이상 있는 경우 Search Service 비준수로 표시됩니다.
Unspecified

string

적용 정책은 명시적으로 지정되지 않으며 동작은 '사용 안 함'으로 설정된 경우와 동일합니다.

SearchSemanticSearch

의미 체계 검색의 가용성을 제어하는 옵션을 설정합니다. 이 구성은 특정 위치의 특정 검색 SKU에 대해서만 가능합니다.

Name 형식 Description
disabled

string

검색 서비스에 대해 의미 체계 순위를 사용할 수 없음을 나타냅니다.
free

string

검색 서비스에서 의미 체계 순위를 사용하도록 설정하고 무료 계층의 한도 내에서 사용됨을 나타냅니다. 이는 의미 체계 순위 요청의 양을 제한하며 추가 비용 없이 제공됩니다. 새로 프로비전된 검색 서비스의 기본값입니다.
standard

string

더 높은 처리량과 의미 체계 순위 요청 볼륨을 사용하여 검색 서비스에서 의미 체계 순위를 청구 가능한 기능으로 사용하도록 설정합니다.

SearchService

검색 서비스 및 현재 상태를 설명합니다.

Name 형식 Default value Description
id

string

리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity

Identity

리소스의 ID입니다.
location

string

리소스가 있는 지리적 위치
name

string

리소스의 이름입니다.
properties.authOptions

DataPlaneAuthOptions

검색 서비스의 데이터 평면 API가 요청을 인증하는 방법에 대한 옵션을 정의합니다. 'disableLocalAuth'가 true로 설정된 경우에는 설정할 수 없습니다.
properties.disableLocalAuth

boolean

true로 설정하면 검색 서비스에 대한 호출이 인증에 API 키를 사용하는 것이 허용되지 않습니다. 'dataPlaneAuthOptions'가 정의된 경우 true로 설정할 수 없습니다.
properties.encryptionWithCmk

EncryptionWithCmk

검색 서비스 내에서 고객 관리자 키를 사용하여 리소스 암호화(예: 인덱스)에 대한 정책을 지정합니다.
properties.hostingMode

HostingMode

default

standard3 SKU에만 적용됩니다. 이 속성을 설정하여 최대 1,000개의 인덱스를 허용하는 최대 3개의 고밀도 파티션을 사용하도록 설정할 수 있습니다. 이는 다른 SKU에 허용되는 최대 인덱스보다 훨씬 높습니다. standard3 SKU의 경우 값은 'default' 또는 'highDensity'입니다. 다른 모든 SKU의 경우 이 값은 'default'여야 합니다.
properties.networkRuleSet

NetworkRuleSet

검색 서비스에 도달하는 방법을 결정하는 네트워크별 규칙입니다.
properties.partitionCount

integer

1

검색 서비스의 파티션 수입니다. 지정된 경우 1, 2, 3, 4, 6 또는 12일 수 있습니다. 1보다 큰 값은 표준 SKU에만 유효합니다. hostingMode가 'highDensity'로 설정된 'standard3' 서비스의 경우 허용되는 값은 1에서 3 사이입니다.
properties.privateEndpointConnections

PrivateEndpointConnection[]

검색 서비스에 대한 프라이빗 엔드포인트 연결 목록입니다.
properties.provisioningState

ProvisioningState

검색 서비스에서 수행된 마지막 프로비전 작업의 상태입니다. 프로비저닝은 서비스 용량을 설정하는 동안 발생하는 중간 상태입니다. 용량이 설정되면 provisioningState가 '성공' 또는 '실패'로 변경됩니다. 클라이언트 애플리케이션은 검색 서비스 가져오기 작업을 사용하여 프로비전 상태 폴링할 수 있습니다(권장 폴링 간격은 30초에서 1분). 무료 서비스를 사용하는 경우 이 값은 검색 서비스 만들기 호출에서 직접 '성공'으로 돌아오는 경향이 있습니다. 이는 무료 서비스가 이미 설정된 용량을 사용하기 때문입니다.
properties.publicNetworkAccess

PublicNetworkAccess

enabled

이 값은 기존 고객 리소스 및 템플릿의 호환성이 손상되는 변경을 방지하기 위해 '사용'으로 설정할 수 있습니다. '사용 안 함'으로 설정하면 공용 인터페이스를 통해 트래픽이 허용되지 않으며 프라이빗 엔드포인트 연결이 단독 액세스 방법이 됩니다.
properties.replicaCount

integer

1

검색 서비스의 복제본 수입니다. 지정된 경우 표준 SKU의 경우 1에서 12 사이의 값이거나 기본 SKU의 경우 1에서 3 사이여야 합니다.
properties.semanticSearch

SearchSemanticSearch

의미 체계 검색의 가용성을 제어하는 옵션을 설정합니다. 이 구성은 특정 위치의 특정 검색 SKU에 대해서만 가능합니다.
properties.sharedPrivateLinkResources

SharedPrivateLinkResource[]

검색 서비스에서 관리하는 공유 프라이빗 링크 리소스 목록입니다.
properties.status

SearchServiceStatus

검색 서비스의 상태. 가능한 값은 다음과 같습니다. '실행 중': 검색 서비스가 실행 중이며 프로비저닝 작업이 진행 중이 아닙니다. '프로비저닝': 검색 서비스가 프로비전되거나 확장 또는 축소되고 있습니다. '삭제 중': 검색 서비스가 삭제되고 있습니다. 'degraded': 검색 서비스가 저하되었습니다. 이 문제는 기본 검색 단위가 정상이 아닌 경우에 발생할 수 있습니다. 검색 서비스가 작동할 가능성이 높지만 성능이 느려지고 일부 요청이 삭제될 수 있습니다. 'disabled': 검색 서비스를 사용할 수 없습니다. 이 상태에서 서비스는 모든 AP 요청을 거부합니다. 'error': 검색 서비스가 오류 상태입니다. 서비스가 성능 저하, 사용 안 함 또는 오류 상태인 경우 Microsoft는 기본 문제를 적극적으로 조사하고 있습니다. 이러한 상태에서도 전용 서비스는 프로비저닝된 검색 단위 수에 따라 여전히 요금을 부과할 수 있습니다.
properties.statusDetails

string

검색 서비스의 세부 정보가 상태.
sku

Sku

청구 속도 및 용량 제한을 결정하는 검색 서비스의 SKU입니다. 이 속성은 새 검색 서비스를 만들 때 필요합니다.
tags

object

리소스 태그.
type

string

리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

SearchServiceStatus

검색 서비스의 상태. 가능한 값은 다음과 같습니다. '실행 중': 검색 서비스가 실행 중이며 프로비저닝 작업이 진행 중이 아닙니다. '프로비저닝': 검색 서비스가 프로비전되거나 확장 또는 축소되고 있습니다. '삭제 중': 검색 서비스가 삭제되고 있습니다. 'degraded': 검색 서비스가 저하되었습니다. 이 문제는 기본 검색 단위가 정상이 아닌 경우에 발생할 수 있습니다. 검색 서비스가 작동할 가능성이 높지만 성능이 느려지고 일부 요청이 삭제될 수 있습니다. 'disabled': 검색 서비스를 사용할 수 없습니다. 이 상태에서 서비스는 모든 AP 요청을 거부합니다. 'error': 검색 서비스가 오류 상태입니다. 서비스가 성능 저하, 사용 안 함 또는 오류 상태인 경우 Microsoft는 기본 문제를 적극적으로 조사하고 있습니다. 이러한 상태에서도 전용 서비스는 프로비저닝된 검색 단위 수에 따라 여전히 요금을 부과할 수 있습니다.

Name 형식 Description
degraded

string

기본 검색 단위가 정상이 아니므로 검색 서비스가 저하됩니다.
deleting

string

검색 서비스가 삭제되고 있습니다.
disabled

string

검색 서비스가 비활성화되고 모든 API 요청이 거부됩니다.
error

string

검색 서비스가 오류 상태이며 프로비전 실패 또는 삭제됨을 나타냅니다.
provisioning

string

검색 서비스가 프로비전되거나 확장 또는 축소되고 있습니다.
running

string

검색 서비스가 실행 중이며 프로비저닝 작업이 진행 중이 아닙니다.

SharedPrivateLinkResource

검색 서비스에서 관리하는 공유 Private Link 리소스에 대해 설명합니다.

Name 형식 Description
id

string

리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name

string

리소스의 이름입니다.
properties

SharedPrivateLinkResourceProperties

검색 서비스에서 관리하는 공유 Private Link 리소스의 속성을 설명합니다.
type

string

리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

SharedPrivateLinkResourceProperties

검색 서비스에서 관리하는 기존 공유 Private Link 리소스의 속성을 설명합니다.

Name 형식 Description
groupId

string

공유 프라이빗 링크 리소스가 있는 리소스 공급자의 그룹 ID입니다.
privateLinkResourceId

string

공유 프라이빗 링크 리소스의 리소스 ID입니다.
provisioningState

SharedPrivateLinkResourceProvisioningState

공유 프라이빗 링크 리소스의 프로비저닝 상태입니다. 유효한 값은 업데이트, 삭제, 실패, 성공 또는 불완전입니다.
requestMessage

string

공유 프라이빗 링크 리소스의 승인을 요청하기 위한 요청 메시지입니다.
resourceRegion

string

선택 사항입니다. 공유 프라이빗 링크를 만들 리소스의 Azure Resource Manager 위치를 지정하는 데 사용할 수 있습니다. DNS 구성이 지역(예: Azure Kubernetes Service)인 리소스에만 필요합니다.
status

SharedPrivateLinkResourceStatus

공유 프라이빗 링크 리소스의 상태입니다. 유효한 값은 보류 중, 승인됨, 거부됨 또는 연결 끊김입니다.

SharedPrivateLinkResourceProvisioningState

공유 프라이빗 링크 리소스의 프로비저닝 상태입니다. 유효한 값은 업데이트, 삭제, 실패, 성공 또는 불완전입니다.

Name 형식 Description
Deleting

string

Failed

string

Incomplete

string

Succeeded

string

Updating

string

SharedPrivateLinkResourceStatus

공유 프라이빗 링크 리소스의 상태입니다. 유효한 값은 보류 중, 승인됨, 거부됨 또는 연결 끊김입니다.

Name 형식 Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

Sku

청구 속도 및 용량 제한을 결정하는 검색 서비스의 SKU를 정의합니다.

Name 형식 Description
name

SkuName

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

SkuName

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

Name 형식 Description
basic

string

최대 3개의 복제본이 있는 전용 서비스에 대한 청구 가능 계층입니다.
free

string

SLA 보장이 없고 청구 가능한 계층에서 제공되는 기능의 하위 집합이 있는 무료 계층입니다.
standard

string

최대 12개의 파티션과 12개의 복제본이 있는 전용 서비스에 대한 청구 가능 계층입니다.
standard2

string

'표준'과 비슷하지만 검색 단위당 더 많은 용량이 있습니다.
standard3

string

최대 12개의 파티션과 12개의 복제본이 있는 가장 큰 표준 제품(또는 hostingMode 속성을 'highDensity'로 설정하는 경우 인덱스가 더 많은 파티션을 최대 3개).
storage_optimized_l1

string

파티션당 1TB(최대 12개의 파티션)를 지원하는 전용 서비스에 대한 청구 가능 계층입니다.
storage_optimized_l2

string

파티션당 최대 12개의 파티션을 지원하는 전용 서비스에 대한 청구 가능 계층입니다.