API: Mention compressed parameter for performing backups (#1188)

Related to: https://github.com/home-assistant/supervisor/pull/3378
This commit is contained in:
Marco Trevisan 2022-02-03 10:25:26 +01:00 committed by GitHub
parent 47ed55f216
commit 4d2e55f16a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 15 additions and 11 deletions

View File

@ -711,6 +711,7 @@ Return a list of [Backups](api/supervisor/models.md#backup)
"type": "partial",
"size": 44,
"protected": true,
"compressed": true,
"content": {
"homeassistant": true,
"addons": ["awesome_addon"],
@ -729,10 +730,11 @@ Create a full backup.
**Payload:**
| key | type | optional | description |
| -------- | ------ | -------- | ------------------------------------------ |
| name | string | True | The name you want to give the backup |
| password | string | True | The password you want to give the backup |
| key | type | optional | description |
| ---------- | ------- | -------- | -----------------------------------------|
| name | string | True | The name 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 |
**Example response:**
@ -764,12 +766,13 @@ Create a partial backup.
**Payload:**
| key | type | optional | description |
| -------- | ------ | -------- | ------------------------------------------- |
| name | string | True | The name you want to give the backup |
| password | string | True | The password you want to give the backup |
| addons | list | True | A list of strings representing add-on slugs |
| folders | list | True | A list of strings representing directories |
| key | type | optional | description |
| ---------- | ------- | -------- | ------------------------------------------- |
| name | string | True | The name you want to give the backup |
| password | string | True | The password you want to give the backup |
| addons | list | True | A list of strings representing add-on slugs |
| folders | list | True | A list of strings representing directories |
| compressed | boolean | True | `false` to create uncompressed backups |
**You need to supply at least one key in the payload.**

View File

@ -175,7 +175,8 @@ These models are describing objects that are getting returned from the superviso
| name | string | The name given to the backup |
| type | string | The type of backup (full, partial) |
| protected | boolean | `true` if the backup is password protected |
| content | dictionary | A dictionary describing the content of the backup |
| content | dictionary | A dictionary describing the content of the backup |
| compressed | boolean | `true` if the backup is saved in a compressed archive |
### Backup -> content