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

管理対象クラスタのクラスタノードを取得します

PDF

GET /accounts/{account_id}/topology/v1/managedClusters/{managedCluster_id}/clusterNodes/{clusterNode_id}

JSONレスポンスボディに格納されているクラスタノードAPIリソースを返します。

パラメータ

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

account_id

string

path（パス）

True

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

  • 例：{{.Account}}

managedCluster_id

string

path（パス）

True

包含するmanagedClusterリソースのID

clusterNode_id

string

path（パス）

True

リストするclusterNodeコレクションのID

応答

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

を入力します

string

True

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

  • 「application/astra-clusterNode」

バージョン

string

True

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

  • "1.0"

ID

string

True

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

  • UUIDv4スキーマに準拠

名前

string

True

ノードのKubernetes名を示す値を含むJSON文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：254

ロール

string

True

ノードのKubernetesロールを示す値を含むJSON文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：254

ラベル

配列["ラベル"]

True

JSONオブジェクトのJSON配列。各JSONオブジェクトには、ノードに関連付けられたKubernetesラベルが含まれています。詳細情報が利用できない場合、この配列は空になります。

  • 最小アイテム数：0

creationTime

string

True

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

  • ISO-8601 Date Time Schemaに準拠

externalIP

string

True

ノードの内部IPアドレスを示す値を含むJSON文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：63

internalIP

string

True

ノードの外部IPアドレスを示す値を含むJSON文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：63

ゾーン

string

True

ノードのKubernetesゾーンを示す値を含むJSON文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：254

リージョン

string

True

ノードのKubernetesリージョンを示す値を含むJSON文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：254

instanceType

string

True

ノードのKubernetesインスタンスタイプを示す値を含むJSON文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：254

kernelVersion

string

True

ノードで使用されているカーネルバージョンを示す値を含むJSON文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：254

osImage

string

True

ノードが使用するオペレーティングシステムイメージを示す値を含むJSON文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：254

numCpus

string

True

ノードに割り当てられたCPUの数を示す値を含むJSON文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：254

memory

string

True

ノードに割り当てられたメモリ量を示す値を含むJSON文字列。定義された値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：254

状態

string

True

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

  • 「running」 - ノードは正常に動作しています

  • 「provisioning」 - ノードはプロビジョニング処理中です

  • 「discovering」 - ノードの側面が検出されている最中です

  • 「pending」 - ノードの検出が予定されています

  • 「failed」 - ノードが障害状態です

  • 「不明」 - ノードの状態を判断できません

メタデータ

"type_astra_metadata"

True

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

  • Astraメタデータスキーマに準拠
回答例 
{
  "type": "application/astra-clusterNode",
  "version": "1.0",
  "id": "5df0e09f-2c30-5b8a-b6b6-4fb4063525e4",
  "name": "test-0",
  "role": "node-role.kubernetes.io/worker",
  "labels": [],
  "creationTime": "2020-09-06T04:35:23.593845Z",
  "externalIP": "192.168.12.44",
  "internalIP": "10.0.1.1",
  "zone": "us-west1-c",
  "region": "us-east1",
  "instanceType": "e2-medium",
  "kernelVersion": "4.18.0-147.0.3.el8_1.x86_64",
  "osImage": "Red Hat Enterprise Linux CoreOS 42.81.20191203.0",
  "numCpus": "2",
  "memory": "67108864Ki",
  "state": "running",
  "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"
}

用語の意味

定義を参照

ラベル

Name を入力します 必須 説明

名前

string

True

ラベル名を含むJSON文字列。定義済みの値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：63

  • 定義された正規表現は次のとおりです："^([\S.]{1,253}\/)?([a-z0-9A-Z_.-]){1,63}$"

Value

string

True

ラベル値を含むJSON文字列。定義済みの値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：63

  • 定義された正規表現は次のとおりです："^([a-z0-9A-Z_.-]){1,63}$"

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

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