Skip to content

Update planned-maintenance.md#408

Open
Kavya-KU wants to merge 1 commit intoMicrosoftDocs:mainfrom
Kavya-KU:patch-1
Open

Update planned-maintenance.md#408
Kavya-KU wants to merge 1 commit intoMicrosoftDocs:mainfrom
Kavya-KU:patch-1

Conversation

@Kavya-KU
Copy link
Copy Markdown

@Kavya-KU Kavya-KU commented Apr 9, 2026

Updated the FAQ section to address a concern raised by one of the customer that why Azure can't utilize the AKS planned maintenance window for the underlying VMSS platform related maintenance.

Updated the FAQ section to address a concern raised by one of the customer that why Azure can't utilize the AKS planned maintenance window for the underlying VMSS platform related maintenance.
@prmerger-automator
Copy link
Copy Markdown
Contributor

@Kavya-KU : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 1b8aca1:

✅ Validation status: passed

File Status Preview URL Details
articles/aks/planned-maintenance.md ✅Succeeded

For more details, please refer to the build report.

@v-regandowner v-regandowner requested a review from Copilot April 9, 2026 15:49
@v-regandowner
Copy link
Copy Markdown
Contributor

@schaffererin

Can you review the proposed changes?

IMPORTANT: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

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

Updates the AKS planned maintenance documentation FAQ to clarify that AKS planned maintenance windows don’t control Azure platform-level maintenance for the underlying VMSS.

Changes:

  • Added a new FAQ entry explaining the separation between AKS planned maintenance and VMSS host/platform maintenance, including how reboot-required maintenance is communicated.


### Can Azure utilize the AKS planned maintenance window for Azure platform‑level maintenance impacting the underlying VMSS that hosts the AKS node pools?

No. The AKS planned maintenance window is specifically intended to schedule and control AKS cluster and node image upgrades in Azure Kubernetes Service. It does not apply to Azure platform‑level maintenance on the underlying VMSS hosting the AKS node pools, they operate independently with no direct dependency between them.
Copy link

Copilot AI Apr 9, 2026

Choose a reason for hiding this comment

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

The sentence ends with a comma splice: "...hosting the AKS node pools, they operate...". Split into two sentences (or use a semicolon) so the relationship is grammatically correct and easier to read.

Suggested change
No. The AKS planned maintenance window is specifically intended to schedule and control AKS cluster and node image upgrades in Azure Kubernetes Service. It does not apply to Azure platform‑level maintenance on the underlying VMSS hosting the AKS node pools, they operate independently with no direct dependency between them.
No. The AKS planned maintenance window is specifically intended to schedule and control AKS cluster and node image upgrades in Azure Kubernetes Service. It does not apply to Azure platform‑level maintenance on the underlying VMSS hosting the AKS node pools. They operate independently with no direct dependency between them.

Copilot uses AI. Check for mistakes.
Comment on lines +464 to +465
Azure periodically performs platform updates to enhance the reliability, performance, and security of the underlying host infrastructure for virtual machines. These updates may include patching software components, upgrading networking infrastructure, or decommissioning hardware. Platform maintenance can be either rebootless or require a reboot.
For maintenance events that require a reboot, customers are notified in advance through Maintenance Notifications, which include a `self‑service phase` that typically last up to four weeks.
Copy link

Copilot AI Apr 9, 2026

Choose a reason for hiding this comment

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

A couple of grammar/style issues here: (1) Microsoft style guidance prefers "might" for possibility, so "These updates may include..." should be "might include"; (2) subject/verb agreement: "phase" is singular, so "typically last" should be "typically lasts".

Suggested change
Azure periodically performs platform updates to enhance the reliability, performance, and security of the underlying host infrastructure for virtual machines. These updates may include patching software components, upgrading networking infrastructure, or decommissioning hardware. Platform maintenance can be either rebootless or require a reboot.
For maintenance events that require a reboot, customers are notified in advance through Maintenance Notifications, which include a `self‑service phase` that typically last up to four weeks.
Azure periodically performs platform updates to enhance the reliability, performance, and security of the underlying host infrastructure for virtual machines. These updates might include patching software components, upgrading networking infrastructure, or decommissioning hardware. Platform maintenance can be either rebootless or require a reboot.
For maintenance events that require a reboot, customers are notified in advance through Maintenance Notifications, which include a `self‑service phase` that typically lasts up to four weeks.

Copilot uses AI. Check for mistakes.

If a newer version of the node image becomes available during the maintenance window, AKS performs a second upgrade to ensure that your node pools are running the latest version. This behavior is normal and doesn't indicate an issue.

### Can Azure utilize the AKS planned maintenance window for Azure platform‑level maintenance impacting the underlying VMSS that hosts the AKS node pools?
Copy link

Copilot AI Apr 9, 2026

Choose a reason for hiding this comment

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

The FAQ heading is very long and uses "utilize" (wordy). Consider shortening it and using "use" to improve scanability in the FAQ list (for example, "Can Azure use the AKS planned maintenance window for platform maintenance on the underlying VMSS?").

Suggested change
### Can Azure utilize the AKS planned maintenance window for Azure platform‑level maintenance impacting the underlying VMSS that hosts the AKS node pools?
### Can Azure use the AKS planned maintenance window for platform maintenance on the underlying VMSS?

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants