jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-13 12:26:50 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add upload service docs to OneDrive (#37637)

Browse Source 
* add service docs

* Update onedrive.markdown

* Fix OneDrive config entry description

* Apply suggestions from code review

* Apply suggestions from code review

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
This commit is contained in:
Josef Zweck 2025-03-07 20:05:51 +01:00 committed by GitHub
parent 26bb2cc20e
commit c231846cab
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 20 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
source/_integrations/onedrive.markdown
View File

@ -18,7 +18,7 @@ ha_platforms:
- sensor
---
This integration allows you to use [Microsoft OneDrive](https://www.microsoft.com/en-us/microsoft-365/onedrive/online-cloud-storage) for [Home Assistant Backups](/common-tasks/general/#backups).
This integration allows you to use [OneDrive](https://www.microsoft.com/en-us/microsoft-365/onedrive/online-cloud-storage) for [Home Assistant Backups](/common-tasks/general/#backups) as well as uploading generic files to your OneDrive.
Backups will be created in a folder called `Home Assistant\backups_<id>` in the `App Folder` of your OneDrive by default.
`id` is part of your Home Assistant instance's unique id to allow backups from multiple instances to the same OneDrive account.
@ -85,6 +85,25 @@ The integration provides the following sensors, which are updated every 5 minute
A drive that is in **Drive state** `Exceeded` will be automatically frozen (meaning you can't upload any more backups & files), until you clear up enough storage.
{% endnote %}
## Actions
This integration provides the following actions:
### Action `onedrive.upload`
You can use the `onedrive.upload` action to upload files from Home Assistant
to OneDrive. For example, to upload `camera` snapshots.
{% details "Upload action details" %}
| Data attribute | Optional | Description | Example |
| ---------------------- | -------- | ----------- | --------|
| `filename` | no | Path to the file to upload. | /media/image.jpg |
| `destination_folder` | no | Folder inside your `Apps/Home Assistant` app folder that is the destination for the uploaded content. Will be created if it does not exist. Supports subfolders. | Snapshots/2025 |
| `config_entry_id` | no | The ID of the OneDrive config entry (the OneDrive you want to upload to). | a1bee602deade2b09bc522749bbce48e |
{% enddetails %}
## Automations
Get started with these automation examples.