AWS Security ChangesHomeSearch

AWS aws-backup: VM discovery requirements for vCenter folder path tag characters

Service: aws-backup · 2026-10-16 · Documentation medium

File: aws-backup/latest/devguide/vm-backups.md

Summary

Adds a 'VM discovery requirements' section explaining that Backup gateway persists each VM's vCenter folder path as an AWS tag, so VMs whose folder path contains characters invalid in tag values (e.g. parentheses, commas, question marks) are silently excluded from discovery and backup, with no metadata-sync status or error metric indication.

Security assessment

Documents a silent backup-coverage gap: VMs with unsupported folder-path characters are excluded from discovery without any error or status signal, which can leave workloads unprotected (data-protection/availability impact) rather than being an auth or encryption issue.

Evidence

+VMs in folders with other characters (such as parentheses `( )`, commas, or question marks) are excluded from discovery. The exclusion does not appear in the metadata-sync status or in error metrics. To include these VMs, rename the folder in vCenter to remove the unsupported characters, then wait for the next metadata sync.

Diff

diff --git a/aws-backup/latest/devguide/vm-backups.md b/aws-backup/latest/devguide/vm-backups.md
index 32c4ac2..7cfbf4a 100644
--- a//aws-backup/latest/devguide/vm-backups.md
+++ b//aws-backup/latest/devguide/vm-backups.md
@@ -7 +7 @@
-Supported VMsBackup consistencyBackup gatewayEndpoints
+Supported VMsVM discovery requirementsBackup consistencyBackup gatewayEndpoints
@@ -44,0 +45,6 @@ AWS Backup can back up and restore virtual machines managed by a VMware vCenter.
+## VM discovery requirements
+
+Backup gateway persists each virtual machine's vCenter folder path as an AWS tag on the discovered VM record. For a VM to be included in the hypervisor's VM list, every segment of its vCenter folder path must contain only characters valid in AWS tag values: letters, digits, spaces, and the following special characters: `_ . : / = + - @`.
+
+VMs in folders with other characters (such as parentheses `( )`, commas, or question marks) are excluded from discovery. The exclusion does not appear in the metadata-sync status or in error metrics. To include these VMs, rename the folder in vCenter to remove the unsupported characters, then wait for the next metadata sync.
+