Skip to content

[BC]Kusto breacking changes announcement#29495

Merged
Pan-Qi merged 2 commits into
Azure:mainfrom
JiaSeng-v:jiaseng/Kusto-breakingchanges
May 5, 2026
Merged

[BC]Kusto breacking changes announcement#29495
Pan-Qi merged 2 commits into
Azure:mainfrom
JiaSeng-v:jiaseng/Kusto-breakingchanges

Conversation

@JiaSeng-v
Copy link
Copy Markdown
Contributor

@JiaSeng-v JiaSeng-v commented May 4, 2026

Description

Mandatory Checklist

  • SHOULD update ChangeLog.md file(s) appropriately
    • Update src/{{SERVICE}}/{{SERVICE}}/ChangeLog.md.
      • A snippet outlining the change(s) made in the PR should be written under the ## Upcoming Release header in the past tense.
    • Should not change ChangeLog.md if no new release is required, such as fixing test case only.
  • SHOULD regenerate markdown help files if there is cmdlet API change. Instruction
  • SHOULD have proper test coverage for changes in pull request.
  • SHOULD NOT adjust version of module manually in pull request

@JiaSeng-v JiaSeng-v requested review from Pan-Qi, VeryEarly and Copilot May 4, 2026 08:41
@JiaSeng-v JiaSeng-v added the Breaking Change Preannounce This PR adds preannouncement about upcoming breaking change label May 4, 2026
@azure-client-tools-bot-prd
Copy link
Copy Markdown

Thanks for your contribution! The pull request validation has started. Please revisit this comment for updated status.

@JiaSeng-v JiaSeng-v added the autorest v4 migration pr migrating module from generated by autorest.powershell v3 to v4 label May 4, 2026
@JiaSeng-v JiaSeng-v mentioned this pull request May 4, 2026
6 tasks
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 updates the Kusto module to surface an upcoming breaking-change announcement (Az v16.0.0 / May 2026) via AutoRest preview-announcement directives and cmdlet-level PreviewMessage attributes, along with some regenerated module metadata/solution updates.

Changes:

  • Added AutoRest preview-announcement directives for multiple Az.Kusto cmdlet groups to display a breaking-change preview banner.
  • Added [...Runtime.PreviewMessage(...)] attributes to several custom Kusto cmdlets to emit the breaking-change preview message.
  • Regenerated/updated Kusto module artifacts (module manifest metadata, solution structure, generation IDs) and added a resources/README.md.

Reviewed changes

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

Show a summary per file
File Description
src/Kusto/Kusto/help/New-AzKustoScript.md Updates help example text (currently introduces a script-name typo).
src/Kusto/Kusto/Az.Kusto.psd1 Regenerated manifest metadata; updates Az.Accounts minimum version and some manifest fields.
src/Kusto/Kusto.sln Solution structure/configuration updates (currently introduces a leading blank line).
src/Kusto/Kusto.Autorest/resources/README.md Adds standard resources folder documentation.
src/Kusto/Kusto.Autorest/README.md Adds breaking-change preview announcement directives for cmdlets.
src/Kusto/Kusto.Autorest/Properties/AssemblyInfo.cs Adds AssemblyInfo for the AutoRest project (minor comment typo present).
src/Kusto/Kusto.Autorest/generate-info.json Updates generation ID.
src/Kusto/Kusto.Autorest/docs/Az.Kusto.md Updates module docs metadata (regenerated).
src/Kusto/Kusto.Autorest/custom/Update-AzKustoDataConnection.ps1 Adds PreviewMessage attribute for breaking-change announcement.
src/Kusto/Kusto.Autorest/custom/Update-AzKustoDatabase.ps1 Adds PreviewMessage attribute for breaking-change announcement.
src/Kusto/Kusto.Autorest/custom/New-AzKustoDataConnection.ps1 Adds PreviewMessage attribute for breaking-change announcement.
src/Kusto/Kusto.Autorest/custom/New-AzKustoDatabase.ps1 Adds PreviewMessage attribute for breaking-change announcement.
src/Kusto/Kusto.Autorest/custom/Invoke-AzKustoDataConnectionValidation.ps1 Adds PreviewMessage attribute for breaking-change announcement.

```

The above command creates a Kusto database script named "newkustoscript" in the resource group "testrg".
The above command creates a Kusto database script named "newkustocript" in the resource group "testrg".
Comment thread src/Kusto/Kusto.sln
@@ -1,4 +1,4 @@



# Modules that must be imported into the global environment prior to importing this module
RequiredModules = @(@{ModuleName = 'Az.Accounts'; ModuleVersion = '4.0.1'; })
RequiredModules = @(@{ModuleName = 'Az.Accounts'; ModuleVersion = '5.4.0'; })
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// Code generated by Microsoft (R) AutoRest Code Generator.Changes may cause incorrect behavior and will be lost if the code
Comment on lines +154 to +172
# Breaking change preview messages for Az v16.0.0 migration to autorest v4
- where:
verb: Add
subject: ^ClusterCalloutPolicy$|^ClusterLanguageExtension$|^DatabasePrincipal$
set:
preview-announcement:
preview-message: "*****************************************************************************************\\r\\n* This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *\\r\\n* At least one change applies to this cmdlet. *\\r\\n* See all possible breaking changes at https://go.microsoft.com/fwlink/?linkid=2333486 *\\r\\n**************************************************************************************************"
- where:
verb: Get
subject: ^AttachedDatabaseConfiguration$|^Cluster$|^ClusterCalloutPolicy$|^ClusterFollowerDatabase$|^ClusterFollowerDatabaseGet$|^ClusterLanguageExtension$|^ClusterOutboundNetworkDependencyEndpoint$|^ClusterPrincipalAssignment$|^ClusterSku$|^Database$|^DatabasePrincipal$|^DatabasePrincipalAssignment$|^DataConnection$|^ManagedPrivateEndpoint$|^OperationsResult$|^PrivateEndpointConnection$|^PrivateLinkResource$|^SandboxCustomImage$|^Script$|^Sku$
set:
preview-announcement:
preview-message: "*****************************************************************************************\\r\\n* This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *\\r\\n* At least one change applies to this cmdlet. *\\r\\n* See all possible breaking changes at https://go.microsoft.com/fwlink/?linkid=2333486 *\\r\\n**************************************************************************************************"
- where:
verb: Invoke
subject: ^DetachClusterFollowerDatabase$|^InviteDatabaseFollower$
set:
preview-announcement:
preview-message: "*****************************************************************************************\\r\\n* This cmdlet will undergo a breaking change in Az v16.0.0, to be released on May 2026. *\\r\\n* At least one change applies to this cmdlet. *\\r\\n* See all possible breaking changes at https://go.microsoft.com/fwlink/?linkid=2333486 *\\r\\n**************************************************************************************************"
@Pan-Qi Pan-Qi merged commit 1e50b82 into Azure:main May 5, 2026
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

autorest v4 migration pr migrating module from generated by autorest.powershell v3 to v4 Breaking Change Preannounce This PR adds preannouncement about upcoming breaking change

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants