新しいASUPリソースを作成します

パラメータ

Name	を入力します	入力	必須	説明
account_id	string	path（パス）	True	包含するアカウントリソースのID 例：{{.Account}}

Name

を入力します

入力

必須

説明

account_id

string

path（パス）

True

包含するアカウントリソースのID

例：{{.Account}}

要求の本文

作成するASUP APIリソースの希望値を示します。

Name	を入力します	必須	説明
を入力します	string	True	リソースのメディアタイプ。定義された値は次のとおりです： "application/astra-asup"
バージョン	string	True	リソースのバージョン。定義された値は次のとおりです： "1.0"
アップロード	string	True	作成が成功した後にAutoSupportバンドルをアップロードするかどうかを示す値を含むJSON文字列。定義値は次のとおりです：「true」 - AutoSupportバンドルをアップロードします。「false」 - AutoSupportバンドルをアップロードしないでください。
dataWindowStart	string	False	AutoSupportバンドルデータ収集ウィンドウの開始時刻を示すタイムスタンプを含むJSON文字列。デフォルトは「dataWindowEnd」キー値の24時間前です。「dataWindowEnd」キー値より前に発生する必要があります。最大で、リクエストの現在時刻から7日前までです。定義値は次のとおりです： ISO-8601 Date Time Schemaに準拠
dataWindowEnd	string	False	AutoSupportバンドルデータ収集ウィンドウの終了時刻を示すタイムスタンプを含むJSON文字列。デフォルトでは、リクエスト時の現在時刻が使用されます。定義された値は次のとおりです： ISO-8601 Date Time Schemaに準拠
メタデータ	"type_astra_metadata"	False	リソースに関連付けられた、クライアントおよびサービス指定のメタデータ。定義された値は次のとおりです： Astra メタデータスキーマに準拠します。作成時に指定しない場合、ラベルのないメタデータオブジェクトが作成されます。

Name

を入力します

必須

説明

を入力します

string

True

リソースのメディアタイプ。定義された値は次のとおりです：

"application/astra-asup"

バージョン

string

True

リソースのバージョン。定義された値は次のとおりです：

"1.0"

アップロード

string

True

作成が成功した後にAutoSupportバンドルをアップロードするかどうかを示す値を含むJSON文字列。定義値は次のとおりです：

「true」 - AutoSupportバンドルをアップロードします。
「false」 - AutoSupportバンドルをアップロードしないでください。

dataWindowStart

string

False

AutoSupportバンドルデータ収集ウィンドウの開始時刻を示すタイムスタンプを含むJSON文字列。デフォルトは「dataWindowEnd」キー値の24時間前です。「dataWindowEnd」キー値より前に発生する必要があります。最大で、リクエストの現在時刻から7日前までです。定義値は次のとおりです：

ISO-8601 Date Time Schemaに準拠

dataWindowEnd

string

False

AutoSupportバンドルデータ収集ウィンドウの終了時刻を示すタイムスタンプを含むJSON文字列。デフォルトでは、リクエスト時の現在時刻が使用されます。定義された値は次のとおりです：

ISO-8601 Date Time Schemaに準拠

メタデータ

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

Name	を入力します	必須	説明
を入力します	string	True	リソースのメディアタイプ。定義された値は次のとおりです： "application/astra-asup"
バージョン	string	True	リソースのバージョン。定義された値は次のとおりです： "1.0"
ID	string	True	リソースのグローバル一意識別子。定義された値は次のとおりです： UUIDv4スキーマに準拠
creationState	string	True	AutoSupport バンドルの作成状態を示す値を含むJSON文字列。「completed」および「partial」状態の場合、「/」または「application/gzip」を含むAcceptヘッダーを指定してリソースURIに対してGETを実行することで、バンドルをダウンロードできます。定義された値は次のとおりです：「running」 - AutoSupportバンドルの生成は正常に実行されています。「完了」 - AutoSupport バンドル生成が完了しました。 "partial" - AutoSupport バンドル生成は完了しましたが、一部のデータがバンドルに含まれていませんでした。 "failed" - AutoSupport バンドル生成が恒久的な障害状態になっています。
creationStateDetails	配列["type_astra_stateDetail"]	True	「creationState」が「partial」または「failed」に移行した理由に関する追加の詳細をリストするJSONオブジェクトのJSON配列。詳細情報がない場合は、この配列は空になります。最小アイテム数：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"です）。「完了」- AutoSupportバンドルのアップロードが完了しました。 "failed" - AutoSupport バンドルのアップロードが恒久的に失敗しています。
uploadStateDetails	配列["type_astra_stateDetail"]	False	「uploadState」が「failed」に移行した理由に関する追加の詳細をリストするJSONオブジェクトのJSON配列。詳細情報がない場合は、この配列は空になります。最小アイテム数：0
triggerType	string	True	ASUPリソースの作成をトリガーした要因を示す値を含むJSON文字列。定義値は次のとおりです： "manual" - ASUP リソースおよび関連する AutoSupport バンドルは手動で作成されました。「scheduled」 - ASUPリソースおよび関連するAutoSupportバンドルは、設定されたスケジュールに従って作成されました。
dataWindowStart	string	True	AutoSupportバンドルデータ収集ウィンドウの開始時刻を示すタイムスタンプを含むJSON文字列。デフォルトは「dataWindowEnd」キー値の24時間前です。「dataWindowEnd」キー値より前に発生する必要があります。最大で、リクエストの現在時刻から7日前までです。定義値は次のとおりです： ISO-8601 Date Time Schemaに準拠
dataWindowEnd	string	True	AutoSupportバンドルデータ収集ウィンドウの終了時刻を示すタイムスタンプを含むJSON文字列。デフォルトでは、リクエスト時の現在時刻が使用されます。定義された値は次のとおりです： ISO-8601 Date Time Schemaに準拠
メタデータ	"type_astra_metadata"	True	リソースに関連付けられた、クライアントおよびサービス指定のメタデータ。定義された値は次のとおりです： Astra メタデータスキーマに準拠します。作成時に指定しない場合、ラベルのないメタデータオブジェクトが作成されます。

Name

を入力します

必須

説明

を入力します

string

True

リソースのメディアタイプ。定義された値は次のとおりです：

"application/astra-asup"

バージョン

string

True

リソースのバージョン。定義された値は次のとおりです：

"1.0"

ID

string

True

リソースのグローバル一意識別子。定義された値は次のとおりです：

UUIDv4スキーマに準拠

creationState

string

True

AutoSupport バンドルの作成状態を示す値を含むJSON文字列。「completed」および「partial」状態の場合、「/」または「application/gzip」を含むAcceptヘッダーを指定してリソースURIに対してGETを実行することで、バンドルをダウンロードできます。定義された値は次のとおりです：

「running」 - AutoSupportバンドルの生成は正常に実行されています。
「完了」 - AutoSupport バンドル生成が完了しました。
"partial" - AutoSupport バンドル生成は完了しましたが、一部のデータがバンドルに含まれていませんでした。
"failed" - AutoSupport バンドル生成が恒久的な障害状態になっています。

creationStateDetails

配列["type_astra_stateDetail"]

True

「creationState」が「partial」または「failed」に移行した理由に関する追加の詳細をリストするJSONオブジェクトのJSON配列。詳細情報がない場合は、この配列は空になります。

最小アイテム数：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"です）。
「完了」- AutoSupportバンドルのアップロードが完了しました。
"failed" - AutoSupport バンドルのアップロードが恒久的に失敗しています。

uploadStateDetails

配列["type_astra_stateDetail"]

False

「uploadState」が「failed」に移行した理由に関する追加の詳細をリストするJSONオブジェクトのJSON配列。詳細情報がない場合は、この配列は空になります。

最小アイテム数：0

triggerType

string

True

ASUPリソースの作成をトリガーした要因を示す値を含むJSON文字列。定義値は次のとおりです：

"manual" - ASUP リソースおよび関連する AutoSupport バンドルは手動で作成されました。
「scheduled」 - ASUPリソースおよび関連するAutoSupportバンドルは、設定されたスケジュールに従って作成されました。

dataWindowStart

string

True

AutoSupportバンドルデータ収集ウィンドウの開始時刻を示すタイムスタンプを含むJSON文字列。デフォルトは「dataWindowEnd」キー値の24時間前です。「dataWindowEnd」キー値より前に発生する必要があります。最大で、リクエストの現在時刻から7日前までです。定義値は次のとおりです：

ISO-8601 Date Time Schemaに準拠

dataWindowEnd

string

True

AutoSupportバンドルデータ収集ウィンドウの終了時刻を示すタイムスタンプを含むJSON文字列。デフォルトでは、リクエスト時の現在時刻が使用されます。定義された値は次のとおりです：

ISO-8601 Date Time Schemaに準拠

メタデータ

"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

Name	を入力します	必須
を入力します	string	True
タイトル	string	True
詳細	string	True
ステータス	string	True
correlationID	string	False

Name

を入力します

必須

説明

を入力します

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

Name	を入力します	必須	説明
を入力します	string	True
タイトル	string	True
詳細	string	True
ステータス	string	True
correlationID	string	False
invalidFields	配列["invalidFields"]	False	無効なリクエストボディフィールドのリスト

Name

を入力します

必須

説明

を入力します

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

Name	を入力します	必須	説明
を入力します	string	True
タイトル	string	True
詳細	string	True
ステータス	string	True
correlationID	string	False
invalidFields	配列["invalidFields"]	False	無効なリクエストボディフィールドのリスト

Name

を入力します

必須

説明

を入力します

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

Name	を入力します	必須
を入力します	string	True
タイトル	string	True
詳細	string	True
ステータス	string	True
correlationID	string	False

Name

を入力します

必須

説明

を入力します

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

Name	を入力します	必須
を入力します	string	True
タイトル	string	True
詳細	string	True
ステータス	string	True
correlationID	string	False

Name

を入力します

必須

説明

を入力します

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_label

Name	を入力します	必須	説明
名前	string	True
Value	string	True

Name

を入力します

必須

説明

名前

string

True

Value

string

True

type_astra_metadata

リソースに関連付けられた、クライアントおよびサービス指定のメタデータ。定義された値は次のとおりです：

Astra メタデータスキーマに準拠します。作成時に指定しない場合、ラベルのないメタデータオブジェクトが作成されます。

Name	を入力します	必須
ラベル	配列["type_astra_label"]	True
作成タイムスタンプ	string	True
modificationTimestamp	string	True
作成者	string	True
modifiedBy	string	False

Name

を入力します

必須

説明

ラベル

配列["type_astra_label"]

True

作成タイムスタンプ

string

True

modificationTimestamp

string

True

作成者

string

True

modifiedBy

string

False

additionalDetails

type_astra_stateDetail

Name	を入力します	必須
を入力します	string	True
タイトル	string	True
詳細	string	True
additionalDetails	"additionalDetails"	False

Name

を入力します

必須

説明

を入力します

string

True

タイトル

string

True

詳細

string

True

additionalDetails

"additionalDetails"

False

invalidParams

Name	を入力します	必須	説明
名前	string	True	無効なクエリパラメータの名前
理由	string	True	クエリパラメータが無効な理由

Name

を入力します

必須

説明

名前

string

True

無効なクエリパラメータの名前

理由

string

True

クエリパラメータが無効な理由

invalidFields

Name	を入力します	必須	説明
名前	string	True	無効なリクエストボディフィールドの名前
理由	string	True	リクエスト本文フィールドが無効な理由

Name

を入力します

必須

説明

名前

string

True

無効なリクエストボディフィールドの名前

理由

string

True

リクエスト本文フィールドが無効な理由

新しいASUPリソースを作成します

Creating your file...

パラメータ

要求の本文

応答

応答

応答

応答

応答

エラー

用語の意味