Sofiar/beta mobile (#41649)

* add mobile number

* use 2025-06-01

* update readme

* update default api version

* Add missing phone_number_type to public client

* Update recordings

* Fix capabilities recordings

* Update PHONE_NUMBER_SWAGGER.md to use public spec

* Add clarification on phone number types and grouping in README.md

* Update development status to reflect beta stage in setup.py

* Add phone number type to list available localities

* Add phone number type to list available localities

* Fix pylint

* Fix comments

* Fix pylint issues

* Fix spacing in comments

* Add optional phone number type

* Update _phone_numbers_client.py

* Update _phone_numbers_client_async.py

* Add release date

---------

Co-authored-by: Andrew Hopkins <[email protected]>
Co-authored-by: Andrew Hopkins <[email protected]>
Co-authored-by: Anna Tisch <[email protected]>

Author: 3 people

sdk/communication/azure-communication-phonenumbers/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Release History
 
+## 1.4.0b1 (2025-07-22)
+
+### Features Added
+- Adds support for mobile number types
+  - mobile numbers are location associated phone numbers with SMS capabilities
+- API version `2025-06-01` is the default.
+
 ## 1.3.0 (2025-06-20)
 
 ### Features Added

sdk/communication/azure-communication-phonenumbers/README.md

@@ -22,7 +22,7 @@ pip install azure-communication-phonenumbers
 
 This SDK provides functionality to easily manage `direct offer` and `direct routing` numbers.
 
-The `direct offer` numbers come in two types: Geographic and Toll-Free. Geographic phone plans are phone plans associated with a location, whose phone numbers' area codes are associated with the area code of a geographic location. Toll-Free phone plans are phone plans not associated location. For example, in the US, toll-free numbers can come with area codes such as 800 or 888.
+The `direct offer` numbers come in three types: Geographic, Toll-Free and Mobile. Geographic and Mobile phone plans are phone plans associated with a location, whose phone numbers' area codes are associated with the area code of a geographic location. Toll-Free phone plans are phone plans not associated location. For example, in the US, toll-free numbers can come with area codes such as 800 or 888.
 They are managed using the `PhoneNumbersClient`
 
 The `direct routing` feature enables connecting your existing telephony infrastructure to ACS.
@@ -77,7 +77,9 @@ sip_routing_client = SipRoutingClient.from_connection_string(connection_str)
 
 #### Phone number types overview
 
-Phone numbers come in two types; Geographic and Toll-Free. Geographic phone numbers are phone numbers associated with a location, whose area codes are associated with the area code of a geographic location. Toll-Free phone numbers are phone numbers with no associated location. For example, in the US, toll-free numbers can come with area codes such as 800 or 888.
+Phone numbers come in three types; Geographic, Toll-Free and Mobile. Toll-Free numbers are not associated with a location. For example, in the US, toll-free numbers can come with area codes such as 800 or 888. Geographic and Mobile phone numbers are phone numbers associated with a location.
+
+Phone number types with the same country are grouped into a phone plan group with that phone number type. For example all Toll-Free phone numbers within the same country are grouped into a phone plan group.
 
 #### Searching and Purchasing and Releasing numbers
 

sdk/communication/azure-communication-phonenumbers/assets.json

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "python",
   "TagPrefix": "python/communication/azure-communication-phonenumbers",
-  "Tag": "python/communication/azure-communication-phonenumbers_db3a0ba22d"
+  "Tag": "python/communication/azure-communication-phonenumbers_ee055c0573"
 }

sdk/communication/azure-communication-phonenumbers/azure/communication/phonenumbers/_api_versions.py

@@ -14,6 +14,7 @@ class ApiVersion(str, Enum, metaclass=CaseInsensitiveEnumMeta):
     V2024_03_01_PREVIEW = "2024-03-01-preview"
     V2025_02_11 = "2025-02-11"
     V2025_04_01 = "2025-04-01"
+    V2025_06_01 = "2025-06-01"
 
 
-DEFAULT_VERSION = ApiVersion.V2025_04_01
+DEFAULT_VERSION = ApiVersion.V2025_06_01

sdk/communication/azure-communication-phonenumbers/azure/communication/phonenumbers/_generated/_client.py

@@ -29,7 +29,7 @@ class PhoneNumbersClient:
     :param endpoint: The communication resource, for example
      https://resourcename.communication.azure.com. Required.
     :type endpoint: str
-    :keyword api_version: Api Version. Default value is "2025-04-01". Note that overriding this
+    :keyword api_version: Api Version. Default value is "2025-06-01". Note that overriding this
      default value may result in unsupported behavior.
     :paramtype api_version: str
     :keyword int polling_interval: Default waiting time between two polls for LRO operations if no

sdk/communication/azure-communication-phonenumbers/azure/communication/phonenumbers/_generated/_configuration.py

@@ -22,13 +22,13 @@ class PhoneNumbersClientConfiguration:  # pylint: disable=too-many-instance-attr
     :param endpoint: The communication resource, for example
      https://resourcename.communication.azure.com. Required.
     :type endpoint: str
-    :keyword api_version: Api Version. Default value is "2025-04-01". Note that overriding this
+    :keyword api_version: Api Version. Default value is "2025-06-01". Note that overriding this
      default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 
     def __init__(self, endpoint: str, **kwargs: Any) -> None:
-        api_version: str = kwargs.pop("api_version", "2025-04-01")
+        api_version: str = kwargs.pop("api_version", "2025-06-01")
 
         if endpoint is None:
             raise ValueError("Parameter 'endpoint' must not be None.")

sdk/communication/azure-communication-phonenumbers/azure/communication/phonenumbers/_generated/aio/_client.py

@@ -29,7 +29,7 @@ class PhoneNumbersClient:
     :param endpoint: The communication resource, for example
      https://resourcename.communication.azure.com. Required.
     :type endpoint: str
-    :keyword api_version: Api Version. Default value is "2025-04-01". Note that overriding this
+    :keyword api_version: Api Version. Default value is "2025-06-01". Note that overriding this
      default value may result in unsupported behavior.
     :paramtype api_version: str
     :keyword int polling_interval: Default waiting time between two polls for LRO operations if no

sdk/communication/azure-communication-phonenumbers/azure/communication/phonenumbers/_generated/aio/_configuration.py

@@ -22,13 +22,13 @@ class PhoneNumbersClientConfiguration:  # pylint: disable=too-many-instance-attr
     :param endpoint: The communication resource, for example
      https://resourcename.communication.azure.com. Required.
     :type endpoint: str
-    :keyword api_version: Api Version. Default value is "2025-04-01". Note that overriding this
+    :keyword api_version: Api Version. Default value is "2025-06-01". Note that overriding this
      default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 
     def __init__(self, endpoint: str, **kwargs: Any) -> None:
-        api_version: str = kwargs.pop("api_version", "2025-04-01")
+        api_version: str = kwargs.pop("api_version", "2025-06-01")
 
         if endpoint is None:
             raise ValueError("Parameter 'endpoint' must not be None.")

sdk/communication/azure-communication-phonenumbers/azure/communication/phonenumbers/_generated/aio/operations/_operations.py

@@ -8,7 +8,7 @@
 # --------------------------------------------------------------------------
 from collections.abc import MutableMapping
 from io import IOBase
-from typing import Any, AsyncIterable, AsyncIterator, Callable, Dict, IO, Optional, TypeVar, Union, cast, overload
+from typing import Any, AsyncIterator, Callable, Dict, IO, Optional, TypeVar, Union, cast, overload
 import urllib.parse
 
 from azure.core import AsyncPipelineClient
@@ -93,15 +93,15 @@ def list_area_codes(
         administrative_division: Optional[str] = None,
         accept_language: Optional[str] = None,
         **kwargs: Any
-    ) -> AsyncIterable["_models.PhoneNumberAreaCode"]:
+    ) -> AsyncItemPaged["_models.PhoneNumberAreaCode"]:
         """Gets the list of available area codes.
 
         Gets the list of available area codes.
 
         :param country_code: The ISO 3166-2 country code, e.g. US. Required.
         :type country_code: str
-        :keyword phone_number_type: Filter by numberType, e.g. Geographic, TollFree. Known values are:
-         "geographic" and "tollFree". Required.
+        :keyword phone_number_type: Filter by numberType, e.g. Geographic, TollFree, Mobile. Known
+         values are: "geographic", "tollFree", and "mobile". Required.
         :paramtype phone_number_type: str or ~azure.communication.phonenumbers.models.PhoneNumberType
         :keyword skip: An optional parameter for how many entries to skip, for pagination purposes. The
          default value is 0. Default value is 0.
@@ -215,7 +215,7 @@ async def get_next(next_link=None):
     @distributed_trace
     def list_available_countries(
         self, *, skip: int = 0, max_page_size: int = 100, accept_language: Optional[str] = None, **kwargs: Any
-    ) -> AsyncIterable["_models.PhoneNumberCountry"]:
+    ) -> AsyncItemPaged["_models.PhoneNumberCountry"]:
         """Gets the list of supported countries.
 
         Gets the list of supported countries.
@@ -461,8 +461,9 @@ def list_available_localities(
         max_page_size: int = 100,
         administrative_division: Optional[str] = None,
         accept_language: Optional[str] = None,
+        phone_number_type: Optional[Union[str, _models.PhoneNumberType]] = None,
         **kwargs: Any
-    ) -> AsyncIterable["_models.PhoneNumberLocality"]:
+    ) -> AsyncItemPaged["_models.PhoneNumberLocality"]:
         """Gets the list of cities or towns with available phone numbers.
 
         Gets the list of cities or towns with available phone numbers.
@@ -481,6 +482,9 @@ def list_available_localities(
         :keyword accept_language: The locale to display in the localized fields in the response. e.g.
          'en-US'. Default value is None.
         :paramtype accept_language: str
+        :keyword phone_number_type: Filter by numberType, e.g. Geographic, TollFree, Mobile. Known
+         values are: "geographic", "tollFree", and "mobile". Default value is None.
+        :paramtype phone_number_type: str or ~azure.communication.phonenumbers.models.PhoneNumberType
         :return: An iterator like instance of PhoneNumberLocality
         :rtype:
          ~azure.core.async_paging.AsyncItemPaged[~azure.communication.phonenumbers.models.PhoneNumberLocality]
@@ -508,6 +512,7 @@ def prepare_request(next_link=None):
                     max_page_size=max_page_size,
                     administrative_division=administrative_division,
                     accept_language=accept_language,
+                    phone_number_type=phone_number_type,
                     api_version=self._config.api_version,
                     headers=_headers,
                     params=_params,
@@ -579,7 +584,7 @@ def list_offerings(
         assignment_type: Optional[Union[str, _models.PhoneNumberAssignmentType]] = None,
         accept_language: Optional[str] = None,
         **kwargs: Any
-    ) -> AsyncIterable["_models.PhoneNumberOffering"]:
+    ) -> AsyncItemPaged["_models.PhoneNumberOffering"]:
         """List available offerings of capabilities with rates for the given country.
 
         List available offerings of capabilities with rates for the given country.
@@ -592,8 +597,8 @@ def list_offerings(
         :keyword max_page_size: An optional parameter for how many entries to return, for pagination
          purposes. The default value is 100. Default value is 100.
         :paramtype max_page_size: int
-        :keyword phone_number_type: Filter by numberType, e.g. Geographic, TollFree. Known values are:
-         "geographic" and "tollFree". Default value is None.
+        :keyword phone_number_type: Filter by numberType, e.g. Geographic, TollFree, Mobile. Known
+         values are: "geographic", "tollFree", and "mobile". Default value is None.
         :paramtype phone_number_type: str or ~azure.communication.phonenumbers.models.PhoneNumberType
         :keyword assignment_type: Filter by assignmentType, e.g. Person, Application. Known values are:
          "person" and "application". Default value is None.
@@ -693,7 +698,7 @@ async def get_next(next_link=None):
     @distributed_trace
     def list_reservations(
         self, *, max_page_size: int = 100, **kwargs: Any
-    ) -> AsyncIterable["_models.PhoneNumbersReservation"]:
+    ) -> AsyncItemPaged["_models.PhoneNumbersReservation"]:
         """Lists all reservations.
 
         Retrieves a paginated list of all phone number reservations. Note that the reservations will
@@ -2147,7 +2152,7 @@ def get_long_running_output(pipeline_response):  # pylint: disable=inconsistent-
     @distributed_trace
     def list_phone_numbers(
         self, *, skip: int = 0, top: int = 100, **kwargs: Any
-    ) -> AsyncIterable["_models.PurchasedPhoneNumber"]:
+    ) -> AsyncItemPaged["_models.PurchasedPhoneNumber"]:
         """Gets the list of all purchased phone numbers.
 
         Gets the list of all purchased phone numbers.

sdk/communication/azure-communication-phonenumbers/azure/communication/phonenumbers/_generated/models/_enums.py

@@ -99,6 +99,7 @@ class PhoneNumberType(str, Enum, metaclass=CaseInsensitiveEnumMeta):
 
     GEOGRAPHIC = "geographic"
     TOLL_FREE = "tollFree"
+    MOBILE = "mobile"
 
 
 class ReservationStatus(str, Enum, metaclass=CaseInsensitiveEnumMeta):