Services - Create Or Update

참조

서비스:: Search Management

API 버전:: 2025-05-01

지정된 리소스 그룹에서 검색 서비스를 만들거나 업데이트합니다. 검색 서비스가 이미 있는 경우 모든 속성이 지정된 값으로 업데이트됩니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string	현재 구독 내의 리소스 그룹의 이름입니다. Azure Resource Manager API 또는 포털에서 이 값을 가져올 수 있습니다.
searchServiceName	path	True	string	만들거나 업데이트할 Azure AI Search 서비스의 이름입니다. 검색 서비스 이름은 소문자, 숫자 또는 대시만 포함해야 하며, 처음 두 문자 또는 마지막 한 문자로 대시를 사용할 수 없고, 연속 대시를 포함할 수 없으며, 길이가 2~60자 사이여야 합니다. 검색 서비스 이름은 서비스 URI의 일부이므로 고유해야 합니다(https://.search.windows.net). 서비스를 만든 후에는 서비스 이름을 변경할 수 없습니다.
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
location	True	string	The geo-location where the resource lives
identity		Identity	The identity of the resource.
properties.authOptions		DataPlaneAuthOptions	검색 서비스의 데이터 평면 API가 요청을 인증하는 방법에 대한 옵션을 정의합니다. 'disableLocalAuth'가 true로 설정된 경우에는 설정할 수 없습니다.
properties.computeType		ComputeType	기본 컴퓨팅 또는 Azure 기밀 컴퓨팅을 사용하여 검색 서비스를 지원하도록 이 속성을 구성합니다.
properties.dataExfiltrationProtections		SearchDataExfiltrationProtection[]	검색 서비스에 대해 명시적으로 허용되지 않는 데이터 반출 시나리오 목록입니다. 현재 지원되는 유일한 값은 'All'으로, 향후 더 세분화된 컨트롤을 사용하여 가능한 모든 데이터 내보내기 시나리오를 사용하지 않도록 설정합니다.
properties.disableLocalAuth		boolean	true로 설정하면 검색 서비스에 대한 호출이 인증에 API 키를 활용하는 것이 허용되지 않습니다. 'dataPlaneAuthOptions'가 정의된 경우에는 true로 설정할 수 없습니다.
properties.encryptionWithCmk		EncryptionWithCmk	검색 서비스 내에서 고객 관리자 키를 사용하여 리소스 암호화(예: 인덱스)에 대한 정책을 지정합니다.
properties.endpoint		string (uri)	Azure AI Search 서비스의 엔드포인트입니다.
properties.hostingMode		HostingMode	standard3 SKU에만 적용됩니다. 최대 1,000개의 인덱스를 허용하는 최대 3개의 고밀도 파티션을 사용하도록 이 속성을 설정할 수 있습니다. 이는 다른 SKU에 허용되는 최대 인덱스보다 훨씬 높습니다. standard3 SKU의 경우 값은 'default' 또는 'highDensity'입니다. 다른 모든 SKU의 경우 이 값은 'default'여야 합니다.
properties.networkRuleSet		NetworkRuleSet	Azure AI Search 서비스에 도달하는 방법을 결정하는 네트워크별 규칙입니다.
properties.partitionCount		integer (int32) minimum: 1 maximum: 12	검색 서비스의 파티션 수입니다. 지정된 경우 1, 2, 3, 4, 6 또는 12일 수 있습니다. 1보다 큰 값은 표준 SKU에만 유효합니다. hostingMode가 'highDensity'로 설정된 'standard3' 서비스의 경우 허용되는 값은 1에서 3 사이입니다.
properties.publicNetworkAccess		PublicNetworkAccess	이 값은 기존 고객 리소스 및 템플릿의 호환성이 손상되는 변경을 방지하기 위해 '사용'으로 설정할 수 있습니다. 'disabled'로 설정하면 공용 인터페이스를 통해 트래픽이 허용되지 않으며 프라이빗 엔드포인트 연결은 배타적인 액세스 방법이 됩니다.
properties.replicaCount		integer (int32) minimum: 1 maximum: 12	검색 서비스의 복제본 수입니다. 지정된 경우 표준 SKU의 경우 1에서 12 사이의 값이거나 기본 SKU의 경우 1에서 3 사이여야 합니다.
properties.semanticSearch		SearchSemanticSearch	의미 체계 검색의 가용성을 제어하는 옵션을 설정합니다. 이 구성은 특정 위치의 특정 Azure AI Search SKU에 대해서만 가능합니다.
properties.upgradeAvailable		UpgradeAvailable	검색 서비스에 사용 가능한 업그레이드가 있는지를 나타냅니다.
sku		Sku	가격 계층 및 용량 제한을 결정하는 검색 서비스의 SKU입니다. 이 속성은 새 검색 서비스를 만들 때 필요합니다.
tags		object	리소스 태그.

응답

Name	형식	Description
200 OK	SearchService	기존 서비스 정의가 성공적으로 업데이트되었습니다. 복제본 또는 파티션 수를 변경한 경우 크기 조정 작업이 비동기적으로 수행됩니다. 서비스 가져오기 요청에 대한 응답에서 반환된 provisioningState 속성을 통해 크기 조정 작업의 상태를 확인할 수 있습니다.
201 Created	SearchService	무료 검색 서비스 만들기를 요청한 경우 이제 DNS 전파 지연에 따라 서비스가 프로비전되고 사용할 준비가 되었습니다. 다른 SKU 형식의 경우 프로비전이 비동기적으로 수행됩니다. 서비스 가져오기 요청에 대한 응답에서 반환된 provisioningState 속성을 통해 크기 조정 작업의 상태를 확인할 수 있습니다.
Other Status Codes	CloudError	HTTP 400(잘못된 요청): 지정된 서비스 이름 또는 서비스 정의가 잘못되었습니다. 자세한 내용은 응답의 오류 코드 및 메시지를 참조하세요. HTTP 404(찾을 수 없음): 구독 또는 리소스 그룹을 찾을 수 없습니다. HTTP 409(충돌): 지정된 구독을 사용할 수 없습니다.

보안

azure_auth

Microsoft ID 플랫폼에서 지원되는 암시적 허용 흐름을 지정합니다.

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

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

SearchCreateOrUpdateService

SearchCreateOrUpdateServiceAuthOptions

SearchCreateOrUpdateServiceDisableLocalAuth

SearchCreateOrUpdateServiceToAllowAccessFromPrivateEndpoints

SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPs

SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPsAndBypass

SearchCreateOrUpdateServiceWithCmkEnforcement

SearchCreateOrUpdateServiceWithDataExfiltration

SearchCreateOrUpdateServiceWithIdentity

SearchCreateOrUpdateWithSemanticSearch

SearchCreateOrUpdateService

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "hostingMode": "default",
    "computeType": "default"
  }
}

샘플 응답

상태 코드:: 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,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "dataExfiltrationProtections": [],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

상태 코드:: 201

{
  "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,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "dataExfiltrationProtections": [],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

SearchCreateOrUpdateServiceAuthOptions

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "hostingMode": "default",
    "computeType": "default",
    "authOptions": {
      "aadOrApiKey": {
        "aadAuthFailureMode": "http401WithBearerChallenge"
      }
    }
  }
}

샘플 응답

상태 코드:: 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,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "authOptions": {
      "aadOrApiKey": {
        "aadAuthFailureMode": "http401WithBearerChallenge"
      }
    },
    "dataExfiltrationProtections": [],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

상태 코드:: 201

{
  "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,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "authOptions": {
      "aadOrApiKey": {
        "aadAuthFailureMode": "http401WithBearerChallenge"
      }
    },
    "dataExfiltrationProtections": [],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

SearchCreateOrUpdateServiceDisableLocalAuth

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "hostingMode": "default",
    "computeType": "default",
    "disableLocalAuth": true
  }
}

샘플 응답

상태 코드:: 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,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": true,
    "authOptions": null,
    "dataExfiltrationProtections": [],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

상태 코드:: 201

{
  "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,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": true,
    "authOptions": null,
    "dataExfiltrationProtections": [],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

SearchCreateOrUpdateServiceToAllowAccessFromPrivateEndpoints

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "publicNetworkAccess": "disabled",
    "hostingMode": "default",
    "computeType": "default"
  }
}

샘플 응답

상태 코드:: 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,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "disabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "dataExfiltrationProtections": [],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

상태 코드:: 201

{
  "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,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "disabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "dataExfiltrationProtections": [],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPs

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 1,
    "partitionCount": 1,
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ]
    },
    "hostingMode": "default",
    "computeType": "default"
  }
}

샘플 응답

상태 코드:: 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": 1,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ]
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "dataExfiltrationProtections": [],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

상태 코드:: 201

{
  "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": 1,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ]
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "dataExfiltrationProtections": [],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPsAndBypass

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 1,
    "partitionCount": 1,
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ],
      "bypass": "AzureServices"
    },
    "hostingMode": "default",
    "computeType": "default"
  }
}

샘플 응답

상태 코드:: 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": 1,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ],
      "bypass": "AzureServices"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "dataExfiltrationProtections": [],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

상태 코드:: 201

{
  "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": 1,
    "partitionCount": 1,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [
        {
          "value": "123.4.5.6"
        },
        {
          "value": "123.4.6.0/18"
        }
      ],
      "bypass": "AzureServices"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "dataExfiltrationProtections": [],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

SearchCreateOrUpdateServiceWithCmkEnforcement

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "hostingMode": "default",
    "computeType": "default",
    "encryptionWithCmk": {
      "enforcement": "Enabled"
    }
  }
}

샘플 응답

상태 코드:: 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,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Enabled",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "dataExfiltrationProtections": [],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

상태 코드:: 201

{
  "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,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Enabled",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "dataExfiltrationProtections": [],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

SearchCreateOrUpdateServiceWithDataExfiltration

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "hostingMode": "default",
    "computeType": "default",
    "dataExfiltrationProtections": [
      "BlockAll"
    ]
  }
}

샘플 응답

상태 코드:: 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,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "dataExfiltrationProtections": [
      "BlockAll"
    ],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

상태 코드:: 201

{
  "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,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "dataExfiltrationProtections": [
      "BlockAll"
    ],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

SearchCreateOrUpdateServiceWithIdentity

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "hostingMode": "default",
    "computeType": "default"
  },
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/user-mi": {}
    }
  }
}

샘플 응답

상태 코드:: 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,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "dataExfiltrationProtections": [],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "principalId": "9d1e1f18-2122-4988-a11c-878782e40a5c",
    "tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/user-mi": {
        "clientId": "cd1dcac8-82dd-45b5-9aed-76795d529f6b",
        "principalId": "24e07a75-1286-41e5-a15d-ded85ec3acd7"
      }
    }
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

상태 코드:: 201

{
  "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,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "dataExfiltrationProtections": [],
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "principalId": "9d1e1f18-2122-4988-a11c-878782e40a5c",
    "tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd",
    "userAssignedIdentities": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/user-mi": {
        "clientId": "cd1dcac8-82dd-45b5-9aed-76795d529f6b",
        "principalId": "24e07a75-1286-41e5-a15d-ded85ec3acd7"
      }
    }
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

SearchCreateOrUpdateWithSemanticSearch

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01

{
  "location": "westus",
  "tags": {
    "app-name": "My e-commerce app"
  },
  "sku": {
    "name": "standard"
  },
  "properties": {
    "replicaCount": 3,
    "partitionCount": 1,
    "hostingMode": "default",
    "computeType": "default",
    "semanticSearch": "free"
  }
}

샘플 응답

상태 코드:: 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,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "dataExfiltrationProtections": [],
    "semanticSearch": "free",
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

상태 코드:: 201

{
  "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,
    "endpoint": "https://mysearchservice.search.windows.net/",
    "status": "provisioning",
    "statusDetails": "",
    "hostingMode": "default",
    "computeType": "default",
    "provisioningState": "provisioning",
    "publicNetworkAccess": "enabled",
    "networkRuleSet": {
      "ipRules": [],
      "bypass": "None"
    },
    "privateEndpointConnections": [],
    "sharedPrivateLinkResources": [],
    "encryptionWithCmk": {
      "enforcement": "Unspecified",
      "encryptionComplianceStatus": "Compliant"
    },
    "disableLocalAuth": false,
    "authOptions": {
      "apiKeyOnly": {}
    },
    "dataExfiltrationProtections": [],
    "semanticSearch": "free",
    "upgradeAvailable": "notAvailable",
    "serviceUpgradedAt": null
  },
  "systemData": {
    "createdBy": "My e-commerce app",
    "createdByType": "Application",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastModifiedBy": "fakeuser@contoso.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-11-01T00:00:00Z"
  }
}

정의

Name	Description
AadAuthFailureMode	인증에 실패한 요청에 대해 검색 서비스의 데이터 평면 API가 보내는 응답에 대해 설명합니다.
ApiKeyOnly	API 키만 인증에 사용할 수 있음을 나타냅니다.
CloudError	API 오류에 대한 정보를 포함합니다.
CloudErrorBody	오류 코드 및 메시지를 사용하여 특정 API 오류를 설명합니다.
ComputeType	기본 컴퓨팅 또는 Azure 기밀 컴퓨팅을 사용하여 검색 서비스를 지원하도록 이 속성을 구성합니다.
createdByType	리소스를 만든 ID의 형식입니다.
DataPlaneAadOrApiKeyAuthOption	Microsoft Entra ID 테넌트에서 API 키 또는 액세스 토큰을 인증에 사용할 수 있음을 나타냅니다.
DataPlaneAuthOptions	검색 서비스가 데이터 평면 요청을 인증하는 방법에 대한 옵션을 정의합니다. 'disableLocalAuth'가 true로 설정된 경우에는 설정할 수 없습니다.
EncryptionWithCmk	검색 서비스 내의 리소스를 고객 관리형 키로 암호화하는 방법을 결정하는 정책을 설명합니다.
HostingMode	standard3 SKU에만 적용됩니다. 최대 1,000개의 인덱스를 허용하는 최대 3개의 고밀도 파티션을 사용하도록 이 속성을 설정할 수 있습니다. 이는 다른 SKU에 허용되는 최대 인덱스보다 훨씬 높습니다. standard3 SKU의 경우 값은 'default' 또는 'highDensity'입니다. 다른 모든 SKU의 경우 이 값은 'default'여야 합니다.
Identity	검색 서비스 ID에 대한 세부 정보입니다. null 값은 검색 서비스에 할당된 ID가 없음을 나타냅니다.
IdentityType	The type of identity used for the resource. 'SystemAssigned, UserAssigned' 유형에는 시스템에서 만든 ID와 사용자 할당 ID 세트가 모두 포함되어 있습니다. 'None' 형식은 서비스에서 모든 ID를 제거합니다.
IpRule	Azure AI Search 서비스의 IP 제한 규칙입니다.
NetworkRuleSet	Azure AI Search 서비스에 도달하는 방법을 결정하는 네트워크별 규칙입니다.
PrivateEndpoint	Microsoft.Network 공급자의 프라이빗 엔드포인트 리소스입니다.
PrivateEndpointConnection	Azure AI Search 서비스에 대한 기존 프라이빗 엔드포인트 연결을 설명합니다.
PrivateEndpointConnectionProperties	검색 서비스에 대한 기존 프라이빗 엔드포인트 연결의 속성을 설명합니다.
PrivateLinkServiceConnectionProvisioningState	프라이빗 링크 서비스 연결의 프로비전 상태입니다. 유효한 값은 업데이트, 삭제, 실패, 성공, 불완전 또는 취소입니다.
PrivateLinkServiceConnectionState	프라이빗 엔드포인트에 대한 기존 Azure Private Link 서비스 연결의 현재 상태를 설명합니다.
PrivateLinkServiceConnectionStatus	프라이빗 링크 서비스 연결의 상태입니다. 유효한 값은 보류 중, 승인됨, 거부됨 또는 연결 끊김입니다.
ProvisioningState	검색 서비스에서 수행된 마지막 프로비전 작업의 상태입니다. 프로비전은 서비스 용량이 설정되는 동안 발생하는 중간 상태입니다. 용량이 설정되면 provisioningState가 '성공' 또는 '실패'로 변경됩니다. 클라이언트 애플리케이션은 검색 서비스 가져오기 작업을 사용하여 작업이 완료된 시기를 확인하여 프로비저닝 상태를 폴링할 수 있습니다(권장 폴링 간격은 30초에서 1분). 무료 서비스를 사용하는 경우 이 값은 검색 서비스 만들기 호출에서 직접 '성공'으로 돌아오는 경향이 있습니다. 이는 무료 서비스가 이미 설정된 용량을 사용하기 때문입니다.
PublicNetworkAccess	이 값은 기존 고객 리소스 및 템플릿의 호환성이 손상되는 변경을 방지하기 위해 '사용'으로 설정할 수 있습니다. 'disabled'로 설정하면 공용 인터페이스를 통해 트래픽이 허용되지 않으며 프라이빗 엔드포인트 연결은 배타적인 액세스 방법이 됩니다.
SearchBypass	'ipRules' 섹션에 정의된 규칙을 무시할 수 있는 인바운드 트래픽의 가능한 원본입니다.
SearchDataExfiltrationProtection	검색 서비스에 대해 명시적으로 허용되지 않는 데이터 반출 시나리오 목록입니다. 현재 지원되는 유일한 값은 'All'으로, 향후 더 세분화된 컨트롤을 사용하여 가능한 모든 데이터 내보내기 시나리오를 사용하지 않도록 설정합니다.
SearchEncryptionComplianceStatus	CMK 암호화되지 않은 개체와 관련하여 검색 서비스 준수 상태를 반환합니다. 서비스에 암호화되지 않은 개체가 두 개 이상 있고 적용이 설정된 경우 서비스는 비준수로 표시됩니다.
SearchEncryptionWithCmk	고객 관리형 키로 암호화되지 않은 개체를 찾은 경우 검색 서비스가 규정 준수를 적용하는 방법을 설명합니다.
SearchSemanticSearch	의미 체계 검색의 가용성을 제어하는 옵션을 설정합니다. 이 구성은 특정 위치의 특정 Azure AI Search SKU에 대해서만 가능합니다.
SearchService	Azure AI Search 서비스 및 현재 상태를 설명합니다.
SearchServiceStatus	검색 서비스의 상태입니다. 가능한 값은 '실행 중'입니다. 검색 서비스가 실행 중이며 프로비저닝 작업이 진행 중이 아닙니다. '프로비저닝': 검색 서비스가 프로비전되거나 확장 또는 축소되고 있습니다. '삭제 중': 검색 서비스가 삭제되고 있습니다. '성능 저하': 검색 서비스가 저하되었습니다. 이 문제는 기본 검색 단위가 정상이 아닌 경우에 발생할 수 있습니다. 검색 서비스가 작동할 가능성이 높지만 성능이 느려지고 일부 요청이 삭제될 수 있습니다. 'disabled': 검색 서비스를 사용할 수 없습니다. 이 상태에서 서비스는 모든 API 요청을 거부합니다. 'error': 검색 서비스가 오류 상태입니다. '중지됨': 검색 서비스가 비활성화된 구독에 있습니다. 서비스가 성능 저하, 사용 안 함 또는 오류 상태인 경우 Azure AI Search 팀이 기본 문제를 적극적으로 조사하고 있다는 의미입니다. 이러한 상태의 전용 서비스는 프로비전된 검색 단위 수에 따라 요금이 청구됩니다.
SharedPrivateLinkResource	Azure AI Search 서비스에서 관리하는 공유 프라이빗 링크 리소스에 대해 설명합니다.
SharedPrivateLinkResourceProperties	Azure AI Search 서비스에서 관리하는 기존 공유 프라이빗 링크 리소스의 속성을 설명합니다.
SharedPrivateLinkResourceProvisioningState	공유 프라이빗 링크 리소스의 프로비전 상태입니다. 유효한 값은 업데이트, 삭제, 실패, 성공 또는 불완전한 값입니다.
SharedPrivateLinkResourceStatus	Status of the shared private link resource. 유효한 값은 보류 중, 승인됨, 거부됨 또는 연결 끊김입니다.
Sku	청구 속도 및 용량 제한을 결정하는 검색 서비스의 SKU를 정의합니다.
SkuName	검색 서비스의 SKU입니다. 유효한 값은 'free': 공유 서비스입니다. '기본': 최대 3개의 복제본이 있는 전용 서비스입니다. '표준': 최대 12개의 파티션과 12개의 복제본이 있는 전용 서비스입니다. 'standard2': 표준과 비슷하지만 검색 단위당 더 많은 용량이 있습니다. 'standard3': 최대 12개의 파티션과 12개의 복제본이 있는 가장 큰 표준 제품입니다(또는 hostingMode 속성을 'highDensity'로 설정한 경우 인덱스가 더 많은 파티션은 최대 3개). 'storage_optimized_l1': 파티션당 최대 12개의 파티션을 지원합니다. 'storage_optimized_l2': 파티션당 2TB, 최대 12개의 파티션을 지원합니다.'
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
UpgradeAvailable	검색 서비스에 사용 가능한 업그레이드가 있는지를 나타냅니다.
UserAssignedIdentity	사용자 할당 ID 속성

AadAuthFailureMode

열거형

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

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

ApiKeyOnly

Object

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

CloudError

Object

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

Name	형식	Description
error	CloudErrorBody	오류 코드 및 메시지를 사용하여 특정 API 오류를 설명합니다.
message	string	오류에 대한 간략한 설명은 무엇이 잘못되었는지를 암시합니다(세부 정보/디버깅 정보는 'error.message' 속성을 참조).

CloudErrorBody

Object

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

Name	형식	Description
code	string	HTTP 상태 코드보다 오류 조건을 보다 정확하게 설명하는 오류 코드입니다. 프로그래밍 방식으로 특정 오류 사례를 처리하는 데 사용할 수 있습니다.
details	CloudErrorBody[]	이 오류와 관련된 중첩된 오류를 포함합니다.
message	string	오류를 자세히 설명하고 디버깅 정보를 제공하는 메시지입니다.
target	string	특정 오류의 대상입니다(예: 오류에 있는 속성의 이름).

ComputeType

열거형

기본 컴퓨팅 또는 Azure 기밀 컴퓨팅을 사용하여 검색 서비스를 지원하도록 이 속성을 구성합니다.

값	Description
confidential	Azure Confidential Compute를 사용하여 서비스를 만듭니다.
default	기본 컴퓨팅을 사용하여 서비스를 만듭니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
Application
Key
ManagedIdentity
User

DataPlaneAadOrApiKeyAuthOption

Object

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

Name	형식	Description
aadAuthFailureMode	AadAuthFailureMode	인증에 실패한 요청에 대해 검색 서비스의 데이터 평면 API가 보내는 응답에 대해 설명합니다.

DataPlaneAuthOptions

Object

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

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

EncryptionWithCmk

Object

검색 서비스 내의 리소스를 고객 관리형 키로 암호화하는 방법을 결정하는 정책을 설명합니다.

Name	형식	Description
encryptionComplianceStatus	SearchEncryptionComplianceStatus	CMK 암호화되지 않은 개체와 관련하여 검색 서비스 준수 상태를 반환합니다. 서비스에 암호화되지 않은 개체가 두 개 이상 있고 적용이 설정된 경우 서비스는 비준수로 표시됩니다.
enforcement	SearchEncryptionWithCmk	고객 관리형 키로 암호화되지 않은 개체를 찾은 경우 검색 서비스가 규정 준수를 적용하는 방법을 설명합니다.

HostingMode

열거형

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

값	Description
default	인덱스 수에 대한 제한은 SKU의 기본 제한에 따라 결정됩니다.
highDensity	검색 서비스에 최대 1000개의 인덱스를 포함할 수 있는 standard3 SKU에 대한 애플리케이션만 해당합니다.

Identity

Object

검색 서비스 ID에 대한 세부 정보입니다. null 값은 검색 서비스에 할당된 ID가 없음을 나타냅니다.

Name	형식	Description
principalId	string	검색 서비스의 시스템 할당 ID의 보안 주체 ID입니다.
tenantId	string	검색 서비스의 시스템 할당 ID의 테넌트 ID입니다.
type	IdentityType	The type of identity used for the resource. 'SystemAssigned, UserAssigned' 유형에는 시스템에서 만든 ID와 사용자 할당 ID 세트가 모두 포함되어 있습니다. 'None' 형식은 서비스에서 모든 ID를 제거합니다.
userAssignedIdentities	<string, UserAssignedIdentity>	The list of user identities associated with the resource. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다.

IdentityType

열거형

The type of identity used for the resource. 'SystemAssigned, UserAssigned' 유형에는 시스템에서 만든 ID와 사용자 할당 ID 세트가 모두 포함되어 있습니다. 'None' 형식은 서비스에서 모든 ID를 제거합니다.

값	Description
None	검색 서비스와 연결된 모든 ID를 제거해야 했음을 나타냅니다.
SystemAssigned	검색 서비스에 대한 시스템 할당 ID가 사용하도록 설정됨을 나타냅니다.
SystemAssigned, UserAssigned	하나 이상의 사용자 할당 ID 할당과 함께 검색 서비스에 대한 시스템 할당 ID가 사용하도록 설정됨을 나타냅니다.
UserAssigned	하나 이상의 사용자 할당 ID가 검색 서비스에 할당됨을 나타냅니다.

IpRule

Object

Azure AI Search 서비스의 IP 제한 규칙입니다.

Name	형식	Description
value	string	단일 IPv4 주소(예: 123.1.2.3) 또는 CIDR 형식의 IP 범위(예: 123.1.2.3/24)에 해당하는 값을 허용합니다.

NetworkRuleSet

Object

Azure AI Search 서비스에 도달하는 방법을 결정하는 네트워크별 규칙입니다.

Name	형식	Description
bypass	SearchBypass	'ipRules' 섹션에 정의된 규칙을 무시할 수 있는 인바운드 트래픽의 가능한 원본입니다.
ipRules	IpRule[]	검색 서비스 엔드포인트에 대한 액세스를 허용하는 인바운드 네트워크를 정의하는 IP 제한 규칙 목록입니다. 그 동안 다른 모든 공용 IP 네트워크는 방화벽에 의해 차단됩니다. 이러한 제한 규칙은 검색 서비스의 'publicNetworkAccess'가 '사용'된 경우에만 적용됩니다. 그렇지 않으면 공용 IP 규칙을 사용하는 경우에도 공용 인터페이스를 통해 트래픽이 허용되지 않으며 프라이빗 엔드포인트 연결은 배타적인 액세스 방법이 됩니다.

PrivateEndpoint

Object

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

Name	형식	Description
id	string	Microsoft.Network 공급자의 프라이빗 엔드포인트 리소스의 리소스 ID입니다.

PrivateEndpointConnection

Object

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

Name	형식	Description
id	string (arm-id)	Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	The name of the resource
properties	PrivateEndpointConnectionProperties	Azure AI Search 서비스에 대한 기존 프라이빗 엔드포인트 연결의 속성에 대해 설명합니다.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProperties

Object

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

Name	형식	Description
groupId	string	프라이빗 링크 서비스가 있는 Azure 리소스의 그룹 ID입니다.
privateEndpoint	PrivateEndpoint	Microsoft.Network 공급자의 프라이빗 엔드포인트 리소스입니다.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	프라이빗 엔드포인트에 대한 기존 Azure Private Link 서비스 연결의 현재 상태를 설명합니다.
provisioningState	PrivateLinkServiceConnectionProvisioningState	프라이빗 링크 서비스 연결의 프로비전 상태입니다. 유효한 값은 업데이트, 삭제, 실패, 성공, 불완전 또는 취소입니다.

PrivateLinkServiceConnectionProvisioningState

열거형

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

값	Description
Canceled	프라이빗 링크 서비스 연결 리소스에 대한 프로비저닝 요청이 취소되었습니다.
Deleting	프라이빗 링크 서비스 연결이 삭제되는 중입니다.
Failed	프라이빗 링크 서비스 연결을 프로비전하거나 삭제하지 못했습니다.
Incomplete	프라이빗 링크 서비스 연결 리소스에 대한 프로비저닝 요청이 수락되었지만 생성 프로세스가 아직 시작되지 않았습니다.
Succeeded	프라이빗 링크 서비스 연결이 프로비저닝을 완료했으며 승인할 준비가 되었습니다.
Updating	프라이빗 링크 서비스 연결은 완전히 작동하기 위해 다른 리소스와 함께 생성되는 중입니다.

PrivateLinkServiceConnectionState

Object

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

Name	형식	Default value	Description
actionsRequired	string	None	필요할 수 있는 추가 작업에 대한 설명입니다.
description	string		프라이빗 링크 서비스 연결 상태에 대한 설명입니다.
status	PrivateLinkServiceConnectionStatus		프라이빗 링크 서비스 연결의 상태입니다. 유효한 값은 보류 중, 승인됨, 거부됨 또는 연결 끊김입니다.

PrivateLinkServiceConnectionStatus

열거형

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

값	Description
Approved	프라이빗 엔드포인트 연결이 승인되었으며 사용할 준비가 된 것입니다.
Disconnected	프라이빗 엔드포인트 연결이 서비스에서 제거되었습니다.
Pending	프라이빗 엔드포인트 연결이 만들어졌으며 승인을 보류 중입니다.
Rejected	프라이빗 엔드포인트 연결이 거부되었으며 사용할 수 없습니다.

ProvisioningState

열거형

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

값	Description
failed	마지막 프로비전 작업이 실패했습니다.
provisioning	검색 서비스가 프로비전되거나 확장 또는 축소되고 있습니다.
succeeded	마지막 프로비전 작업이 성공적으로 완료되었습니다.

PublicNetworkAccess

열거형

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

값	Description
disabled	검색 서비스는 공용 인터넷에서 발생하는 트래픽에서 액세스할 수 없습니다. 승인된 프라이빗 엔드포인트 연결을 통해서만 액세스가 허용됩니다.
enabled	검색 서비스는 공용 인터넷에서 발생하는 트래픽에서 액세스할 수 있습니다.

SearchBypass

열거형

'ipRules' 섹션에 정의된 규칙을 무시할 수 있는 인바운드 트래픽의 가능한 원본입니다.

값	Description
AzureServices	Azure 신뢰할 수 있는 서비스에서 시작된 요청이 'ipRules' 섹션에 정의된 규칙을 무시할 수 있음을 나타냅니다.
None	원본이 'ipRules' 섹션에 정의된 규칙을 무시할 수 없음을 나타냅니다. 기본값입니다.

SearchDataExfiltrationProtection

열거형

검색 서비스에 대해 명시적으로 허용되지 않는 데이터 반출 시나리오 목록입니다. 현재 지원되는 유일한 값은 'All'으로, 향후 더 세분화된 컨트롤을 사용하여 가능한 모든 데이터 내보내기 시나리오를 사용하지 않도록 설정합니다.

값	Description
BlockAll	모든 데이터 반출 시나리오를 사용할 수 없음을 나타냅니다.

SearchEncryptionComplianceStatus

열거형

CMK 암호화되지 않은 개체와 관련하여 검색 서비스 준수 상태를 반환합니다. 서비스에 암호화되지 않은 개체가 두 개 이상 있고 적용이 설정된 경우 서비스는 비준수로 표시됩니다.

값	Description
Compliant	CMK 암호화되지 않은 개체의 수가 0이거나 적용을 사용하지 않도록 설정되었기 때문에 검색 서비스가 규정을 준수하고 있음을 나타냅니다.
NonCompliant	검색 서비스에 CMK 암호화되지 않은 개체가 둘 이상 있음을 나타냅니다.

SearchEncryptionWithCmk

열거형

고객 관리형 키로 암호화되지 않은 개체를 찾은 경우 검색 서비스가 규정 준수를 적용하는 방법을 설명합니다.

값	Description
Disabled	고객 관리형 키 암호화는 적용되지 않습니다. 기본 제공 서비스 관리 암호화만 사용됩니다.
Enabled	하나 이상의 개체가 고객 관리형 키로 암호화되지 않은 경우 검색 서비스는 비준수로 표시됩니다.
Unspecified	적용 정책은 명시적으로 지정되지 않으며 동작은 '사용 안 함'으로 설정된 경우와 동일합니다.

SearchSemanticSearch

열거형

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

값	Description
disabled	검색 서비스에 대해 의미 체계 재전송을 사용할 수 없음을 나타냅니다. 기본값입니다.
free	검색 서비스에서 의미 체계 재전송을 사용하도록 설정하고 무료 플랜의 제한 내에서 사용됨을 나타냅니다. 무료 플랜은 의미 체계 순위 요청의 양을 제한하며 추가 비용 없이 제공됩니다. 이는 새로 프로비전된 검색 서비스의 기본값입니다.
standard	검색 서비스에서 의미 체계 재전송을 청구 가능한 기능으로 사용하도록 설정하며, 처리량과 의미상 재전송된 쿼리 볼륨이 높습니다.

SearchService

Object

Azure AI Search 서비스 및 현재 상태를 설명합니다.

Name	형식	Default value	Description
id	string (arm-id)		Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	Identity		The identity of the resource.
location	string		The geo-location where the resource lives
name	string		The name of the resource
properties.authOptions	DataPlaneAuthOptions		검색 서비스의 데이터 평면 API가 요청을 인증하는 방법에 대한 옵션을 정의합니다. 'disableLocalAuth'가 true로 설정된 경우에는 설정할 수 없습니다.
properties.computeType	ComputeType		기본 컴퓨팅 또는 Azure 기밀 컴퓨팅을 사용하여 검색 서비스를 지원하도록 이 속성을 구성합니다.
properties.dataExfiltrationProtections	SearchDataExfiltrationProtection[]		검색 서비스에 대해 명시적으로 허용되지 않는 데이터 반출 시나리오 목록입니다. 현재 지원되는 유일한 값은 'All'으로, 향후 더 세분화된 컨트롤을 사용하여 가능한 모든 데이터 내보내기 시나리오를 사용하지 않도록 설정합니다.
properties.disableLocalAuth	boolean		true로 설정하면 검색 서비스에 대한 호출이 인증에 API 키를 활용하는 것이 허용되지 않습니다. 'dataPlaneAuthOptions'가 정의된 경우에는 true로 설정할 수 없습니다.
properties.eTag	string		업데이트 중에 낙관적 동시성 제어에 사용할 수 있는 서비스의 etag를 나타내는 시스템 생성 속성입니다.
properties.encryptionWithCmk	EncryptionWithCmk		검색 서비스 내에서 고객 관리자 키를 사용하여 리소스 암호화(예: 인덱스)에 대한 정책을 지정합니다.
properties.endpoint	string (uri)		Azure AI Search 서비스의 엔드포인트입니다.
properties.hostingMode	HostingMode	default	standard3 SKU에만 적용됩니다. 최대 1,000개의 인덱스를 허용하는 최대 3개의 고밀도 파티션을 사용하도록 이 속성을 설정할 수 있습니다. 이는 다른 SKU에 허용되는 최대 인덱스보다 훨씬 높습니다. standard3 SKU의 경우 값은 'default' 또는 'highDensity'입니다. 다른 모든 SKU의 경우 이 값은 'default'여야 합니다.
properties.networkRuleSet	NetworkRuleSet		Azure AI Search 서비스에 도달하는 방법을 결정하는 네트워크별 규칙입니다.
properties.partitionCount	integer (int32) minimum: 1 maximum: 12	1	검색 서비스의 파티션 수입니다. 지정된 경우 1, 2, 3, 4, 6 또는 12일 수 있습니다. 1보다 큰 값은 표준 SKU에만 유효합니다. hostingMode가 'highDensity'로 설정된 'standard3' 서비스의 경우 허용되는 값은 1에서 3 사이입니다.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Azure AI Search 서비스에 대한 프라이빗 엔드포인트 연결 목록입니다.
properties.provisioningState	ProvisioningState		검색 서비스에서 수행된 마지막 프로비전 작업의 상태입니다. 프로비전은 서비스 용량이 설정되는 동안 발생하는 중간 상태입니다. 용량이 설정되면 provisioningState가 '성공' 또는 '실패'로 변경됩니다. 클라이언트 애플리케이션은 검색 서비스 가져오기 작업을 사용하여 작업이 완료된 시기를 확인하여 프로비저닝 상태를 폴링할 수 있습니다(권장 폴링 간격은 30초에서 1분). 무료 서비스를 사용하는 경우 이 값은 검색 서비스 만들기 호출에서 직접 '성공'으로 돌아오는 경향이 있습니다. 이는 무료 서비스가 이미 설정된 용량을 사용하기 때문입니다.
properties.publicNetworkAccess	PublicNetworkAccess	enabled	이 값은 기존 고객 리소스 및 템플릿의 호환성이 손상되는 변경을 방지하기 위해 '사용'으로 설정할 수 있습니다. 'disabled'로 설정하면 공용 인터페이스를 통해 트래픽이 허용되지 않으며 프라이빗 엔드포인트 연결은 배타적인 액세스 방법이 됩니다.
properties.replicaCount	integer (int32) minimum: 1 maximum: 12	1	검색 서비스의 복제본 수입니다. 지정된 경우 표준 SKU의 경우 1에서 12 사이의 값이거나 기본 SKU의 경우 1에서 3 사이여야 합니다.
properties.semanticSearch	SearchSemanticSearch		의미 체계 검색의 가용성을 제어하는 옵션을 설정합니다. 이 구성은 특정 위치의 특정 Azure AI Search SKU에 대해서만 가능합니다.
properties.serviceUpgradedAt	string (date-time)		검색 서비스가 마지막으로 업그레이드된 날짜 및 시간입니다. 서비스가 처음으로 업그레이드될 때까지 이 필드는 null이 됩니다.
properties.sharedPrivateLinkResources	SharedPrivateLinkResource[]		Azure AI Search 서비스에서 관리하는 공유 프라이빗 링크 리소스 목록입니다.
properties.status	SearchServiceStatus		검색 서비스의 상태입니다. 가능한 값은 '실행 중'입니다. 검색 서비스가 실행 중이며 프로비저닝 작업이 진행 중이 아닙니다. '프로비저닝': 검색 서비스가 프로비전되거나 확장 또는 축소되고 있습니다. '삭제 중': 검색 서비스가 삭제되고 있습니다. '성능 저하': 검색 서비스가 저하되었습니다. 이 문제는 기본 검색 단위가 정상이 아닌 경우에 발생할 수 있습니다. 검색 서비스가 작동할 가능성이 높지만 성능이 느려지고 일부 요청이 삭제될 수 있습니다. 'disabled': 검색 서비스를 사용할 수 없습니다. 이 상태에서 서비스는 모든 API 요청을 거부합니다. 'error': 검색 서비스가 오류 상태입니다. '중지됨': 검색 서비스가 비활성화된 구독에 있습니다. 서비스가 성능 저하, 사용 안 함 또는 오류 상태인 경우 Azure AI Search 팀이 기본 문제를 적극적으로 조사하고 있다는 의미입니다. 이러한 상태의 전용 서비스는 프로비전된 검색 단위 수에 따라 요금이 청구됩니다.
properties.statusDetails	string		검색 서비스 상태의 세부 정보입니다.
properties.upgradeAvailable	UpgradeAvailable		검색 서비스에 사용 가능한 업그레이드가 있는지를 나타냅니다.
sku	Sku		가격 계층 및 용량 제한을 결정하는 검색 서비스의 SKU입니다. 이 속성은 새 검색 서비스를 만들 때 필요합니다.
systemData	systemData		createdBy 및 modifiedBy 정보를 포함하는 검색 서비스의 Azure Resource Manager 메타데이터입니다.
tags	object		리소스 태그.
type	string		리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

SearchServiceStatus

열거형

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

값	Description
degraded	기본 검색 단위가 정상이 아니므로 검색 서비스가 저하됩니다.
deleting	검색 서비스가 삭제되고 있습니다.
disabled	검색 서비스가 비활성화되고 모든 API 요청이 거부됩니다.
error	검색 서비스가 오류 상태이며 프로비전 실패 또는 삭제됨을 나타냅니다.
provisioning	검색 서비스가 프로비전되거나 확장 또는 축소되고 있습니다.
running	검색 서비스가 실행 중이며 프로비저닝 작업이 진행 중이 아닙니다.
stopped	검색 서비스가 비활성화된 구독에 있습니다.

SharedPrivateLinkResource

Object

Azure AI Search 서비스에서 관리하는 공유 프라이빗 링크 리소스에 대해 설명합니다.

Name	형식	Description
id	string (arm-id)	Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	The name of the resource
properties	SharedPrivateLinkResourceProperties	Azure AI Search 서비스에서 관리하는 공유 프라이빗 링크 리소스의 속성을 설명합니다.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

SharedPrivateLinkResourceProperties

Object

Azure AI Search 서비스에서 관리하는 기존 공유 프라이빗 링크 리소스의 속성을 설명합니다.

Name	형식	Description
groupId	string	공유 프라이빗 링크 리소스의 리소스 공급자의 그룹 ID입니다.
privateLinkResourceId	string	공유 프라이빗 링크 리소스의 리소스 ID입니다.
provisioningState	SharedPrivateLinkResourceProvisioningState	공유 프라이빗 링크 리소스의 프로비전 상태입니다. 유효한 값은 업데이트, 삭제, 실패, 성공 또는 불완전한 값입니다.
requestMessage	string	공유 프라이빗 링크 리소스의 승인을 요청하는 메시지입니다.
resourceRegion	string	선택 사항입니다. 공유 프라이빗 링크를 만드는 리소스의 Azure Resource Manager 위치를 지정하는 데 사용할 수 있습니다. DNS 구성이 지역(예: Azure Kubernetes Service)인 리소스에만 필요합니다.
status	SharedPrivateLinkResourceStatus	Status of the shared private link resource. 유효한 값은 보류 중, 승인됨, 거부됨 또는 연결 끊김입니다.

SharedPrivateLinkResourceProvisioningState

열거형

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

값	Description
Deleting	공유 프라이빗 링크 리소스가 삭제되는 중입니다.
Failed	공유 프라이빗 링크 리소스를 프로비전하거나 삭제하지 못했습니다.
Incomplete	공유 프라이빗 링크 리소스에 대한 프로비저닝 요청이 수락되었지만 생성 프로세스가 아직 시작되지 않았습니다.
Succeeded	공유 프라이빗 링크 리소스가 프로비저닝을 마쳤으며 승인할 준비가 되었습니다.
Updating	공유 프라이빗 링크 리소스는 완전히 작동하기 위해 다른 리소스와 함께 만들어지는 중입니다.

SharedPrivateLinkResourceStatus

열거형

Status of the shared private link resource. 유효한 값은 보류 중, 승인됨, 거부됨 또는 연결 끊김입니다.

값	Description
Approved	공유 프라이빗 링크 리소스가 승인되어 사용할 준비가 된 것입니다.
Disconnected	공유 프라이빗 링크 리소스가 서비스에서 제거되었습니다.
Pending	공유 프라이빗 링크 리소스가 만들어졌으며 승인을 보류 중입니다.
Rejected	공유 프라이빗 링크 리소스가 거부되었으며 사용할 수 없습니다.

Sku

Object

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

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

SkuName

열거형

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

값	Description
basic	최대 3개의 복제본이 있는 전용 서비스에 대한 청구 가능 계층입니다.
free	SLA 보장 및 청구 가능 계층에서 제공되는 기능의 하위 집합이 없는 무료 계층.
standard	최대 12개의 파티션과 12개의 복제본이 있는 전용 서비스에 대한 청구 가능 계층입니다.
standard2	'표준'과 비슷하지만 검색 단위당 더 많은 용량이 있습니다.
standard3	최대 12개의 파티션과 12개의 복제본(또는 hostingMode 속성을 'highDensity'로 설정한 경우 인덱스가 더 많은 파티션을 최대 3개까지 포함)하는 가장 큰 표준 제품입니다.
storage_optimized_l1	파티션당 최대 12개의 파티션을 지원하는 전용 서비스에 대한 청구 가능 계층입니다.
storage_optimized_l2	파티션당 최대 12개의 파티션을 지원하는 전용 서비스에 대한 청구 가능 계층입니다.

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

UpgradeAvailable

열거형

검색 서비스에 사용 가능한 업그레이드가 있는지를 나타냅니다.

값	Description
available	서비스에 사용할 수 있는 업그레이드가 있습니다.
notAvailable	현재 서비스에 업그레이드를 사용할 수 없습니다.

UserAssignedIdentity

Object

사용자 할당 ID 속성

Name	형식	Description
clientId	string (uuid)	The client ID of the assigned identity.
principalId	string (uuid)	The principal ID of the assigned identity.

다음을 통해 공유

Services - Create Or Update

URI 매개 변수

요청 헤더

요청 본문

응답

보안

azure_auth

범위

예제

SearchCreateOrUpdateService

샘플 요청

샘플 응답

SearchCreateOrUpdateServiceAuthOptions

샘플 요청

샘플 응답

SearchCreateOrUpdateServiceDisableLocalAuth

샘플 요청

샘플 응답

SearchCreateOrUpdateServiceToAllowAccessFromPrivateEndpoints

샘플 요청

샘플 응답

SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPs

샘플 요청

샘플 응답

SearchCreateOrUpdateServiceToAllowAccessFromPublicCustomIPsAndBypass

샘플 요청

샘플 응답

SearchCreateOrUpdateServiceWithCmkEnforcement

샘플 요청

샘플 응답

SearchCreateOrUpdateServiceWithDataExfiltration

샘플 요청

샘플 응답

SearchCreateOrUpdateServiceWithIdentity

샘플 요청

샘플 응답

SearchCreateOrUpdateWithSemanticSearch

샘플 요청

샘플 응답

정의

AadAuthFailureMode

ApiKeyOnly

CloudError

CloudErrorBody

ComputeType

createdByType

DataPlaneAadOrApiKeyAuthOption

DataPlaneAuthOptions

EncryptionWithCmk

HostingMode

Identity

IdentityType

IpRule

NetworkRuleSet

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProperties

PrivateLinkServiceConnectionProvisioningState

PrivateLinkServiceConnectionState

PrivateLinkServiceConnectionStatus

ProvisioningState

PublicNetworkAccess

SearchBypass

SearchDataExfiltrationProtection

SearchEncryptionComplianceStatus

SearchEncryptionWithCmk

SearchSemanticSearch

SearchService

SearchServiceStatus

SharedPrivateLinkResource

SharedPrivateLinkResourceProperties

SharedPrivateLinkResourceProvisioningState

SharedPrivateLinkResourceStatus

Sku

SkuName

systemData

UpgradeAvailable

UserAssignedIdentity