Skip to main content
Astra Automation
本产品推出了新版本。
简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

检索应用程序备份

PDF

GET /accounts/{account_id}/topology/v1/appBackups/{appBackup_id}

返回 JSON 响应正文中存储的 Application Backup API 资源。

参数

名称 Type 在 Required Description

account_id

string

path

True

包含帐户资源的 ID

  • 示例：{{.Account}}

appBackup_id

string

path

True

要列出的 appBackup 集合的 ID

响应

Status: 200, Returns the stored Application Backup API resource in the JSON response body.
名称 Type Required Description

type

string

True

资源的媒体类型。定义的值为：

  • "application/astra-appBackup"

version

string

True

资源的版本。定义的值为：

  • "1.0"

  • "1.1"

  • "1.2"

id

string

True

资源的全局唯一标识符。定义的值为：

  • 符合 UUIDv4 架构

name

string

True

包含用户指定的备份名称的 JSON 字符串。如果未指定，或者当备份由计划启动时，系统会分配备份的名称。定义的值为：

  • 最小长度：1

  • 最大长度：63

  • 符合 DNS 1123 标签架构

bucketID

string

True

包含一个可选存储桶 ID 的 JSON 字符串，该 ID 指示将在创建时存储备份的位置。如果未指定，则使用系统选择的存储桶。如果没有可用的存储桶，则在创建时将返回错误。定义的值为：

  • 符合 Astra 标识符架构

snapshotID

string

False

包含用于创建备份的快照的 JSON 字符串。要创建备份，可以在创建时指定与要备份的应用程序关联的快照 ID。如果未指定，将为备份创建新的快照。定义的值为：

  • 符合 Astra 标识符架构

scheduleID

string

False

包含可选计划 ID 的 JSON 字符串，指示备份是由计划触发的，以及哪个计划触发了备份。仅适用于由计划启动的备份。定义的值为：

  • 符合 Astra 标识符架构

状态

string

True

包含指示备份操作状态的值的 JSON 字符串。定义的值为：

  • "pending" - 应用程序备份已计划进行发现

  • "discovering" - 正在发现应用程序备份

  • "running" - 应用程序备份正在正常运行

  • "completed" - 应用程序备份已成功完成

  • "failed" - 应用程序备份处于永久失败状态

  • "removed" - 当前无法访问应用程序备份

  • "unknown" - 无法确定应用程序备份状态

stateUnready

数组[string]

True

JSON 字符串的 JSON 数组，每个字符串指示应用程序备份无法转换为"running"的原因，或者它已转换为"failed"或"removed"的原因。定义的值为：

  • 最小长度：1

  • 最大长度：127

hookState

string

False

JSON 字符串包含一个值，该值指示作为快照的一部分运行的任何执行挂钩的状态。定义的值为：

  • "failed" - 一个或多个执行挂钩出现故障

  • "success" - 没有或多个适用的挂钩，所有挂钩均成功

hookStateDetails

数组["type_astra_stateDetail"]

False

JSON 对象的 JSON 数组，其中列出了有关"hookState"转换为"失败"的其他详细信息。如果没有可用的详细信息，此数组将为空。

  • 最小项目数：0

backupCreationTimestamp

string

False

JSON 字符串，包含指示备份时间的时间戳。定义的值为：

  • 符合 ISO-8601 日期时间方案

totalBytes

数字

False

包含备份中字节总数的 JSON 数字。

bytesDone

数字

False

JSON 数字，包含正在运行的备份所备份的字节数。备份完成后，它与 totalBytes 字段匹配。

percentDone

数字

False

包含正在运行的备份完成百分比的 JSON 编号。备份完成后，设置为"100"。

元数据

"type_astra_metadata"

True

与资源关联的客户端和服务指定的元数据。定义的值为：

  • 符合 Astra 元数据架构如果在创建时未指定，则将创建没有标签的元数据对象。
响应示例 
{
  "type": "application/astra-appBackup",
  "version": "1.2",
  "id": "bab39d53-2d04-5297-b92e-58df89a2117b",
  "name": "app-name-245",
  "bucketID": "0afbe357-a717-4c7a-8b3d-d0368959c8de",
  "scheduleID": "1fe83650-9b3c-41ef-bb25-a2910c19c33e",
  "state": "pending",
  "stateUnready": [],
  "metadata": {
    "labels": [],
    "creationTimestamp": "2022-10-06T20:58:16.305662Z",
    "modificationTimestamp": "2022-10-06T20:58:16.305662Z",
    "createdBy": "8f84cf09-8036-51e4-b579-bd30cb07b269"
  }
}

响应

Status: 401, Unauthorized
名称 Type Required Description

type

string

True

标题

string

True

详细信息

string

True

状态

string

True

correlationID

string

False
响应示例 
{
  "type": "https://astra.netapp.io/problems/3",
  "title": "Missing bearer token",
  "detail": "The request is missing the required bearer token.",
  "status": "401"
}

响应

Status: 400, Bad request
名称 Type Required Description

type

string

True

标题

string

True

详细信息

string

True

状态

string

True

correlationID

string

False

invalidParams

数组["invalidParams"]

False

无效查询参数列表
响应示例 
{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

响应

Status: 403, Forbidden
名称 Type Required Description

type

string

True

标题

string

True

详细信息

string

True

状态

string

True

correlationID

string

False
响应示例 
{
  "type": "https://astra.netapp.io/problems/11",
  "title": "Operation not permitted",
  "detail": "The requested operation isn't permitted.",
  "status": "403"
}

响应

Status: 500, Internal server error
名称 Type Required Description

type

string

True

标题

string

True

详细信息

string

True

状态

string

True

correlationID

string

False
响应示例 
{
  "type": "https://astra.netapp.io/problems/95",
  "title": "Backup not retrieved",
  "detail": "The backup wasn't retrieved because of an internal server issue.",
  "status": "500"
}

错误

Status: 404, Not found
名称 Type Required Description

type

string

True

标题

string

True

详细信息

string

True

状态

string

True

correlationID

string

False
错误响应示例 
{
  "type": "https://astra.netapp.io/problems/2",
  "title": "Collection not found",
  "detail": "The collection specified in the request URI wasn't found.",
  "status": "404"
}

定义

查看定义

type_astra_stateDetail

名称 Type Required Description

type

string

True

标题

string

True

详细信息

string

True

类型 Astra 标签

名称 Type Required Description

name

string

True

value

string

True

type_astra_metadata

与资源关联的客户端和服务指定的元数据。定义的值为：

  • 符合 Astra 元数据架构如果在创建时未指定，则将创建没有标签的元数据对象。

名称 Type Required Description

labels

数组["类型 Astra 标签"]

True

creationTimestamp

string

True

modificationTimestamp

string

True

已创建

string

True

modifiedBy

string

False

invalidParams

名称 Type Required Description

name

string

True

无效查询参数的名称

原因

string

True

查询参数无效的原因