API

Red Hat Advanced Cluster Management for Kubernetes 2.3

アプリケーションリソース、チャネル、サブスクリプションの作成や管理、情報のクエリーに使用できる API の一覧を表示します。

概要

アプリケーションリソース、チャネル、サブスクリプションの作成や管理、情報のクエリーに使用できる API の一覧を表示します。

第1章 API

API にアクセスして、アプリケーションリソース、チャネル、サブスクリプションの作成や管理、さらに情報のクエリーを行うことができます。

ユーザーに必要なアクセス権: ロールが割り当てられているアクションのみを実行できます。「ロールベースのアクセス制御」のドキュメントで、アクセス要件について確認してください。

詳細は、以下の各リソースに関する API のドキュメントを参照してください。

1.1. Clusters API

1.1.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes のクラスターリソースについて説明します。クラスターリソースには、create、query、delete、update の 4 つの要求を使用できます。

1.1.1.1. バージョン情報

バージョン: 2.3.0

1.1.1.2. お問い合わせ先

お問い合わせメール: apiteam@swagger.io

1.1.1.3. ライセンス情報

ライセンス: Apache 2.0
ライセンス URL: http://www.apache.org/licenses/LICENSE-2.0.html
利用規約: http://swagger.io/terms/

1.1.1.4. URI スキーム

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

1.1.1.5. タグ

  • cluster.open-cluster-management.io: クラスターを作成して管理します。

1.1.1.6. 外部ドキュメント

説明: Swagger に関する詳細は次を確認してください。
URL: http://swagger.io

1.1.2. パス

1.1.2.1. 全クラスターのクエリー

GET /cluster.open-cluster-management.io/v1/managedclusters
1.1.2.1.1. 説明

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

1.1.2.1.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

1.1.2.1.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.1.2.1.4. 消費
  • cluster/yaml
1.1.2.1.5. タグ
  • cluster.open-cluster-management.io

1.1.2.2. クラスターの作成

POST /cluster.open-cluster-management.io/v1/managedclusters
1.1.2.2.1. 説明

クラスターを作成します。

1.1.2.2.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

ボディー

body
必須

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

クラスター

1.1.2.2.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.1.2.2.4. 消費
  • cluster/yaml
1.1.2.2.5. タグ
  • cluster.open-cluster-management.io
1.1.2.2.6. HTTP 要求の例
1.1.2.2.6.1. 要求ボディー
{
  "apiVersion" : "cluster.open-cluster-management.io/v1",
  "kind" : "ManagedCluster",
  "metadata" : {
    "labels" : {
      "vendor" : "OpenShift"
    },
    "name" : "cluster1"
  },
  "spec": {
    "hubAcceptsClient": true,
    "managedClusterClientConfigs": [
      {
        "caBundle": "test",
        "url": "https://test.com"
      }
    ]
  },
  "status" : { }
}

1.1.2.3. 単一クラスターのクエリー

GET /cluster.open-cluster-management.io/v1/managedclusters/{cluster_name}
1.1.2.3.1. 説明

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

1.1.2.3.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

cluster_name
必須

問い合わせるクラスターの名前。

文字列

1.1.2.3.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.1.2.3.4. タグ
  • cluster.open-cluster-management.io

1.1.2.4. クラスターの削除

DELETE /cluster.open-cluster-management.io/v1/managedclusters/{cluster_name}
1.1.2.4.1. 説明

単一クラスターを削除します。

1.1.2.4.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

cluster_name
必須

削除するクラスターの名前。

文字列

1.1.2.4.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.1.2.4.4. タグ
  • cluster.open-cluster-management.io

1.1.3. 定義

1.1.3.1. クラスター

Name (名前)スキーマ

apiVersion
必須

文字列

kind
必須

文字列

metadata
必須

オブジェクト

spec
必須

spec

spec

Name (名前)スキーマ

hubAcceptsClient
必須

ブール値

managedClusterClientConfigs
任意

< managedClusterClientConfigs > array

leaseDurationSeconds
任意

整数 (int32)

managedClusterClientConfigs

Name (名前)説明スキーマ

URL
必須

 

文字列

cabundle
任意

パターン: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"

文字列 (バイト)

1.2. Clustersets API (v1alpha1)

1.2.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes のClustersetリソースについて説明します。Clustersetリソースには、create、query、delete、update の 4 つの要求を使用できます。

1.2.1.1. バージョン情報

バージョン: 2.3.0

1.2.1.2. お問い合わせ先

お問い合わせメール: apiteam@swagger.io

1.2.1.3. ライセンス情報

ライセンス: Apache 2.0
ライセンス URL: http://www.apache.org/licenses/LICENSE-2.0.html
利用規約: http://swagger.io/terms/

1.2.1.4. URI スキーム

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

1.2.1.5. タグ

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

1.2.1.6. 外部ドキュメント

説明: Swagger に関する詳細は次を確認してください。
URL: http://swagger.io

1.2.2. パス

1.2.2.1. 全clustersetのクエリー

GET /cluster.open-cluster-management.io/v1alpha1/managedclustersets
1.2.2.1.1. 説明

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

1.2.2.1.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

1.2.2.1.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.2.2.1.4. 消費
  • clusterset/yaml
1.2.2.1.5. タグ
  • cluster.open-cluster-management.io

1.2.2.2. clustersetの作成

POST /cluster.open-cluster-management.io/v1alpha1/managedclustersets
1.2.2.2.1. 説明

Clustersetを作成します。

1.2.2.2.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

ボディー

body
必須

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

Clusterset

1.2.2.2.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.2.2.2.4. 消費
  • clusterset/yaml
1.2.2.2.5. タグ
  • cluster.open-cluster-management.io
1.2.2.2.6. HTTP 要求の例
1.2.2.2.6.1. 要求ボディー
{
  "apiVersion" : "cluster.open-cluster-management.io/v1alpha1",
  "kind" : "ManagedClusterSet",
  "metadata" : {
    "name" : "clusterset1"
  },
  "spec": { },
  "status" : { }
}

1.2.2.3. 単一clustersetのクエリー

GET /cluster.open-cluster-management.io/v1alpha1/managedclustersets/{clusterset_name}
1.2.2.3.1. 説明

単一のclustersetに対してクエリーを実行して詳細を確認します。

1.2.2.3.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

clusterset_name
必須

問い合わせるclustersetの名前。

文字列

1.2.2.3.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.2.2.3.4. タグ
  • cluster.open-cluster-management.io

1.2.2.4. clustersetの削除

DELETE /cluster.open-cluster-management.io/v1alpha1/managedclustersets/{clusterset_name}
1.2.2.4.1. 説明

単一clustersetを削除します。

1.2.2.4.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

clusterset_name
必須

削除するclustersetの名前。

文字列

1.2.2.4.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.2.2.4.4. タグ
  • cluster.open-cluster-management.io

1.2.3. 定義

1.2.3.1. Clusterset

Name (名前)スキーマ

apiVersion
必須

文字列

kind
必須

文字列

metadata
必須

オブジェクト

1.3. Clustersetbindings API (v1alpha1)

1.3.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes の clustersetbinding リソースについて説明します。clustersetbinding リソースには、create、query、delete、update の 4 つの要求を使用できます。

1.3.1.1. バージョン情報

バージョン: 2.3.0

1.3.1.2. お問い合わせ先

お問い合わせメール: apiteam@swagger.io

1.3.1.3. ライセンス情報

ライセンス: Apache 2.0
ライセンス URL: http://www.apache.org/licenses/LICENSE-2.0.html
利用規約: http://swagger.io/terms/

1.3.1.4. URI スキーム

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

1.3.1.5. タグ

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

1.3.1.6. 外部ドキュメント

説明: Swagger に関する詳細は次を確認してください。
URL: http://swagger.io

1.3.2. パス

1.3.2.1. 全 clustersetbinding のクエリー

GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/managedclustersetbindings
1.3.2.1.1. 説明

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

1.3.2.1.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.3.2.1.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.3.2.1.4. 消費
  • clustersetbinding/yaml
1.3.2.1.5. タグ
  • cluster.open-cluster-management.io

1.3.2.2. clustersetbinding の作成

POST /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/managedclustersetbindings
1.3.2.2.1. 説明

clustersetbinding を作成します。

1.3.2.2.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

ボディー

body
必須

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

Clustersetbinding

1.3.2.2.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.3.2.2.4. 消費
  • clustersetbinding/yaml
1.3.2.2.5. タグ
  • cluster.open-cluster-management.io
1.3.2.2.6. HTTP 要求の例
1.3.2.2.6.1. 要求ボディー
{
  "apiVersion" : "cluster.open-cluster-management.io/v1",
  "kind" : "ManagedClusterSetBinding",
  "metadata" : {
    "name" : "clusterset1",
    "namespace" : "ns1"
  },
 "spec": {
    "clusterSet": "clusterset1"
  },
  "status" : { }
}

1.3.2.3. 単一 clustersetbinding のクエリー

GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/managedclustersetbindings/{clustersetbinding_name}
1.3.2.3.1. 説明

単一の clustersetbinding に対してクエリーを実行して詳細を確認します。

1.3.2.3.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

パス

clustersetbinding_name
必須

問い合わせる clustersetbinding の名前。

文字列

1.3.2.3.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.3.2.3.4. タグ
  • cluster.open-cluster-management.io

1.3.2.4. clustersetbinding の削除

DELETE /cluster.open-cluster-management.io/v1alpha1/managedclustersetbindings/{clustersetbinding_name}
1.3.2.4.1. 説明

単一 clustersetbinding を削除します。

1.3.2.4.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

パス

clustersetbinding_name
必須

削除する clustersetbinding の名前。

文字列

1.3.2.4.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.3.2.4.4. タグ
  • cluster.open-cluster-management.io

1.3.3. 定義

1.3.3.1. Clustersetbinding

Name (名前)スキーマ

apiVersion
必須

文字列

kind
必須

文字列

metadata
必須

オブジェクト

spec
必須

spec

spec

Name (名前)スキーマ

clusterSet
必須

文字列

1.4. Clusterview API (v1alpha1)

1.4.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes の clusterview リソースについて説明します。clusterview リソースには、アクセス可能なマネージドクラスターおよびマネージドクラスターセットの一覧を表示できる CLI コマンドが含まれます。使用できる要求は、list、get、および watch の 3 つです。

1.4.1.1. バージョン情報

バージョン: 2.3.0

1.4.1.2. お問い合わせ先

お問い合わせメール: apiteam@swagger.io

1.4.1.3. ライセンス情報

ライセンス: Apache 2.0
ライセンス URL: http://www.apache.org/licenses/LICENSE-2.0.html
利用規約: http://swagger.io/terms/

1.4.1.4. URI スキーム

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

1.4.1.5. タグ

  • clusterview.open-cluster-management.io: お使いの ID がアクセスできるマネージドクラスターの一覧を表示します。

1.4.1.6. 外部ドキュメント

説明: Swagger に関する詳細は次を確認してください。
URL: http://swagger.io

1.4.2. パス

1.4.2.1. マネージドクラスターの取得

GET /managedclusters.clusterview.open-cluster-management.io
1.4.2.1.1. 説明

アクセス可能なマネージドクラスターの一覧を表示します。

1.4.2.1.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

1.4.2.1.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.4.2.1.4. 消費
  • managedcluster/yaml
1.4.2.1.5. タグ
  • clusterview.open-cluster-management.io

1.4.2.2. マネージドクラスターの一覧表示

LIST /managedclusters.clusterview.open-cluster-management.io
1.4.2.2.1. 説明

アクセス可能なマネージドクラスターの一覧を表示します。

1.4.2.2.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

ボディー

body
任意

マネージドクラスターを一覧表示するユーザー ID の名前。

文字列

1.4.2.2.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.4.2.2.4. 消費
  • managedcluster/yaml
1.4.2.2.5. タグ
  • clusterview.open-cluster-management.io
1.4.2.2.6. HTTP 要求の例
1.4.2.2.6.1. 要求ボディー
{
  "apiVersion" : "clusterview.open-cluster-management.io/v1alpha1",
  "kind" : "ClusterView",
  "metadata" : {
    "name" : "<user_ID>"
  },
  "spec": { },
  "status" : { }
}

1.4.2.3. マネージドクラスターセットの監視

WATCH /managedclusters.clusterview.open-cluster-management.io
1.4.2.3.1. 説明

アクセス可能なマネージドクラスターを確認します。

1.4.2.3.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

clusterview_name
任意

監視するユーザー ID の名前。

文字列

1.4.2.3.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.4.2.4. マネージドクラスターセットの一覧表示

GET /managedclustersets.clusterview.open-cluster-management.io
1.4.2.4.1. 説明

アクセス可能なマネージドクラスターを一覧表示します。

1.4.2.4.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

clusterview_name
任意

監視するユーザー ID の名前。

文字列

1.4.2.4.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.4.2.5. マネージドクラスターセットの一覧表示

LIST /managedclustersets.clusterview.open-cluster-management.io
1.4.2.5.1. 説明

アクセス可能なマネージドクラスターを一覧表示します。

1.4.2.5.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

clusterview_name
任意

監視するユーザー ID の名前。

文字列

1.4.2.5.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.4.2.6. マネージドクラスターセットの監視

WATCH /managedclustersets.clusterview.open-cluster-management.io
1.4.2.6.1. 説明

アクセス可能なマネージドクラスターを確認します。

1.4.2.6.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

clusterview_name
任意

監視するユーザー ID の名前。

文字列

1.4.2.6.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.5. Channels API

1.5.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes のChannelリソースについて説明します。Channelリソースには、create、query、delete、update の 4 つの要求を使用できます。

1.5.1.1. バージョン情報

バージョン: 2.3.0

1.5.1.2. お問い合わせ先

お問い合わせメール: apiteam@swagger.io

1.5.1.3. ライセンス情報

ライセンス: Apache 2.0
ライセンス URL: http://www.apache.org/licenses/LICENSE-2.0.html
利用規約: http://swagger.io/terms/

1.5.1.4. URI スキーム

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

1.5.1.5. タグ

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

1.5.1.6. 外部ドキュメント

説明: Swagger に関する詳細は次を確認してください。
URL: http://swagger.io

1.5.2. パス

1.5.2.1. チャネルの作成

POST /apps.open-cluster-management.io/v1/namespaces/{namespace}/channels
1.5.2.1.1. 説明

チャネルを作成します。

1.5.2.1.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

ボディー

body
必須

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

Channel

1.5.2.1.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.5.2.1.4. 消費
  • application/yaml
1.5.2.1.5. タグ
  • channels.apps.open-cluster-management.io
1.5.2.1.6. HTTP 要求の例
1.5.2.1.6.1. 要求ボディー
{
  "apiVersion": "apps.open-cluster-management.io/v1",
  "kind": "Channel",
  "metadata": {
    "name": "sample-channel",
    "namespace": "default"
  },
  "spec": {
    "configMapRef": {
      "kind": "configmap",
      "name": "bookinfo-resource-filter-configmap"
    },
    "pathname": "https://charts.helm.sh/stable",
    "type": "HelmRepo"
  }
}

1.5.2.2. ターゲット namespace の全チャネルのクエリー

GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/channels
1.5.2.2.1. 説明

チャネルに対してクエリーを実行して詳細を確認します。

1.5.2.2.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.5.2.2.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.5.2.2.4. 消費
  • application/yaml
1.5.2.2.5. タグ
  • channels.apps.open-cluster-management.io

1.5.2.3. namespace の単一チャネルのクエリー

GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/channels/{channel_name}
1.5.2.3.1. 説明

単一のチャネルに対してクエリーを実行して詳細を確認します。

1.5.2.3.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

channel_name
必須

問い合わせる deployable の名前。

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.5.2.3.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.5.2.3.4. タグ
  • channels.apps.open-cluster-management.io

1.5.2.4. Channelの削除

DELETE /apps.open-cluster-management.io/v1/namespaces/{namespace}/channels/{channel_name}
1.5.2.4.1. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

channel_name
必須

削除するChannelの名前。

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.5.2.4.2. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.5.2.4.3. タグ
  • channels.apps.open-cluster-management.io

1.5.3. 定義

1.5.3.1. Channel

Name (名前)スキーマ

apiVersion
必須

文字列

kind
必須

文字列

metadata
必須

オブジェクト

spec
必須

spec

spec

Name (名前)説明スキーマ

configMapRef
任意

ObjectReference には参照先のオブジェクトを調査または変更するのに十分な情報が含まれます。

configMapRef

gates
任意

ChannelGate はチャネルにプロモートする基準を定義します。

gates

pathname
必須

 

文字列

secretRef
任意

ObjectReference には参照先のオブジェクトを調査または変更するのに十分な情報が含まれます。

secretRef

sourceNamespaces
任意

 

< 列挙 (Namespace、HelmRepo、ObjectBucket、Git、namespace、helmrepo、objectbucket、github) > 配列

configMapRef

Name (名前)説明スキーマ

apiVersion
任意

参照先の API バージョン。

文字列

fieldPath
任意

オブジェクト全体ではなく一部を参照する場合に、この文字列には、desiredState.manifest.containers[2] など、有効な JSON/Go フィールドアクセスステートメントを含める必要があります。たとえば、オブジェクトの参照先が Pod 内のコンテナーの場合には、「spec.containers{name}」などの値に設定されます (「name」はイベントをトリガーしたコンテナー名に置き換えます)。またはコンテナー名が指定されていない場合には、「spec.containers[2]」の値に設定されます (この Pod 内でインデックス が 2 のコンテナー)。この構文が選択された唯一の理由は、オブジェクトの一部の参照を明確に定義するためです。TODO: この設計は最終版ではないので今後このフィールドは変更される可能性があります。

文字列

kind
任意

参照先の種類。詳細: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

文字列

name
任意

参照先の名前。詳細: Names

文字列

namespace
任意

参照先の namespace。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

文字列

resourceVersion
任意

この参照が作成される特定の resourceVersion (ある場合)。詳細: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

文字列

uid
任意

参照先の UID。詳細: UIDs

文字列

gates

Name (名前)説明スキーマ

annotations
任意

k8s の典型的なアノテーション

annotations

labelSelector
任意

ラベルセレクターとは、一連のリソースに対するラベルクエリー機能です。matchLabels と matchExpressions の結果は AND を使用して結合されます。ラベルセレクターが空の場合は、全オブジェクトをマッチします。ラベルセレクターが null の場合は、どのオブジェクトもマッチしません。

labelSelector

name
任意

 

文字列

annotations

Name (名前)スキーマ

key
任意

文字列

value
任意

文字列

labelSelector

Name (名前)説明スキーマ

matchExpressions
任意

matchExpressions はラベルセレクターの要件の一覧です。要件は AND で結合されます。

< matchExpressions > 配列

matchLabels
任意

matchLabels は、{key,value} ペアのマップです。MatchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには「key」、演算子には「In」、値配列には「value」のみが含まれます。要件は AND で結合されます。

< 文字列、文字列 > マップ

matchExpressions

Name (名前)説明スキーマ

key
必須

key は、セレクターの適用先のラベルキーです。

文字列

operator
必須

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

文字列

values
任意

values は文字列値の配列です。operator が In または NotIn の場合には、values配列を空白にできません。operator が Exists または DoesNotExist の場合には、values配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

< 文字列 > 配列

secretRef

Name (名前)説明スキーマ

apiVersion
任意

参照先の API バージョン。

文字列

fieldPath
任意

オブジェクト全体ではなく一部を参照する場合に、この文字列には、desiredState.manifest.containers[2] など、有効な JSON/Go フィールドアクセスステートメントを含める必要があります。たとえば、オブジェクトの参照先が Pod 内のコンテナーの場合には、「spec.containers{name}」などの値に設定されます (「name」はイベントをトリガーしたコンテナー名に置き換えます)。またはコンテナー名が指定されていない場合には、「spec.containers[2]」の値に設定されます (この Pod 内でインデックス が 2 のコンテナー)。この構文が選択された唯一の理由は、オブジェクトの一部の参照を明確に定義するためです。TODO: この設計は最終版ではないので今後このフィールドは変更される可能性があります。

文字列

kind
任意

参照先の種類。詳細: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds

文字列

name
任意

参照先の名前。詳細: Names

文字列

namespace
任意

参照先の namespace。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

文字列

resourceVersion
任意

この参照が作成される特定の resourceVersion (ある場合)。詳細: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency

文字列

uid
任意

参照先の UID。詳細:UIDs

文字列

1.6. Subscriptions API

1.6.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes のSubscriptionリソースについて説明します。Subscriptionリソースには、create、query、delete、update の 4 つの要求を使用できます。

1.6.1.1. バージョン情報

バージョン: 2.3.0

1.6.1.2. お問い合わせ先

お問い合わせメール: apiteam@swagger.io

1.6.1.3. ライセンス情報

ライセンス: Apache 2.0
ライセンス URL: http://www.apache.org/licenses/LICENSE-2.0.html
利用規約: http://swagger.io/terms/

1.6.1.4. URI スキーム

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

1.6.1.5. タグ

  • subscriptions.apps.open-cluster-management.io: サブスクリプションを作成して管理します。

1.6.1.6. 外部ドキュメント

説明: Swagger に関する詳細は次を確認してください。
URL: http://swagger.io

1.6.2. パス

1.6.2.1. サブスクリプションの作成

POST /apps.open-cluster-management.io/v1/namespaces/{namespace}/subscriptions
1.6.2.1.1. 説明

サブスクリプションを作成します。

1.6.2.1.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

ボディー

body
必須

作成するサブスクリプションを記述するパラメーター。

Subscription

1.6.2.1.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.6.2.1.4. 消費
  • subscription/yaml
1.6.2.1.5. タグ
  • subscriptions.apps.open-cluster-management.io
1.6.2.1.6. HTTP 要求の例
1.6.2.1.6.1. 要求ボディー
{
  "apiVersion" : "apps.open-cluster-management.io/v1",
  "kind" : "Subscription",
  "metadata" : {
    "name" : "sample_subscription",
    "namespace" : "default",
    "labels" : {
      "app" : "sample_subscription-app"
    },
    "annotations" : {
      "apps.open-cluster-management.io/git-path" : "apps/sample/",
      "apps.open-cluster-management.io/git-branch" : "sample_branch"
    }
  },
  "spec" : {
    "channel" : "channel_namespace/sample_channel",
    "packageOverrides" : [ {
      "packageName" : "my-sample-application",
      "packageAlias" : "the-sample-app",
      "packageOverrides" : [ {
        "path" : "spec",
        "value" : {
          "persistence" : {
            "enabled" : false,
            "useDynamicProvisioning" : false
          },
          "license" : "accept",
          "tls" : {
            "hostname" : "my-mcm-cluster.icp"
          },
          "sso" : {
            "registrationImage" : {
              "pullSecret" : "hub-repo-docker-secret"
            }
          }
        }
      } ]
    } ],
    "placement" : {
      "placementRef" : {
        "kind" : "PlacementRule",
        "name" : "demo-clusters"
      }
    }
  }
}

1.6.2.2. 全サブスクリプションのクエリー

GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/subscriptions
1.6.2.2.1. 説明

サブスクリプションにクエリーを行い、詳細を確認します。

1.6.2.2.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.6.2.2.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.6.2.2.4. 消費
  • subscription/yaml
1.6.2.2.5. タグ
  • subscriptions.apps.open-cluster-management.io

1.6.2.3. 単一サブスクリプションのクエリー

GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/subscriptions/{subscription_name}
1.6.2.3.1. 説明

1 つのサブスクリプションにクエリーを行い、詳細を確認します。

1.6.2.3.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

パス

subscription_name
必須

問い合わせるサブスクリプションの名前。

文字列

1.6.2.3.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.6.2.3.4. タグ
  • subscriptions.apps.open-cluster-management.io

1.6.2.4. サブスクリプションの削除

DELETE /apps.open-cluster-management.io/v1/namespaces/{namespace}/subscriptions/{subscription_name}
1.6.2.4.1. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

パス

subscription_name
必須

削除するサブスクリプションの名前。

文字列

1.6.2.4.2. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.6.2.4.3. タグ
  • subscriptions.apps.open-cluster-management.io

1.6.3. 定義

1.6.3.1. Subscription

Name (名前)スキーマ

apiVersion
必須

文字列

kind
必須

文字列

metadata
必須

metadata

spec
必須

spec

status
任意

status

metadata

Name (名前)スキーマ

annotations
任意

オブジェクト

labels
任意

オブジェクト

name
任意

文字列

namespace
任意

文字列

spec

Name (名前)スキーマ

channel
必須

文字列

name
任意

文字列

overrides
任意

<overrides > 配列

packageFilter
任意

packageFilter

packageOverrides
任意

< packageOverrides > 配列

placement
任意

placement

timewindow
任意

timewindow

overrides

Name (名前)スキーマ

clusterName
必須

文字列

clusterOverrides
必須

< オブジェクト > 配列

packageFilter

Name (名前)説明スキーマ

annotations
任意

 

< 文字列、文字列 > マップ

filterRef
任意

 

filterRef

labelSelector
任意

 

labelSelector

version
任意

パターン: "([0-9]+)\\.[0-9]+)(\\.[0-9]+)|(\\.[0-9]+)?(\\.[xX]$"

文字列

filterRef

Name (名前)スキーマ

name
任意

文字列

labelSelector

Name (名前)スキーマ

matchExpressions
任意

< matchExpressions > 配列

matchLabels
任意

< 文字列、文字列 > マップ

matchExpressions

Name (名前)スキーマ

key
必須

文字列

operator
必須

文字列

values
任意

< 文字列 > 配列

packageOverrides

Name (名前)スキーマ

packageAlias
任意

文字列

packageName
必須

文字列

packageOverrides
任意

< オブジェクト > 配列

placement

Name (名前)スキーマ

clusterSelector
任意

clusterSelector

clusters
任意

<clusters > 配列

local
任意

ブール値

placementRef
任意

placementRef

clusterSelector

Name (名前)スキーマ

matchExpressions
任意

< matchExpressions > 配列

matchLabels
任意

< 文字列、文字列 > マップ

matchExpressions

Name (名前)スキーマ

key
必須

文字列

operator
必須

文字列

values
任意

< 文字列 > 配列

clusters

Name (名前)スキーマ

name
必須

文字列

placementRef

Name (名前)スキーマ

apiVersion
任意

文字列

fieldPath
任意

文字列

kind
任意

文字列

name
任意

文字列

namespace
任意

文字列

resourceVersion
任意

文字列

uid
任意

文字列

timewindow

Name (名前)スキーマ

daysofweek
任意

< 文字列 > 配列

hours
任意

<hours > 配列

location
任意

文字列

windowtype
任意

列挙 (active、blocked、Active、Blocked)

hours

Name (名前)スキーマ

end
任意

文字列

start
任意

文字列

status

Name (名前)スキーマ

lastUpdateTime
任意

文字列 (date-time)

message
任意

文字列

phase
任意

文字列

reason
任意

文字列

statuses
任意

オブジェクト

1.7. PlacementRules API

1.7.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes の PlacementRule リソースについて説明します。PlacementRule リソースには、create、query、delete、update の 4 つの要求を使用できます。

1.7.1.1. バージョン情報

バージョン: 2.3.0

1.7.1.2. お問い合わせ先

お問い合わせメール: apiteam@swagger.io

1.7.1.3. ライセンス情報

ライセンス: Apache 2.0
ライセンス URL: http://www.apache.org/licenses/LICENSE-2.0.html
利用規約: http://swagger.io/terms/

1.7.1.4. URI スキーム

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

1.7.1.5. タグ

  • placementrules.apps.open-cluster-management.io: 配置ルールを作成して管理します。

1.7.1.6. 外部ドキュメント

説明: Swagger に関する詳細は次を確認してください。
URL: http://swagger.io

1.7.2. パス

1.7.2.1. 配置ルールの作成

POST /apps.open-cluster-management.io/v1/namespaces/{namespace}/placementrules
1.7.2.1.1. 説明

配置ルールを作成します。

1.7.2.1.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

ボディー

body
必須

作成する配置ルールを記述するパラメーター。

PlacementRule

1.7.2.1.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.7.2.1.4. 消費
  • application/yaml
1.7.2.1.5. タグ
  • placementrules.apps.open-cluster-management.io
1.7.2.1.6. HTTP 要求の例
1.7.2.1.6.1. 要求ボディー
{
  "apiVersion" : "apps.open-cluster-management.io/v1",
  "kind" : "PlacementRule",
  "metadata" : {
    "name" : "towhichcluster",
    "namespace" : "ns-sub-1"
  },
  "spec" : {
    "clusterConditions" : [ {
      "type": "ManagedClusterConditionAvailable",
      "status": "True"
    } ],
    "clusterSelector" : { }
  }
}

1.7.2.2. 全配置ルールのクエリー

GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/placementrules
1.7.2.2.1. 説明

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

1.7.2.2.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.7.2.2.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.7.2.2.4. 消費
  • application/yaml
1.7.2.2.5. タグ
  • placementrules.apps.open-cluster-management.io

1.7.2.3. 単一の placementrule のクエリー

GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/placementrules/{placementrule_name}
1.7.2.3.1. 説明

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

1.7.2.3.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

パス

placementrule_name
必須

問い合わせる placementrule の名前。

文字列

1.7.2.3.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.7.2.3.4. タグ
  • placementrules.apps.open-cluster-management.io

1.7.2.4. placementrule の削除

DELETE /apps.open-cluster-management.io/v1/namespaces/{namespace}/placementrules/{placementrule_name}
1.7.2.4.1. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

パス

placementrule_name
必須

削除する placementrule の名前。

文字列

1.7.2.4.2. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.7.2.4.3. タグ
  • placementrules.apps.open-cluster-management.io

1.7.3. 定義

1.7.3.1. Placementrule

Name (名前)スキーマ

apiVersion
必須

文字列

kind
必須

文字列

metadata
必須

オブジェクト

spec
必須

spec

spec

Name (名前)スキーマ

clusterConditions
任意

< clusterConditions > 配列

clusterReplicas
任意

整数

clusterSelector
任意

clusterSelector

clusters
任意

<clusters > 配列

policies
任意

<policies > 配列

resourceHint
任意

resourceHint

schedulerName
任意

文字列

clusterConditions

Name (名前)スキーマ

status
任意

文字列

type
任意

文字列

clusterSelector

Name (名前)スキーマ

matchExpressions
任意

< matchExpressions > 配列

matchLabels
任意

< 文字列、文字列 > マップ

matchExpressions

Name (名前)スキーマ

key
任意

文字列

operator
任意

文字列

values
任意

< 文字列 > 配列

clusters

Name (名前)スキーマ

name
任意

文字列

policies

Name (名前)スキーマ

apiVersion
任意

文字列

fieldPath
任意

文字列

kind
任意

文字列

name
任意

文字列

namespace
任意

文字列

resourceVersion
任意

文字列

uid
任意

文字列

resourceHint

Name (名前)スキーマ

order
任意

文字列

type
任意

文字列

1.8. Applications API

1.8.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes のApplicationリソースについて説明します。Applicationリソースには、create、query、delete、update の 4 つの要求を使用できます。

1.8.1.1. バージョン情報

バージョン: 2.3.0

1.8.1.2. お問い合わせ先

お問い合わせメール: apiteam@swagger.io

1.8.1.3. ライセンス情報

ライセンス: Apache 2.0
ライセンス URL: http://www.apache.org/licenses/LICENSE-2.0.html
利用規約: http://swagger.io/terms/

1.8.1.4. URI スキーム

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

1.8.1.5. タグ

  • applications.app.k8s.io: アプリケーションを作成して管理します。

1.8.1.6. 外部ドキュメント

説明: Swagger に関する詳細は次を確認してください。
URL: http://swagger.io

1.8.2. パス

1.8.2.1. アプリケーションの作成

POST /app.k8s.io/v1beta1/namespaces/{namespace}/applications
1.8.2.1.1. 説明

アプリケーションを作成します。

1.8.2.1.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

ボディー

body
必須

作成するアプリケーションを記述するパラメーター。

Application

1.8.2.1.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.8.2.1.4. 消費
  • application/yaml
1.8.2.1.5. タグ
  • applications.app.k8s.io
1.8.2.1.6. HTTP 要求の例
1.8.2.1.6.1. 要求ボディー
{
  "apiVersion" : "app.k8s.io/v1beta1",
  "kind" : "Application",
  "metadata" : {
    "labels" : {
      "app" : "nginx-app-details"
    },
    "name" : "nginx-app-3",
    "namespace" : "ns-sub-1"
  },
  "spec" : {
    "componentKinds" : [ {
      "group" : "apps.open-cluster-management.io",
      "kind" : "Subscription"
    } ]
  },
  "selector" : {
    "matchLabels" : {
      "app" : "nginx-app-details"
    }
  },
  "status" : { }
}

1.8.2.2. 全アプリケーションのクエリー

GET /app.k8s.io/v1beta1/namespaces/{namespace}/applications
1.8.2.2.1. 説明

アプリケーションにクエリーを行い、詳細を確認します。

1.8.2.2.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.8.2.2.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.8.2.2.4. 消費
  • application/yaml
1.8.2.2.5. タグ
  • applications.app.k8s.io

1.8.2.3. 単一アプリケーションのクエリー

GET /app.k8s.io/v1beta1/namespaces/{namespace}/applications/{application_name}
1.8.2.3.1. 説明

1 つのアプリケーションに対してクエリーを行い、詳細を確認します。

1.8.2.3.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

application_name
必須

問い合わせるアプリケーションの名前。

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.8.2.3.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.8.2.3.4. タグ
  • applications.app.k8s.io

1.8.2.4. アプリケーションの削除

DELETE /app.k8s.io/v1beta1/namespaces/{namespace}/applications/{application_name}
1.8.2.4.1. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

application_name
必須

削除するアプリケーションの名前。

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.8.2.4.2. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.8.2.4.3. タグ
  • applications.app.k8s.io

1.8.3. 定義

1.8.3.1. Application

Name (名前)スキーマ

apiVersion
必須

文字列

kind
必須

文字列

metadata
必須

オブジェクト

spec
必須

spec

spec

Name (名前)スキーマ

assemblyPhase
任意

文字列

componentKinds
任意

< オブジェクト > 配列

descriptor
任意

descriptor

info
任意

<info > 配列

selector
任意

オブジェクト

descriptor

Name (名前)スキーマ

description
任意

文字列

icons
任意

<icons > 配列

keywords
任意

< 文字列 > 配列

links
任意

<links > 配列

maintainers
任意

<maintainers > 配列

notes
任意

文字列

owners
任意

<owners > 配列

type
任意

文字列

version
任意

文字列

icons

Name (名前)スキーマ

size
任意

文字列

src
必須

文字列

type
任意

文字列

Name (名前)スキーマ

description
任意

文字列

url
任意

文字列

maintainers

Name (名前)スキーマ

email
任意

文字列

name
任意

文字列

url
任意

文字列

owners

Name (名前)スキーマ

email
任意

文字列

name
任意

文字列

url
任意

文字列

info

Name (名前)スキーマ

name
任意

文字列

type
任意

文字列

value
任意

文字列

valueFrom
任意

valueFrom

valueFrom

Name (名前)スキーマ

configMapKeyRef
任意

configMapKeyRef

ingressRef
任意

ingressRef

secretKeyRef
任意

secretKeyRef

serviceRef
任意

serviceRef

type
任意

文字列

configMapKeyRef

Name (名前)スキーマ

apiVersion
任意

文字列

fieldPath
任意

文字列

key
任意

文字列

kind
任意

文字列

name
任意

文字列

namespace
任意

文字列

resourceVersion
任意

文字列

uid
任意

文字列

ingressRef

Name (名前)スキーマ

apiVersion
任意

文字列

fieldPath
任意

文字列

host
任意

文字列

kind
任意

文字列

name
任意

文字列

namespace
任意

文字列

path
任意

文字列

resourceVersion
任意

文字列

uid
任意

文字列

secretKeyRef

Name (名前)スキーマ

apiVersion
任意

文字列

fieldPath
任意

文字列

key
任意

文字列

kind
任意

文字列

name
任意

文字列

namespace
任意

文字列

resourceVersion
任意

文字列

uid
任意

文字列

serviceRef

Name (名前)スキーマ

apiVersion
任意

文字列

fieldPath
任意

文字列

kind
任意

文字列

name
任意

文字列

namespace
任意

文字列

path
任意

文字列

port
任意

整数 (int32)

resourceVersion
任意

文字列

uid
任意

文字列

1.9. Helm API

1.9.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes の HelmRelease リソースについて説明します。HelmRelease リソースには、create、query、delete、update の 4 つの要求を使用できます。

1.9.1.1. バージョン情報

バージョン: 2.3.0

1.9.1.2. お問い合わせ先

お問い合わせメール: apiteam@swagger.io

1.9.1.3. ライセンス情報

ライセンス: Apache 2.0
ライセンス URL: http://www.apache.org/licenses/LICENSE-2.0.html
利用規約: http://swagger.io/terms/

1.9.1.4. URI スキーム

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

1.9.1.5. タグ

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

1.9.1.6. 外部ドキュメント

説明: Swagger に関する詳細は次を確認してください。
URL: http://swagger.io

1.9.2. パス

1.9.2.1. helmrelease の作成

POST /apps.open-cluster-management.io/v1/namespaces/{namespace}/helmreleases
1.9.2.1.1. 説明

helmrelease を作成します。

1.9.2.1.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

ボディー

body
必須

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

HelmRelease

1.9.2.1.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.9.2.1.4. 消費
  • application/yaml
1.9.2.1.5. タグ
  • helmreleases.apps.open-cluster-management.io
1.9.2.1.6. HTTP 要求の例
1.9.2.1.6.1. 要求ボディー
{
  "apiVersion" : "apps.open-cluster-management.io/v1",
  "kind" : "HelmRelease",
  "metadata" : {
    "name" : "nginx-ingress",
    "namespace" : "default"
  },
  "repo" : {
    "chartName" : "nginx-ingress",
    "source" : {
      "helmRepo" : {
        "urls" : [ "https://kubernetes-charts.storage.googleapis.com/nginx-ingress-1.26.0.tgz" ]
      },
      "type" : "helmrepo"
    },
    "version" : "1.26.0"
  },
  "spec" : {
    "defaultBackend" : {
      "replicaCount" : 3
    }
  }
}

1.9.2.2. 全 helmrelease のクエリー

GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/helmreleases
1.9.2.2.1. 説明

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

1.9.2.2.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.9.2.2.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.9.2.2.4. 消費
  • application/yaml
1.9.2.2.5. タグ
  • helmreleases.apps.open-cluster-management.io

1.9.2.3. 単一の helmrelease のクエリー

GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/helmreleases/{helmrelease_name}
1.9.2.3.1. 説明

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

1.9.2.3.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

helmrelease_name
必須

問い合わせる helmrelease の名前。

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.9.2.3.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.9.2.3.4. タグ
  • helmreleases.apps.open-cluster-management.io

1.9.2.4. helmrelease の削除

DELETE /apps.open-cluster-management.io/v1/namespaces/{namespace}/helmreleases/{helmrelease_name}
1.9.2.4.1. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

helmrelease_name
必須

削除する helmrelease の名前。

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.9.2.4.2. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.9.2.4.3. タグ
  • helmreleases.apps.open-cluster-management.io

1.9.3. 定義

1.9.3.1. HelmRelease

Name (名前)スキーマ

apiVersion
必須

文字列

kind
必須

文字列

metadata
必須

オブジェクト

repo
必須

repo

spec
必須

オブジェクト

status
必須

status

repo

Name (名前)スキーマ

chartName
任意

文字列

configMapRef
任意

configMapRef

secretRef
任意

secretRef

source
任意

source

version
任意

文字列

configMapRef

Name (名前)スキーマ

apiVersion
任意

文字列

fieldPath
任意

文字列

kind
任意

文字列

name
任意

文字列

namespace
任意

文字列

resourceVersion
任意

文字列

uid
任意

文字列

secretRef

Name (名前)スキーマ

apiVersion
任意

文字列

fieldPath
任意

文字列

kind
任意

文字列

name
任意

文字列

namespace
任意

文字列

resourceVersion
任意

文字列

uid
任意

文字列

source

Name (名前)スキーマ

github
任意

github

helmRepo
任意

helmRepo

type
任意

文字列

github

Name (名前)スキーマ

branch
任意

文字列

chartPath
任意

文字列

urls
任意

< 文字列 > 配列

helmRepo

Name (名前)スキーマ

urls
任意

< 文字列 > 配列

status

Name (名前)スキーマ

conditions
必須

<conditions > 配列

deployedRelease
任意

deployedRelease

conditions

Name (名前)スキーマ

lastTransitionTime
任意

文字列 (date-time)

message
任意

文字列

reason
任意

文字列

status
必須

文字列

type
必須

文字列

deployedRelease

Name (名前)スキーマ

manifest
任意

文字列

name
任意

文字列

1.10. Policy API

1.10.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes のPolicyリソースについて説明します。Policyリソースには、create、query、delete、update の 4 つの要求を使用できます。

1.10.1.1. バージョン情報

バージョン: 2.3.0

1.10.1.2. お問い合わせ先

お問い合わせメール: apiteam@swagger.io

1.10.1.3. ライセンス情報

ライセンス: Apache 2.0
ライセンス URL: http://www.apache.org/licenses/LICENSE-2.0.html
利用規約: http://swagger.io/terms/

1.10.1.4. URI スキーム

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

1.10.1.5. タグ

  • policy.open-cluster-management.io/v1: ポリシーを作成して管理します。

1.10.1.6. 外部ドキュメント

説明: Swagger に関する詳細は次を確認してください。
URL: http://swagger.io

1.10.2. パス

1.10.2.1. ポリシーの作成

POST /policy.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}
1.10.2.1.1. 説明

ポリシーを作成します。

1.10.2.1.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

ボディー

body
必須

作成するポリシーを記述するパラメーター

Application

1.10.2.1.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.10.2.1.4. 消費
  • application/json
1.10.2.1.5. タグ
  • policy.open-cluster-management.io
1.10.2.1.6. HTTP 要求の例
1.10.2.1.6.1. 要求ボディー
{
  "apiVersion": "policy.open-cluster-management.io/v1",
  "kind": "Policy",
  "metadata": {
    "name": "test-policy-swagger",
    "description": "Example body for Policy API Swagger docs"
  },
  "spec": {
    "remediationAction": "enforce",
    "namespaces": {
      "include": [
        "default"
      ],
      "exclude": [
        "kube*"
      ]
    },
    "policy-templates": {
    "kind": "ConfigurationPolicy",
    "apiVersion": "policy.open-cluster-management.io/v1",
    "complianceType": "musthave",
    "metadata": {
      "namespace": null,
      "name": "test-role"
    },
    "selector": {
      "matchLabels": {
        "cloud": "IBM"
      }
    },
    "spec" : {
      "object-templates": {
        "complianceType": "mustHave",
        "objectDefinition": {
          "apiVersion": "rbac.authorization.k8s.io/v1",
          "kind": "Role",
          "metadata": {
            "name": "role-policy",
          },
          "rules": [
            {
              "apiGroups": [
                "extensions",
                "apps"
              ],
              "resources": [
                "deployments"
              ],
              "verbs": [
                "get",
                "list",
                "watch",
                "delete"
              ]
            },
            {
              "apiGroups": [
                "core"
              ],
              "resources": [
                "pods"
              ],
              "verbs": [
                "create",
                "update",
                "patch"
              ]
            },
            {
              "apiGroups": [
                "core"
              ],
              "resources": [
                "secrets"
              ],
              "verbs": [
                "get",
                "watch",
                "list",
                "create",
                "delete",
                "update",
                "patchß"
              ],
            },
          ],
        },
      },
    },
  },

1.10.2.2. 全ポリシーのクエリー

GET /policy.open-cluster-management.io/v1/namespaces/{namespace}/policies/{policy_name}
1.10.2.2.1. 説明

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

1.10.2.2.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

ポリシーを適用する namespace (例: default)

文字列

1.10.2.2.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.10.2.2.4. 消費
  • application/json
1.10.2.2.5. タグ
  • policy.open-cluster-management.io

1.10.2.3. 単一ポリシーのクエリー

GET /policy.open-cluster-management.io/v1/namespaces/{namespace}/policies/{policy_name}
1.10.2.3.1. 説明

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

1.10.2.3.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

policy_name
必須

問い合わせるポリシーの名前。

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.10.2.3.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.10.2.3.4. タグ
  • policy.open-cluster-management.io

1.10.2.4. ポリシーの削除

DELETE /policy.open-cluster-management.io/v1/namespaces/{namespace}/policies/{policy_name}
1.10.2.4.1. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

policy_name
必須

削除するポリシーの名前。

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.10.2.4.2. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.10.2.4.3. タグ
  • policy.open-cluster-management.io

1.10.3. 定義

1.10.3.1. Policy

Name (名前)説明スキーマ

apiVersion
必須

Policyのバージョンスキーマ。

文字列

kind
必須

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

文字列

metadata
必須

ポリシーを定義するルールを記述します。

オブジェクト

spec

Name (名前)説明スキーマ

remediationAction
任意

リソースで定義されているように違反をどのように処理するかを表す値。

文字列

namespaceSelector
必須

ポリシーが適用される namespace を表す値。

文字列

policy-templates

Name (名前)説明スキーマ

apiVersion
必須

Policyのバージョンスキーマ。

文字列

kind
任意

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

文字列

metadata
必須

ポリシーを定義するルールを記述します。

オブジェクト

complianceType

マネージドクラスターに評価または適用する必要のあるロールおよび他の Kubernetes オブジェクトの予想される動作を一覧表示するために使用されます。

文字列

clusterConditions
任意

ラベルを定義するセクション。

文字列

rules
任意

 

文字列

clusterConditions

Name (名前)説明スキーマ

matchLabels
任意

ポリシーを namespace に適用するのに必要なラベル。

オブジェクト

cloud
任意

ポリシーをクラウドプロバイダーに適用するのに必要なラベル。

文字列

rules

Name (名前)説明スキーマ

apiGroups
必須

このルールが適用される API の一覧。

文字列

resources
必須

リソースタイプの一覧。

オブジェクト

verbs
必須

動詞の一覧。

文字列

1.11. Observability API

1.11.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes の MultiClusterObservability リソースについて説明します。MultiClusterObservability リソースには、create、query、delete、update の 4 つの要求を使用できます。

1.11.1.1. バージョン情報

バージョン: 2.3.0

1.11.1.2. お問い合わせ先

お問い合わせメール: apiteam@swagger.io

1.11.1.3. ライセンス情報

ライセンス: Apache 2.0
ライセンス URL: http://www.apache.org/licenses/LICENSE-2.0.html
利用規約: http://swagger.io/terms/

1.11.1.4. URI スキーム

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

1.11.1.5. タグ

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

1.11.1.6. 外部ドキュメント

説明: Swagger に関する詳細は次を確認してください。
URL: http://swagger.io

1.11.2. パス

1.11.2.1. multiclusterobservability リソースの作成

POST /apis/observability.open-cluster-management.io/v1beta2/multiclusterobservabilities
1.11.2.1.1. 説明

MultiClusterObservability リソースを作成します。

1.11.2.1.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

ボディー

body
必須

作成する MultiClusterObservability リソースを記述するパラメーター

MultiClusterObservability

1.11.2.1.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.11.2.1.4. 消費
  • application/yaml
1.11.2.1.5. タグ
  • observability.apps.open-cluster-management.io
1.11.2.1.6. HTTP 要求の例
1.11.2.1.6.1. 要求ボディー
{
  "apiVersion": "observability.open-cluster-management.io/v1beta2",
  "kind": "MultiClusterObservability",
  "metadata": {
    "name": "example"
  },
  "spec": {
    "observabilityAddonSpec": {}
    "storageConfig": {
      "metricObjectStorage": {
        "name": "thanos-object-storage",
        "key": "thanos.yaml"
       }
   }
}

1.11.2.2. すべての multiclusterobservability のクエリー

GET /apis/observability.open-cluster-management.io/v1beta2/multiclusterobservabilities
1.11.2.2.1. 説明

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

1.11.2.2.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

1.11.2.2.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.11.2.2.4. 消費
  • application/yaml
1.11.2.2.5. タグ
  • observability.apps.open-cluster-management.io

1.11.2.3. 単一の multiclusterobservability のクエリー

GET /apis/observability.open-cluster-management.io/v1beta2/multiclusterobservabilities/{multiclusterobservability_name}
1.11.2.3.1. 説明

単一の MultiClusterObservability リソースに対してクエリーを実行して詳細を確認します。

1.11.2.3.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

multiclusterobservability_name
必須

問い合わせる multiclusterobservability の名前

文字列

1.11.2.3.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.11.2.3.4. タグ
  • observability.apps.open-cluster-management.io

1.11.2.4. multiclusterobservability リソースの削除

DELETE /apis/observability.open-cluster-management.io/v1beta2/multiclusterobservabilities/{multiclusterobservability_name}
1.11.2.4.1. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

multiclusterobservability_name
必須

削除する multiclusterobservability の名前

文字列

1.11.2.4.2. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.11.2.4.3. タグ
  • observability.apps.open-cluster-management.io

1.11.3. 定義

1.11.3.1. MultiClusterObservability

Name (名前)説明スキーマ

apiVersion
必須

MultiClusterObservability のバージョンスキーマ。

文字列

kind
必須

REST リソース (MultiClusterObservability) を表す文字列の値。

文字列

metadata
必須

ポリシーを定義するルールを記述します。

オブジェクト

spec

Name (名前)説明スキーマ

enableDownSampling
任意

downsample を有効または無効にします。デフォルト値は true です。downsample データがない場合は、クエリーを利用できません。

ブール値

imagePullPolicy
任意

MultiClusterObservability イメージのプルポリシー。デフォルト値は Always です。

corev1.PullPolicy

imagePullSecret
任意

MultiClusterObservability イメージのプルシークレット。デフォルト値は multiclusterhub-operator-pull-secretです。

文字列

nodeSelector
任意

ノードセレクターの仕様。

map[string]string

observabilityAddonSpec
必須

可観測性アドオンがインストール済みの全マネージドクラスターのグローバル設定。

observabilityAddonSpec

storageConfig
必須

可観測性が使用するストレージ設定を指定します。

StorageConfig

tolerations
任意

すべてのコンポーネントがテイントを容認する機能を提供します。

[]corev1.Toleration

advanced
任意

可観測性の詳細設定。

advanced

resources
任意

MultiClusterObservability で必要なコンピュートリソース。

corev1.ResourceRequirements

replicas
任意

MultiClusterObservability のレプリカ。

整数

storageConfig

Name (名前)説明スキーマ

alertmanagerStorageSize
任意

alertmanager ステートフルセットに適用されるストレージの量。デフォルト値は 1Gi です。

文字列

compactStorageSize
任意

thanos のコンパクトなステートフルセットに適用されるストレージの量。デフォルト値は 100Gi です。

文字列

metricObjectStorage
必須

メトリクスのシークレットを設定するオブジェクトストア。

metricObjectStorage

receiveStorageSize
任意

thanos 受信ステートフルセットに適用されるストレージの量。デフォルト値は 100Gi です。

文字列

ruleStorageSize
任意

thanos ルールのステートフルセットに適用されるストレージの量。デフォルト値は 1Gi です。

文字列

storageClass
任意

storageClass ステートフルセットを指定します。このストレージは、オペレーティングシステムでストレージを作成するように metricObjectStorage が設定されている場合に、オブジェクトストレージに使用します。デフォルト値は gp2 です。

文字列

storeStorageSize
任意

thanos ストアステートフルセットに適用されるストレージの量。デフォルト値は 10Gi です。

文字列

metricObjectStorage

Name (名前)説明スキーマ

key
必須

選択するシークレットのキー。有効な秘密鍵でなければなりません。Thanos のドキュメント を参照してください。

文字列

name
必須

metricObjectStorage の名前。詳細は、「Kubernetes Names」を参照してください。

文字列

observabilityAddonSpec

Name (名前)説明スキーマ

enableMetrics
任意

可観測性アドオンがメトリクスをハブクラスターに送信するかどうかを指定します。デフォルト値は true です。

ブール値

interval
任意

可観測性アドオンがメトリクスをハブクラスターに送信する間隔。デフォルト値は 60 秒(60s)です。

整数

resources
任意

メトリクスコレクターリソース要件のリソースデフォルトの CPU 要求は 100m で、メモリー要求は 100Mi です。

corev1.ResourceRequirements

advanced

Name (名前)説明スキーマ

retentionConfig
任意

可観測性によって使用されるデータ保持設定を指定します。

RetentionConfig

rbacQueryProxy
任意

rbac-query-proxy デプロイメントのレプリカおよびリソースを指定します。

CommonSpec

grafana
任意

grafana デプロイメントのレプリカおよびリソースを指定します。

CommonSpec

alertmanager
任意

alertmanager ステートフルセットのレプリカおよびリソースを指定します。

CommonSpec

observatoriumAPI
任意

observatorium-api デプロイメントのレプリカおよびリソースを指定します。

CommonSpec

queryFrontend
任意

query-frontend デプロイメントのレプリカおよびリソースを指定します。

CommonSpec

query
任意

クエリーデプロイメントのレプリカおよびリソースを指定します。

CommonSpec

receive
任意

受信ステートフルセットのレプリカおよびリソースを指定します。

CommonSpec

rule
任意

ルールのステートフルセットのレプリカおよびリソースを指定します。

CommonSpec

store
任意

ストアステートフルセットのレプリカおよびリソースを指定します。

CommonSpec

compact
任意

コンパクトなステートフルセットのリソースを指定します。

compact

storeMemcached
任意

store-memcached のレプリカ、リソースなどを指定します。

storeMemcached

queryFrontendMemcached
任意

query-frontend-memcached のレプリカ、リソースなどを指定します。

CacheConfig

retentionConfig

Name (名前)説明スキーマ

blockDuration
任意

時系列データベース (TSDB) ブロックを停止する時間。デフォルト値は 2h です。

文字列

cleanupInterval
任意

部分的にアップロードされたブロックが消去される頻度および、--wait が有効な削除マークの付いたブロックが消去される頻度。デフォルト値は 5m です。

文字列

deleteDelay
任意

削除対象のブロックがバケットから削除されるまでの期間。デフォルト値は 48h です。

文字列

retentionInLocal
任意

ローカルストレージからの未加工のサンプルを保持する時間。デフォルト値は 24h です。

文字列

retentionResolutionRaw
任意

バスケットで未加工の解像度サンプルを保持する時間。デフォルト値は 30 日 (30d) です。

文字列

retentionResolution5m
任意

バスケットに解像度 1 (5 分) のサンプルを保持する時間。デフォルト値は 180 日 (180d) です。

文字列

retentionResolution1h
任意

バスケットに解像度 2 (1 時間) のサンプルを保持する時間。デフォルト値は 0 日 (0d) です。

文字列

compact

Name (名前)説明スキーマ

resources
任意

MultiCLusterObservability で必要なコンピュートリソース

corev1.ResourceRequirements

storeMemcached

Name (名前)説明スキーマ

resources
任意

MultiCLusterObservability で必要なコンピュートリソース

corev1.ResourceRequirements

replicas
任意

MultiClusterObservability のレプリカ。

整数

memoryLimitMb
任意

メガバイト単位の Memcached のメモリー制限。

整数

maxItemSize
任意

Memcached の最大項目サイズ。デフォルト値は 1m, min:1k, max:1024m です。

文字列

connectionLimit
任意

Memcached の同時接続の最大数。デフォルト値:

整数

status

Name (名前)説明スキーマ

status
任意

ステータスには、MultiClusterObservability のさまざまな条件のステータスが含まれます。

metav1.Condition

1.12. Search customization API

1.12.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes の searchCustomization リソースについて説明します。SearchCustomization リソースには、create、query、delete、update の 4 つの要求を使用できます。

1.12.1.1. バージョン情報

バージョン: 2.3.0

1.12.1.2. お問い合わせ先

お問い合わせメール: apiteam@swagger.io

1.12.1.3. ライセンス情報

ライセンス: Apache 2.0
ライセンス URL: http://www.apache.org/licenses/LICENSE-2.0.html
利用規約: http://swagger.io/terms/

1.12.1.4. URI スキーム

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

1.12.1.5. タグ

  • search.open-cluster-management.io/v1: 永続ボリュームを作成して管理します。

1.12.1.6. 外部ドキュメント

説明: Swagger に関する詳細は次を確認してください。
URL: http://swagger.io

1.12.2. パス

1.12.2.1. searchCustomization の作成

POST /search.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}
1.12.2.1.1. 説明

searchCustomization を作成します。

1.12.2.1.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

ボディー

body
必須

作成するポリシーを記述するパラメーター

 
1.12.2.1.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.12.2.1.4. 消費
  • searchCustomization/json
1.12.2.1.5. タグ
  • search.open-cluster-management.io
1.12.2.1.6. HTTP 要求の例
1.12.2.1.6.1. 要求ボディー
{
  "apiVersion": "search.open-cluster-management.io/v1",
  "kind": "SearchCustomization",
  "metadata": {
    "name": "test-search-swagger",
    "description": "Example body for SearchCustomization API Swagger docs"
  },
  "spec": {
    "remediationAction": "enforce",
    "namespaces": {
      "include": [
        "default"
      ],
      "exclude": [
        "kube*"
      ]
    },
    "policy-templates": {
    "kind": "ConfigurationPolicy",
    "apiVersion": "search.open-cluster-management.io/v1alpha1",
    "complianceType": "musthave",
    "metadata": {
      "namespace": null,
      "name": "test-role"
    },
    "selector": {
      "matchLabels": {
        "cloud": "IBM"
      }
    },
    "spec" : {
      "object-templates": {
        "complianceType": "mustHave",
        "objectDefinition": {
          "apiVersion": "rbac.authorization.k8s.io/v1",
          "kind": "Role",
          "metadata": {
            "name": "role-policy",
          },
          "rules": [
            {
              "apiGroups": [
                "extensions",
                "apps"
              ],
              "resources": [
                "deployments"
              ],
              "verbs": [
                "get",
                "list",
                "watch",
                "delete"
              ]
            },
            {
              "apiGroups": [
                "core"
              ],
              "resources": [
                "pods"
              ],
              "verbs": [
                "create",
                "update",
                "patch"
              ]
            },
            {
              "apiGroups": [
                "core"
              ],
              "resources": [
                "secrets"
              ],
              "verbs": [
                "get",
                "watch",
                "list",
                "create",
                "delete",
                "update",
                "patchß"
              ],
            },
          ],
        },
      },
    },
  },

1.12.2.2. searchCustomization のクエリー

GET /search.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}
1.12.2.2.1. 説明

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

1.12.2.2.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

ポリシーを適用する namespace (例: default)

文字列

1.12.2.2.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.12.2.2.4. 消費
  • searchCustomization/json
1.12.2.2.5. タグ
  • search.open-cluster-management.io

1.12.2.3. 単一ポリシーのクエリー

GET /search.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}
1.12.2.3.1. 説明

単一の searchCustomization に対してクエリーを実行して詳細を確認します。

1.12.2.3.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

policy_name
必須

問い合わせるポリシーの名前。

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.12.2.3.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.12.2.3.4. タグ
  • search.open-cluster-management.io

1.12.2.4. searchCustomization の削除

DELETE /search.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}
1.12.2.4.1. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

policy_name
必須

削除するポリシーの名前。

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.12.2.4.2. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.12.2.4.3. タグ
  • search.open-cluster-management.io

1.12.3. 定義

1.12.3.1. SearchCustomization

Name (名前)説明スキーマ

apiVersion
必須

SearchCustomization のバージョンスキーマ。

文字列

kind
必須

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

文字列

metadata
必須

ポリシーを定義するルールを記述します。

オブジェクト

spec

Name (名前)説明スキーマ

remediationAction
任意

リソースで定義されているように違反をどのように処理するかを表す値。

文字列

namespaces
必須

ポリシーが適用される際に、include または exclude する namespace を表す値。

文字列

policy-templates

Name (名前)説明スキーマ

apiVersion
必須

SearchCustomization のバージョンスキーマ。

文字列

kind
任意

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

文字列

metadata
必須

ポリシーを定義するルールを記述します。

オブジェクト

complianceType

マネージドクラスターに評価または適用する必要のあるロールおよび他の Kubernetes オブジェクトの予想される動作を一覧表示するために使用されます。

文字列

clusterConditions
任意

ラベルを定義するセクション。

文字列

rules
任意

 

文字列

clusterConditions

Name (名前)説明スキーマ

matchLabels
任意

ポリシーを namespace に適用するのに必要なラベル。

オブジェクト

cloud
任意

ポリシーをクラウドプロバイダーに適用するのに必要なラベル。

文字列

rules

Name (名前)説明スキーマ

apiGroups
必須

このルールが適用される API の一覧。

文字列

resources
必須

リソースタイプの一覧。

オブジェクト

verbs
必須

動詞の一覧。

文字列

1.13. MultiClusterHub API

1.13.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes の MultiClusterHub リソースについて説明します。MultiClusterHub リソースには、create、query、delete、update の 4 つの要求を使用できます。

1.13.1.1. バージョン情報

バージョン: 2.3.0

1.13.1.2. お問い合わせ先

お問い合わせメール: apiteam@swagger.io

1.13.1.3. ライセンス情報

ライセンス: Apache 2.0
ライセンス URL: http://www.apache.org/licenses/LICENSE-2.0.html
利用規約: http://swagger.io/terms/

1.13.1.4. URI スキーム

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

1.13.1.5. タグ

  • multiclusterhubs.operator.open-cluster-management.io: マルチクラスターハブ演算子を作成して管理します。

1.13.1.6. 外部ドキュメント

説明: Swagger に関する詳細は次を確認してください。
URL: http://swagger.io

1.13.2. パス

1.13.2.1. MultiClusterHub リソースの作成

POST /operator.open-cluster-management.io/v1beta1/namespaces/{namespace}/mch
1.13.2.1.1. 説明

MultiClusterHub リソースを作成し、multicluster hub のインスタンスの設定を定義します。

1.13.2.1.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

ボディー

body
必須

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

定義

1.13.2.1.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.13.2.1.4. 消費
  • multiclusterhubs/yaml
1.13.2.1.5. タグ
  • multiclusterhubs.operator.open-cluster-management.io
1.13.2.1.6. HTTP 要求の例
1.13.2.1.6.1. 要求ボディー
{
  "apiVersion": "apiextensions.k8s.io/v1",
  "kind": "CustomResourceDefinition",
  "metadata": {
    "name": "multiclusterhubs.operator.open-cluster-management.io"
    },
  "spec": {
    "group": "operator.open-cluster-management.io",
    "names": {
      "kind": "MultiClusterHub",
      "listKind": "MultiClusterHubList",
      "plural": "multiclusterhubs",
      "shortNames": [
          "mch"
	  ],
     "singular": "multiclusterhub"
     },
    "scope": "Namespaced",
    "versions": [
        {
	    "additionalPrinterColumns": [
                {
		   "description": "The overall status of the multicluster hub.",
                   "jsonPath": ".status.phase",
                   "name": "Status",
                   "type": "string"
		   },
               {
	           "jsonPath": ".metadata.creationTimestamp",
                   "name": "Age",
                   "type": "date"
		   }
            ],
            "name": "v1",
            "schema": {
                "openAPIV3Schema": {
                    "description": "MultiClusterHub defines the configuration for an instance of
          the multiCluster hub.",
        "properties": {
            "apiVersion": {
                "description": "APIVersion defines the versioned schema of this representation
              of an object. Servers should convert recognized schemas to the latest
              internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
                "type": "string"
            },
            "kind": {
                "description": "Kind is a string value representing the REST resource this
              object represents. Servers may infer this from the endpoint the client
              submits requests to. Cannot be updated. The value is in CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
                "type": "string"
            },
            "metadata": {
                "type": "object"
            },
            "spec": {
                "description": "MultiClusterHubSpec defines the desired state of MultiClusterHub.",
                "properties": {
                    "availabilityConfig": {
                        "description": "Specifies deployment replication for improved availability.
                  Options are: Basic and High (default).",
                        "type": "string"
                },
                "customCAConfigmap": {
                    "description": "Provide the customized OpenShift default ingress CA certificate
                  to {product-title-short}.",
                  }
                    "type": "string"
                },
        "disableHubSelfManagement": {
                    "description": "Disable automatic import of the hub cluster as a managed
                  cluster.",
                    "type": "boolean"
                },
        "disableUpdateClusterImageSets": {
                    "description": "Disable automatic update of ClusterImageSets.",
                    "type": "boolean"
                },
                "hive": {
                    "description": "(Deprecated) Overrides for the default HiveConfig specification.",
                    "properties": {
        "additionalCertificateAuthorities": {
        "description": "(Deprecated) AdditionalCertificateAuthorities is
                      a list of references to secrets in the 'hive' namespace that
                      contain an additional Certificate Authority to use when communicating
                      with target clusters. These certificate authorities are
                      used in addition to any self-signed CA generated by each cluster
                      on installation.",
                           "items": {
                    "description": "LocalObjectReference contains the information
                        to let you locate the referenced object inside the same namespace.",
                    "properties": {
                    "name": {
                        "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names",
                        "type": "string"
                     }
		             },
                    "type": "object"
                      },
                           "type": "array"
                    },
                       "backup": {
                    "description": "(Deprecated) Backup specifies configuration for backup
                      integration. If absent, backup integration is disabled.",
                    "properties": {
                    "minBackupPeriodSeconds": {
                    "description": "(Deprecated) MinBackupPeriodSeconds specifies
                          that a minimum of MinBackupPeriodSeconds occurs in between
                          each backup. This is used to rate limit backups. This potentially
                          batches together multiple changes into one backup. No backups
                          are lost for changes that happen during the interval
                          that is queued up, and results in a backup once
                          the interval has been completed.",
                    "type": "integer"
                        },
                    "velero": {
                    "description": "(Deprecated) Velero specifies configuration for the Velero backup integration.",
		    "properties": {
			"enabled": {
			    "description": "(Deprecated) Enabled dictates if the Velero backup integration is enabled. If not specified, the default is disabled.",
			    "type": "boolean"
			}
		   },
		    "type": "object"
				        }
				  },
				        "type": "object"
				     },
		    "externalDNS": {
		    "description": "(Deprecated) ExternalDNS specifies configuration for external-dns if it is to be deployed by Hive. If absent, external-dns is not deployed.",
		    "properties": {
		    "aws": {
		    "description": "(Deprecated) AWS contains AWS-specific settings for external DNS.",
		    "properties": {
		        "credentials": {
			    "description": "(Deprecated) Credentials reference a secret that is used to authenticate with AWS Route53. It needs permission to manage entries in each of the managed domains for this cluster. Secret should have AWS keys named 'aws_access_key_id' and 'aws_secret_access_key'.",
			    "properties": {
				"name": {
																		            "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names",
																		                             "type": "string"
						    }
					},
			    "type": "object"
			}
		},
		   "type": "object"
					},
		   "gcp": {
		   "description": "(Deprecated) GCP contains Google Cloud Platform specific settings for external DNS.",
		   "properties": {
		       "credentials": {
			   "description": "(Deprecated) Credentials reference a secret that is used to authenticate with GCP DNS. It needs permission to manage entries in each of the managed domains for this cluster. Secret should have a key names 'osServiceAccount.json'. The credentials must specify the project to use.",
			   "properties": {
			       "name": {
		   "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names",
				   "type": "string"
							}
						},
			   "type": "object"
			}
		},
		"type": "object"
					}
				},
				      "type": "object"
					},
		"failedProvisionConfig": {
		"description": "(Deprecated) FailedProvisionConfig is used to configure settings related to handling provision failures.",
		"properties": {
		"skipGatherLogs": {
		"description": "(Deprecated) SkipGatherLogs disables functionality that attempts to gather full logs from the cluster if an installation fails for any reason. The logs are stored in a persistent volume for up to seven days.",
	        "type": "boolean"
				   }
				},
				  "type": "object"
				  },
		"globalPullSecret": {
		"description": "(Deprecated) GlobalPullSecret is used to specify a pull secret that is used globally by all of the cluster deployments. For each cluster deployment, the contents of GlobalPullSecret are merged with the specific pull secret for a cluster deployment(if specified), with precedence given to the contents of the pull secret for the cluster deployment.",
		"properties": {
		"name": {
		"description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names",
		"type": "string"
			                }
				},
				  "type": "object"
							},
		"maintenanceMode": {
	        "description": "(Deprecated) MaintenanceMode can be set to true to disable the Hive controllers in situations where you need to ensure nothing is running that adds or act upon finalizers on Hive types. This should rarely be needed. Sets replicas to zero for the 'hive-controllers' deployment to accomplish this.",
				  "type": "boolean"
							}
						},
			  "required": [
				         "failedProvisionConfig"
						     ],
			  "type": "object"
						 },
		"imagePullSecret": {
		    "description": "Override pull secret for accessing MultiClusterHub operand and endpoint images.",
		    "type": "string"
					},
		"ingress": {
		    "description": "Configuration options for ingress management.",
		    "properties": {
			"sslCiphers": {
	"description": "List of SSL ciphers enabled for management ingress. Defaults to full list of supported ciphers.",
			    "items": {
		    "type": "string"
					},
			    "type": "array"
						}
					},
			       "type": "object"
						},
			   "nodeSelector": {
		   "additionalProperties": {
				   "type": "string"
						},
			       "description": "Set the node selectors..",
			       "type": "object"
			},
			   "overrides": {
			       "description": "Developer overrides.",
			       "properties": {
		   "imagePullPolicy": {
		   "description": "Pull policy of the multicluster hub images.",
			               "type": "string"
							}
						},
			      "type": "object"
									},
		   "separateCertificateManagement": {
				     "description": "(Deprecated) Install cert-manager into its own namespace.",
				     "type": "boolean"
						    }
					   },
			   "type": "object"
		       },
		       "status": {
			 "description": "MulticlusterHubStatus defines the observed state of MultiClusterHub.",
			 "properties": {
			     "components": {
		      "additionalProperties": {
		      "description": "StatusCondition contains condition information.",
				      "properties": {
		      "lastTransitionTime": {
		      "description": "LastTransitionTime is the last time the condition changed from one status to another.",
		      "format": "date-time",
		      "type": "string"
					},
		      "message": {
		      "description": "Message is a human-readable message indicating\ndetails about the last status change.",
		      "type": "string"
						},
				          "reason": {
		      "description": "Reason is a (brief) reason for the last status change of the condition.",
		      "type": "string"
						},
					  "status": {
		      "description": "Status is the status of the condition. One of True, False, Unknown.",
		      "type": "string"
					},
					  "type": {
		      "description": "Type is the type of the cluster condition.",
		      "type": "string"
					}
				},
				     "type": "object"
						      },
				  "description": "Components []ComponentCondition `json:\"manifests,omitempty\"`",
				  "type": "object"
							},
			      "conditions": {
				  "description": "Conditions contain the different condition statuses for the MultiClusterHub.",
				  "items": {
		      "description": "StatusCondition contains condition information.",
				      "properties": {
		      "lastTransitionTime": {
		      "description": "LastTransitionTime is the last time the condition changed from one status to another.",
		      "format": "date-time",
		      "type": "string"
					},
		      "lastUpdateTime": {
		      "description": "The last time this condition was updated.",
		      "format": "date-time",
		      "type": "string"
					},
		      "message": {
		      "description": "Message is a human-readable message indicating details about the last status change.",
		      "type": "string"
						},
				          "reason": {
		      "description": "Reason is a (brief) reason for the last status change of the condition.",
		      "type": "string"
					},
					  "status": {
		      "description": "Status is the status of the condition. One of True, False, Unknown.",
		      "type": "string"
						},
					  "type": {
		      "description": "Type is the type of the cluster condition.",
		      "type": "string"
					}
				},
				     "type": "object"
						      },
				 "type": "array"
					},
			     "currentVersion": {
				 "description": "CurrentVersion indicates the current version..",
				 "type": "string"
						},
			     "desiredVersion": {
				 "description": "DesiredVersion indicates the desired version.",
				 "type": "string"
						 },
			     "phase": {
				 "description": "Represents the running phase of the MultiClusterHub",
				 "type": "string"
							}
						},
	                 "type": "object"
					   }
				   },
                "type": "object"
			        }
		         },
        "served": true,
        "storage": true,
        "subresources": {
	    "status": {}
	    }
	}
    ]
  }
}

1.13.2.2. 全 MultiClusterHubs のクエリー

GET /operator.open-cluster-management.io/v1beta1/namespaces/{namespace}/operator
1.13.2.2.1. 説明

multicluster hub 演算子に対してクエリーを実行して詳細を確認します。

1.13.2.2.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.13.2.2.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.13.2.2.4. 消費
  • operator/yaml
1.13.2.2.5. タグ
  • multiclusterhubs.operator.open-cluster-management.io

1.13.2.3. MultiClusterHub 演算子のクエリー

GET /operator.open-cluster-management.io/v1beta1/namespaces/{namespace}/operator/{multiclusterhub_name}
1.13.2.3.1. 説明

単一の multicluster hub 演算子に対してクエリーを実行して詳細を確認します。

1.13.2.3.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

application_name
必須

問い合わせるアプリケーションの名前。

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.13.2.3.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.13.2.3.4. タグ
  • multiclusterhubs.operator.open-cluster-management.io

1.13.2.4. MultiClusterHub 演算子の削除

DELETE /operator.open-cluster-management.io/v1beta1/namespaces/{namespace}/operator/{multiclusterhub_name}
1.13.2.4.1. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

application_name
必須

削除する multicluster hub 演算子の名前

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.13.2.4.2. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.13.2.4.3. タグ
  • multiclusterhubs.operator.open-cluster-management.io

1.13.3. 定義

1.13.3.1. Multicluster hub operator

Name (名前)説明スキーマ

apiVersion
必須

MultiClusterHub のバージョンスキーマ。

文字列

kind
必須

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

文字列

metadata
必須

リソースを定義するルールを記述します。

オブジェクト

spec
必須

リソース仕様。

spec

spec

availabilityConfig
任意
デプロイメントレプリケーションを指定して可用性を向上させます。デフォルト値は High です。文字列

customCAConfigmap
任意

カスタマイズされた OpenShift デフォルト Ingress CA 証明書を Red Hat Advanced Cluster Management に提供します。

文字列

disableHubSelfManagement
任意

マネージドクラスターとしてハブクラスターの自動インポートを無効にします。

ブール値

disableUpdateClusterImageSets
任意

ClusterImageSets の自動更新を無効にします。

ブール値

hive
任意

(非推奨) デフォルトの HiveConfig 仕様を上書きするオブジェクト。

hive

imagePullSecret
任意

MultiClusterHub オペランドおよびエンドポイントイメージにアクセスするためのプルシークレットを上書きします。

文字列

ingress
任意

Ingress 管理の設定オプション。

ingress

nodeSelector
任意

ノードセレクターを設定します。

文字列

separateCertificateManagement
任意

(非推奨) cert-manager を独自の namespace にインストールします。

ブール値

hive

additionalCertificateAuthorities
任意
(非推奨) ターゲットクラスターとの通信時に使用する追加の認証局が含まれる hive namespace のシークレットへの参照一覧。インストール時に各クラスターが生成する自己署名の CA に加え、この認証局が使用されます。オブジェクト

backup
任意

(非推奨) バックアップ統合の設定を指定します。存在しない場合、バックアップ統合は無効になります。

backup

externalDNS
任意

(非推奨) Hive でデプロイする場合は external-dns の設定を指定します。存在しない場合、external-dns はデプロイされません。

オブジェクト

failedProvisionConfig
必須

(非推奨) プロビジョニングの失敗の処理に関連する設定に使用します。

failedProvisionConfig

globalPullSecret
任意

(非推奨) 全クラスターデプロイメントがグローバルで使用するプルシークレットを指定するのに使用します。クラスターデプロイメントごとに、globalPullSecret の内容はクラスターデプロイメントの特定のプルシークレットにマージされます (指定されている場合)。これはクラスターデプロイメントのプルシークレットの内容よりも優先されます。

オブジェクト

maintenanceMode
任意

(非推奨) True に設定して、Hiver タイプのファイナライザーに対して追加したり、実行したりするような操作が行われないようにする必要がある場合など、Hive コントローラーを無効にできます。このような状況はほぼ発生しないはずです。hive-controllers デプロイメントの場合にはレプリカを 0 に設定してこれを実行します。

ブール値

ingress

sslCiphers
任意
管理 Ingress 向けに有効になっている SSL 暗号の一覧。デフォルトは、対応している暗号の全一覧です。文字列

backup

minBackupPeriodSeconds
任意
(非推奨) 次のバックアップが発生するまでの最小の MinBackupPeriodSeconds を指定します。これは、レート制限バックアップに使用します。これにより、1 つのバックアップに複数の変更がまとめられる可能性があります。この期間に加えられた変更がキューに格納され、この期間が終了したらバックアップが行われるので、バックアップは失われません。整数

velero
任意

(非推奨) Velero は Velero バックアップ統合の設定を指定します。

オブジェクト

failedProvisionConfig

skipGatherLogs
任意
(非推奨) インストールに失敗した場合に、クラスターから全ログの収集を試行する機能を無効にします。ログは最長 7 日間永続ボリュームに保存されます。ブール値

status

components
任意
ステータス設定のコンポーネント。オブジェクト

conditions
任意

multicluster hub のさまざまな条件が含まれます。

conditions

desiredVersion
任意

必要なバージョンを指定します。

文字列

phase
任意

MultiClusterHub リソースのアクティブなフェーズを表します。このパラメーターに使用される値は、PendingRunningInstallingUpdatingUninstallingです。

文字列

conditions

lastTransitionTime
任意
状態が別のステータスに最後に変わった時刻文字列

lastUpdateTime
任意

この状態が最後に更新された時刻。

文字列

message
必須

メッセージは人間が判読できるメッセージで、最後にステータスが変更されたときの情報を指定します。

文字列

reason
必須

状態のステータスが変更された理由の簡単な説明。

文字列

status
必須

状態のテータス。

文字列

type
必須

クラスターの状態のタイプ。

文字列

StatusConditions

kind
必須
このステータスを表すリソースの 種類文字列

available
必須

このコンポーネントが適切に実行されているかどうかを示します。

ブール値

lastTransitionTime
任意

状態が別のステータスに最後に変わった時刻

metav1.time

lastUpdateTime
任意

この状態が最後に更新された時刻。

metav1.time

message
必須

メッセージは人間が判読できるメッセージで、最後にステータスが変更されたときの情報を指定します。

文字列

reason
任意

状態のステータスが変更された理由の簡単な説明。

文字列

status
任意

状態のテータス。

文字列

type
任意

クラスターの状態のタイプ。

文字列

1.14. Placements API (v1alpha1)

1.14.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes の Placement リソースについて説明します。Placement リソースには、create、query、delete、update の 4 つの要求を使用できます。

1.14.1.1. バージョン情報

バージョン: 2.3.0

1.14.1.2. お問い合わせ先

お問い合わせメール: apiteam@swagger.io

1.14.1.3. ライセンス情報

ライセンス: Apache 2.0
ライセンス URL: http://www.apache.org/licenses/LICENSE-2.0.html
利用規約: http://swagger.io/terms/

1.14.1.4. URI スキーム

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

1.14.1.5. タグ

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

1.14.1.6. 外部ドキュメント

説明: Swagger に関する詳細は次を確認してください。
URL: http://swagger.io

1.14.2. パス

1.14.2.1. 全 Placement のクエリー

GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placements
1.14.2.1.1. 説明

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

1.14.2.1.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

1.14.2.1.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.14.2.1.4. 消費
  • placement/yaml
1.14.2.1.5. タグ
  • cluster.open-cluster-management.io

1.14.2.2. Placement の作成

POST /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placements
1.14.2.2.1. 説明

Placement を作成します。

1.14.2.2.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

ボディー

body
必須

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

Placement

1.14.2.2.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.14.2.2.4. 消費
  • placement/yaml
1.14.2.2.5. タグ
  • cluster.open-cluster-management.io
1.14.2.2.6. HTTP 要求の例
1.14.2.2.6.1. 要求ボディー
{
  "apiVersion" : "cluster.open-cluster-management.io/v1alpha1",
  "kind" : "Placement",
  "metadata" : {
    "name" : "placement1",
    "namespace": "ns1"
  },
  "spec": {
    "predicates": [
      {
        "requiredClusterSelector": {
          "labelSelector": {
            "matchLabels": {
              "vendor": "OpenShift"
            }
          }
        }
      }
    ]
  },
  "status" : { }
}

1.14.2.3. 単一の Placement のクエリー

GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placements/{placement_name}
1.14.2.3.1. 説明

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

1.14.2.3.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

placement_name
必須

問い合わせる Placement の名前。

文字列

1.14.2.3.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.14.2.3.4. タグ
  • cluster.open-cluster-management.io

1.14.2.4. Placement の削除

DELETE /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placements/{placement_name}
1.14.2.4.1. 説明

単一の Placement を削除します。

1.14.2.4.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

placement_name
必須

削除する Placement の名前。

文字列

1.14.2.4.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.14.2.4.4. タグ
  • cluster.open-cluster-management.io

1.14.3. 定義

1.14.3.1. Placement

Name (名前)説明スキーマ

apiVersion
必須

Placement のバージョンスキーマ。

文字列

kind
必須

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

文字列

metadata
必須

Placement のメタデータ。

オブジェクト

spec
必須

Placement の仕様。

spec

spec

Name (名前)説明スキーマ

ClusterSets
任意

ManagedClusters を選択する ManagedClusterSets のサブセット。空白の場合には、Placement namespace にバインドされる ManagedClusterSets から ManagedClusters が選択されます。それ以外の場合は、ManagedClusters がこのサブセットの交差部分から選択され、ManagedClusterSets は Placement namespace にバインドされます。

文字列の配列

numberOfClusters
任意

選択する ManagedClusters の必要数。

整数 (int32)

predicates
任意

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

clusterPredicate 配列

clusterPredicate

Name (名前)説明スキーマ

requiredClusterSelector
任意

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

clusterSelector

clusterSelector

Name (名前)説明スキーマ

labelSelector
任意

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

オブジェクト

claimSelector
任意

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

clusterClaimSelector

clusterClaimSelector

Name (名前)説明スキーマ

matchExpressions
任意

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

< オブジェクト > 配列

1.15. PlacementDecisions API (v1alpha1)

1.15.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes の PlacementDecision リソースについて説明します。PlacementDecision リソースには、create、query、delete、update の 4 つの要求を使用できます。

1.15.1.1. バージョン情報

バージョン: 2.3.0

1.15.1.2. お問い合わせ先

お問い合わせメール: apiteam@swagger.io

1.15.1.3. ライセンス情報

ライセンス: Apache 2.0
ライセンス URL: http://www.apache.org/licenses/LICENSE-2.0.html
利用規約: http://swagger.io/terms/

1.15.1.4. URI スキーム

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

1.15.1.5. タグ

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

1.15.1.6. 外部ドキュメント

説明: Swagger に関する詳細は次を確認してください。
URL: http://swagger.io

1.15.2. パス

1.15.2.1. 全 PlacementDecision のクエリー

GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/placementdecisions
1.15.2.1.1. 説明

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

1.15.2.1.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

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/v1alpha1/namespaces/{namespace}/placementdecisions
1.15.2.2.1. 説明

PlacementDecisions を作成します。

1.15.2.2.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

ボディー

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. 要求ボディー
{
  "apiVersion" : "cluster.open-cluster-management.io/v1alpha1",
  "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/v1alpha1/namespaces/{namespace}/placementdecisions/{placementdecision_name}
1.15.2.3.1. 説明

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

1.15.2.3.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

placementdecision_name
必須

問い合わせる PlacementDecision の名前。

文字列

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/v1alpha1/namespaces/{namespace}/placementdecisions/{placementdecision_name}
1.15.2.4.1. 説明

単一の PlacementDecision を削除します。

1.15.2.4.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

placementdecision_name
必須

削除する PlacementDecision の名前。

文字列

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

Name (名前)説明スキーマ

apiVersion
必須

PlacementDecision のバージョンスキーマ。

文字列

kind
必須

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

文字列

metadata
必須

PlacementDecision のメタデータ。

オブジェクト

1.16. DiscoveryConfig API

1.16.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes の DiscoveryConfig リソースについて説明します。DiscoveryConfig リソースには、create、query、delete、update の 4 つの要求を使用できます。

1.16.1.1. バージョン情報

バージョン: 2.3.0

1.16.1.2. お問い合わせ先

お問い合わせメール: apiteam@swagger.io

1.16.1.3. ライセンス情報

ライセンス: Apache 2.0
ライセンス URL: http://www.apache.org/licenses/LICENSE-2.0.html
利用規約: http://swagger.io/terms/

1.16.1.4. URI スキーム

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

1.16.1.5. タグ

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

1.16.1.6. 外部ドキュメント

説明: Swagger に関する詳細は次を確認してください。
URL: http://swagger.io

1.16.2. パス

1.16.2.1. DiscoveryConfig の作成

POST /app.k8s.io/v1alpha1/namespaces/{namespace}/discoveryconfigs
1.16.2.1.1. 説明

DiscoveryConfig を作成します。

1.16.2.1.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

ボディー

body
必須

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

DiscoveryConfig

1.16.2.1.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.16.2.1.4. 消費
  • discoveryconfigs/yaml
1.16.2.1.5. タグ
  • discoveryconfigs.discovery.open-cluster-management.io
1.16.2.1.5.1. 要求ボディー
{
  "apiVersion": "apiextensions.k8s.io/v1",
  "kind": "CustomResourceDefinition",
  "metadata": {
    "annotations": {
      "controller-gen.kubebuilder.io/version": "v0.4.1",
    },
    "creationTimestamp": null,
    "name": "discoveryconfigs.discovery.open-cluster-management.io",
  },
  "spec": {
    "group": "discovery.open-cluster-management.io",
    "names": {
      "kind": "DiscoveryConfig",
      "listKind": "DiscoveryConfigList",
      "plural": "discoveryconfigs",
      "singular": "discoveryconfig"
    },
    "scope": "Namespaced",
    "versions": [
      {
        "name": "v1alpha1",
        "schema": {
          "openAPIV3Schema": {
            "description": "DiscoveryConfig is the Schema for the discoveryconfigs API",
            "properties": {
              "apiVersion": {
                "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
                "type": "string"
              },
              "kind": {
                "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
                "type": "string"
              },
              "metadata": {
                "type": "object"
              },
              "spec": {
                "description": "DiscoveryConfigSpec defines the desired state of DiscoveryConfig",
                "properties": {
                  "credential": {
                    "description": "Credential is the secret containing credentials to connect to the OCM api on behalf of a user",
                    "type": "string"
                  },
                  "filters": {
                    "description": "Sets restrictions on what kind of clusters to discover",
                    "properties": {
                      "lastActive": {
                        "description": "LastActive is the last active in days of clusters to discover, determined by activity timestamp",
                        "type": "integer"
                      },
                      "openShiftVersions": {
                        "description": "OpenShiftVersions is the list of release versions of OpenShift of the form \"<Major>.<Minor>\"",
                        "items": {
                          "description": "Semver represents a partial semver string with the major and minor version in the form \"<Major>.<Minor>\". For example: \"4.5\"",
                          "pattern": "^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)$",
                          "type": "string"
                        },
                        "type": "array"
                      }
                    },
                    "type": "object"
                  }
                },
                "required": [
                  "credential"
                ],
                "type": "object"
              },
              "status": {
                "description": "DiscoveryConfigStatus defines the observed state of DiscoveryConfig",
                "type": "object"
              }
            },
            "type": "object"
          }
        },
        "served": true,
        "storage": true,
        "subresources": {
          "status": {}
        }
      }
    ]
  },
  "status": {
    "acceptedNames": {
      "kind": "",
      "plural": ""
    },
    "conditions": [],
    "storedVersions": []
  }
}

1.16.2.2. すべての DiscoveryConfigs のクエリー

GET /operator.open-cluster-management.io/v1alpha1/namespaces/{namespace}/operator
1.16.2.2.1. 説明

discovery config 演算子に対してクエリーを実行して詳細を確認します。

1.16.2.2.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.16.2.2.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.16.2.2.4. 消費
  • operator/yaml
1.16.2.2.5. タグ
  • discoveryconfigs.discovery.open-cluster-management.io

1.16.2.3. DiscoveryConfig 演算子の削除

DELETE /operator.open-cluster-management.io/v1alpha1/namespaces/{namespace}/operator/{discoveryconfigs_name}
1.16.2.3.1. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

application_name
必須

削除する Discovery Config 演算子の名前。

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.16.2.3.2. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.16.2.3.3. タグ
  • discoveryconfigs.operator.open-cluster-management.io

1.16.3. 定義

1.16.3.1. DiscoveryConfig

Name (名前)説明スキーマ

apiVersion
必須

discoveryconfigs のバージョンスキーマ。

文字列

kind
必須

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

文字列

metadata
必須

リソースを定義するルールを記述します。

オブジェクト

spec
必須

DiscoveryConfig の必要な状態を定義します。

仕様の一覧」を参照してください。

1.16.3.2. 仕様の一覧

Name (名前)説明スキーマ

credential
必須

credential は、ユーザーの代わりに OCM API に接続するための認証情報が含まれるシークレットです。

文字列

filters
任意

検出するクラスターの種類に制限を設定します。

フィルターの一覧を参照してください。

1.16.3.3. フィルターの一覧

Name (名前)説明スキーマ

lastActive
必須

lastActive は、検出するクラスターの最後のアクティブ日数で、アクティビティーのタイムスタンプによって決定されます。

整数

openShiftVersions
任意

openShiftVersions は、OpenShift のリリースバージョン("<Major>.<Minor>" 形式)の一覧です。

オブジェクト

1.17. DiscoveredCluster API

1.17.1. 概要

このドキュメントでは、Red Hat Advanced Cluster Management for Kubernetes の DiscoveredCluster リソースについて説明します。DiscoveredCluster リソースには、create、query、delete、update の 4 つの要求を使用できます。

1.17.1.1. バージョン情報

バージョン: 2.3.0

1.17.1.2. お問い合わせ先

お問い合わせメール: apiteam@swagger.io

1.17.1.3. ライセンス情報

ライセンス: Apache 2.0
ライセンス URL: http://www.apache.org/licenses/LICENSE-2.0.html
利用規約: http://swagger.io/terms/

1.17.1.4. URI スキーム

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

1.17.1.5. タグ

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

1.17.1.6. 外部ドキュメント

説明: Swagger に関する詳細は次を確認してください。
URL: http://swagger.io

1.17.2. パス

1.17.2.1. DiscoveredCluster の作成

POST /app.k8s.io/v1alpha1/namespaces/{namespace}/discoveredclusters
1.17.2.1.1. 説明

DiscoveredCluster を作成します。

1.17.2.1.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

ボディー

body
必須

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

DiscoveredCluster

1.17.2.1.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.17.2.1.4. 消費
  • discoveredclusters/yaml
1.17.2.1.5. タグ
  • discoveredclusters.discovery.open-cluster-management.io
1.17.2.1.5.1. 要求ボディー
{
  "apiVersion": "apiextensions.k8s.io/v1",
  "kind": "CustomResourceDefinition",
  "metadata": {
    "annotations": {
      "controller-gen.kubebuilder.io/version": "v0.4.1",\
    },
    "creationTimestamp": null,
    "name": "discoveredclusters.discovery.open-cluster-management.io",
  },
  "spec": {
    "group": "discovery.open-cluster-management.io",
    "names": {
      "kind": "DiscoveredCluster",
      "listKind": "DiscoveredClusterList",
      "plural": "discoveredclusters",
      "singular": "discoveredcluster"
    },
    "scope": "Namespaced",
    "versions": [
      {
        "name": "v1alpha1",
        "schema": {
          "openAPIV3Schema": {
            "description": "DiscoveredCluster is the Schema for the discoveredclusters API",
            "properties": {
              "apiVersion": {
                "description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
                "type": "string"
              },
              "kind": {
                "description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
                "type": "string"
              },
              "metadata": {
                "type": "object"
              },
              "spec": {
                "description": "DiscoveredClusterSpec defines the desired state of DiscoveredCluster",
                "properties": {
                  "activityTimestamp": {
                    "format": "date-time",
                    "type": "string"
                  },
                  "apiUrl": {
                    "type": "string"
                  },
                  "cloudProvider": {
                    "type": "string"
                  },
                  "console": {
                    "type": "string"
                  },
                  "creationTimestamp": {
                    "format": "date-time",
                    "type": "string"
                  },
                  "credential": {
                    "description": "ObjectReference contains enough information to let you inspect or modify the referred object. --- New uses of this type are discouraged because of difficulty describing its usage when embedded in APIs.  1. Ignored fields.  It includes many fields which are not generally honored.  For instance, ResourceVersion and FieldPath are both very rarely valid in actual usage.  2. Invalid usage help.  It is impossible to add specific help for individual usage.  In most embedded usages, there are particular     restrictions like, \"must refer only to types A and B\" or \"UID not honored\" or \"name must be restricted\".     Those cannot be well described when embedded.  3. Inconsistent validation.  Because the usages are different, the validation rules are different by usage, which makes it hard for users to predict what will happen.  4. The fields are both imprecise and overly precise.  Kind is not a precise mapping to a URL. This can produce ambiguity     during interpretation and require a REST mapping.  In most cases, the dependency is on the group,resource tuple     and the version of the actual struct is irrelevant.  5. We cannot easily change it.  Because this type is embedded in many locations, updates to this type     will affect numerous schemas.  Don't make new APIs embed an underspecified API type they do not control. Instead of using this type, create a locally provided and used type that is well-focused on your reference. For example, ServiceReferences for admission registration: https://github.com/kubernetes/api/blob/release-1.17/admissionregistration/v1/types.go#L533 .",
                    "properties": {
                      "apiVersion": {
                        "description": "API version of the referent.",
                        "type": "string"
                      },
                      "fieldPath": {
                        "description": "If referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the object reference is to a container within a pod, this would take on a value like: \"spec.containers{name}\" (where \"name\" refers to the name of the container that triggered the event) or if no container name is specified \"spec.containers[2]\" (container with index 2 in this pod). This syntax is chosen only to have some well-defined way of referencing a part of an object. TODO: this design is not final and this field is subject to change in the future.",
                        "type": "string"
                      },
                      "kind": {
                        "description": "Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
                        "type": "string"
                      },
                      "name": {
                        "description": "Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names",
                        "type": "string"
                      },
                      "namespace": {
                        "description": "Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/",
                        "type": "string"
                      },
                      "resourceVersion": {
                        "description": "Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency",
                        "type": "string"
                      },
                      "uid": {
                        "description": "UID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids",
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "displayName": {
                    "type": "string"
                  },
                  "isManagedCluster": {
                    "type": "boolean"
                  },
                  "name": {
                    "type": "string"
                  },
                  "openshiftVersion": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "type": {
                    "type": "string"
                  }
                },
                "required": [
                  "apiUrl",
                  "displayName",
                  "isManagedCluster",
                  "name",
                  "type"
                ],
                "type": "object"
              },
              "status": {
                "description": "DiscoveredClusterStatus defines the observed state of DiscoveredCluster",
                "type": "object"
              }
            },
            "type": "object"
          }
        },
        "served": true,
        "storage": true,
        "subresources": {
          "status": {}
        }
      }
    ]
  },
  "status": {
    "acceptedNames": {
      "kind": "",
      "plural": ""
    },
    "conditions": [],
    "storedVersions": []
  }
}

1.17.2.2. すべての DiscoveredClusters のクエリー

GET /operator.open-cluster-management.io/v1alpha1/namespaces/{namespace}/operator
1.17.2.2.1. 説明

discovered clusters 演算子に対してクエリーを実行して詳細を確認します。

1.17.2.2.2. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.17.2.2.3. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.17.2.2.4. 消費
  • operator/yaml
1.17.2.2.5. タグ
  • discoveredclusters.discovery.open-cluster-management.io

1.17.2.3. DiscoveredCluster 演算子の削除

DELETE /operator.open-cluster-management.io/v1alpha1/namespaces/{namespace}/operator/{discoveredclusters_name}
1.17.2.3.1. パラメーター
タイプName (名前)説明スキーマ

ヘッダー

COOKIE
必須

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

文字列

パス

application_name
必須

削除する Discovered Cluster 演算子の名前。

文字列

パス

namespace
必須

使用する namespace (例: default)

文字列

1.17.2.3.2. 応答
HTTP コード説明スキーマ

200

成功

コンテンツなし

403

アクセス禁止

コンテンツなし

404

リソースが見つからない

コンテンツなし

500

内部サービスエラー

コンテンツなし

503

サービスが利用できない

コンテンツなし

1.17.2.3.3. タグ
  • discoveredclusters.operator.open-cluster-management.io

1.17.3. 定義

1.17.3.1. DiscoveredCluster

Name (名前)説明スキーマ

apiVersion
必須

discoveredclusters のバージョンスキーマ。

文字列

kind
必須

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

文字列

metadata
必須

リソースを定義するルールを記述します。

オブジェクト

spec
必須

DiscoveredClusterSpec は、DiscoveredCluster の必要な状態を定義します。

仕様の一覧」を参照してください。

1.17.3.2. 仕様の一覧

Name (名前)説明スキーマ

activityTimestamp
任意

Discoveredclusters 最後に利用可能なアクティビティータイムスタンプ。

metav1.time

apiUrl
必須

Discoveredclusters API URL エンドポイント。

文字列

cloudProvider
任意

discoveredcluster のクラウドプロバイダー。

文字列

console
任意

Discoveredclusters コンソール URL エンドポイント。

文字列

creationTimestamp
任意

Discoveredclusters 作成タイプスタンプ。

metav1.time

credential
任意

クラスターが検出された認証情報への参照。

corev1.ObjectReference

displayName
必須

検出されたクラスターの表示名。

文字列

isManagedCluster
必須

true の場合、クラスターは ACM によって管理されます。

ブール値

name
必須

検出されたクラスターの名前。

文字列

openshiftVersion
任意

検出されたクラスターの OpenShift バージョン。

文字列

status
任意

検出されたクラスターのステータス。

文字列

type
必須

OpenShift フレーバー(例:OCP、ROSA など)。

文字列