1.17. ManagedClusterSet API (v1beta1)

1.17.1. 概述

本文档介绍了与 Red Hat Advanced Cluster Management for Kubernetes 的 ManagedClusterSet 资源相关的 API 信息。ManagedClusterSet 资源有 4 个可用的请求：create、query、delete 和 update。ManagedClusterSet 将两个或多个受管集群分组到可一起工作的集合。属于集合的受管集群可以有类似的属性，如共享使用目的或同一部署区域。

1.17.1.1. 版本信息

版本 : 2.7.0

1.17.1.2. URI scheme

BasePath : /kubernetes/apis
Schemes : HTTPS

1.17.1.3. Tags

cluster.open-cluster-management.io : 创建和管理 ManagedClusterSets

1.17.2. 路径

1.17.2.1. 查询所有 managedclustersets

GET /cluster.open-cluster-management.io/v1beta2/namespaces/{namespace}/managedclustersets

1.17.2.1.1. 描述

查询 managedclustersets 以获取更多详细信息。

1.17.2.1.2. 参数

类型	Name	描述	模式
标头	COOKIE 必需	身份验证：Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN 是用户访问令牌。	字符串
路径	namespace 必需	要使用的命名空间，如 default。	字符串

1.17.2.1.3. 响应

HTTP 代码	描述	模式
200	成功	无内容
403	禁止访问	无内容
404	未找到资源	无内容
500	内部服务错误	无内容
503	服务不可用	无内容

1.17.2.1.4. 使用

managedclusterset/yaml

1.17.2.1.5. Tags

cluster.open-cluster-management.io

1.17.2.2. 创建 managedclusterset

POST /cluster.open-cluster-management.io/v1beta2/namespaces/{namespace}/managedclustersets

1.17.2.2.1. 描述

创建 managedclusterset.

1.17.2.2.2. 参数

类型	Name	描述	模式
标头	COOKIE 必需	身份验证：Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN 是用户访问令牌。	字符串
路径	namespace 必需	要使用的命名空间，如 `default`。	字符串
Body	body 必需	描述要创建的 managedclusterset 的参数。	ManagedClusterSet

1.17.2.2.3. 响应

HTTP 代码	描述	模式
200	成功	无内容
403	禁止访问	无内容
404	未找到资源	无内容
500	内部服务错误	无内容
503	服务不可用	无内容

1.17.2.2.4. 使用

managedclusterset/yaml

1.17.2.2.5. Tags

cluster.open-cluster-management.io

1.17.2.2.6. HTTP 请求示例

1.17.2.2.6.1. 请求正文

{
  "apiVersion" : "cluster.open-cluster-management.io/v1beta2",
  "kind" : "ManagedClusterSet",
  "metadata" : {
    "name" : "example-clusterset",
  },
 "spec": {
  },
  "status" : { }
}

1.17.2.3. 查询单个 managedclusterset

GET /cluster.open-cluster-management.io/v1beta2/namespaces/{namespace}/managedclustersets/{managedclusterset_name}

1.17.2.3.1. 描述

查询单个 managedclusterset 获取更多详细信息。

1.17.2.3.2. 参数

类型	Name	描述	模式
标头	COOKIE 必需	身份验证：Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN 是用户访问令牌。	字符串
路径	namespace 必需	要使用的命名空间，如 `default`。	字符串
路径	managedclusterset_name 必需	要查询的 managedclusterset 的名称。	字符串

1.17.2.3.3. 响应

HTTP 代码	描述	模式
200	成功	无内容
403	禁止访问	无内容
404	未找到资源	无内容
500	内部服务错误	无内容
503	服务不可用	无内容

1.17.2.3.4. Tags

cluster.open-cluster-management.io

1.17.2.4. 删除 managedclusterset

DELETE /cluster.open-cluster-management.io/v1beta2/managedclustersets/{managedclusterset_name}

1.17.2.4.1. 描述

删除单个 managedclusterset

1.17.2.4.2. 参数

类型	Name	描述	模式
标头	COOKIE 必需	身份验证：Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN 是用户访问令牌。	字符串
路径	namespace 必需	要使用的命名空间，如 `default`。	字符串
路径	managedclusterset_name 必需	要删除的 managedclusterset 的名称。	字符串

1.17.2.4.3. 响应

HTTP 代码	描述	模式
200	成功	无内容
403	禁止访问	无内容
404	未找到资源	无内容
500	内部服务错误	无内容
503	服务不可用	无内容

1.17.2.4.4. Tags

cluster.open-cluster-management.io

1.17.3. 定义

1.17.3.1. ManagedClusterSet

Name	描述	模式
apiVersion 必需	`ManagedClusterSet` 的版本化模式。	字符串
kind 必需	代表 REST 资源的字符串值。	字符串
metadata 必需	`ManagedClusterSet` 的元数据。	对象
spec必需	`ManagedClusterSet` 的规格。	spec