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

クラウド用の新しいクラスターを作成する

05/23/2026

PDF

POST /accounts/{account_id}/topology/v1/clouds/{cloud_id}/clusters

作成するクラスタ API リソースの希望値を指定します。

パラメータ

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

Name

を入力します

入力

必須

説明

account_id

string

path（パス）

True

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

例：{{.Account}}

cloud_id

string

path（パス）

True

包含するクラウドリソースのID

要求の本文

作成するクラスタ API リソースの希望値を指定します。

Name	を入力します	必須	説明
を入力します	string	True	リソースのメディアタイプ。定義された値は次のとおりです： "application/astra-cluster"
バージョン	string	True	リソースのバージョン。定義された値は次のとおりです： "1.0" "1.1" "1.2" "1.3" "1.4" "1.5" "1.6" "1.7"
名前	string	False	クラスター名を含むJSON文字列。指定がない場合は、クラスターのKubernetes名が使用されます。定義された値は次のとおりです：最小長さ：1 最大長さ：63 この文字列は、XSS、Unicode、ディレクトリトラバーサル、SQLインジェクション攻撃を防ぐために内部的に検証されます
accHost	string	False	このクラスタが現在アクセスされているAstra Control Centerのインスタンスをホストしていることを示すJSON文字列。定義された値は次のとおりです：「true」 - このクラスタは、現在アクセスされているAstra Control Centerのインスタンスをホストしています。
clusterType	string	False	クラスターの種類を示す値を含むJSON文字列。定義値は次のとおりです：「gke」- Google Kubernetes Engine 上でホストされる Kubernetes 「aks」 - Microsoft Azure Kubernetes Service 上でホストされている Kubernetes 「eks」 - Amazon Elastic Kubernetes Service でホストされる Kubernetes 「rke」 - クラスタのタイプは Rancher です「tanzu」 - クラスタのタイプは Tanzu Kubernetes Grid です "openshift" - クラスタのタイプはOpenShift 「anthos」 - クラスタのタイプはGKE Anthosです「kubernetes」 - クラスタは汎用Kubernetesです
credentialID	string	False	クラスタのkubeconfigファイルを含むクレデンシャルのIDを示す値を含むJSON文字列。定義されている値は次のとおりです： Astra識別子スキーマに準拠します。privateRouteIDとconnectorCapabilitiesのconnectorV2オプションが提供される場合、credentialIDはオプションです。提供されていない場合は、credentialIDが必要です。それ以外の場合は、エラーが発生します。credentialIDとリレー対応コネクタが提供される場合、エラーが発生します。
privateRouteID	string	False	プライベートクラスタのロケーションIDを含むJSON文字列。最小長さ：1 最大長さ：255
connectorCapabilities	array[string]	False	このクラスタに関連付けられているコネクタの機能。下位互換性のためのオプション。存在しない場合は、プロキシが想定される機能となります。
メタデータ	"type_astra_metadata_update"	False	リソースに関連付けられた、クライアントおよびサービス指定のメタデータ。定義された値は次のとおりです： Astra メタデータスキーマに準拠します。作成時に指定しない場合、ラベルのないメタデータオブジェクトが作成されます。更新時に指定されていない場合、メタデータオブジェクトのラベル、creationTimestamp および createdBy は、変更なしで保持されます。

Name

を入力します

必須

説明

を入力します

string

True

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

"application/astra-cluster"

バージョン

string

True

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

"1.0"
"1.1"
"1.2"
"1.3"
"1.4"
"1.5"
"1.6"
"1.7"

名前

string

False

クラスター名を含むJSON文字列。指定がない場合は、クラスターのKubernetes名が使用されます。定義された値は次のとおりです：

最小長さ：1
最大長さ：63
この文字列は、XSS、Unicode、ディレクトリトラバーサル、SQLインジェクション攻撃を防ぐために内部的に検証されます

accHost

string

False

このクラスタが現在アクセスされているAstra Control Centerのインスタンスをホストしていることを示すJSON文字列。定義された値は次のとおりです：

「true」 - このクラスタは、現在アクセスされているAstra Control Centerのインスタンスをホストしています。

clusterType

string

False

クラスターの種類を示す値を含むJSON文字列。定義値は次のとおりです：

「gke」- Google Kubernetes Engine 上でホストされる Kubernetes
「aks」 - Microsoft Azure Kubernetes Service 上でホストされている Kubernetes
「eks」 - Amazon Elastic Kubernetes Service でホストされる Kubernetes
「rke」 - クラスタのタイプは Rancher です
「tanzu」 - クラスタのタイプは Tanzu Kubernetes Grid です
"openshift" - クラスタのタイプはOpenShift
「anthos」 - クラスタのタイプはGKE Anthosです
「kubernetes」 - クラスタは汎用Kubernetesです

credentialID

string

False

クラスタのkubeconfigファイルを含むクレデンシャルのIDを示す値を含むJSON文字列。定義されている値は次のとおりです：

Astra識別子スキーマに準拠します。privateRouteIDとconnectorCapabilitiesのconnectorV2オプションが提供される場合、credentialIDはオプションです。提供されていない場合は、credentialIDが必要です。それ以外の場合は、エラーが発生します。credentialIDとリレー対応コネクタが提供される場合、エラーが発生します。

privateRouteID

string

False

プライベートクラスタのロケーションIDを含むJSON文字列。

最小長さ：1
最大長さ：255

connectorCapabilities

array[string]

False

このクラスタに関連付けられているコネクタの機能。下位互換性のためのオプション。存在しない場合は、プロキシが想定される機能となります。

メタデータ

"type_astra_metadata_update"

False

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

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

リクエスト例

{
  "type": "application/astra-cluster",
  "version": "1.7",
  "name": "GKE-22",
  "credentialID": "6fa2f917-f730-41b8-9c15-17f531843b31"
}

応答

Status: 201, Returns the newly created cluster resource in the JSON response body.

Name	を入力します	必須	説明
を入力します	string	True	リソースのメディアタイプ。定義された値は次のとおりです： "application/astra-cluster"
バージョン	string	True	リソースのバージョン。定義された値は次のとおりです： "1.0" "1.1" "1.2" "1.3" "1.4" "1.5" "1.6" "1.7"
ID	string	True	リソースのグローバル一意識別子。定義された値は次のとおりです： UUIDv4スキーマに準拠
名前	string	True	クラスター名を含むJSON文字列。指定がない場合は、クラスターのKubernetes名が使用されます。定義された値は次のとおりです：最小長さ：1 最大長さ：63 この文字列は、XSS、Unicode、ディレクトリトラバーサル、SQLインジェクション攻撃を防ぐために内部的に検証されます
状態	string	True	クラスターの動作状態を示す値を含むJSON文字列。定義された値は次のとおりです：「pending」 - クラスターの検出が予定されています「discovering」 - クラスタの検出処理中です「provisioning」 - クラスタのプロビジョニング処理中です「running」 - クラスターは正常に動作しています「failed」 - クラスタが永続的な障害状態にあります「削除済み」 - クラスターには現在アクセスできません「不明」 - クラスタの状態を判別できません
stateUnready	array[string]	True	JSON文字列のJSON配列。各文字列は、クラスターが「実行中」状態に移行できない理由、「実行中」状態中に問題が発生した場合、または「失敗」状態や「削除済み」状態に移行した理由を示します。定義された値は次のとおりです：最小長さ：1 最大長さ：127
managedState	string	True	クラスターの管理状態を示す値を含むJSON文字列。定義された値は次のとおりです：「pending」 - クラスターは検出または追加される予定です "ineligible" - クラスタは "running" 状態であり、管理下になく、管理の対象ではありません。この不適格性の理由は、unready キー値に記載されています。「削除中」 - クラスタは削除処理中です「管理対象外」 - クラスタが「実行中」または「失敗」状態であり、管理対象外で、管理対象にすることができます「managing」 - クラスタは「running」状態であり、管理処理中です "managed" - クラスタは "running"、"failed"、または "removed" 状態であり、管理下にあります
managedStateDetails	配列["type_astra_stateDetail"]	False	現在の状態に関する詳細情報（現在の状態に至った理由を含む）をリストしたJSONオブジェクトのJSON配列。詳細情報がない場合は、この配列は空になります。定義された値は次のとおりです：最小アイテム数：0
protectionState	string	True	クラスターの保護状態を示す値を含むJSON文字列。定義された値は次のとおりです：「full」 - クラスターのデフォルトのストレージクラスはスナップショットをサポートします「部分的」 - クラスターには、スナップショットをサポートしていないstorageClassesのみがあります "atRisk"：クラスターのデフォルトのストレージクラスはスナップショットをサポートしていません
protectionStateDetails	配列["type_astra_stateDetail"]	True	現在の保護状態に関する詳細情報（現在の状態に至った理由を含む）を一覧表示するJSONオブジェクトのJSON配列。詳細情報が利用できない場合、この配列は空になります。定義値は次のとおりです：最小アイテム数：0
restoreTargetSupported	string	False	クラスターがアプリケーションデータ管理操作の_ターゲット_となる能力を示す値を含むJSON文字列。定義された値は次のとおりです：「true」 - クラスタは、アプリケーションデータ管理処理の対象として適格です。「false」 - クラスタは、アプリケーションデータ管理処理の対象として適格では_ありません_。
snapshotSupported	string	False	クラスターがアプリケーションデータ管理のバックアップのような操作を実行できるかどうかを示す値を含むJSON文字列。定義された値は次のとおりです：「true」 - クラスタはアプリケーションデータ管理操作を実行できます。「false」 - クラスタは、アプリケーションデータ管理処理を実行する資格が_ありません_。
managedStateUnready	array[string]	True	JSON文字列のJSON配列。各文字列は、クラスターが管理対象とならない理由、またはクラスターは管理対象であるが、管理中に致命的ではないエラーが発生したことを示す。定義された値は次のとおりです：最小長さ：1 最大長さ：127
managedTimestamp	string	False	クラスターが管理下に置かれた日時を示すタイムスタンプを含むJSON文字列。定義された値は次のとおりです： ISO-8601 日付時刻スキーマに準拠このキーは、クラスタのmanagedStateが「managed」の場合にのみ返されます。
tridentVersion	string	False	クラスタにインストールされているTridentのバージョンを含むJSON文字列。定義された値は次のとおりです：ソフトウェアバージョンスキーマに準拠
acpVersion	string	False	クラスタにインストールされているAstra Control Provisionerのバージョンを含むJSON文字列。定義された値は次のとおりです：ソフトウェアバージョンスキーマに準拠
tridentManagedState	string	False	このクラスタ上の Trident の管理状態を示す列挙値のセットの 1 つを含む JSON 文字列。定義された値は次のとおりです：「managed」 - クラスタ上の Trident インスタンスは Astra によって管理されます「管理されていない」 - クラスター上のTridentインスタンスはAstraによって管理されていません
tridentManagedStateDesired	string	False	Tridentの目的の管理状態を示す値を含むJSON文字列。定義された値は次のとおりです：「managed」 - このクラスター上でTridentを管理する「unmanaged」 - このクラスター上でTridentを管理しない
tridentManagedStateDetails	配列["type_astra_stateDetail"]	False	状態が「管理対象」または「管理対象外」に移行した理由に関する詳細情報をリストしたJSONオブジェクトのJSON配列。+ 詳細情報が利用できない場合、この配列は空になります。最小アイテム数：0
tridentManagedStateAllowed	array[string]	False	特定のtridentManagedStateで要求できる状態。各定義済み状態において、以下の状態を要求することができます： "managed"："managed" "unmanaged"："管理対象外"
inUse	string	True	クラスターに管理対象アプリケーションが存在するかどうか、つまり削除できないかどうかを示す値を含むJSON文字列。定義値は次のとおりです：「false」 - クラスターは管理されていないか、管理されているが、関連付けられている管理対象アプリケーションがない「true」 - クラスターは管理されており、管理対象アプリケーションが関連付けられています
accHost	string	False	このクラスタが現在アクセスされているAstra Control Centerのインスタンスをホストしていることを示すJSON文字列。定義された値は次のとおりです：「true」 - このクラスタは、現在アクセスされているAstra Control Centerのインスタンスをホストしています。
clusterType	string	True	クラスターの種類を示す値を含むJSON文字列。定義値は次のとおりです：「gke」- Google Kubernetes Engine 上でホストされる Kubernetes 「aks」 - Microsoft Azure Kubernetes Service 上でホストされている Kubernetes 「eks」 - Amazon Elastic Kubernetes Service でホストされる Kubernetes 「rke」 - クラスタのタイプは Rancher です「tanzu」 - クラスタのタイプは Tanzu Kubernetes Grid です "openshift" - クラスタのタイプはOpenShift 「anthos」 - クラスタのタイプはGKE Anthosです「kubernetes」 - クラスタは汎用Kubernetesです
clusterVersion	string	False	クラスタ環境のセマンティックバージョニング表現を示す値を含むJSON文字列。Kubernetesクラスタの場合、これはKubernetesのバージョンです。定義された値は次のとおりです：最小長さ：1 最大長さ：31
clusterVersionString	string	False	クラスタ環境の拡張バージョン情報を示す値を含むJSON文字列。Kubernetesクラスタの場合、これは完全なKubernetesバージョンです。定義された値は次のとおりです：最小長さ：1 最大長さ：31
clusterCreationTimestamp	string	False	クラスターが最初に作成された日時を示すタイムスタンプを含むJSON文字列。定義された値は次のとおりです： ISO-8601 Date Time Schemaに準拠
ネームスペース	array[string]	False	JSON文字列のJSON配列。各文字列は、クラスター内の名前空間を示します。定義された値は次のとおりです：最小長さ：1 最大長：253
defaultStorageClass	string	False	Kubernetesで設定されているデフォルトのストレージクラスに対応するストレージクラスIDを含むJSON文字列。定義された値は次のとおりです： Astra識別子スキーマに準拠
cloudID	string	True	クラスターが実行されているクラウドのIDを示す値を含むJSON文字列。定義された値は次のとおりです： Astra識別子スキーマに準拠
credentialID	string	False	クラスタのkubeconfigファイルを含むクレデンシャルのIDを示す値を含むJSON文字列。定義されている値は次のとおりです： Astra識別子スキーマに準拠します。privateRouteIDとconnectorCapabilitiesのconnectorV2オプションが提供される場合、credentialIDはオプションです。提供されていない場合は、credentialIDが必要です。それ以外の場合は、エラーが発生します。credentialIDとリレー対応コネクタが提供される場合、エラーが発生します。
場所	string	False	クラスターが実行されているクラウドから提供される値を含むJSON文字列。この値は、クラスターのクラウド固有の場所を示します。定義値は次のとおりです：最小長さ：1 最大長さ：63
isMultizonal	string	False	クラスターが実行されているクラウドから提供される値を含むJSON文字列。この値は、クラスターが2つ以上の可用性ゾーンにまたがっているかどうかを示します。定義値は次のとおりです：「true」 - クラスタが2つ以上のアベイラビリティゾーンにまたがっている「false」 - クラスタは単一のアベイラビリティゾーン内に完全に配置されています
privateRouteID	string	False	プライベートクラスタのロケーションIDを含むJSON文字列。最小長さ：1 最大長さ：255
connectorCapabilities	array[string]	False	このクラスタに関連付けられているコネクタの機能。下位互換性のためのオプション。存在しない場合は、プロキシが想定される機能となります。
apiServiceID	string	False	Kubernetes（k8s）APIサービスオブジェクトからのUUIDを含むJSON文字列。クラスタを一意に識別するために使用されます。
メタデータ	"type_astra_metadata_update"	True	リソースに関連付けられた、クライアントおよびサービス指定のメタデータ。定義された値は次のとおりです： Astra メタデータスキーマに準拠します。作成時に指定しない場合、ラベルのないメタデータオブジェクトが作成されます。更新時に指定されていない場合、メタデータオブジェクトのラベル、creationTimestamp および createdBy は、変更なしで保持されます。

Name

を入力します

必須

説明

を入力します

string

True

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

"application/astra-cluster"

バージョン

string

True

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

"1.0"
"1.1"
"1.2"
"1.3"
"1.4"
"1.5"
"1.6"
"1.7"

string

True

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

UUIDv4スキーマに準拠

名前

string

True

クラスター名を含むJSON文字列。指定がない場合は、クラスターのKubernetes名が使用されます。定義された値は次のとおりです：

最小長さ：1
最大長さ：63
この文字列は、XSS、Unicode、ディレクトリトラバーサル、SQLインジェクション攻撃を防ぐために内部的に検証されます

状態

string

True

クラスターの動作状態を示す値を含むJSON文字列。定義された値は次のとおりです：

「pending」 - クラスターの検出が予定されています
「discovering」 - クラスタの検出処理中です
「provisioning」 - クラスタのプロビジョニング処理中です
「running」 - クラスターは正常に動作しています
「failed」 - クラスタが永続的な障害状態にあります
「削除済み」 - クラスターには現在アクセスできません
「不明」 - クラスタの状態を判別できません

stateUnready

array[string]

True

JSON文字列のJSON配列。各文字列は、クラスターが「実行中」状態に移行できない理由、「実行中」状態中に問題が発生した場合、または「失敗」状態や「削除済み」状態に移行した理由を示します。定義された値は次のとおりです：

最小長さ：1
最大長さ：127

managedState

string

True

クラスターの管理状態を示す値を含むJSON文字列。定義された値は次のとおりです：

「pending」 - クラスターは検出または追加される予定です
"ineligible" - クラスタは "running" 状態であり、管理下になく、管理の対象ではありません。この不適格性の理由は、unready キー値に記載されています。
「削除中」 - クラスタは削除処理中です
「管理対象外」 - クラスタが「実行中」または「失敗」状態であり、管理対象外で、管理対象にすることができます
「managing」 - クラスタは「running」状態であり、管理処理中です
"managed" - クラスタは "running"、"failed"、または "removed" 状態であり、管理下にあります

managedStateDetails

配列["type_astra_stateDetail"]

False

現在の状態に関する詳細情報（現在の状態に至った理由を含む）をリストしたJSONオブジェクトのJSON配列。詳細情報がない場合は、この配列は空になります。定義された値は次のとおりです：

最小アイテム数：0

protectionState

string

True

クラスターの保護状態を示す値を含むJSON文字列。定義された値は次のとおりです：

「full」 - クラスターのデフォルトのストレージクラスはスナップショットをサポートします
「部分的」 - クラスターには、スナップショットをサポートしていないstorageClassesのみがあります
"atRisk"：クラスターのデフォルトのストレージクラスはスナップショットをサポートしていません

protectionStateDetails

配列["type_astra_stateDetail"]

True

現在の保護状態に関する詳細情報（現在の状態に至った理由を含む）を一覧表示するJSONオブジェクトのJSON配列。詳細情報が利用できない場合、この配列は空になります。定義値は次のとおりです：

最小アイテム数：0

restoreTargetSupported

string

False

クラスターがアプリケーションデータ管理操作の_ターゲット_となる能力を示す値を含むJSON文字列。定義された値は次のとおりです：

「true」 - クラスタは、アプリケーションデータ管理処理の対象として適格です。
「false」 - クラスタは、アプリケーションデータ管理処理の対象として適格では_ありません_。

snapshotSupported

string

False

クラスターがアプリケーションデータ管理のバックアップのような操作を実行できるかどうかを示す値を含むJSON文字列。定義された値は次のとおりです：

「true」 - クラスタはアプリケーションデータ管理操作を実行できます。
「false」 - クラスタは、アプリケーションデータ管理処理を実行する資格が_ありません_。

managedStateUnready

array[string]

True

JSON文字列のJSON配列。各文字列は、クラスターが管理対象とならない理由、またはクラスターは管理対象であるが、管理中に致命的ではないエラーが発生したことを示す。定義された値は次のとおりです：

最小長さ：1
最大長さ：127

managedTimestamp

string

False

クラスターが管理下に置かれた日時を示すタイムスタンプを含むJSON文字列。定義された値は次のとおりです：

ISO-8601 日付時刻スキーマに準拠このキーは、クラスタのmanagedStateが「managed」の場合にのみ返されます。

tridentVersion

string

False

クラスタにインストールされているTridentのバージョンを含むJSON文字列。定義された値は次のとおりです：

ソフトウェアバージョンスキーマに準拠

acpVersion

string

False

クラスタにインストールされているAstra Control Provisionerのバージョンを含むJSON文字列。定義された値は次のとおりです：

ソフトウェアバージョンスキーマに準拠

tridentManagedState

string

False

このクラスタ上の Trident の管理状態を示す列挙値のセットの 1 つを含む JSON 文字列。定義された値は次のとおりです：

「managed」 - クラスタ上の Trident インスタンスは Astra によって管理されます
「管理されていない」 - クラスター上のTridentインスタンスはAstraによって管理されていません

tridentManagedStateDesired

string

False

Tridentの目的の管理状態を示す値を含むJSON文字列。定義された値は次のとおりです：

「managed」 - このクラスター上でTridentを管理する
「unmanaged」 - このクラスター上でTridentを管理しない

tridentManagedStateDetails

配列["type_astra_stateDetail"]

False

状態が「管理対象」または「管理対象外」に移行した理由に関する詳細情報をリストしたJSONオブジェクトのJSON配列。+ 詳細情報が利用できない場合、この配列は空になります。

最小アイテム数：0

tridentManagedStateAllowed

array[string]

False

特定のtridentManagedStateで要求できる状態。各定義済み状態において、以下の状態を要求することができます：

"managed"："managed"
"unmanaged"："管理対象外"

inUse

string

True

クラスターに管理対象アプリケーションが存在するかどうか、つまり削除できないかどうかを示す値を含むJSON文字列。定義値は次のとおりです：

「false」 - クラスターは管理されていないか、管理されているが、関連付けられている管理対象アプリケーションがない
「true」 - クラスターは管理されており、管理対象アプリケーションが関連付けられています

accHost

string

False

このクラスタが現在アクセスされているAstra Control Centerのインスタンスをホストしていることを示すJSON文字列。定義された値は次のとおりです：

「true」 - このクラスタは、現在アクセスされているAstra Control Centerのインスタンスをホストしています。

clusterType

string

True

クラスターの種類を示す値を含むJSON文字列。定義値は次のとおりです：

「gke」- Google Kubernetes Engine 上でホストされる Kubernetes
「aks」 - Microsoft Azure Kubernetes Service 上でホストされている Kubernetes
「eks」 - Amazon Elastic Kubernetes Service でホストされる Kubernetes
「rke」 - クラスタのタイプは Rancher です
「tanzu」 - クラスタのタイプは Tanzu Kubernetes Grid です
"openshift" - クラスタのタイプはOpenShift
「anthos」 - クラスタのタイプはGKE Anthosです
「kubernetes」 - クラスタは汎用Kubernetesです

clusterVersion

string

False

クラスタ環境のセマンティックバージョニング表現を示す値を含むJSON文字列。Kubernetesクラスタの場合、これはKubernetesのバージョンです。定義された値は次のとおりです：

最小長さ：1
最大長さ：31

clusterVersionString

string

False

クラスタ環境の拡張バージョン情報を示す値を含むJSON文字列。Kubernetesクラスタの場合、これは完全なKubernetesバージョンです。定義された値は次のとおりです：

最小長さ：1
最大長さ：31

clusterCreationTimestamp

string

False

クラスターが最初に作成された日時を示すタイムスタンプを含むJSON文字列。定義された値は次のとおりです：

ISO-8601 Date Time Schemaに準拠

ネームスペース

array[string]

False

JSON文字列のJSON配列。各文字列は、クラスター内の名前空間を示します。定義された値は次のとおりです：

最小長さ：1
最大長：253

defaultStorageClass

string

False

Kubernetesで設定されているデフォルトのストレージクラスに対応するストレージクラスIDを含むJSON文字列。定義された値は次のとおりです：

Astra識別子スキーマに準拠

cloudID

string

True

クラスターが実行されているクラウドのIDを示す値を含むJSON文字列。定義された値は次のとおりです：

Astra識別子スキーマに準拠

credentialID

string

False

クラスタのkubeconfigファイルを含むクレデンシャルのIDを示す値を含むJSON文字列。定義されている値は次のとおりです：

Astra識別子スキーマに準拠します。privateRouteIDとconnectorCapabilitiesのconnectorV2オプションが提供される場合、credentialIDはオプションです。提供されていない場合は、credentialIDが必要です。それ以外の場合は、エラーが発生します。credentialIDとリレー対応コネクタが提供される場合、エラーが発生します。

場所

string

False

クラスターが実行されているクラウドから提供される値を含むJSON文字列。この値は、クラスターのクラウド固有の場所を示します。定義値は次のとおりです：

最小長さ：1
最大長さ：63

isMultizonal

string

False

クラスターが実行されているクラウドから提供される値を含むJSON文字列。この値は、クラスターが2つ以上の可用性ゾーンにまたがっているかどうかを示します。定義値は次のとおりです：

「true」 - クラスタが2つ以上のアベイラビリティゾーンにまたがっている
「false」 - クラスタは単一のアベイラビリティゾーン内に完全に配置されています

privateRouteID

string

False

プライベートクラスタのロケーションIDを含むJSON文字列。

最小長さ：1
最大長さ：255

connectorCapabilities

array[string]

False

このクラスタに関連付けられているコネクタの機能。下位互換性のためのオプション。存在しない場合は、プロキシが想定される機能となります。

apiServiceID

string

False

Kubernetes（k8s）APIサービスオブジェクトからのUUIDを含むJSON文字列。クラスタを一意に識別するために使用されます。

メタデータ

"type_astra_metadata_update"

True

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

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

回答例

{
  "type": "application/astra-cluster",
  "version": "1.7",
  "id": "dd95ce34-55ce-5f74-bb49-2f734fe5da30",
  "name": "GKE-22",
  "state": "running",
  "stateUnready": [],
  "managedState": "unmanaged",
  "managedStateUnready": [],
  "protectionState": "full",
  "protectionStateDetails": [],
  "tridentVersion": "23.10.0",
  "acpVersion": "23.10.0",
  "tridentManagedState": "managed",
  "tridentManagedStateDetails": [],
  "inUse": "false",
  "clusterType": "kubernetes",
  "clusterVersion": "1.91.1",
  "clusterVersionString": "1.19.1",
  "clusterCreationTimestamp": "2020-08-06T12:24:52.256624Z",
  "namespaces": [
    "kube-system",
    "kube-public",
    "my-app-1"
  ],
  "defaultStorageClass": "31c95aba-99d9-4987-b1bb-000dfce5952c",
  "cloudID": "548bdc1f-f00e-4a23-a062-83265d224d46",
  "credentialID": "6fa2f917-f730-41b8-9c15-17f531843b31",
  "location": "europe-west4",
  "isMultizonal": "false",
  "apiServiceID": "6bf33af2-872a-4553-a891-26b510c3edbe",
  "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

Name

を入力します

必須

説明

を入力します

string

True

タイトル

string

True

詳細

string

True

ステータス

string

True

correlationID

string

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: 500, Internal server error

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/64",
  "title": "Storage classes not found",
  "detail": "Storage classes from Trident weren't found.",
  "status": "500"
}

エラー

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_update

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

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

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

Name

を入力します

必須

説明

ラベル

配列["type_astra_label"]

False

作成タイムスタンプ

string

False

modificationTimestamp

string

False

作成者

string

False

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

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

クラウド用の新しいクラスターを作成する

Creating your file...

パラメータ

要求の本文

応答

応答

応答

応答

応答

応答

エラー

用語の意味