Skip to main content
24.02
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

アップグレードを変更する

PDF

PUT /accounts/{account_id}/core/v1/upgrades/{upgrade_id}

保存されているリソース全体を、指定されたJSONリクエストボディに置き換えますが、ユーザーが変更できないキー値は保持します。

副作用

  • アップグレードは、目的の状態に基づいてスケジュール設定または実行されます。

パラメータ

Name を入力します 入力 必須 説明

account_id

string

path（パス）

True

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

  • 例：{{.Account}}

upgrade_id

string

path（パス）

True

リストするアップグレード コレクションの ID

要求の本文

保存されているリソース全体を、指定されたJSONリクエストボディに置き換えますが、ユーザーが変更できないキー値は保持します。

副作用

  • アップグレードは、目的の状態に基づいてスケジュール設定または実行されます。

Name を入力します 必須 説明

を入力します

string

True

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

  • "application/astra-upgrade"

バージョン

string

True

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

  • "1.0"

  • "1.1"

ID

string

False

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

  • UUIDv4スキーマに準拠

componentName

string

False

アップグレード可能なソフトウェアの種類名を含むJSON文字列。定義された値は次のとおりです：

  • "acc"

  • "acs"

  • 「trident」

  • "kubernetes"

componentInstance

string

False

アップグレード可能なコンポーネントのURIを含むJSON文字列。定義された値は次のとおりです：

  • 最小長さ：3

  • 最大長さ：4095

componentID

string

False

アップグレード可能なコンポーネントのグローバルに一意な識別子を含むJSON文字列。定義された値は次のとおりです：

  • Astra識別子スキーマに準拠

upgradeVersion

string

False

アップグレード可能なソフトウェアイメージファイルのSemVerを含むJSON文字列。定義された値は次のとおりです：

  • SemVerスキーマに準拠

currentVersion

string

False

アップグレード対象となるエンティティの現在のSemVerを含むJSON文字列。定義された値は次のとおりです：

  • SemVerスキーマに準拠

依存関係

array[string]

False

JSON文字列のJSON配列。各文字列には、このアップグレードを進める前に完了しなければならないアップグレードのUUIDが含まれています。どのアップグレードを前提条件として、どの順序で実行するかを決定するために使用されます。定義された値は次のとおりです：

  • Astra識別子スキーマに準拠

状態

string

False

アップグレードの動作状態を示す値を含むJSON文字列。自動アップグレードが有効になっている場合、アップグレードは「scheduled」の状態から開始されます。それ以外の場合は、アップグレードは「proposed」の状態から開始されます。定義された値は次のとおりです：

  • 「利用不可」 - 現時点ではアップグレードはご利用いただけません

  • 「提案済み」 - アップグレードは提案されていますが、承認されるまで自動的には実行されません

  • 「scheduled」 - アップグレードは承認されていますが、依存関係、時間的制約、または利用可能なリソースの問題により、インストール準備ができていません。

  • 「running」 - アップグレードが進行中です

  • 「complete」 - アップグレードが完了しました

  • 「failed」 - アップグレードが完了しませんでした

stateDesired

string

False

「state」の望ましい状態を示す値を含むJSON文字列。このフィールドは、ユーザーがリソースの状態変更を直接要求できる場合にのみ含まれます。定義された値は次のとおりです：

  • 「提案済み」 - アップグレードは承認されておらず、実施してはなりません

  • 「予定済み」 - アップグレードは承認されており、指定された期間内に実行する必要があります

  • 「running」：時間枠に関係なく、アップグレードは直ちに実行する必要があります

stateDetails

配列["type_astra_stateDetail"]

False

現在の「状態」に関する詳細情報を一覧表示する JSON オブジェクトの JSON 配列。詳細情報が利用できない場合、この配列は空になります。

  • 最小アイテム数：0

メタデータ

"type_astra_metadata_update"

False

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

  • Astra メタデータスキーマに準拠します。更新時に指定されていない場合、メタデータオブジェクトのラベル、creationTimestamp および createdBy は、変更されずに保持されます。
リクエスト例 
{
  "type": "application/astra-upgrade",
  "version": "1.1",
  "stateDesired": "running"
}

応答

Status: 204, Indicates if the upgrade resource was updated.

応答

Status: 401, Unauthorized
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

無効なリクエストボディフィールドのリスト
回答例 
{
  "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

無効なリクエストボディフィールドのリスト
回答例 
{
  "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
回答例 
{
  "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
エラー応答の例 
{
  "type": "https://astra.netapp.io/problems/1",
  "title": "Resource not found",
  "detail": "The resource specified in the request URI wasn't found.",
  "status": "404"
}

用語の意味

定義を参照

additionalDetails

type_astra_stateDetail

Name を入力します 必須 説明

を入力します

string

True

タイトル

string

True

詳細

string

True

additionalDetails

"additionalDetails"

False

type_astra_label

Name を入力します 必須 説明

名前

string

True

Value

string

True

type_astra_metadata_update

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

  • Astra メタデータスキーマに準拠します。更新時に指定されていない場合、メタデータオブジェクトのラベル、creationTimestamp および createdBy は、変更されずに保持されます。

Name を入力します 必須 説明

ラベル

配列["type_astra_label"]

False

作成タイムスタンプ

string

False

modificationTimestamp

string

False

作成者

string

False

modifiedBy

string

False

invalidParams

Name を入力します 必須 説明

名前

string

True

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

理由

string

True

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

invalidFields

Name を入力します 必須 説明

名前

string

True

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

理由

string

True

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