Repository navigation
Board Review: [Azure AI Search] 2026-11-01 Management-plane SDK GA #10377
Description
Responsible Service Team
Azure AI Search
Main Contacts
Yangyang Lu (@yangylu91), efrainretana
Expected Code Complete Date
2026-11-01
Expected Release Date
2026-11-16
Link to Documentation Introducing/Describing the Service
https://learn.microsoft.com/azure/search/search-what-is-azure-search
Link to the Service REST APIs / TypeSpec
Link to GitHub Issue for Previous Review Sessions (if applicable)
No response
Languages for this Review
.NET
.NET
- APIView:
https://spa.apiview.dev/review/3d158aec12a44b6ab7dd9a0e19643903?activeApiRevisionId=4743f351830a429dbdab1a9db5ecfa1f&diffApiRevisionId=233812e0f881478a88d958a90e35573a&diffStyle=trees - Samples:
https://github.com/Azure/azure-sdk-for-net/tree/3b66c55ebb81090415b90733474c4d94d7755fd9/sdk/search/Azure.ResourceManager.Search/tests/Samples - PR:
[AutoPR Azure.ResourceManager.Search]-generated-from-SDK Generation - .NET-6951987 azure-sdk-for-net#63806 - README:
https://github.com/Azure/azure-sdk-for-net/blob/3b66c55ebb81090415b90733474c4d94d7755fd9/sdk/search/Azure.ResourceManager.Search/README.md - Changelog:
https://github.com/Azure/azure-sdk-for-net/blob/3b66c55ebb81090415b90733474c4d94d7755fd9/sdk/search/Azure.ResourceManager.Search/CHANGELOG.md
Review scope: Stable release of Azure.ResourceManager.Search version 1.4.0, targeting management-plane REST API 2026-11-01. Relative to GA SDK 1.3.0 / REST API 2025-05-01, additions include Serverless SKU support, Free/Standard knowledge-retrieval billing configuration, and SearchServiceStatus.Stopped .
Spec PR: Azure/azure-rest-api-specs#47009
Hero scenarios: Serverless service creation, retrieval, deletion, and quota lookup; knowledge-retrieval billing configuration during creation and updates, including read-back. These are provided in separate Sample_Serverless.cs and Sample_KnowledgeRetrievalBilling.cs files.
Validation: CI passed, and samples compile. ARM manifest deployment for the live 2026-11-01 RP endpoint is in progress, so recorded integration coverage is pending. Given the release timeline, we’d like to submit this review request now and would appreciate guidance on proceeding while live validation is completed. Samples are linked in GitHub but not yet uploaded to APIView.
Java
No response
Python
No response
TypeScript
No response
Go
No response
Additional Languages (C++, Rust)
No response
Confirmations
- For existing packages, a diff revision is selected in APIView for each language. For brand-new packages, the initial API surface is submitted.
- CI checks are passing on all linked PRs
Activity
github-actions commentedon Oct 23, 2026
✅ All materials verified for .NET.
This review request is ready for architects. The
ready-for-reviewlabel has been applied.Assigned for review: .NET → Jesse Squire (@jsquire), m-nash, JoshLove-msft
Assigned architects are explicitly mentioned and receive GitHub assignment notifications. Apply your
<language>-api-approvedlabel when the review is complete.Validation details
.NET:
yangylu91 commentedon Oct 29, 2026
Hi Jesse Squire (@jsquire), m-nash, JoshLove-msft, could you pls help review the .NET SDK request for Azure Search RP 2026-11-01 GA? Thank you!
m-nash commentedon Oct 30, 2026
.NET review of
Azure.ResourceManager.Search1.4.0 against GA1.3.0: the new surface (SearchServiceSkuName.Serverless,KnowledgeRetrieval/SearchKnowledgeRetrieval) looks good, but there's one blocking item, which I've left as a comment in APIView: addingSearchServiceStatus.Stoppedis a behavioral break forSearchServiceData.Status.🟡 Separately, the hidden
SearchServiceData.SkuNameandSearchServicePatch.SkuNameback-compat getters map theSearchSkuNameproperty onto the legacy closedSearchSkuNameenum, which has no serverless member. Reading them on a serverless service throwsArgumentOutOfRangeException, so code still using them fails as soon as a subscription contains a serverless service. Returnnullfor values the legacy enum can't represent instead of throwing.On proceeding while live validation completes: please hold the merge of Azure/azure-sdk-for-net#63806 (it releases immediately via
auto-release) until2026-11-01is live and validated. 1.4.0 moves the default api-version of every operation to2026-11-01, so shipping before ARM serves it breaks existing Get, List, and CreateOrUpdate calls. Green CI doesn't cover this yet: management playback ignoresapi-versionwhen matching recordings, and the Search recordings date from March. Once the endpoint is live, re-record the existing tests against2026-11-01and run the two hero-scenario samples before merging.🤖 m-nash-copilot
yangylu91 commentedon Nov 4, 2026
m-nash Thanks for the review. Updates in Azure/azure-sdk-for-net#63806:
Statusproperties, adds extensibleServiceStatus/SearchServiceState, and returnsnullfrom legacy status/SKU getters for unrepresentable values. Please re-review the additive status API.2026-11-01EUAP recordings for all 34 enabled sync/async service integration cases. Both hero create/read/delete samples passed live; two pre-existing ignored cases remain unchanged.The PR remains on hold pending global ARM manifest deployment (ETA 11/13), subscription-wide List/Serverless-quota revalidation, and reviewer sign-off. Canary success is not being treated as global readiness.
yangylu91 commentedon Nov 5, 2026
m-nash Could you please re-review the compatibility fixes linked above and confirm whether the .NET SDK/API review can be signed off?
The canary recordings and both hero create/read/delete samples have passed.
We will keep the PR unmerged until global ARM manifest deployment completes.
Thanks a lot for your time and guidance!
yangylu91 commentedon Nov 6, 2026
Update: synced with Josh on Teams. Pushed commit 331f25f: Mark legacy Status properties obsolete; use ServiceStatus instead per feedback.