Query Keys - Create

지정된 검색 서비스에 대한 새 쿼리 키를 생성합니다. 서비스당 최대 50개의 쿼리 키를 만들 수 있습니다.

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

URI 매개 변수

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

string

새 쿼리 API 키의 이름입니다.

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

QueryKey

쿼리 키가 성공적으로 만들어졌으며 응답에 있습니다. 쿼리 키를 데이터 평면 REST API 또는 Azure SDK의 'api-key' 매개 변수 값으로 사용하여 ID로 문서 쿼리 및 조회와 같은 검색 인덱스에서 읽기 전용 작업을 수행할 수 있습니다.

Other Status Codes

CloudError

HTTP 404(찾을 수 없음): 구독, 리소스 그룹 또는 검색 서비스를 찾을 수 없습니다. HTTP 409(충돌): 지정된 구독을 사용할 수 없습니다.

보안

azure_auth

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

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

SearchCreateQueryKey

Sample Request

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/createQueryKey/Query key for browser-based clients?api-version=2023-11-01

Sample Response

{
  "name": "Query key for browser-based clients",
  "key": "<a query API key>"
}

정의

Name Description
CloudError

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

CloudErrorBody

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

QueryKey

쿼리 작업에 대한 권한만 있는 지정된 검색 서비스에 대한 API 키를 설명합니다.

CloudError

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

Name 형식 Description
error

CloudErrorBody

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

CloudErrorBody

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

Name 형식 Description
code

string

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

details

CloudErrorBody[]

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

message

string

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

target

string

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

QueryKey

쿼리 작업에 대한 권한만 있는 지정된 검색 서비스에 대한 API 키를 설명합니다.

Name 형식 Description
key

string

쿼리 API 키의 값입니다.

name

string

쿼리 API 키의 이름입니다. 비어 있을 수 있습니다.