From ddd2df1b04daf597d8c4f0207d4bc52785aeccf5 Mon Sep 17 00:00:00 2001 From: Josef Zweck Date: Fri, 27 Dec 2024 16:00:06 +0100 Subject: [PATCH 1/3] Create azure_storage.markdown --- source/_integrations/azure_storage.markdown | 46 +++++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 source/_integrations/azure_storage.markdown diff --git a/source/_integrations/azure_storage.markdown b/source/_integrations/azure_storage.markdown new file mode 100644 index 00000000000..7ff6ca8d9ee --- /dev/null +++ b/source/_integrations/azure_storage.markdown @@ -0,0 +1,46 @@ +--- +title: Azure Storage +description: Instructions on how to setup Azure storage accounts to be used with backups. +ha_release: 2025.2 +ha_category: + - Backup +ha_iot_class: Cloud Polling +ha_config_flow: true +ha_domain: azure_storage +ha_codeowners: + - '@zweckj' +ha_integration_type: service +--- + +This integration allows you to use [Azure storage accounts](https://learn.microsoft.com/en-us/azure/storage/common/storage-account-overview) for use with Home Assistant Backups. + +{% include integrations/config_flow.md %} + +{% configuration_basic %} +Storage account name: + description: "The name of the storage account. Only the name, nothing else." +Container name: + description: "Blob container name to store the backups. If the container does not exist, it will be created. Defaults to `hass-backups`." +Storage account key: + description: "One of the two storage account keys. Used to authenticate against the storage account" +{% endconfiguration_basic %} + + +## Known Limitations + +- Only storage accounts that have a default URL `storageaccountname.blob.core.windows.net` are supported at this point +- Since only key based authentication is possible, this has to be enabled in your storage account. + +## Removing the integration + +This integration follows standard integration removal. No extra steps are required. + +{% include integrations/remove_device_service.md %} + +## Troubleshooting + +{% details "Authentication failure" %} + +Check that your storage account allows (`Shared Key` access)[https://learn.microsoft.com/en-us/azure/storage/common/shared-key-authorization-prevent?tabs=portal#remediate-authorization-via-shared-key]. + +{% enddetails %} From 94c7a6e3bab51e3f2f22eb1d672e24f67742e433 Mon Sep 17 00:00:00 2001 From: Josef Zweck Date: Fri, 27 Dec 2024 16:05:00 +0100 Subject: [PATCH 2/3] Fix markdown link syntax in Azure Storage doc --- source/_integrations/azure_storage.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/azure_storage.markdown b/source/_integrations/azure_storage.markdown index 7ff6ca8d9ee..55457664082 100644 --- a/source/_integrations/azure_storage.markdown +++ b/source/_integrations/azure_storage.markdown @@ -41,6 +41,6 @@ This integration follows standard integration removal. No extra steps are requir {% details "Authentication failure" %} -Check that your storage account allows (`Shared Key` access)[https://learn.microsoft.com/en-us/azure/storage/common/shared-key-authorization-prevent?tabs=portal#remediate-authorization-via-shared-key]. +Check that your storage account allows [`Shared Key` access](https://learn.microsoft.com/en-us/azure/storage/common/shared-key-authorization-prevent?tabs=portal#remediate-authorization-via-shared-key). {% enddetails %} From c3d2d60b7c14ca38a79af0c271356ec1d577ab0a Mon Sep 17 00:00:00 2001 From: Josef Zweck Date: Mon, 24 Feb 2025 21:05:36 +0100 Subject: [PATCH 3/3] Update source/_integrations/azure_storage.markdown Co-authored-by: Martin Hjelmare --- source/_integrations/azure_storage.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/azure_storage.markdown b/source/_integrations/azure_storage.markdown index 55457664082..094d5304f75 100644 --- a/source/_integrations/azure_storage.markdown +++ b/source/_integrations/azure_storage.markdown @@ -1,7 +1,7 @@ --- title: Azure Storage description: Instructions on how to setup Azure storage accounts to be used with backups. -ha_release: 2025.2 +ha_release: 2025.3 ha_category: - Backup ha_iot_class: Cloud Polling