创建新 ASUP 资源

参数

名称	Type	在	Required	Description
account_id	string	path	True	包含帐户资源的 ID 示例：{{.Account}}

名称

Type

在

Required

Description

account_id

string

path

True

包含帐户资源的 ID

示例：{{.Account}}

请求正文

指示要创建的 ASUP API 资源的所需值。

名称	Type	Required	Description
type	string	True	资源的媒体类型。定义的值为： "application/astra-asup"
version	string	True	资源的版本。定义的值为： "1.0"
上传	string	True	包含指示是否在成功创建后上传 AutoSupport 捆绑包的值的 JSON 字符串。定义的值为： "true" - 上传 AutoSupport 捆绑包。 "false" - 不要上传 AutoSupport 捆绑包。
dataWindowStart	string	False	包含指示 AutoSupport 捆绑包数据收集窗口开始时间的时间戳的 JSON 字符串。默认为"dataWindowEnd"键值之前的 24 小时。必须位于"dataWindowEnd"键值之前。最多距离当前请求时间提前 7 天。定义的值为：符合 ISO-8601 日期时间方案
dataWindowEnd	string	False	JSON 字符串，包含指示 AutoSupport 捆绑包数据收集窗口结束时间的时间戳。默认为请求的当前时间。定义的值是：符合 ISO-8601 日期时间方案
元数据	"type_astra_metadata"	False	与资源关联的客户端和服务指定的元数据。定义的值为：符合 Astra 元数据架构如果在创建时未指定，则将创建没有标签的元数据对象。

名称

Type

Required

Description

type

string

True

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

"application/astra-asup"

version

string

True

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

"1.0"

上传

string

True

包含指示是否在成功创建后上传 AutoSupport 捆绑包的值的 JSON 字符串。定义的值为：

"true" - 上传 AutoSupport 捆绑包。
"false" - 不要上传 AutoSupport 捆绑包。

dataWindowStart

string

False

包含指示 AutoSupport 捆绑包数据收集窗口开始时间的时间戳的 JSON 字符串。默认为"dataWindowEnd"键值之前的 24 小时。必须位于"dataWindowEnd"键值之前。最多距离当前请求时间提前 7 天。定义的值为：

符合 ISO-8601 日期时间方案

dataWindowEnd

string

False

JSON 字符串，包含指示 AutoSupport 捆绑包数据收集窗口结束时间的时间戳。默认为请求的当前时间。定义的值是：

符合 ISO-8601 日期时间方案

元数据

"type_astra_metadata"

False

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

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

请求示例

{
  "type": "application/astra-asup",
  "version": "1.0",
  "upload": "true"
}

响应

Status: 201, Returns the newly created asup resource in the JSON response body.

名称	Type	Required	Description
type	string	True	资源的媒体类型。定义的值为： "application/astra-asup"
version	string	True	资源的版本。定义的值为： "1.0"
id	string	True	资源的全局唯一标识符。定义的值为：符合 UUIDv4 架构
creationState	string	True	包含指示 AutoSupport 捆绑包创建状态的值的 JSON 字符串。对于"completed"和"partial"状态，可以通过使用包含"/"或"application/gzip"的 Accept 标头执行资源 URI 的 GET 来下载捆绑包。定义的值为： "running" - AutoSupport 捆绑包生成正在正常运行。 "completed" - AutoSupport 捆绑包生成已完成。 "partial" - AutoSupport 捆绑包生成已完成，但捆绑包中未包含某些数据。 "failed" - AutoSupport 捆绑包生成处于永久失败状态。
creationStateDetails	数组["type_astra_stateDetail"]	True	JSON 对象的 JSON 数组，列出有关 "creationState" 转换为 "partial" 或 "failed" 的其他详细信息。如果没有可用的详细信息，则此数组将为空。最小项目数：0
上传	string	True	包含指示是否在成功创建后上传 AutoSupport 捆绑包的值的 JSON 字符串。定义的值为： "true" - 上传 AutoSupport 捆绑包。 "false" - 不要上传 AutoSupport 捆绑包。
uploadState	string	False	包含指示 AutoSupport 捆绑包上传状态（如果已请求）的值的 JSON 字符串。定义的值为： "pending" - 计划在 AutoSupport 捆绑包创建完成时上传 AutoSupport 捆绑包（"creationState" 为 "running"）。 "blocked" - 未尝试 AutoSupport 捆绑包上传，因为未创建捆绑包（"creationState" 为 "failed"）或上传被阻止，因为没有许可证。 "running" - AutoSupport 捆绑包上传正常运行（"creationState" 为 "completed" 或 "partial"）。 "completed" - AutoSupport 捆绑包上传已完成。 "failed" - AutoSupport 捆绑上传处于永久失败状态。
uploadStateDetails	数组["type_astra_stateDetail"]	False	JSON 对象的 JSON 数组，列出有关"uploadState"转换为"failed"的原因的其他详细信息。如果没有可用的详细信息，此数组将为空。最小项目数：0
triggerType	string	True	包含一个值的 JSON 字符串，该值指示触发 ASUP 资源创建的原因。定义的值为： "manual" - ASUP 资源和相关 AutoSupport 捆绑包是手动创建的。 "scheduled" - ASUP 资源和相关 AutoSupport 捆绑包是根据配置的计划创建的。
dataWindowStart	string	True	包含指示 AutoSupport 捆绑包数据收集窗口开始时间的时间戳的 JSON 字符串。默认为"dataWindowEnd"键值之前的 24 小时。必须位于"dataWindowEnd"键值之前。最多距离当前请求时间提前 7 天。定义的值为：符合 ISO-8601 日期时间方案
dataWindowEnd	string	True	JSON 字符串，包含指示 AutoSupport 捆绑包数据收集窗口结束时间的时间戳。默认为请求的当前时间。定义的值是：符合 ISO-8601 日期时间方案
元数据	"type_astra_metadata"	True	与资源关联的客户端和服务指定的元数据。定义的值为：符合 Astra 元数据架构如果在创建时未指定，则将创建没有标签的元数据对象。

名称

Type

Required

Description

type

string

True

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

"application/astra-asup"

version

string

True

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

"1.0"

id

string

True

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

符合 UUIDv4 架构

creationState

string

True

包含指示 AutoSupport 捆绑包创建状态的值的 JSON 字符串。对于"completed"和"partial"状态，可以通过使用包含"/"或"application/gzip"的 Accept 标头执行资源 URI 的 GET 来下载捆绑包。定义的值为：

"running" - AutoSupport 捆绑包生成正在正常运行。
"completed" - AutoSupport 捆绑包生成已完成。
"partial" - AutoSupport 捆绑包生成已完成，但捆绑包中未包含某些数据。
"failed" - AutoSupport 捆绑包生成处于永久失败状态。

creationStateDetails

数组["type_astra_stateDetail"]

True

JSON 对象的 JSON 数组，列出有关 "creationState" 转换为 "partial" 或 "failed" 的其他详细信息。如果没有可用的详细信息，则此数组将为空。

最小项目数：0

上传

string

True

包含指示是否在成功创建后上传 AutoSupport 捆绑包的值的 JSON 字符串。定义的值为：

"true" - 上传 AutoSupport 捆绑包。
"false" - 不要上传 AutoSupport 捆绑包。

uploadState

string

False

包含指示 AutoSupport 捆绑包上传状态（如果已请求）的值的 JSON 字符串。定义的值为：

"pending" - 计划在 AutoSupport 捆绑包创建完成时上传 AutoSupport 捆绑包（"creationState" 为 "running"）。
"blocked" - 未尝试 AutoSupport 捆绑包上传，因为未创建捆绑包（"creationState" 为 "failed"）或上传被阻止，因为没有许可证。
"running" - AutoSupport 捆绑包上传正常运行（"creationState" 为 "completed" 或 "partial"）。
"completed" - AutoSupport 捆绑包上传已完成。
"failed" - AutoSupport 捆绑上传处于永久失败状态。

uploadStateDetails

数组["type_astra_stateDetail"]

False

JSON 对象的 JSON 数组，列出有关"uploadState"转换为"failed"的原因的其他详细信息。如果没有可用的详细信息，此数组将为空。

最小项目数：0

triggerType

string

True

包含一个值的 JSON 字符串，该值指示触发 ASUP 资源创建的原因。定义的值为：

"manual" - ASUP 资源和相关 AutoSupport 捆绑包是手动创建的。
"scheduled" - ASUP 资源和相关 AutoSupport 捆绑包是根据配置的计划创建的。

dataWindowStart

string

True

包含指示 AutoSupport 捆绑包数据收集窗口开始时间的时间戳的 JSON 字符串。默认为"dataWindowEnd"键值之前的 24 小时。必须位于"dataWindowEnd"键值之前。最多距离当前请求时间提前 7 天。定义的值为：

符合 ISO-8601 日期时间方案

dataWindowEnd

string

True

JSON 字符串，包含指示 AutoSupport 捆绑包数据收集窗口结束时间的时间戳。默认为请求的当前时间。定义的值是：

符合 ISO-8601 日期时间方案

元数据

"type_astra_metadata"

True

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

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

响应示例

{
  "type": "application/astra-asup",
  "version": "1.0",
  "id": "9950003f-a1c7-5ca7-8930-06eec25f60aa",
  "creationState": "running",
  "creationStateDetails": [],
  "upload": "true",
  "uploadState": "pending",
  "uploadStateDetails": [],
  "triggerType": "manual",
  "dataWindowStart": "2020-08-05T12:24:00.000000Z",
  "dataWindowEnd": "2020-08-06T12:24:52.000000Z",
  "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
type	string	True
标题	string	True
详细信息	string	True
状态	string	True
correlationID	string	False

名称

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
invalidFields	数组["invalidFields"]	False	无效请求正文字段列表

名称

Type

Required

Description

type

string

True

标题

string

True

详细信息

string

True

状态

string

True

correlationID

string

False

invalidFields

数组["invalidFields"]

False

无效请求正文字段列表

响应示例

{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

响应

Status: 409, Conflict

名称	Type	Required	Description
type	string	True
标题	string	True
详细信息	string	True
状态	string	True
correlationID	string	False
invalidFields	数组["invalidFields"]	False	无效请求正文字段列表

名称

Type

Required

Description

type

string

True

标题

string

True

详细信息

string

True

状态

string

True

correlationID

string

False

invalidFields

数组["invalidFields"]

False

无效请求正文字段列表

响应示例

{
  "type": "https://astra.netapp.io/problems/10",
  "title": "JSON resource conflict",
  "detail": "The request body JSON contains a field that conflicts with an idempotent value.",
  "status": "409"
}

响应

Status: 403, Forbidden

名称	Type	Required
type	string	True
标题	string	True
详细信息	string	True
状态	string	True
correlationID	string	False

名称

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
type	string	True
标题	string	True
详细信息	string	True
状态	string	True
correlationID	string	False

名称

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"
}

定义

查看定义

类型 Astra 标签

名称	Type	Required	Description
name	string	True
value	string	True

名称

Type

Required

Description

name

string

True

value

string

True

type_astra_metadata

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

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

名称	Type	Required
labels	数组["类型 Astra 标签"]	True
creationTimestamp	string	True
modificationTimestamp	string	True
已创建	string	True
modifiedBy	string	False

名称

Type

Required

Description

labels

数组["类型 Astra 标签"]

True

creationTimestamp

string

True

modificationTimestamp

string

True

已创建

string

True

modifiedBy

string

False

additionalDetails

type_astra_stateDetail

名称	Type	Required
type	string	True
标题	string	True
详细信息	string	True
additionalDetails	"additionalDetails"	False

名称

Type

Required

Description

type

string

True

标题

string

True

详细信息

string

True

additionalDetails

"additionalDetails"

False

invalidParams

名称	Type	Required	Description
name	string	True	无效查询参数的名称
原因	string	True	查询参数无效的原因

名称

Type

Required

Description

name

string

True

无效查询参数的名称

原因

string

True

查询参数无效的原因

invalidFields

名称	Type	Required	Description
name	string	True	无效请求正文字段的名称
原因	string	True	请求正文字段无效的原因

名称

Type

Required

Description

name

string

True

无效请求正文字段的名称

原因

string

True

请求正文字段无效的原因

创建新 ASUP 资源

Creating your file...

参数

请求正文

响应

响应

响应

响应

响应

错误

定义