Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions sdk/search/azure-search-documents/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,24 @@

### Features Added

- Added `ApiVersion.V2026_08_01_PREVIEW` so the `2026-08-01-preview` Search API version can be
selected via the `api_version` keyword on the clients.

### Breaking Changes

### Bugs Fixed

### Other Changes

- Updated `tsp-location.yaml` and `_metadata.json` to target spec commit
`c19e358860e3cb89a8c7021e8c5a181ab6ef7f62` (`2026-08-01-preview`). The new `2026-08-01-preview`
models and operations are not yet included in this release: the documented generator emits the
synthesized root-namespace request/response models (e.g. `EntraAppAuthentication`,
`FileUploadMetadata`, `KnowledgeBaseRetrieveDefaults`) into a top-level `search` package and
references them with an invalid cross-package relative import (`from ......search import models`),
which is non-importable. This is a spec-side defect (the root `Search` namespace lacks a blanket
`@@clientNamespace("Azure.Search.Documents")` in `client.tsp`) and must be fixed in
`Azure/azure-rest-api-specs` before the full surface can be regenerated.
## 12.1.0b1 (2026-05-28)

### Features Added
Expand Down
4 changes: 2 additions & 2 deletions sdk/search/azure-search-documents/_metadata.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"apiVersion": "2026-05-01-preview",
"apiVersion": "2026-08-01-preview",
"apiVersions": {
"Search": "2026-05-01-preview"
"Search": "2026-08-01-preview"
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,7 @@ class ApiVersion(str, Enum, metaclass=CaseInsensitiveEnumMeta):
V2025_09_01 = "2025-09-01"
V2026_04_01 = "2026-04-01"
V2026_05_01_PREVIEW = "2026-05-01-preview"
V2026_08_01_PREVIEW = "2026-08-01-preview"


DEFAULT_VERSION = ApiVersion.V2026_05_01_PREVIEW
Expand Down
15 changes: 14 additions & 1 deletion sdk/search/azure-search-documents/tests/test_search_client.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,12 @@
from azure.core.credentials import AzureKeyCredential
from azure.core.paging import ItemPaged

from azure.search.documents import ApiVersion, IndexDocumentsBatch, RequestEntityTooLargeError, SearchClient
from azure.search.documents import (
ApiVersion,
IndexDocumentsBatch,
RequestEntityTooLargeError,
SearchClient,
)
from azure.search.documents._operations._patch import SearchPageIterator
from azure.search.documents.models import FacetResult, IndexingResult, SearchResult

Expand Down Expand Up @@ -93,6 +98,14 @@ def test_constructor_accepts_supported_api_version_enum(self):

assert client._config.api_version == ApiVersion.V2020_06_30

def test_api_version_enum_includes_2026_08_01_preview(self):
assert ApiVersion.V2026_08_01_PREVIEW == "2026-08-01-preview"

def test_constructor_accepts_2026_08_01_preview_api_version_enum(self):
client = create_search_client(api_version=ApiVersion.V2026_08_01_PREVIEW)

assert client._config.api_version == "2026-08-01-preview"


class TestSearchRequestBuilding:
@mock.patch("azure.search.documents._operations._operations._SearchClientOperationsMixin._search_post")
Expand Down
2 changes: 1 addition & 1 deletion sdk/search/azure-search-documents/tsp-location.yaml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
directory: specification/search/data-plane/Search
commit: 8be8c75d9bb11ea95d8a7e251db74aa78b5cd76c
commit: c19e358860e3cb89a8c7021e8c5a181ab6ef7f62
repo: Azure/azure-rest-api-specs

Loading