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

检索应用程序快照

PDF

GET /accounts/{account_id}/k8s/v1/apps/{app_id}/appSnaps/{appSnap_id}

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

参数

名称 Type 在 Required Description

account_id

string

path

True

包含帐户资源的 ID

  • 示例：{{.Account}}

app_id

string

path

True

包含应用程序资源的 ID

appSnap_id

string

path

True

要列出的 appSnap 集合的 ID

响应

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

type

string

True

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

  • "application/astra-appSnap"

version

string

True

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

  • "1.0"

  • "1.1"

  • "1.2"

id

string

True

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

  • 符合 UUIDv4 架构

name

string

True

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

  • 最小长度：1

  • 最大长度：63

  • 符合 DNS 1123 标签架构

scheduleID

string

False

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

  • 符合 Astra 标识符架构

snapshotAppAsset

string

False

包含与快照对应的应用程序资产 ID 的 JSON 字符串。当应用程序快照的状态为"completed"时，将返回此字段。定义的值是：

  • 符合 Astra 标识符架构

状态

string

True

包含指示快照操作状态的值的 JSON 字符串。定义的值是：

  • "pending" - 应用程序快照计划进行发现

  • "discovering" - 正在发现应用程序快照

  • "running" - 应用快照运行正常

  • "completed" - 应用程序快照已完成

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

  • "removed" - 当前无法访问应用程序快照

  • "unknown" - 无法确定应用程序快照状态

stateUnready

数组[string]

True

JSON 字符串的 JSON 数组，每个数组指示应用程序快照无法转换为"running"或转换为"failed"的原因。定义的值是：

  • 最小长度：1

  • 最大长度：127

hookState

string

False

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

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

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

hookStateDetails

数组["type_astra_stateDetail"]

False

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

  • 最小项目数：0

元数据

"type_astra_metadata"

True

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

  • 符合 Astra 元数据架构如果在创建时未指定，则将创建没有标签的元数据对象。
响应示例 
{
  "type": "application/astra-appSnap",
  "version": "1.2",
  "id": "4f56a1df-8f47-541a-bd81-77260053a2f6",
  "name": "app-name-245",
  "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: 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"
}

定义

查看定义

additionalDetails

type_astra_stateDetail

名称 Type Required Description

type

string

True

标题

string

True

详细信息

string

True

additionalDetails

"additionalDetails"

False

类型 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

查询参数无效的原因