Network Security Perimeter Configurations - Reconcile

Azure AI 검색 리소스 공급자에 대한 네트워크 보안 경계 구성을 조정합니다. 이렇게 하면 검색 서비스가 최신 구성을 전달하는지 확인하여 네트워크 보안 경계 구성과 수동 다시 동기화가 트리거됩니다.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/networkSecurityPerimeterConfigurations/{nspConfigName}/reconcile?api-version=2026-11-01

URI 매개 변수

속성 In(다음 안에) 필수 형식 Description
nspConfigName
path True

string

minLength: 38
maxLength: 100
pattern: ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}\.[a-z][a-z0-9]*$

네트워크 보안 경계 구성 이름입니다.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.

searchServiceName
path True

string

pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$

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

subscriptionId
path True

string (uuid)

대상 구독의 ID입니다. 값은 UUID여야 합니다.

api-version
query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.

응답

속성 형식 Description
202 Accepted

자원 작업이 허용되었습니다.

헤더

Location: string

Other Status Codes

CloudError

예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

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

범위

속성 Description
user_impersonation 사용자 계정을 사칭하다

예제

Reconcile NSP Config

샘플 요청

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/networkSecurityPerimeterConfigurations/00000001-2222-3333-4444-111144444444.assoc1/reconcile?api-version=2026-11-01

샘플 응답

Location: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/locations/westus/AsyncOperationResults/11111111-1111-1111-1111-111111111111

정의

속성 Description
CloudError

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

CloudErrorBody

오류 코드 및 메시지를 사용하여 특정 API 오류를 설명합니다.

CloudError

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

속성 형식 Description
error

CloudErrorBody

오류 코드 및 메시지를 사용하여 특정 API 오류를 설명합니다.

message

string

오류에 대한 간략한 설명은 무엇이 잘못되었는지를 암시합니다(세부 정보/디버깅 정보는 'error.message' 속성을 참조).

CloudErrorBody

오류 코드 및 메시지를 사용하여 특정 API 오류를 설명합니다.

속성 형식 Description
code

string

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

details

CloudErrorBody[]

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

message

string

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

target

string

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