1.15. PlacementDecisions API (v1beta1)

1.15.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes の PlacementDecision リソースについて説明します。PlacementDecision リソースには、create、query、delete、update の 4 つのリクエストを使用できます。PlacementDecision は、プレースメントからの決定を示します。PlacementDecision は、ラベル cluster.open-cluster-management.io/placement={placement name} を使用して特定の配置を参照します。

1.15.1.1. バージョン情報

Version: 2.8.0

1.15.1.2. URI スキーム

ベースパス: /kubernetes/apis
スキーム: HTTPS

1.15.1.3. タグ

cluster.open-cluster-management.io: PlacementDecision を作成して管理します。

1.15.2. パス

1.15.2.1. 全 PlacementDecision のクエリー

GET /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/placementdecisions

1.15.2.1.1. 説明

PlacementDecisions に対してクエリーを実行して詳細を確認します。

1.15.2.1.2. パラメーター

型	名前	説明	スキーマ
Header	COOKIE 必須	Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。	string

1.15.2.1.3. レスポンス

HTTP コード	説明	スキーマ
200	成功	コンテンツなし
403	アクセス禁止	コンテンツなし
404	リソースが見つからない	コンテンツなし
500	内部サービスエラー	コンテンツなし
503	サービスが利用できない	コンテンツなし

1.15.2.1.4. 消費

placementdecision/yaml

1.15.2.1.5. タグ

cluster.open-cluster-management.io

1.15.2.2. PlacementDecision の作成

POST /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/placementdecisions

1.15.2.2.1. 説明

PlacementDecisions を作成します。

1.15.2.2.2. パラメーター

型	名前	説明	スキーマ
Header	COOKIE 必須	Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。	string
Body	body 必須	作成する PlacementDecision を記述するパラメーター	PlacementDecision

1.15.2.2.3. レスポンス

HTTP コード	説明	スキーマ
200	成功	コンテンツなし
403	アクセス禁止	コンテンツなし
404	リソースが見つからない	コンテンツなし
500	内部サービスエラー	コンテンツなし
503	サービスが利用できない	コンテンツなし

1.15.2.2.4. 消費

placementdecision/yaml

1.15.2.2.5. タグ

cluster.open-cluster-management.io

1.15.2.2.6. HTTP リクエストの例

1.15.2.2.6.1. 要求の body

{
  "apiVersion" : "cluster.open-cluster-management.io/v1beta1",
  "kind" : "PlacementDecision",
  "metadata" : {
    "labels" : {
      "cluster.open-cluster-management.io/placement" : "placement1"
    },
    "name" : "placement1-decision1",
    "namespace": "ns1"
  },
  "status" : { }
}

1.15.2.3. 単一の PlacementDecision のクエリー

GET /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/placementdecisions/{placementdecision_name}

1.15.2.3.1. 説明

1 つの PlacementDecisions に対してクエリーを実行して詳細を確認します。

1.15.2.3.2. パラメーター

型	名前	説明	スキーマ
Header	COOKIE 必須	Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。	string
パス	placementdecision_name 必須	問い合わせる PlacementDecision の名前	string

1.15.2.3.3. レスポンス

HTTP コード	説明	スキーマ
200	成功	コンテンツなし
403	アクセス禁止	コンテンツなし
404	リソースが見つからない	コンテンツなし
500	内部サービスエラー	コンテンツなし
503	サービスが利用できない	コンテンツなし

1.15.2.3.4. タグ

cluster.open-cluster-management.io

1.15.2.4. PlacementDecision の削除

DELETE /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/placementdecisions/{placementdecision_name}

1.15.2.4.1. 説明

単一の PlacementDecision を削除します。

1.15.2.4.2. パラメーター

型	名前	説明	スキーマ
Header	COOKIE 必須	Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。	string
パス	placementdecision_name 必須	削除する PlacementDecision の名前	string

1.15.2.4.3. レスポンス

HTTP コード	説明	スキーマ
200	成功	コンテンツなし
403	アクセス禁止	コンテンツなし
404	リソースが見つからない	コンテンツなし
500	内部サービスエラー	コンテンツなし
503	サービスが利用できない	コンテンツなし

1.15.2.4.4. タグ

cluster.open-cluster-management.io

1.15.3. 定義

1.15.3.1. PlacementDecision

名前	説明	スキーマ
apiVersion 必須	`PlacementDecision` のバージョン管理されたスキーマ。	string
kind 必須	REST リソースを表す文字列の値	string
metadata 必須	`PlacementDecision` のメタデータ。	object
status 任意	`PlacementDecision` の現在のステータス。	PlacementStatus

PlacementStatus

Name	説明	スキーマ
Decisions 必須	プレースメントに応じた決定のスライス。	ClusterDecision array

ClusterDecision

Name	説明	スキーマ
clusterName 必須	`ManagedCluster` の名前。	string
reason 必須	`ManagedCluster` が選択されている理由。	string