Update api version (Azure#36425)

* Some review feedback also applies to preview

* update

* updates

* updates

* updates

* Update

* update

* updates

* updates

* updates

* update

* update

* update

* update

* Update api version

* update

* update tests

* update

Author: xiangyan99

sdk/search/azure-search-documents/CHANGELOG.md

@@ -14,6 +14,24 @@
 
 ### Other Changes
 
+- Updated the API version to "2024-09-01-preview"
+- Below models were renamed
+  - `azure.search.documents.indexes.models.SearchIndexerIndexProjections` -> `azure.search.documents.indexes.models.SearchIndexerIndexProjection`
+  - `azure.search.documents.indexes.models.LineEnding` -> `azure.search.documents.indexes.models.OrcLineEnding`
+  - `azure.search.documents.indexes.models.ScalarQuantizationCompressionConfiguration` -> `azure.search.documents.indexes.models.ScalarQuantizationCompression`
+  - `azure.search.documents.indexes.models.VectorSearchCompressionConfiguration` -> `azure.search.documents.indexes.models.VectorSearchCompression`
+  - `azure.search.documents.indexes.models.VectorSearchCompressionTargetDataType` -> `azure.search.documents.indexes.models.VectorSearchCompressionTarget`
+- Below properties were renamed
+  - `azure.search.documents.indexes.models.AzureMachineLearningVectorizer.name` -> `azure.search.documents.indexes.models.AzureMachineLearningVectorizer.vectorizer_name`
+  - `azure.search.documents.indexes.models.AzureOpenAIEmbeddingSkill.deployment_id` -> `azure.search.documents.indexes.models.AzureOpenAIEmbeddingSkill.deployment_name`
+  - `azure.search.documents.indexes.models.AzureOpenAIEmbeddingSkill.resource_uri` -> `azure.search.documents.indexes.models.AzureOpenAIEmbeddingSkill.resource_url`
+  - `azure.search.documents.indexes.models.AzureOpenAIVectorizer.azure_open_ai_parameters` -> `azure.search.documents.indexes.models.AzureOpenAIVectorizer.parameters`
+  - `azure.search.documents.indexes.models.AzureOpenAIVectorizer.name` -> `azure.search.documents.indexes.models.AzureOpenAIVectorizer.vectorizer_name`
+  - `azure.search.documents.indexes.models.SearchIndexerDataUserAssignedIdentity.user_assigned_identity` -> `azure.search.documents.indexes.models.SearchIndexerDataUserAssignedIdentity.resource_id`
+  - `azure.search.documents.indexes.models.VectorSearchProfile.compression_configuration_name` -> `azure.search.documents.indexes.models.VectorSearchProfile.compression_name`
+  - `azure.search.documents.indexes.models.VectorSearchProfile.vectorizer` -> `azure.search.documents.indexes.models.VectorSearchProfile.vectorizer_name`
+  - `azure.search.documents.indexes.models.VectorSearchVectorizer.name` -> `azure.search.documents.indexes.models.VectorSearchVectorizer.vectorizer_name`
+
 ## 11.6.0b4 (2024-05-07)
 
 ### Features Added

sdk/search/azure-search-documents/README.md

@@ -162,8 +162,9 @@ exposes operations on these resources through three main client types.
 Azure AI Search provides two powerful features: **semantic ranking** and **vector search**.
 
 **Semantic ranking** enhances the quality of search results for text-based queries. By enabling semantic ranking on your search service, you can improve the relevance of search results in two ways:
-- It applies secondary ranking to the initial result set, promoting the most semantically relevant results to the top.
-- It extracts and returns captions and answers in the response, which can be displayed on a search page to enhance the user's search experience.
+
+* It applies secondary ranking to the initial result set, promoting the most semantically relevant results to the top.
+* It extracts and returns captions and answers in the response, which can be displayed on a search page to enhance the user's search experience.
 
 To learn more about semantic ranking, you can refer to the [documentation](https://learn.microsoft.com/azure/search/vector-search-overview).
 
@@ -184,14 +185,12 @@ that you can [import into your own index from the Azure portal.](https://docs.mi
 These are just a few of the basics - please [check out our Samples](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/search/azure-search-documents/samples) for
 much more.
 
-
 * [Querying](#querying)
 * [Creating an index](#creating-an-index)
 * [Adding documents to your index](#adding-documents-to-your-index)
 * [Retrieving a specific document from your index](#retrieving-a-specific-document-from-your-index)
 * [Async APIs](#async-apis)
 
-
 ### Querying
 
 Let's start by importing our namespaces.
@@ -226,7 +225,6 @@ for result in results:
     print("{}: {})".format(result["hotelId"], result["hotelName"]))
 ```
 
-
 ### Creating an index
 
 You can use the `SearchIndexClient` to create a search index. Fields can be
@@ -240,6 +238,7 @@ client = SearchIndexClient(service_endpoint, AzureKeyCredential(key))
 name = "hotels"
 fields = [
     SimpleField(name="hotelId", type=SearchFieldDataType.String, key=True),
+    SimpleField(name="hotelName", type=SearchFieldDataType.String, searchable=True),
     SimpleField(name="baseRate", type=SearchFieldDataType.Double),
     SearchableField(name="description", type=SearchFieldDataType.String, collection=True),
     ComplexField(
@@ -271,10 +270,7 @@ to be aware of.
 
 ```python
 DOCUMENT = {
-    "category": "Hotel",
     "hotelId": "1000",
-    "rating": 4.0,
-    "rooms": [],
     "hotelName": "Azure Inn",
 }
 
@@ -289,8 +285,8 @@ print("Upload of new document succeeded: {}".format(result[0].succeeded))
 
 To authenticate in a [National Cloud](https://docs.microsoft.com/azure/active-directory/develop/authentication-national-cloud), you will need to make the following additions to your client configuration:
 
-- Set the `AuthorityHost` in the credential options or via the `AZURE_AUTHORITY_HOST` environment variable
-- Set the `audience` in `SearchClient`, `SearchIndexClient`, or `SearchIndexerClient`
+* Set the `AuthorityHost` in the credential options or via the `AZURE_AUTHORITY_HOST` environment variable
+* Set the `audience` in `SearchClient`, `SearchIndexClient`, or `SearchIndexerClient`
 
 ```python
 # Create a SearchClient that will authenticate through AAD in the China national cloud.
@@ -325,8 +321,6 @@ result = search_client.get_document(key="23")
 
 print("Details for hotel '23' are:")
 print("        Name: {}".format(result["hotelName"]))
-print("      Rating: {}".format(result["rating"]))
-print("    Category: {}".format(result["category"]))
 ```
 
 <!-- END SNIPPET -->

sdk/search/azure-search-documents/assets.json

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "python",
   "TagPrefix": "python/search/azure-search-documents",
-  "Tag": "python/search/azure-search-documents_5cbab0a8a5"
+  "Tag": "python/search/azure-search-documents_d9c3f0ef0f"
 }

sdk/search/azure-search-documents/azure/search/documents/_api_versions.py

@@ -8,10 +8,10 @@
 
 
 class ApiVersion(str, Enum, metaclass=CaseInsensitiveEnumMeta):
-    #: this is the default version
     V2020_06_30 = "2020-06-30"
     V2023_11_01 = "2023-11-01"
-    V2024_05_01_PREVIEW = "2024-05-01-preview"
+    V2024_07_01 = "2024-07-01"
+    V2024_09_01_PREVIEW = "2024-09-01-preview"
 
 
-DEFAULT_VERSION = ApiVersion.V2024_05_01_PREVIEW
+DEFAULT_VERSION = ApiVersion.V2024_09_01_PREVIEW

sdk/search/azure-search-documents/azure/search/documents/_generated/_configuration.py

@@ -1,6 +1,6 @@
 # coding=utf-8
 # --------------------------------------------------------------------------
-# Code generated by Microsoft (R) AutoRest Code Generator (autorest: 3.10.1, generator: @autorest/python@6.13.12)
+# Code generated by Microsoft (R) AutoRest Code Generator (autorest: 3.10.2, generator: @autorest/python@6.19.0)
 # Changes may cause incorrect behavior and will be lost if the code is regenerated.
 # --------------------------------------------------------------------------
 
@@ -21,13 +21,13 @@ class SearchIndexClientConfiguration:  # pylint: disable=too-many-instance-attri
     :type endpoint: str
     :param index_name: The name of the index. Required.
     :type index_name: str
-    :keyword api_version: Api Version. Default value is "2024-05-01-preview". Note that overriding
+    :keyword api_version: Api Version. Default value is "2024-09-01-preview". Note that overriding
      this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 
     def __init__(self, endpoint: str, index_name: str, **kwargs: Any) -> None:
-        api_version: str = kwargs.pop("api_version", "2024-05-01-preview")
+        api_version: str = kwargs.pop("api_version", "2024-09-01-preview")
 
         if endpoint is None:
             raise ValueError("Parameter 'endpoint' must not be None.")

sdk/search/azure-search-documents/azure/search/documents/_generated/_search_index_client.py

@@ -1,11 +1,12 @@
 # coding=utf-8
 # --------------------------------------------------------------------------
-# Code generated by Microsoft (R) AutoRest Code Generator (autorest: 3.10.1, generator: @autorest/python@6.13.12)
+# Code generated by Microsoft (R) AutoRest Code Generator (autorest: 3.10.2, generator: @autorest/python@6.19.0)
 # Changes may cause incorrect behavior and will be lost if the code is regenerated.
 # --------------------------------------------------------------------------
 
 from copy import deepcopy
 from typing import Any
+from typing_extensions import Self
 
 from azure.core import PipelineClient
 from azure.core.pipeline import policies
@@ -26,7 +27,7 @@ class SearchIndexClient:  # pylint: disable=client-accepts-api-version-keyword
     :type endpoint: str
     :param index_name: The name of the index. Required.
     :type index_name: str
-    :keyword api_version: Api Version. Default value is "2024-05-01-preview". Note that overriding
+    :keyword api_version: Api Version. Default value is "2024-09-01-preview". Note that overriding
      this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
@@ -91,7 +92,7 @@ def _send_request(self, request: HttpRequest, *, stream: bool = False, **kwargs:
     def close(self) -> None:
         self._client.close()
 
-    def __enter__(self) -> "SearchIndexClient":
+    def __enter__(self) -> Self:
         self._client.__enter__()
         return self
 

sdk/search/azure-search-documents/azure/search/documents/_generated/_serialization.py

@@ -144,6 +144,8 @@ def _json_attemp(data):
                 # context otherwise.
                 _LOGGER.critical("Wasn't XML not JSON, failing")
                 raise DeserializationError("XML is invalid") from err
+        elif content_type.startswith("text/"):
+            return data_as_str
         raise DeserializationError("Cannot deserialize content-type: {}".format(content_type))
 
     @classmethod
@@ -1441,7 +1443,7 @@ def _deserialize(self, target_obj, data):
         elif isinstance(response, type) and issubclass(response, Enum):
             return self.deserialize_enum(data, response)
 
-        if data is None:
+        if data is None or data is CoreNull:
             return data
         try:
             attributes = response._attribute_map  # type: ignore

sdk/search/azure-search-documents/azure/search/documents/_generated/_vendor.py

@@ -1,6 +1,6 @@
 # coding=utf-8
 # --------------------------------------------------------------------------
-# Code generated by Microsoft (R) AutoRest Code Generator (autorest: 3.10.1, generator: @autorest/python@6.13.12)
+# Code generated by Microsoft (R) AutoRest Code Generator (autorest: 3.10.2, generator: @autorest/python@6.19.0)
 # Changes may cause incorrect behavior and will be lost if the code is regenerated.
 # --------------------------------------------------------------------------
 

sdk/search/azure-search-documents/azure/search/documents/_generated/aio/__init__.py

@@ -1,6 +1,6 @@
 # coding=utf-8
 # --------------------------------------------------------------------------
-# Code generated by Microsoft (R) AutoRest Code Generator (autorest: 3.10.1, generator: @autorest/python@6.13.12)
+# Code generated by Microsoft (R) AutoRest Code Generator (autorest: 3.10.2, generator: @autorest/python@6.19.0)
 # Changes may cause incorrect behavior and will be lost if the code is regenerated.
 # --------------------------------------------------------------------------
 
@@ -21,13 +21,13 @@ class SearchIndexClientConfiguration:  # pylint: disable=too-many-instance-attri
     :type endpoint: str
     :param index_name: The name of the index. Required.
     :type index_name: str
-    :keyword api_version: Api Version. Default value is "2024-05-01-preview". Note that overriding
+    :keyword api_version: Api Version. Default value is "2024-09-01-preview". Note that overriding
      this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 
     def __init__(self, endpoint: str, index_name: str, **kwargs: Any) -> None:
-        api_version: str = kwargs.pop("api_version", "2024-05-01-preview")
+        api_version: str = kwargs.pop("api_version", "2024-09-01-preview")
 
         if endpoint is None:
             raise ValueError("Parameter 'endpoint' must not be None.")