第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.1.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
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
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. 要求ボディー リンクのコピーリンクがクリップボードにコピーされました!
1.1.2.3. 単一クラスターのクエリー リンクのコピーリンクがクリップボードにコピーされました!
GET /cluster.open-cluster-management.io/v1/managedclusters/{cluster_name}
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}
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. クラスター リンクのコピーリンクがクリップボードにコピーされました!
| 名前 | Schema |
|---|---|
|
apiVersion | string |
|
kind | string |
|
metadata | object |
|
spec |
spec
| 名前 | Schema |
|---|---|
|
hubAcceptsClient | bool |
|
managedClusterClientConfigs | < managedClusterClientConfigs > array |
|
leaseDurationSeconds | 整数 (int32) |
managedClusterClientConfigs
| 名前 | 説明 | Schema |
|---|---|---|
|
URL | string | |
|
cabundle |
パターン : | 文字列 (バイト) |