check before: 2025-02-01
Product:
Teams
Platform:
Online, US Instances, World tenant
Status:
Change type:
Admin impact, Feature update, Updated message
Links:
Details:
Summary:
The Get-CsPhoneNumberAssignment cmdlet page size limit will be updated to a maximum of 1,000 numbers per query. The rollout will begin in early February 2025 and complete by late February 2025. Requests exceeding this limit will result in a "Bad request" starting January 6, 2025.
Details:
Updated February 20, 2025: We have updated the rollout timeline below. Thank you for your patience.
To maintain the best performance and reliability of our service, we are updating the page size limit for the phone number retrieval API (Get-CsPhoneNumberAssignment cmdlet) to a maximum of 1,000 numbers per query.
[When this will happen:]
General Availability (Worldwide, GCC): We will begin rolling out early February 2025 (previously mid-January) and expect to complete by late February 2025 (previously mid-February).
Change Category:
XXXXXXX ... free basic plan only
Scope:
XXXXXXX ... free basic plan only
Release Phase:
Created:
2024-12-07
updated:
2025-02-21
Task Type
XXXXXXX ... free basic plan only
Docu to Check
XXXXXXX ... free basic plan only
MS How does it affect me
XXXXXXX ... free basic plan only
MS Preperations
XXXXXXX ... free basic plan only
MS Urgency
XXXXXXX ... free basic plan only
MS workload name
XXXXXXX ... free basic plan only
summary for non-techies**
XXXXXXX ... free basic plan only
Direct effects for Operations**
API Request Limit Change
The maximum page size limit for the Get-CsPhoneNumberAssignment cmdlet will be reduced to 1,000 numbers per query, leading to potential disruptions in automated scripts or applications that rely on retrieving more than 1,000 numbers at once.
- roles: IT Administrators, Developers
- references: https://learn.microsoft.com/en-us/powershell/module/teams/get-csphonenumberassignment?view=teams-ps
Increased Error Rates
Requests exceeding the new limit will result in 'Bad request' errors, which can lead to increased support tickets and user frustration if not communicated properly beforehand.
- roles: Support Staff, End Users
- references: https://learn.microsoft.com/en-us/powershell/module/teams/get-csphonenumberassignment?view=teams-ps
Operational Disruption
If users or systems are not prepared for the new limit, it may cause operational disruptions, especially for those relying on bulk number retrieval for reporting or management purposes.
- roles: IT Administrators, Business Analysts
- references: https://learn.microsoft.com/en-us/powershell/module/teams/get-csphonenumberassignment?view=teams-ps
Configutation Options**
XXXXXXX ... paid membership only
Opportunities**
Optimized API Usage
With the new page size limit of 1,000 numbers per query, organizations can optimize their API usage by batching requests more efficiently. This will reduce the number of API calls required and improve the performance of number retrieval operations.
- next-steps: Analyze current API call patterns and adjust scripts or applications to batch requests in compliance with the new limit. Provide training to relevant staff on the updated usage.
- roles: IT Administrators, Developers, Operations Managers
- references: https://learn.microsoft.com/en-us/powershell/module/teams/get-csphonenumberassignment?view=teams-ps
Improved User Experience in Number Management
By adapting to the new limit, IT can ensure that users experience fewer errors related to 'Bad requests'. This will enhance the overall user experience when managing phone numbers in Teams, as users will be less likely to encounter issues when retrieving their assignments.
- next-steps: Communicate the changes to end-users and provide guidance on how to retrieve phone numbers effectively. Update any user-facing documentation to reflect the new limits and best practices.
- roles: End Users, Support Teams, Help Desk Staff
- references: https://learn.microsoft.com/en-us/powershell/module/teams/export-csacquiredphonenumber?view=teams-ps
Cost-Effective Resource Allocation
With a better understanding of the new API limits, organizations can allocate resources more effectively, reducing unnecessary API calls and potential licensing costs associated with over-usage of API resources.
- next-steps: Review current API usage metrics and identify areas where costs can be reduced. Implement monitoring tools to track API usage post-update.
- roles: Finance Teams, IT Administrators, Operations Managers
- references: https://learn.microsoft.com/en-us/powershell/module/teams/get-csphonenumberassignment?view=teams-ps
Potentional Risks**
XXXXXXX ... paid membership only
IT Security**
XXXXXXX ... paid membership only
explanation for non-techies**
XXXXXXX ... free basic plan only
** AI generated content. This information must be reviewed before use.
a free basic plan is required to see more details. Sign up here
A cloudsocut.one plan is required to see all the changed details. If you are already a customer, choose login.
If you are new to cloudscout.one please choose a plan.
change history
| Date | Property | old | new |
| 2025-02-21 | MC Last Updated | 01/24/2025 22:18:04 | 2025-02-20T15:51:43Z |
| 2025-02-21 | MC Messages | Updated January 24, 2025: We have updated the rollout timeline below. Thank you for your patience.
To maintain the best performance and reliability of our service, we are updating the page size limit for the phone number retrieval API (Get-CsPhoneNumberAssignment cmdlet) to a maximum of 1,000 numbers per query. [When this will happen:] General Availability (Worldwide, GCC): We will begin rolling out early February 2025 (previously mid-January) and expect to complete by mid-February 2025 (previously late January). | Updated February 20, 2025: We have updated the rollout timeline below. Thank you for your patience.
To maintain the best performance and reliability of our service, we are updating the page size limit for the phone number retrieval API (Get-CsPhoneNumberAssignment cmdlet) to a maximum of 1,000 numbers per query. [When this will happen:] General Availability (Worldwide, GCC): We will begin rolling out early February 2025 (previously mid-January) and expect to complete by late February 2025 (previously mid-February). |
| 2025-02-21 | MC End Time | 03/30/2025 09:00:00 | 2025-04-07T09:00:00Z |
| 2025-02-21 | MC Summary | The update to Get-CsPhoneNumberAssignment cmdlet limits phone number retrieval to 1,000 numbers per query, starting January 6, 2025. Rollout begins early February and ends mid-February 2025. Exceeding this limit will result in a "Bad request." Users should adjust their requests accordingly. | The Get-CsPhoneNumberAssignment cmdlet page size limit will be updated to a maximum of 1,000 numbers per query. The rollout will begin in early February 2025 and complete by late February 2025. Requests exceeding this limit will result in a "Bad request" starting January 6, 2025. |
| 2025-01-25 | MC Messages | Updated January 9, 2025: We have updated the rollout timeline below. Thank you for your patience.
To maintain the best performance and reliability of our service, we are updating the page size limit for the phone number retrieval API (Get-CsPhoneNumberAssignment cmdlet) to a maximum of 1,000 numbers per query. [When this will happen:] General Availability (Worldwide, GCC): We will begin rolling out mid-January 2025 (previously early January) and expect to complete by late January 2025 (previously mid-January). | Updated January 24, 2025: We have updated the rollout timeline below. Thank you for your patience.
To maintain the best performance and reliability of our service, we are updating the page size limit for the phone number retrieval API (Get-CsPhoneNumberAssignment cmdlet) to a maximum of 1,000 numbers per query. [When this will happen:] General Availability (Worldwide, GCC): We will begin rolling out early February 2025 (previously mid-January) and expect to complete by mid-February 2025 (previously late January). |
| 2025-01-25 | MC Last Updated | 01/09/2025 23:01:09 | 2025-01-24T22:18:04Z |
| 2025-01-25 | MC Summary | The update to Get-CsPhoneNumberAssignment cmdlet limits phone number retrieval to 1,000 numbers per query, starting January 6, 2025. Rollout begins mid-January and ends late January 2025. Exceeding this limit will result in a "Bad request." Users should adjust their requests accordingly. | The update to Get-CsPhoneNumberAssignment cmdlet limits phone number retrieval to 1,000 numbers per query, starting January 6, 2025. Rollout begins early February and ends mid-February 2025. Exceeding this limit will result in a "Bad request." Users should adjust their requests accordingly. |
| 2025-01-10 | MC Messages | To maintain the best performance and reliability of our service, we are updating the page size limit for the phone number retrieval API (Get-CsPhoneNumberAssignment cmdlet) to a maximum of 1,000 numbers per query.
[When this will happen:] General Availability (Worldwide, GCC): We will begin rolling out early January 2025 and expect to complete by mid-January 2025. | Updated January 9, 2025: We have updated the rollout timeline below. Thank you for your patience.
To maintain the best performance and reliability of our service, we are updating the page size limit for the phone number retrieval API (Get-CsPhoneNumberAssignment cmdlet) to a maximum of 1,000 numbers per query. [When this will happen:] General Availability (Worldwide, GCC): We will begin rolling out mid-January 2025 (previously early January) and expect to complete by late January 2025 (previously mid-January). |
| 2025-01-10 | MC Title | Update to Get-CsPhoneNumberAssignment | (Updated) Update to Get-CsPhoneNumberAssignment |
| 2025-01-10 | MC Last Updated | 12/07/2024 00:39:14 | 2025-01-09T23:01:09Z |
| 2025-01-10 | MC MessageTagNames | Feature update, Admin impact | Updated message, Feature update, Admin impact |
| 2025-01-10 | MC Summary | The Get-CsPhoneNumberAssignment cmdlet's page size limit is being updated to a maximum of 1,000 numbers per query. Starting January 6, 2025, requests exceeding this limit will result in an error. Organizations should adjust their requests accordingly to avoid issues. | The update to Get-CsPhoneNumberAssignment cmdlet limits phone number retrieval to 1,000 numbers per query, starting January 6, 2025. Rollout begins mid-January and ends late January 2025. Exceeding this limit will result in a "Bad request." Users should adjust their requests accordingly. |
Last updated 4 weeks ago
