Skip to content

[IoT] BREAKING CHANGE: Migrate az iot hub devicestream command group to CLI extension#31913

Merged
zhoxing-ms merged 1 commit intoAzure:devfrom
vilit1:removedevicestream
Aug 8, 2025
Merged

[IoT] BREAKING CHANGE: Migrate az iot hub devicestream command group to CLI extension#31913
zhoxing-ms merged 1 commit intoAzure:devfrom
vilit1:removedevicestream

Conversation

@vilit1
Copy link
Copy Markdown
Contributor

@vilit1 vilit1 commented Aug 4, 2025

Related command
az iot hub devicestream

Description
Removes the az iot hub devicestream command group from this code base. The commands are moved to the azure-iot extension with the same functionality (Azure/azure-iot-cli-extension#748)

This way we can keep one version of the IoT Hub API in this repository.

Testing Guide
Removed the command from test_iot_hub, ran the recorded tests, and ran the tests live. The recorded tests did not change.

History Notes
[IoT] Remove az iot hub devicestream. To use this command, please install the latest version of the extension azure-iot.


This checklist is used to make sure that common guidelines for a pull request are followed.

Copilot AI review requested due to automatic review settings August 4, 2025 19:46
@azure-client-tools-bot-prd
Copy link
Copy Markdown

azure-client-tools-bot-prd bot commented Aug 4, 2025

️✔️AzureCLI-FullTest
️✔️acr
️✔️latest
️✔️3.12
️✔️3.9
️✔️acs
️✔️latest
️✔️3.12
️✔️3.9
️✔️advisor
️✔️latest
️✔️3.12
️✔️3.9
️✔️ams
️✔️latest
️✔️3.12
️✔️3.9
️✔️apim
️✔️latest
️✔️3.12
️✔️3.9
️✔️appconfig
️✔️latest
️✔️3.12
️✔️3.9
️✔️appservice
️✔️latest
️✔️3.12
️✔️3.9
️✔️aro
️✔️latest
️✔️3.12
️✔️3.9
️✔️backup
️✔️latest
️✔️3.12
️✔️3.9
️✔️batch
️✔️latest
️✔️3.12
️✔️3.9
️✔️batchai
️✔️latest
️✔️3.12
️✔️3.9
️✔️billing
️✔️latest
️✔️3.12
️✔️3.9
️✔️botservice
️✔️latest
️✔️3.12
️✔️3.9
️✔️cdn
️✔️latest
️✔️3.12
️✔️3.9
️✔️cloud
️✔️latest
️✔️3.12
️✔️3.9
️✔️cognitiveservices
️✔️latest
️✔️3.12
️✔️3.9
️✔️compute_recommender
️✔️latest
️✔️3.12
️✔️3.9
️✔️computefleet
️✔️latest
️✔️3.12
️✔️3.9
️✔️config
️✔️latest
️✔️3.12
️✔️3.9
️✔️configure
️✔️latest
️✔️3.12
️✔️3.9
️✔️consumption
️✔️latest
️✔️3.12
️✔️3.9
️✔️container
️✔️latest
️✔️3.12
️✔️3.9
️✔️containerapp
️✔️latest
️✔️3.12
️✔️3.9
️✔️core
️✔️latest
️✔️3.12
️✔️3.9
️✔️cosmosdb
️✔️latest
️✔️3.12
️✔️3.9
️✔️databoxedge
️✔️latest
️✔️3.12
️✔️3.9
️✔️dls
️✔️latest
️✔️3.12
️✔️3.9
️✔️dms
️✔️latest
️✔️3.12
️✔️3.9
️✔️eventgrid
️✔️latest
️✔️3.12
️✔️3.9
️✔️eventhubs
️✔️latest
️✔️3.12
️✔️3.9
️✔️feedback
️✔️latest
️✔️3.12
️✔️3.9
️✔️find
️✔️latest
️✔️3.12
️✔️3.9
️✔️hdinsight
️✔️latest
️✔️3.12
️✔️3.9
️✔️identity
️✔️latest
️✔️3.12
️✔️3.9
️✔️iot
️✔️latest
️✔️3.12
️✔️3.9
️✔️keyvault
️✔️latest
️✔️3.12
️✔️3.9
️✔️lab
️✔️latest
️✔️3.12
️✔️3.9
️✔️managedservices
️✔️latest
️✔️3.12
️✔️3.9
️✔️maps
️✔️latest
️✔️3.12
️✔️3.9
️✔️marketplaceordering
️✔️latest
️✔️3.12
️✔️3.9
️✔️monitor
️✔️latest
️✔️3.12
️✔️3.9
️✔️mysql
️✔️latest
️✔️3.12
️✔️3.9
️✔️netappfiles
️✔️latest
️✔️3.12
️✔️3.9
️✔️network
️✔️latest
️✔️3.12
️✔️3.9
️✔️policyinsights
️✔️latest
️✔️3.12
️✔️3.9
️✔️privatedns
️✔️latest
️✔️3.12
️✔️3.9
️✔️profile
️✔️latest
️✔️3.12
️✔️3.9
️✔️rdbms
️✔️latest
️✔️3.12
️✔️3.9
️✔️redis
️✔️latest
️✔️3.12
️✔️3.9
️✔️relay
️✔️latest
️✔️3.12
️✔️3.9
️✔️resource
️✔️latest
️✔️3.12
️✔️3.9
️✔️role
️✔️latest
️✔️3.12
️✔️3.9
️✔️search
️✔️latest
️✔️3.12
️✔️3.9
️✔️security
️✔️latest
️✔️3.12
️✔️3.9
️✔️servicebus
️✔️latest
️✔️3.12
️✔️3.9
️✔️serviceconnector
️✔️latest
️✔️3.12
️✔️3.9
️✔️servicefabric
️✔️latest
️✔️3.12
️✔️3.9
️✔️signalr
️✔️latest
️✔️3.12
️✔️3.9
️✔️sql
️✔️latest
️✔️3.12
️✔️3.9
️✔️sqlvm
️✔️latest
️✔️3.12
️✔️3.9
️✔️storage
️✔️latest
️✔️3.12
️✔️3.9
️✔️synapse
️✔️latest
️✔️3.12
️✔️3.9
️✔️telemetry
️✔️latest
️✔️3.12
️✔️3.9
️✔️util
️✔️latest
️✔️3.12
️✔️3.9
️✔️vm
️✔️latest
️✔️3.12
️✔️3.9

@azure-client-tools-bot-prd
Copy link
Copy Markdown

azure-client-tools-bot-prd bot commented Aug 4, 2025

❌AzureCLI-BreakingChangeTest
❌iot
rule cmd_name rule_message suggest_message
1012 - SubgroupRemove iot hub devicestream sub group iot hub devicestream removed please confirm sub group iot hub devicestream removed

Please submit your Breaking Change Pre-announcement ASAP if you haven't already. Please note:

  • Breaking changes can only be merged during the designated breaking change window
  • A pre-announcement must be released at least one month in advance

For more details on how to introduce breaking changes, refer to the documentation: azure-cli/doc/how_to_introduce_breaking_changes.md

@yonzhan
Copy link
Copy Markdown
Collaborator

yonzhan commented Aug 4, 2025

Thank you for your contribution! We will review the pull request and get back to you soon.

@github-actions
Copy link
Copy Markdown

github-actions bot commented Aug 4, 2025

The git hooks are available for azure-cli and azure-cli-extensions repos. They could help you run required checks before creating the PR.

Please sync the latest code with latest dev branch (for azure-cli) or main branch (for azure-cli-extensions).
After that please run the following commands to enable git hooks:

pip install azdev --upgrade
azdev setup -c <your azure-cli repo path> -r <your azure-cli-extensions repo path>

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR removes the az iot hub devicestream command group from the Azure CLI codebase, migrating its functionality to the azure-iot extension to maintain a single version of the IoT Hub API in the main repository.

  • Removes the iot_hub_devicestream_show function and associated command registration
  • Removes test coverage for the devicestream show command
  • Cleans up help documentation and API version references

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.

Show a summary per file
File Description
test_iot_commands.py Removes test case for devicestream show command
custom.py Removes the iot_hub_devicestream_show function implementation
commands.py Removes command group registration for devicestream commands
_help.py Removes help documentation for devicestream commands
_shared.py Removes ad hoc API version reference for devicestream functionality
Comments suppressed due to low confidence (1)

@zhoxing-ms
Copy link
Copy Markdown
Contributor

Because this PR may cause a breaking change, it is recommended to release it in the breaking change window

@vilit1
Copy link
Copy Markdown
Contributor Author

vilit1 commented Aug 5, 2025

Because this PR may cause a breaking change, it is recommended to release it in the breaking change window

@zhoxing-ms
Does removal of a preview command still count as a breaking change? Or does it count as a breaking change because this command was present for a while?

If this is a breaking change, I can adjust this pr (or create a new pr) to deprecate rather than fully remove and do a follow up removal pr the next month.

@digimaun
Copy link
Copy Markdown
Member

digimaun commented Aug 5, 2025

@zhoxing-ms this command was classified as preview, was using a legacy API and has minimal usage - do these conditions warrant a breaking change?

@zhoxing-ms
Copy link
Copy Markdown
Contributor

Does removal of a preview command still count as a breaking change? Or does it count as a breaking change because this command was present for a while?

Yes, exactly

@zhoxing-ms
Copy link
Copy Markdown
Contributor

this command was classified as preview, was using a legacy API and has minimal usage - do these conditions warrant a breaking change?

May I ask do you have Telemetry to evaluate how much usage it has?

@zhoxing-ms zhoxing-ms changed the title [IoT] Remove az iot hub devicestream [IoT] BREAKING CHANGE: Remove az iot hub devicestream Aug 7, 2025
@vilit1
Copy link
Copy Markdown
Contributor Author

vilit1 commented Aug 7, 2025

Here is the data for July:
image
This is extremely small compared to other command usage.

@zhoxing-ms zhoxing-ms changed the title [IoT] BREAKING CHANGE: Remove az iot hub devicestream [IoT] BREAKING CHANGE: Migrate az iot hub devicestream command group to CLI extension Aug 8, 2025
@zhoxing-ms zhoxing-ms merged commit 204d34b into Azure:dev Aug 8, 2025
59 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants