Skip to main content
Astra Automation
本繁體中文版使用機器翻譯，譯文僅供參考，若與英文版本牴觸，應以英文版本為準。

擷取升級

PDF

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

在 JSON 回應本文中傳回已儲存的 Upgrade API 資源。

參數

Name 類型 在 必要 說明

account_id

字串

路徑

True

包含帳戶資源的 ID

  • 範例：{{.Account}}

upgrade_id

字串

路徑

True

要列出的升級集合 ID

回應

Status: 200, Returns the stored Upgrade API resource in the JSON response body.
Name 類型 必要 說明

類型

字串

True

資源的媒體類型。定義的值為：

  • "application/astra-upgrade"

版本

字串

True

資源版本。已定義值包括：

  • "1.0"

  • "1.1"

ID

字串

True

資源的全域唯一識別碼。定義的值為：

  • 符合 UUIDv4 架構

componentName

字串

True

包含可升級軟體類型名稱的 JSON 字串。已定義的值包括：

  • "acc"

  • "acs"

  • "Trident"

  • "kubernetes"

componentInstance

字串

True

包含可升級元件 URI 的 JSON 字串。已定義的值包括：

  • 最短長度：3

  • 最大長度：4095

componentID

字串

True

包含可升級元件的全域唯一識別碼的 JSON 字串。已定義的值包括：

  • 符合 Astra 識別符架構

upgradeVersion

字串

True

包含可升級到的軟體映像檔案的 SemVer 的 JSON 字串。已定義的值包括：

  • 符合 SemVer 模式

currentVersion

字串

True

包含待升級實體目前 SemVer 的 JSON 字串。已定義的值包括：

  • 符合 SemVer 模式

相依性

陣列［string］

True

JSON 字串的 JSON 陣列，每個字串包含一個升級的 UUID，該升級必須在目前升級之前完成。用於確定哪些升級將作為先決條件執行以及執行順序。已定義的值包括：

  • 符合 Astra 識別符架構

狀態

字串

True

JSON 字串，包含指示升級運作狀態的值。如果啟用自動升級，升級將以「scheduled」狀態開始。否則，升級將以「proposed」狀態開始。定義的值為：

  • 「unavailable」- 目前無法進行升級

  • 「proposed」- 升級已提出，但在獲得核准之前不會自動執行

  • 「已排程」- 升級已獲核准，但由於相依性、時間範圍或可用資源而尚未準備好安裝

  • "running" - 升級正在進行中

  • 「complete」—升級已完成

  • 「failed」—升級未完成

stateDesired

字串

True

包含「state」所需狀態值的 JSON 字串。只有當使用者可以直接要求變更資源狀態時，才會包含此欄位。已定義的值包括：

  • 「proposed」——該升級未經批准，不得執行

  • 「已安排」- 升級已獲批准，必須在指定的時間窗口內執行

  • 「running」- 無論時間視窗如何，升級都必須立即執行

stateDetails

陣列["type_astra_stateDetail"]

True

JSON 物件的 JSON 陣列，其中列出有關目前「狀態」的其他詳細資料。如果沒有可用的詳細資料，此陣列將為空白。

  • 最低項目數：0

中繼資料

"type_astra_metadata_update"

True

與資源相關聯的用戶端和服務指定中繼資料。定義的值為：

  • 符合 Astra Metadata Schema。如果在更新時未指定，元資料物件的標籤、creationTimestamp 和 createdBy 將保持不變。
範例回應 
{
  "type": "application/astra-upgrade",
  "version": "1.1",
  "id": "aa9a8e88-c012-55b1-b514-7cd94dc79008",
  "componentName": "trident",
  "componentInstance": "https://<dns_name>/accounts/0b311ae7-d89a-4a11-a52c-1349ca090415/topology/v1/clouds/fdda3ff3-a46a-43a4-902e-444fde2baeba/storageBackends/72d19c3c-eb43-4bec-b23e-a228c900aded",
  "componentID": "72d19c3c-eb43-4bec-b23e-a228c900aded",
  "upgradeVersion": "21.07.1",
  "currentVersion": "21.04.1",
  "dependencies": [],
  "state": "scheduled",
  "stateDesired": "scheduled",
  "stateDetails": [],
  "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 類型 必要 說明

類型

字串

True

標題

字串

True

詳細資料

字串

True

狀態

字串

True

correlationID

字串

錯誤
範例回應 
{
  "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 類型 必要 說明

類型

字串

True

標題

字串

True

詳細資料

字串

True

狀態

字串

True

correlationID

字串

錯誤

invalidParams

陣列["invalidParams"]

錯誤

無效查詢參數清單
範例回應 
{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

回應

Status: 403, Forbidden
Name 類型 必要 說明

類型

字串

True

標題

字串

True

詳細資料

字串

True

狀態

字串

True

correlationID

字串

錯誤
範例回應 
{
  "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 類型 必要 說明

類型

字串

True

標題

字串

True

詳細資料

字串

True

狀態

字串

True

correlationID

字串

錯誤
範例錯誤回應 
{
  "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

Name 類型 必要 說明

類型

字串

True

標題

字串

True

詳細資料

字串

True

additionalDetails

"additionalDetails"

錯誤

type_astra_label

Name 類型 必要 說明

姓名

字串

True

值

字串

True

type_astra_metadata_update

與資源相關聯的用戶端和服務指定中繼資料。定義的值為：

  • 符合 Astra Metadata Schema。如果在更新時未指定，元資料物件的標籤、creationTimestamp 和 createdBy 將保持不變。

Name 類型 必要 說明

標籤

陣列["type_astra_label"]

錯誤

建立時間戳記

字串

錯誤

修改時間戳記

字串

錯誤

建立者

字串

錯誤

modifiedBy

字串

錯誤

invalidParams

Name 類型 必要 說明

姓名

字串

True

無效查詢參數的名稱

原因

字串

True

查詢參數無效的原因