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

擷取授權

PDF

GET /accounts/{account_id}/core/v1/licenses/{license_id}

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

參數

Name 類型 在 必要 說明

account_id

字串

路徑

True

包含帳戶資源的 ID

  • 範例：{{.Account}}

license_id

字串

路徑

True

要列出的授權集合 ID

回應

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

類型

字串

True

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

  • "application/astra-license"

版本

字串

True

資源版本。定義的值為：

  • "1.0"

ID

字串

True

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

  • 符合 UUIDv4 架構

分配

字串

錯誤

包含 ID 的 JSON 字串，指示授權分配給哪個對象。僅在分配授權時存在。對於 Astra Control Center 授權，此欄位必須填入帳戶 ID，並且必須與 POST URI 中指定的帳戶 ID 相符。定義的值為：

  • 符合 Astra 識別符架構

hostID

字串

錯誤

包含授權綁定的主機識別碼的 JSON 字串。僅當授權鎖定到主機時才存在。定義的值為：

  • 最短長度：1

  • 最大長度：63

deviceCredentialID

字串

錯誤

包含與 Credential API 關聯的 deviceCredential 識別碼的 JSON 字串。僅適用於 Astra Data Store 授權。定義的值為：

  • 符合 Astra 識別符架構

isEvaluation

字串

True

JSON 字串，用於指示授權是否為評估授權。定義的值為：

  • "true"

  • "false"

licenseProtocol

字串

True

包含從授權中擷取的授權通訊協定的 JSON 字串。定義的值為：

  • 字串內容未經架構驗證

licenseText

字串

True

JSON 字串，包含從 NetApp 授權系統取得的授權 JSON 的 base64 編碼表示。必須以原始位元組層級順序提供，以便進行簽章驗證。定義的值為：

  • 符合 base64 編碼資料架構

validFromTimestamp

字串

True

包含時間戳記的 JSON 字串，指示授權何時生效。定義的值為：

  • 符合 ISO-8601 日期時間架構

validUntilTimestamp

字串

True

包含時間戳記的 JSON 字串，指示授權何時不再有效。定義的值為：

  • 符合 ISO-8601 日期時間架構

產品

字串

True

包含從授權中擷取的產品字串的 JSON 字串。定義的值為：

  • 字串內容未經架構驗證

productVersion

字串

True

包含從授權中擷取的版本字串的 JSON 字串。定義的值為：

  • 字串內容未經架構驗證

產品 SN

字串

True

包含從授權中擷取的序號字串的 JSON 字串。定義的值為：

  • 字串內容未經架構驗證

功能

字串

True

包含從授權中擷取的套件值的 JSON 字串。定義的值為：

  • 字串內容未經架構驗證

容量

字串

True

包含從授權中擷取之容量的 JSON 字串。

capacity2

字串

True

包含從授權中擷取之次要容量的 JSON 字串。

附加元件

陣列["附加元件"]

錯誤

包含授權附加元件清單的 JSON 物件 JSON 陣列。附加元件是指授權在未來某個潛在日期發生的變更。

中繼資料

"type_astra_metadata_update"

True

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

  • 符合 Astra Metadata Schema。如果在建立時未指定、則會建立沒有標籤的中繼資料物件。如果在更新時未指定，元資料物件的標籤、creationTimestamp 和 createdBy 將保持不變。
範例回應 
{
  "type": "application/astra-license",
  "version": "1.0",
  "id": "6db53b32-8417-5d3c-8ef0-552fc602c78f",
  "allocation": "4185d09b-6687-4801-a832-c005a9d94f41",
  "hostID": "99132549-e0c2-4203-9d1e-598628b4ff9b",
  "isEvaluation": "false",
  "licenseProtocol": "ASTRASDS-ENT-SUBS",
  "licenseText": "ewogICAic3RhdHVzUmVzcCI6ewogMTYwNzAwIgp9",
  "validFromTimestamp": "2020-08-06T00:00:00.000000Z",
  "validUntilTimestamp": "2021-08-06T00:00:00.000000Z",
  "product": "Astra Control Center",
  "productVersion": "1.0",
  "productSN": "320000046",
  "features": "ASTRA-ENT-STD",
  "capacity": "4000",
  "capacity2": "0",
  "addons": [
    {
      "startDate": "2020-08-06T00:00:00.000000Z",
      "endDate": "2021-08-06T00:00:00.000000Z",
      "capacity": "4000",
      "licenseProtocol": "ASTRA-ENT-STD",
      "features": "p-nfs,dm-storage-policy-based-pvs-for-k8s,dm-spbm-based-vvols-for-vms,dm-storage-efficiency,dm-data-at-rest-encryption"
    }
  ],
  "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"
}

定義

請參閱定義

附加元件

Name 類型 必要 說明

startDate

字串

錯誤

包含時間戳記的 JSON 字串，指示此附加元件何時生效。定義的值為：

  • 符合 ISO-8601 日期時間架構

endDate

字串

錯誤

包含時間戳記的 JSON 字串，指示此附加元件何時失效。定義的值為：

  • 符合 ISO-8601 日期時間架構

功能

字串

錯誤

包含與此附加元件相關聯的功能清單的 JSON 字串。定義的值為：

  • 字串內容未通過架構驗證。

容量

字串

錯誤

包含從附加元件中擷取的容量資訊的 JSON 字串。定義的值為：

  • 字串內容未經架構驗證

licenseProtocol

字串

錯誤

包含與此附加元件相關聯的授權通訊協定的 JSON 字串。定義的值為：

  • 字串內容未經架構驗證

type_astra_label

Name 類型 必要 說明

姓名

字串

True

值

字串

True

type_astra_metadata_update

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

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

Name 類型 必要 說明

標籤

陣列["type_astra_label"]

錯誤

建立時間戳記

字串

錯誤

修改時間戳記

字串

錯誤

建立者

字串

錯誤

modifiedBy

字串

錯誤

invalidParams

Name 類型 必要 說明

姓名

字串

True

無效查詢參數的名稱

原因

字串

True

查詢參數無效的原因