Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

1.13. Placements API (v1beta1)

1.13.1. 概要
リンクのコピー

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes の Placement リソースについて説明します。Placement リソースには、create、query、delete、update の 4 つのリクエストを使用できます。Placement は、placement namespace にバインドされている ManagedClusterSets から一連の ManagedClusters を選択するルールを定義します。ラベル cluster.open-cluster-management.io/placement={placement name} を持つ PlacementDecisions のスライスが作成され、この配置によって選択される ManagedClusters が表されます。

1.13.1.1. バージョン情報
リンクのコピー

バージョン: 2.7.0

1.13.1.2. URI スキーム
リンクのコピー

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

1.13.1.3. タグ
リンクのコピー

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

1.13.2. パス
リンクのコピー

1.13.2.1. 全 Placement のクエリー
リンクのコピー

GET /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/placements
Copy to Clipboard Toggle word wrap
1.13.2.1.1. 説明
リンクのコピー

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

1.13.2.1.2. パラメーター
リンクのコピー
Expand
型名前説明スキーマ

ヘッダー

COOKIE
必須

Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。

文字列

1.13.2.1.3. レスポンス
リンクのコピー
Expand
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.13.2.1.4. 消費
リンクのコピー
  • placement/yaml
1.13.2.1.5. タグ
リンクのコピー
  • cluster.open-cluster-management.io

1.13.2.2. Placement の作成
リンクのコピー

POST /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/placements
Copy to Clipboard Toggle word wrap
1.13.2.2.1. 説明
リンクのコピー

Placement を作成します。

1.13.2.2.2. パラメーター
リンクのコピー
Expand
型名前説明スキーマ

ヘッダー

COOKIE
必須

Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。

文字列

ボディー

body
必須

作成する placement を記述するパラメーター

Placement

1.13.2.2.3. レスポンス
リンクのコピー
Expand
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.13.2.2.4. 消費
リンクのコピー
  • placement/yaml
1.13.2.2.5. タグ
リンクのコピー
  • cluster.open-cluster-management.io
1.13.2.2.6. HTTP 要求の例
リンクのコピー
1.13.2.2.6.1. 要求のボディー
リンクのコピー
{
  "apiVersion" : "cluster.open-cluster-management.io/v1beta1",
  "kind" : "Placement",
  "metadata" : {
    "name" : "placement1",
    "namespace": "ns1"
  },
  "spec": {
    "predicates": [
      {
        "requiredClusterSelector": {
          "labelSelector": {
            "matchLabels": {
              "vendor": "OpenShift"
            }
          }
        }
      }
    ]
  },
  "status" : { }
}
Copy to Clipboard Toggle word wrap

1.13.2.3. 単一の Placement のクエリー
リンクのコピー

GET /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/placements/{placement_name}
Copy to Clipboard Toggle word wrap
1.13.2.3.1. 説明
リンクのコピー

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

1.13.2.3.2. パラメーター
リンクのコピー
Expand
型Name説明スキーマ

ヘッダー

COOKIE
必須

Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。

string

パス

placement_name
必須

問い合わせる Placement の名前

string

1.13.2.3.3. レスポンス
リンクのコピー
Expand
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.13.2.3.4. タグ
リンクのコピー
  • cluster.open-cluster-management.io

1.13.2.4. Placement の削除
リンクのコピー

DELETE /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/placements/{placement_name}
Copy to Clipboard Toggle word wrap
1.13.2.4.1. 説明
リンクのコピー

単一の Placement を削除します。

1.13.2.4.2. パラメーター
リンクのコピー
Expand
型Name説明スキーマ

ヘッダー

COOKIE
必須

Authorization: Bearer {ACCESS_TOKEN}。ACCESS_TOKEN はユーザーのアクセストークンに置き換えます。

string

パス

placement_name
必須

削除する Placement の名前

string

1.13.2.4.3. レスポンス
リンクのコピー
Expand
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.13.2.4.4. タグ
リンクのコピー
  • cluster.open-cluster-management.io

1.13.3. 定義
リンクのコピー

1.13.3.1. Placement
リンクのコピー

Expand
名前説明スキーマ

apiVersion
必須

Placement のバージョン管理されたスキーマ。

string

kind
必須

REST リソースを表す文字列の値

string

metadata
必須

Placement のメタデータ。

object

spec
必須

Placement の仕様。

spec

spec

Expand
名前説明スキーマ

clusterSets
optional

ManagedClusters の選択元となる ManagedClusterSets のサブセット。ManagedClusterSet が空の場合、ManagedClusters は Placement namespace にバインドされている ManagedClusterSets から選択されます。ManagedClusterSet に ManagedClusters が含まれている場合、ManagedClusters はこのサブセットの交差部分から選択されます。選択された ManagedClusterSets は placement namespace にバインドされます。

string array

numberOfClusters
任意

選択する ManagedClusters の数。

整数 (int32)

predicates
任意

ManagedClusters を選択するクラスター述語のサブセット。条件ロジックは OR です。

clusterPredicate アレイ

prioritizerPolicy
optional

プライオリタイザーのポリシー。

prioritizerPolicy

tolerations
任意

特定の Taint を持つマネージドクラスターが、一致する許容範囲を持つプレースメントによって選択されることを許可するが、必須ではない値。

Toleration 配列

clusterPredicate

Expand
名前説明スキーマ

requiredClusterSelector
任意

ラベルおよびクラスター要求のある ManagedClusters を選択するクラスターセレクター。

clusterSelector

clusterSelector

Expand
名前説明スキーマ

labelSelector
任意

ラベル別の ManagedClusters のセレクター。

object

claimSelector
任意

要求別の ManagedClusters のセレクター。

clusterClaimSelector

clusterClaimSelector

Expand
名前説明スキーマ

matchExpressions
任意

クラスター要求セレクター要件のサブセット。条件ロジックは AND です。

< オブジェクト > 配列

prioritizerPolicy

Expand
名前説明スキーマ

mode
任意

Exact、Additive、または "" のいずれか。"" のデフォルト値は Additive です。

string

configurations
任意

プライオリタイザーの設定。

prioritizerConfig 配列

prioritizerConfig

Expand
名前説明スキーマ

scoreCoordinate
required

プライオリタイザーおよびスコアソースの設定。

scoreCoordinate

weight
任意

プライオリタイザースコアの重み。値は [-10,10] の範囲内である必要があります。

int32

scoreCoordinate

Expand
名前説明スキーマ

type
必須

プライオリタイザースコアのタイプ。有効な値は BuiltIn または AddOn です。

string

builtIn
任意

次のオプションからの BuiltIn プライオリタイザーの名前: 1) バランス: クラスター間の決定のバランスをとります。2) 安定: 既存の決定が安定していることを確認します。3) ResourceAllocatableCPU & ResourceAllocatableMemory: 割り当て可能なリソースに基づいてクラスターを分類します。4) 分散: ワークロードをトポロジーに均等に分散します。

string

addOn
optional

type が AddOn の場合、AddOn はリソース名とスコア名を定義します。

object

容認

Expand
名前説明スキーマ

key
任意

Toleration が適用される Taint キー。空は、すべての Taint キーに一致することを意味します。

string

Operator
任意

キーと値の関係。有効な Operator は Exists および Equal です。デフォルト値は Equal です。

string

value
任意

Toleration に一致する Taint 値。

string

effect
任意

一致する Taint 効果。空は、すべての Taint 効果に一致することを意味します。指定した場合、許可される値は NoSelect、PreferNoSelect、および NoSelectIfNew です。

string

tolerationSeconds
optional

Taint が許容される時間の長さ。その後、Taint は許容されません。デフォルト値は nil です。これは、Taint が許容される期間に時間制限がないことを示します。

int64

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat