mirror of
https://github.com/home-assistant/developers.home-assistant.git
synced 2025-07-10 10:56:28 +00:00
Document API options for excluding DB from backups (#1941)
This commit is contained in:
parent
82d39c795b
commit
23209d9e53
@ -763,12 +763,13 @@ Create a full backup.
|
|||||||
|
|
||||||
**Payload:**
|
**Payload:**
|
||||||
|
|
||||||
| key | type | optional | description |
|
| key | type | optional | description |
|
||||||
| ---------- | -------------- | -------- | ---------------------------------------------- |
|
| ------------------------------ | -------------- | -------- | ---------------------------------------------------- |
|
||||||
| name | string | True | The name you want to give the backup |
|
| name | string | True | The name you want to give the backup |
|
||||||
| password | string | True | The password you want to give the backup |
|
| password | string | True | The password you want to give the backup |
|
||||||
| compressed | boolean | True | `false` to create uncompressed backups |
|
| compressed | boolean | True | `false` to create uncompressed backups |
|
||||||
| location | string or null | True | Name of a backup mount or `null` for /backup |
|
| location | string or null | True | Name of a backup mount or `null` for /backup |
|
||||||
|
| homeassistant_exclude_database | boolean | True | Exclude the Home Assistant database file from backup |
|
||||||
|
|
||||||
**Example response:**
|
**Example response:**
|
||||||
|
|
||||||
@ -800,15 +801,16 @@ Create a partial backup.
|
|||||||
|
|
||||||
**Payload:**
|
**Payload:**
|
||||||
|
|
||||||
| key | type | optional | description |
|
| key | type | optional | description |
|
||||||
| ------------- | -------------- | -------- | ---------------------------------------------- |
|
| ------------------------------ | -------------- | -------- | ---------------------------------------------------- |
|
||||||
| name | string | True | The name you want to give the backup |
|
| name | string | True | The name you want to give the backup |
|
||||||
| password | string | True | The password you want to give the backup |
|
| password | string | True | The password you want to give the backup |
|
||||||
| homeassistant | boolean | True | Add home assistant core settings to the backup |
|
| homeassistant | boolean | True | Add home assistant core settings to the backup |
|
||||||
| addons | list | True | A list of strings representing add-on slugs |
|
| addons | list | True | A list of strings representing add-on slugs |
|
||||||
| folders | list | True | A list of strings representing directories |
|
| folders | list | True | A list of strings representing directories |
|
||||||
| compressed | boolean | True | `false` to create uncompressed backups |
|
| compressed | boolean | True | `false` to create uncompressed backups |
|
||||||
| location | string or null | True | Name of a backup mount or `null` for /backup |
|
| location | string or null | True | Name of a backup mount or `null` for /backup |
|
||||||
|
| homeassistant_exclude_database | boolean | True | Exclude the Home Assistant database file from backup |
|
||||||
|
|
||||||
**You need to supply at least one key in the payload.**
|
**You need to supply at least one key in the payload.**
|
||||||
|
|
||||||
@ -990,22 +992,24 @@ Returns information about the Home Assistant core
|
|||||||
|
|
||||||
**Returned data:**
|
**Returned data:**
|
||||||
|
|
||||||
| key | type | description |
|
| key | type | description |
|
||||||
| ---------------- | -------------- | ---------------------------------------------------------- |
|
| ------------------------ | -------------- | ---------------------------------------------------------- |
|
||||||
| version | string | The installed core version |
|
| version | string | The installed core version |
|
||||||
| version_latest | string | The latest published version in the active channel |
|
| version_latest | string | The latest published version in the active channel |
|
||||||
| update_available | boolean | `true` if an update is available |
|
| update_available | boolean | `true` if an update is available |
|
||||||
| arch | string | The architecture of the host (armhf, aarch64, i386, amd64) |
|
| arch | string | The architecture of the host (armhf, aarch64, i386, amd64) |
|
||||||
| machine | string | The machine type that is running the host |
|
| machine | string | The machine type that is running the host |
|
||||||
| ip_address | string | The internal docker IP address to the supervisor |
|
| ip_address | string | The internal docker IP address to the supervisor |
|
||||||
| image | string | The container image that is running the core |
|
| image | string | The container image that is running the core |
|
||||||
| boot | boolean | `true` if it should start on boot |
|
| boot | boolean | `true` if it should start on boot |
|
||||||
| port | int | The port Home Assistant is running on |
|
| port | int | The port Home Assistant is running on |
|
||||||
| ssl | boolean | `true` if Home Assistant is using SSL |
|
| ssl | boolean | `true` if Home Assistant is using SSL |
|
||||||
| watchdog | boolean | `true` if watchdog is enabled |
|
| watchdog | boolean | `true` if watchdog is enabled |
|
||||||
| wait_boot | int | Max time to wait during boot |
|
| wait_boot | int | Max time to wait during boot |
|
||||||
| audio_input | string or null | The description of the audio input device |
|
| audio_input | string or null | The description of the audio input device |
|
||||||
| audio_output | string or null | The description of the audio output device |
|
| audio_output | string or null | The description of the audio output device |
|
||||||
|
| backups_exclude_database | boolean | Backups exclude Home Assistant database file by default |
|
||||||
|
|
||||||
|
|
||||||
**Example response:**
|
**Example response:**
|
||||||
|
|
||||||
@ -1044,17 +1048,18 @@ Passing `image`, `refresh_token`, `audio_input` or `audio_output` with `null` re
|
|||||||
|
|
||||||
**Payload:**
|
**Payload:**
|
||||||
|
|
||||||
| key | type | description |
|
| key | type | description |
|
||||||
| -------------- | -------------- | ----------------------------------- |
|
| ------------------------ | -------------- | ----------------------------------------------------------- |
|
||||||
| boot | boolean | Start Core on boot |
|
| boot | boolean | Start Core on boot |
|
||||||
| image | string or null | Name of custom image |
|
| image | string or null | Name of custom image |
|
||||||
| port | int | The port that Home Assistant run on |
|
| port | int | The port that Home Assistant run on |
|
||||||
| ssl | boolean | `true` to enable SSL |
|
| ssl | boolean | `true` to enable SSL |
|
||||||
| watchdog | boolean | `true` to enable the watchdog |
|
| watchdog | boolean | `true` to enable the watchdog |
|
||||||
| wait_boot | int | Time to wait for Core to startup |
|
| wait_boot | int | Time to wait for Core to startup |
|
||||||
| refresh_token | string or null | Token to authenticate with Core |
|
| refresh_token | string or null | Token to authenticate with Core |
|
||||||
| audio_input | string or null | Profile name for audio input |
|
| audio_input | string or null | Profile name for audio input |
|
||||||
| audio_output | string or null | Profile name for audio output |
|
| audio_output | string or null | Profile name for audio output |
|
||||||
|
| backups_exclude_database | boolean | `true` to exclude Home Assistant database file from backups |
|
||||||
|
|
||||||
**You need to supply at least one key in the payload.**
|
**You need to supply at least one key in the payload.**
|
||||||
|
|
||||||
|
@ -190,19 +190,20 @@ The `content` key of a backup object contains the following keys:
|
|||||||
|
|
||||||
## Backup details
|
## Backup details
|
||||||
|
|
||||||
| key | type | description |
|
| key | type | description |
|
||||||
| ------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------ |
|
| ------------------------------ | -------------- | ------------------------------------------------------------------------------------------------------------------------- |
|
||||||
| slug | string | A generated slug for the backup |
|
| slug | string | A generated slug for the backup |
|
||||||
| type | string | The type of backup (full, partial) |
|
| type | string | The type of backup (full, partial) |
|
||||||
| name | string | The name given to the backup |
|
| name | string | The name given to the backup |
|
||||||
| date | string | ISO date string representation of the date the backup was created |
|
| date | string | ISO date string representation of the date the backup was created |
|
||||||
| size | string | The size of the backup in MB |
|
| size | string | The size of the backup in MB |
|
||||||
| protected | boolean | `true` if the backup is password protected |
|
| protected | boolean | `true` if the backup is password protected |
|
||||||
| location | string or null | The name of the backup mount it's stored on. `null` if it's stored locally. |
|
| location | string or null | The name of the backup mount it's stored on. `null` if it's stored locally. |
|
||||||
| homeassistant | string | The version of Home Assistant that was in use |
|
| homeassistant | string | The version of Home Assistant that was in use |
|
||||||
| addons | list | A list of add-ons in the backup. Add-ons are represented as a dictionary with these keys [`slug`,`name`,`version`,`size`] |
|
| addons | list | A list of add-ons in the backup. Add-ons are represented as a dictionary with these keys [`slug`,`name`,`version`,`size`] |
|
||||||
| repositories | list | A list of add-on repository URL's as strings |
|
| repositories | list | A list of add-on repository URL's as strings |
|
||||||
| folders | list | A list of strings representing directories |
|
| folders | list | A list of strings representing directories |
|
||||||
|
| homeassistant_exclude_database | boolean | `true` if the Home Assistant database file was excluded from this backup |
|
||||||
|
|
||||||
## Stats
|
## Stats
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user