MicrosoftDocs / azure-docs-cli

Repository used to store content for the docs.microsoft.com content for the Azure CLI
https://docs.microsoft.com/cli/azure/
Creative Commons Attribution 4.0 International
211 stars 490 forks source link

Creation of backup-instance for Blob Storage Containers needs clarification #4763

Open Salazander opened 3 weeks ago

Salazander commented 3 weeks ago

Type of issue

Missing information

Feedback

The issues mentioned in https://github.com/Azure/azure-cli-extensions/issues/7499 can be avoided in the future by providing guidance on how to chain the commands az dataprotection backup-instance initialize-backupconfig and az dataprotection backup-instance initialize when setting up vaulted backups for blob storage containers.

The current docs mention

--backup-configuration
Backup configuration for backup. Use this parameter to configure protection for AzureKubernetesService.

The docs could mention how to generate the backup-configuration for blob containers. The fact that AzureKubernetesService are mentioned explicitly suggests to the reader that this parameter is not relevant for other use-cases.

Page URL

https://learn.microsoft.com/en-us/cli/azure/dataprotection/backup-instance?view=azure-cli-latest#az-dataprotection-backup-instance-initialize-backupconfig

Content source URL

https://github.com/MicrosoftDocs/azure-docs-cli/blob/main/latest/docs-ref-autogen/dataprotection/backup-instance.yml

Author

@dbradish-microsoft

Document Id

463aa6af-5d08-2929-b244-6abfc9baf3b2

PesalaPavan commented 2 weeks ago

@Salazander Thanks for your feedback! I've assigned this issue to the author who will investigate and update as appropriate.

dbradish-microsoft commented 2 weeks ago

@AbhishekMallick-MS, In looking for az dataprotection backup-instance%, it looks like you have written the following conceptual articles that use this command prefix:

The only doc that uses az dataprotection backup-instance initialize-backupconfig is for AKS. Can you please implement the customer request for one of the Azure Blob articles?