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 |
|---|---|---|---|---|
|
nsp
|
path | True |
string minLength: 38maxLength: 100 pattern: ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}\.[a-z][a-z0-9]*$ |
네트워크 보안 경계 구성 이름입니다. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다. |
|
search
|
path | True |
string pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$ |
지정된 리소스 그룹과 연결된 Azure AI 검색 서비스의 이름입니다. |
|
subscription
|
path | True |
string (uuid) |
대상 구독의 ID입니다. 값은 UUID여야 합니다. |
|
api-version
|
query | True |
string minLength: 1 |
이 작업에 사용할 API 버전입니다. |
응답
| 속성 | 형식 | Description |
|---|---|---|
| 202 Accepted |
자원 작업이 허용되었습니다. 헤더 Location: string |
|
| Other Status Codes |
예기치 않은 오류 응답입니다. |
보안
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 |
|---|---|
|
Cloud |
API 오류에 대한 정보를 포함합니다. |
|
Cloud |
오류 코드 및 메시지를 사용하여 특정 API 오류를 설명합니다. |
CloudError
API 오류에 대한 정보를 포함합니다.
| 속성 | 형식 | Description |
|---|---|---|
| error |
오류 코드 및 메시지를 사용하여 특정 API 오류를 설명합니다. |
|
| message |
string |
오류에 대한 간략한 설명은 무엇이 잘못되었는지를 암시합니다(세부 정보/디버깅 정보는 'error.message' 속성을 참조). |
CloudErrorBody
오류 코드 및 메시지를 사용하여 특정 API 오류를 설명합니다.
| 속성 | 형식 | Description |
|---|---|---|
| code |
string |
HTTP 상태 코드보다 오류 조건을 보다 정확하게 설명하는 오류 코드입니다. 프로그래밍 방식으로 특정 오류 사례를 처리하는 데 사용할 수 있습니다. |
| details |
이 오류와 관련된 중첩된 오류를 포함합니다. |
|
| message |
string |
오류를 자세히 설명하고 디버깅 정보를 제공하는 메시지입니다. |
| target |
string |
특정 오류의 대상(예: 오류가 있는 속성의 이름)입니다. |