1.7. PlacementRules API (已弃用)

1.7.1. 概述

本文档介绍了与 Red Hat Advanced Cluster Management for Kubernetes 的 PlacementRule 资源相关的 API 信息。PlacementRule 资源有 4 个可用的请求：create、query、delete 和 update。

1.7.1.1. 版本信息

版本 : 2.8.0

1.7.1.2. URI scheme

BasePath : /kubernetes/apis
Schemes : HTTPS

1.7.1.3. Tags

placementrules.apps.open-cluster-management.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 必需	身份验证：Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN 是用户访问令牌。	字符串
路径	namespace 必需	要使用的命名空间，如 default。	字符串
Body	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. Tags

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 必需	身份验证：Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN 是用户访问令牌。	字符串
路径	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. Tags

placementrules.apps.open-cluster-management.io

1.7.2.3. 查询单个放置规则

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

1.7.2.3.1. 描述

查询单个放置规则以了解更多详细信息。

1.7.2.3.2. 参数

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

1.7.2.3.3. 响应

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

1.7.2.3.4. Tags

placementrules.apps.open-cluster-management.io

1.7.2.4. 删除放置规则

DELETE /apps.open-cluster-management.io/v1/namespaces/{namespace}/placementrules/{placementrule_name}

1.7.2.4.1. 参数

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

1.7.2.4.2. 响应

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

1.7.2.4.3. Tags

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 可选	字符串