Skip to main content
23.04
本製品の最新リリースがご利用いただけます。
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

パッケージを取得する

PDF

GET /accounts/{account_id}/core/v1/packages/{package_id}

JSONレスポンスボディに格納されたパッケージAPIリソースを返します。

パラメータ

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

account_id

string

path（パス）

True

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

  • 例：{{.Account}}

package_id

string

path（パス）

True

一覧表示するパッケージコレクションのID

応答

Status: 200, Returns the stored Package API resource in the JSON response body.
Name を入力します 必須 説明

を入力します

string

True

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

  • 「application/astra-package」

バージョン

string

True

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

  • "1.0"

ID

string

True

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

  • UUIDv4スキーマに準拠

packageName

string

True

パッケージ名を含むJSON文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長:31 例の値:

  • "acc"

  • "acs"

  • 「trident」

packageVersion

string

True

パッケージのSemVerを含むJSON文字列。定義された値は次のとおりです：

  • SemVerスキーマに準拠

packageType

string

True

パッケージの種類を示すJSON文字列。これは、完全インストールパッケージかパッチかを示します。定義された値は次のとおりです：

  • "インストール"

  • "patch"

bundleName

array[string]

False

パッケージが含まれているバンドルの名前を含むJSON文字列のJSON配列。

severityLevel

string

True

このパッチまたはインストールの重大度レベルを示すJSON文字列。定義された値は次のとおりです：

  • 「recommended」 - インストールを推奨 - デフォルト値

  • 「critical」 - 重大なバグ修正やセキュリティパッチに対処するため、インストールを強く推奨します

packageState

string

True

パッケージの動作状態を示す値を含むJSON文字列。パッケージの確認とインポートが完了すると、ステータスは「complete」と表示されます。そうでない場合は、状態は「incomplete」と表示されます。定義された値は次のとおりです：

  • 「verifying」 - パッケージは検証中です

  • 「corrupt」 - パッケージが破損しています

  • 「incomplete」 - パッケージに要素が不足しています

  • 「available」 - パッケージに関連するすべての要素が利用可能であり、パッケージはすぐに使用できます。

packageStateTransitions

配列["type_astra_stateTransition"]

True

JSONオブジェクトのJSON配列。各オブジェクトは、特定の定義済み状態からの許可された状態遷移のセットを表します。各JSONオブジェクトには「from」と「to」というフィールドが含まれており、「from」の値は状態の名前、「to」の値は許可された宛先状態の配列です。定義された値は次のとおりです：

  • 状態遷移スキーマに準拠する

packageStateDetails

配列["type_astra_stateDetail"]

True

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

  • 最小アイテム数：0

画像

配列["画像"]

False

パッケージの一部である各 Docker イメージを含む JSON オブジェクトの JSON 配列。

アーティファクト

配列["アーティファクト"]

False

このパッケージに関連付けられている追加の成果物（バイナリファイルなど）を記述するJSONオブジェクトのJSON配列。

files

配列["files"]

False

JSONオブジェクトのJSON配列。各オブジェクトは、このパッケージに関連付けられた画像以外の成果物を表します。

upgradableVersions

"upgradableVersions"

False

パッケージバージョンにアップグレード可能な最小バージョンと最大バージョンを含むJSONオブジェクト。

依存関係

配列["依存関係"]

False

このパッケージをインストールするために必要な、特定の依存関係の最小バージョンを記述するJSONオブジェクトのJSON配列

メタデータ

"type_astra_metadata"

True

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

  • Astra メタデータスキーマに準拠します。作成時に指定しない場合、ラベルのないメタデータオブジェクトが作成されます。
回答例 
{
  "type": "application/astra-package",
  "version": "1.0",
  "id": "54edc2b3-18c5-5371-904b-ebcd04d88bdc",
  "packageName": "acc",
  "packageVersion": "22.09.1",
  "packageType": "patch",
  "packageState": "available",
  "packageStateTransitions": [
    {
      "from": "verifying",
      "to": [
        "corrupt",
        "incomplete",
        "available"
      ]
    },
    {
      "from": "corrupt",
      "to": [
        "incomplete",
        "available"
      ]
    },
    {
      "from": "incomplete",
      "to": [
        "corrupt",
        "available"
      ]
    },
    {
      "from": "available",
      "to": [
        "corrupt",
        "available"
      ]
    }
  ],
  "packageStateDetails": [],
  "severityLevel": "recommended",
  "images": [
    {
      "imagePath": "/globalcicd/acc",
      "imageName": "storage-provider",
      "imageTag": "1.3.116",
      "imageDigest": "sha256:2e04d178815537b0ad8c3224e8754e33642da781a161f1be239853dae33deafc"
    },
    {
      "imagePath": "/globalcicd/acc",
      "imageName": "storage-backend-metrics",
      "imageTag": "1.3.45",
      "imageDigest": "sha256:2e04d178815537b0ad8c3224e8754e33642da781a161f1be239853dae33deafc"
    },
    {
      "imagePath": "/globalcicd/acc",
      "imageName": "credentials",
      "imageTag": "1.3.45",
      "imageDigest": "sha256:2e04d178815537b0ad8c3224e8754e33642da781a161f1be239853dae33deafc"
    }
  ],
  "files": [
    {
      "fileName": "astra_control_center_min.yaml",
      "fileIdentifier": "astra_min",
      "fileMediaType": "application/x-yaml",
      "fileContents": "VGhpcyBpcyBzdXBwb3NlZCB0byBiZSBhIGNvbXByZXNzZWQgZmlsZSBjb250ZW50"
    }
  ],
  "dependencies": [
    {
      "componentName": "acc",
      "componentMinVersion": "22.04.29"
    },
    {
      "componentName": "kubernetes",
      "componentMinVersion": "v1.19.7",
      "componentMaxVersion": "v1.20"
    },
    {
      "componentName": "trident",
      "componentMinVersion": "v21.01.1"
    }
  ],
  "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
回答例 
{
  "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

invalidParams

配列["invalidParams"]

False

無効なクエリパラメータのリスト
回答例 
{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

応答

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/2",
  "title": "Collection not found",
  "detail": "The collection specified in the request URI wasn't found.",
  "status": "404"
}

用語の意味

定義を参照

type_astra_stateTransition

Name を入力します 必須 説明

-

string

True

-

array[string]

True

type_astra_stateDetail

Name を入力します 必須 説明

を入力します

string

True

タイトル

string

True

詳細

string

True

dependsOnImages

Name を入力します 必須 説明

imagePath

string

True

このDockerイメージへのパスを含むJSON文字列。レジストリ名を含めてはならず、ルートからイメージへの絶対パスのみを含める必要があります。例：/globalcicd/acc 定義値：

  • 最小長さ：1

  • 最大長さ：1023

imageName

string

True

Docker イメージ名を含む JSON 文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：63

imageTag

string

True

この画像のタグ/バージョンを表すJSON文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：31

画像

Name を入力します 必須 説明

imageName

string

True

Docker イメージ名を含む JSON 文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：63

imagePath

string

True

このDockerイメージへのパスを含むJSON文字列。レジストリ名を含めてはならず、ルートからイメージへの絶対パスのみを含める必要があります。例：/globalcicd/acc 定義値：

  • 最小長さ：1

  • 最大長さ：1023

imageTag

string

True

この画像のタグ/バージョンを表すJSON文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：31

imageDigest

string

True

この画像のダイジェストを表すJSON文字列。定義された値は次のとおりです：

  • 定義された正規表現は次のとおりです："^(sha256:)[0-9a-f]{64}$"

dependsOnImages

配列["dependsOnImages"]

False

現在のイメージをインストールまたはアップグレードするために必要なイメージを記述するJSONオブジェクトのJSON配列。

dependsOnComponents

Name を入力します 必須 説明

componentName

string

True

コンポーネント名を表すJSON文字列。定義された値は次のとおりです：

  • "acc"

  • "acs"

  • 「trident」

  • "kubernetes"

バージョン

array[string]

True

現在のイメージをインストールするために必要なコンポーネントのバージョンを定義するJSON文字列のJSON配列。

アーティファクト

Name を入力します 必須 説明

artifactName

string

True

ファイル名を含むJSON文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：63

artifactIdentifier

string

True

このファイルの識別子を含むJSON文字列。同じパッケージタイプのバージョン間では、ファイル名は変更される可能性がありますが、識別子は通常同じままです。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：511

artifactPath

string

True

既知の Astra Control Center データストア / ロケーションのルートからこのアーティファクトへのパスを含む JSON 文字列。例：/vmware/1.0/ 定義されている値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：1023

artifactVersion

string

False

提供されている場合、その成果物のバージョンを含むJSON文字列。定義された値は次のとおりです：

  • SemVerスキーマに準拠

  • 最小長さ：1

  • 最大長さ：31

dependsOnComponents

配列["dependsOnComponents"]

False

現在のイメージをインストール/アップグレードするために必要なインストール済みコンポーネントを記述するJSONオブジェクトのJSON配列。

files

Name を入力します 必須 説明

fileName

string

True

ファイル名を含むJSON文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：63

fileIdentifier

string

True

このファイルの識別子を含むJSON文字列。同じパッケージタイプのバージョン間では、ファイル名は変更される可能性がありますが、識別子は通常同じままです。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：511

fileMediaType

string

True

ファイルのメディアタイプを含むJSON文字列。定義済み値は、 "IANA"で定義されているメディアタイプです。さらに、yamlファイル用のapplication/x-yamlまたはapplication/x-yamlもサポートされています。

  • 最小長さ：1

  • 最大長さ：211

fileContents

string

True

ファイルの内容を含むJSON文字列。定義された値は次のとおりです：

  • Base64 スキーマに準拠します。FIXME - これが圧縮されていることをどのように指定すればよいですか？どのようなアルゴリズムなどですか？

upgradableVersions

パッケージバージョンにアップグレード可能な最小バージョンと最大バージョンを含むJSONオブジェクト。

Name を入力します 必須 説明

minVersion

string

False

パッケージバージョンにアップグレード可能な最小バージョンを記述したJSON文字列。定義された値は次のとおりです：

  • SemVerスキーマに準拠

maxVersion

string

False

パッケージバージョンにアップグレード可能な最大バージョンを記述したJSON文字列。定義された値は次のとおりです：

  • SemVerスキーマに準拠

依存関係

Name を入力します 必須 説明

componentName

string

True

コンポーネント名を表すJSON文字列。定義された値は次のとおりです：

  • "acc"

  • "acs"

  • 「trident」

  • "kubernetes"

componentMinVersion

string

False

そのコンポーネントに必要な最小バージョンを記述したJSON文字列。定義された値は次のとおりです：

  • SemVerスキーマに準拠

componentMaxVersion

string

False

そのコンポーネントに必要な最大バージョンを記述したJSON文字列。定義された値は次のとおりです：

  • SemVerスキーマに準拠

type_astra_label

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

invalidParams

Name を入力します 必須 説明

名前

string

True

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

理由

string

True

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