Create Backup

POST

/v1/deployments/{deployment_id}/backup

curl --request POST \
  --url https://api.cloud.agentums.ru/v1/deployments/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/backup \
  --header 'Authorization: Bearer <token>'

• Прод

Снять резервную копию тома агента (п. 42.5 ТЗ).

202, а не 200. Копию снимает сама машина — у нас нет к ней доступа, — и займёт это минуты. Ответ подтверждает заказ, а не готовность; готовность видна в списке копий.

Агент на время упаковки останавливается. Том — это живая база сессий, и копия, снятая с работающего агента, восстанавливается через раз. Секунды простоя честнее архива, который не разворачивается.

Authorizations

• bearerAuth

Parameters

Path Parameters

deployment_id

required

Deployment Id

string format: uuid

Responses

202

Successful Response

Media typeapplication/json

BackupOut

Одна резервная копия тома агента.

Ссылки на скачивание здесь НЕТ. Архив — это весь агент целиком: настройки, память, рабочая папка и переписка; адрес, по которому его заберёт любой, кому его переслали, не должен появляться в списке, который показывают на экране и отдают в поддержку. Восстановление придёт отдельным действием, как и доступ к машине.

object

created_at

Any of:

string

string format: date-time

null

null

error

Error

string

""

finished_at

Any of:

string

string format: date-time

null

null

id

required

Id

string format: uuid

size_bytes

Size Bytes

integer

0

status

required

Status

string

Example

{
  "error": "",
  "size_bytes": 0
}

422

Validation Error

Media typeapplication/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

ctx

Context

object

input

Input

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Example^generated

{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}