Skip to content

Commit cfaf033

Browse files
Clarify PUT vs. PATCH when enabling semantic search
1 parent efe7dfe commit cfaf033

File tree

1 file changed

+1
-2
lines changed

1 file changed

+1
-2
lines changed

articles/search/semantic-search-overview.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -122,7 +122,7 @@ Alternatively, you can also enable semantic search using the REST API that's des
122122
To enable Semantic Search using the REST API, you can use the [Create or Update Service API](/rest/api/searchmanagement/2021-04-01-preview/services/create-or-update#searchsemanticsearch).
123123

124124
> [!NOTE]
125-
> Create or Update supports two HTTP methods: PUT and PATCH. PUT replaces all properties in the service with their defaults if they are not specified in the request. PATCH only replaces properties that are specified in the request. It's possible to accidentally introduce an unexpected scaling or configuration change if PUT is used. It's recommended to use PATCH when enabling semantic search.
125+
> Create or Update supports two HTTP methods: PUT and PATCH. Both PUT and PATCH can be used to update existing services, but only PUT can be used to create a new service. If PUT is used to update an existing service, it replaces all properties in the service with their defaults if they are not specified in the request. When PATCH is used to update an existing service, it only replaces properties that are specified in the request. When using PUT to update an existing service, it's possible to accidentally introduce an unexpected scaling or configuration change. When enabling semantic search on an existing service, it's recommended to use PATCH instead of PUT.
126126
127127
* Management REST API version 2021-04-01-Preview provides the semantic search property
128128

@@ -137,7 +137,6 @@ PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegrou
137137
}
138138
```
139139

140-
141140
## Disable semantic search
142141

143142
To reverse feature enablement, or for full protection against accidental usage and charges, you can [disable semantic search](/rest/api/searchmanagement/2021-04-01-preview/services/create-or-update#searchsemanticsearch) using the Create or Update Service API on your search service. After the feature is disabled, any requests that include the semantic query type will be rejected.

0 commit comments

Comments
 (0)