Este conteúdo não está disponível no idioma selecionado.
APIs
View a list of APIs that you can use to create and manage application resources, channels, subscriptions, and to query information.
Abstract
Chapter 1. APIs
You can access APIs to create and manage application resources, channels, subscriptions, and to query information.
User required access: You can only perform actions that your role is assigned. Learn about access requirements from the Role-based access control documentation.
For more information, review the API documentation for each of the following resources:
1.1. Clusters API
1.1.1. Overview
This documentation is for the cluster resource for Red Hat Advanced Cluster Management for Kubernetes. Cluster resource has four possible requests: create, query, delete and update.
1.1.1.1. Version information
Version : 2.2.0
1.1.1.2. Contact information
Contact Email : apiteam@swagger.io
1.1.1.3. License information
						License : Apache 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0.html
Terms of service : http://swagger.io/terms/
					
1.1.1.4. URI scheme
						BasePath : /kubernetes/apis
Schemes : HTTPS
					
1.1.1.5. Tags
- cluster.open-cluster-management.io : Create and manage clusters
1.1.1.6. External Docs
						Description : Find out more about Swagger.
URL : http://swagger.io
					
1.1.2. Paths
1.1.2.1. Query all clusters
GET /cluster.open-cluster-management.io/v1/managedclusters
GET /cluster.open-cluster-management.io/v1/managedclusters1.1.2.1.1. Description
Query your clusters for more details.
1.1.2.1.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
1.1.2.1.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.1.2.1.4. Consumes
- 
									cluster/yaml
1.1.2.1.5. Tags
- cluster.open-cluster-management.io
1.1.2.2. Create a cluster
POST /cluster.open-cluster-management.io/v1/managedclusters
POST /cluster.open-cluster-management.io/v1/managedclusters1.1.2.2.1. Description
Create a cluster
1.1.2.2.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Body | 
											body | Parameters describing the cluster to be created. | 
1.1.2.2.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.1.2.2.4. Consumes
- 
									cluster/yaml
1.1.2.2.5. Tags
- cluster.open-cluster-management.io
1.1.2.2.6. Example HTTP request
1.1.2.2.6.1. Request body
1.1.2.3. Query a single cluster
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. Description
Query a single cluster for more details.
1.1.2.3.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											cluster_name | Name of the cluster that you want to query. | string | 
1.1.2.3.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.1.2.3.4. Tags
- cluster.open-cluster-management.io
1.1.2.4. Delete a cluster
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. Description
Delete a single cluster
1.1.2.4.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											cluster_name | Name of the cluster that you want to delete. | string | 
1.1.2.4.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.1.2.4.4. Tags
- cluster.open-cluster-management.io
1.1.3. Definitions
1.1.3.1. Cluster
| Name | Schema | 
|---|---|
| 
										apiVersion | string | 
| 
										kind | string | 
| 
										metadata | object | 
| 
										spec | 
spec
| Name | Schema | 
|---|---|
| 
										hubAcceptsClient | bool | 
| 
										managedClusterClientConfigs | < managedClusterClientConfigs > array | 
| 
										leaseDurationSeconds | integer (int32) | 
managedClusterClientConfigs
| Name | Description | Schema | 
|---|---|---|
| 
										URL | string | |
| 
										CABundle | 
										Pattern :  | string (byte) | 
1.2. Clustersets API (v1alpha1)
1.2.1. Overview
This documentation is for the Clusterset resource for Red Hat Advanced Cluster Management for Kubernetes. Clusterset resource has four possible requests: create, query, delete and update.
1.2.1.1. Version information
Version : 2.2.0
1.2.1.2. Contact information
Contact Email : apiteam@swagger.io
1.2.1.3. License information
						License : Apache 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0.html
Terms of service : http://swagger.io/terms/
					
1.2.1.4. URI scheme
						BasePath : /kubernetes/apis
Schemes : HTTPS
					
1.2.1.5. Tags
- cluster.open-cluster-management.io : Create and manage Clustersets
1.2.1.6. External Docs
						Description : Find out more about Swagger.
URL : http://swagger.io
					
1.2.2. Paths
1.2.2.1. Query all clustersets
GET /cluster.open-cluster-management.io/v1alpha1/managedclustersets
GET /cluster.open-cluster-management.io/v1alpha1/managedclustersets1.2.2.1.1. Description
Query your Clustersets for more details.
1.2.2.1.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
1.2.2.1.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.2.2.1.4. Consumes
- 
									clusterset/yaml
1.2.2.1.5. Tags
- cluster.open-cluster-management.io
1.2.2.2. Create a clusterset
POST /cluster.open-cluster-management.io/v1alpha1/managedclustersets
POST /cluster.open-cluster-management.io/v1alpha1/managedclustersets1.2.2.2.1. Description
Create a Clusterset.
1.2.2.2.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Body | 
											body | Parameters describing the clusterset to be created. | 
1.2.2.2.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.2.2.2.4. Consumes
- 
									clusterset/yaml
1.2.2.2.5. Tags
- cluster.open-cluster-management.io
1.2.2.2.6. Example HTTP request
1.2.2.2.6.1. Request body
1.2.2.3. Query a single clusterset
GET /cluster.open-cluster-management.io/v1alpha1/managedclustersets/{clusterset_name}
GET /cluster.open-cluster-management.io/v1alpha1/managedclustersets/{clusterset_name}1.2.2.3.1. Description
Query a single clusterset for more details.
1.2.2.3.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											clusterset_name | Name of the clusterset that you want to query. | string | 
1.2.2.3.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.2.2.3.4. Tags
- cluster.open-cluster-management.io
1.2.2.4. Delete a clusterset
DELETE /cluster.open-cluster-management.io/v1alpha1/managedclustersets/{clusterset_name}
DELETE /cluster.open-cluster-management.io/v1alpha1/managedclustersets/{clusterset_name}1.2.2.4.1. Description
Delete a single clusterset.
1.2.2.4.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											clusterset_name | Name of the clusterset that you want to delete. | string | 
1.2.2.4.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.2.2.4.4. Tags
- cluster.open-cluster-management.io
1.2.3. Definitions
1.2.3.1. Clusterset
| Name | Schema | 
|---|---|
| 
										apiVersion | string | 
| 
										kind | string | 
| 
										metadata | object | 
1.3. Clustersetbindings API (v1alpha1)
1.3.1. Overview
This documentation is for the clustersetbinding resource for Red Hat Advanced Cluster Management for Kubernetes. Clustersetbinding resource has four possible requests: create, query, delete and update.
1.3.1.1. Version information
Version : 2.2.0
1.3.1.2. Contact information
Contact Email : apiteam@swagger.io
1.3.1.3. License information
						License : Apache 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0.html
Terms of service : http://swagger.io/terms/
					
1.3.1.4. URI scheme
						BasePath : /kubernetes/apis
Schemes : HTTPS
					
1.3.1.5. Tags
- cluster.open-cluster-management.io : Create and manage clustersetbindings
1.3.1.6. External Docs
						Description : Find out more about Swagger.
URL : http://swagger.io
					
1.3.2. Paths
1.3.2.1. Query all clustersetbindings
GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/managedclustersetbindings
GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/managedclustersetbindings1.3.2.1.1. Description
Query your clustersetbindings for more details.
1.3.2.1.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.3.2.1.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.3.2.1.4. Consumes
- 
									clustersetbinding/yaml
1.3.2.1.5. Tags
- cluster.open-cluster-management.io
1.3.2.2. Create a clustersetbinding
POST /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/managedclustersetbindings
POST /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/managedclustersetbindings1.3.2.2.1. Description
Create a clustersetbinding.
1.3.2.2.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
| Body | 
											body | Parameters describing the clustersetbinding to be created. | 
1.3.2.2.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.3.2.2.4. Consumes
- 
									clustersetbinding/yaml
1.3.2.2.5. Tags
- cluster.open-cluster-management.io
1.3.2.2.6. Example HTTP request
1.3.2.2.6.1. Request body
1.3.2.3. Query a single clustersetbinding
GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/managedclustersetbindings/{clustersetbinding_name}
GET /cluster.open-cluster-management.io/v1alpha1/namespaces/{namespace}/managedclustersetbindings/{clustersetbinding_name}1.3.2.3.1. Description
Query a single clustersetbinding for more details.
1.3.2.3.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
| Path | 
											clustersetbinding_name | Name of the clustersetbinding that you want to query. | string | 
1.3.2.3.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.3.2.3.4. Tags
- cluster.open-cluster-management.io
1.3.2.4. Delete a clustersetbinding
DELETE /cluster.open-cluster-management.io/v1alpha1/managedclustersetbindings/{clustersetbinding_name}
DELETE /cluster.open-cluster-management.io/v1alpha1/managedclustersetbindings/{clustersetbinding_name}1.3.2.4.1. Description
Delete a single clustersetbinding.
1.3.2.4.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
| Path | 
											clustersetbinding_name | Name of the clustersetbinding that you want to delete. | string | 
1.3.2.4.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.3.2.4.4. Tags
- cluster.open-cluster-management.io
1.3.3. Definitions
1.3.3.1. Clustersetbinding
| Name | Schema | 
|---|---|
| 
										apiVersion | string | 
| 
										kind | string | 
| 
										metadata | object | 
| 
										spec | 
spec
| Name | Schema | 
|---|---|
| 
										clusterSet | string | 
1.4. Channels API
1.4.1. Overview
This documentation is for the Channel resource for Red Hat Advanced Cluster Management for Kubernetes. The Channel resource has four possible requests: create, query, delete and update.
1.4.1.1. Version information
Version : 2.2.0
1.4.1.2. Contact information
Contact Email : apiteam@swagger.io
1.4.1.3. License information
						License : Apache 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0.html
Terms of service : http://swagger.io/terms/
					
1.4.1.4. URI scheme
						BasePath : /kubernetes/apis
Schemes : HTTPS
					
1.4.1.5. Tags
- channels.apps.open-cluster-management.io : Create and manage deployables
1.4.1.6. External Docs
						Description : Find out more about Swagger.
URL : http://swagger.io
					
1.4.2. Paths
1.4.2.1. Create a channel
POST /apps.open-cluster-management.io/v1/namespaces/{namespace}/channels
POST /apps.open-cluster-management.io/v1/namespaces/{namespace}/channels1.4.2.1.1. Description
Create a channel.
1.4.2.1.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
| Body | 
											body | Parameters describing the deployable to be created. | 
1.4.2.1.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.4.2.1.4. Consumes
- 
									application/yaml
1.4.2.1.5. Tags
- channels.apps.open-cluster-management.io
1.4.2.1.6. Example HTTP request
1.4.2.1.6.1. Request body
1.4.2.2. Query all channels for the target namespace
GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/channels
GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/channels1.4.2.2.1. Description
Query your channels for more details.
1.4.2.2.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.4.2.2.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.4.2.2.4. Consumes
- 
									application/yaml
1.4.2.2.5. Tags
- channels.apps.open-cluster-management.io
1.4.2.3. Query a single channels of a namespace
GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/channels/{channel_name}
GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/channels/{channel_name}1.4.2.3.1. Description
Query a single channels for more details.
1.4.2.3.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											channel_name | Name of the deployable that you wan to query. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.4.2.3.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.4.2.3.4. Tags
- channels.apps.open-cluster-management.io
1.4.2.4. Delete a Channel
DELETE /apps.open-cluster-management.io/v1/namespaces/{namespace}/channels/{channel_name}
DELETE /apps.open-cluster-management.io/v1/namespaces/{namespace}/channels/{channel_name}1.4.2.4.1. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											channel_name | Name of the Channel that you want to delete. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.4.2.4.2. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.4.2.4.3. Tags
- channels.apps.open-cluster-management.io
1.4.3. Definitions
1.4.3.1. Channel
| Name | Schema | 
|---|---|
| 
										apiVersion | string | 
| 
										kind | string | 
| 
										metadata | object | 
| 
										spec | 
spec
| Name | Description | Schema | 
|---|---|---|
| 
										configMapRef | ObjectReference contains enough information to let you inspect or modify the referred object. | |
| 
										gates | ChannelGate defines criteria for promote to channel | |
| 
										pathname | string | |
| 
										secretRef | ObjectReference contains enough information to let you inspect or modify the referred object. | |
| 
										sourceNamespaces | < enum (Namespace, HelmRepo, ObjectBucket, Git, namespace, helmrepo, objectbucket, github) > array | 
configMapRef
| Name | Description | Schema | 
|---|---|---|
| 
										apiVersion | API version of the referent. | string | 
| 
										fieldPath | 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. | string | 
| 
										kind | Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds | string | 
| 
										name | Name of the referent. More info: Names | string | 
| 
										namespace | Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ | string | 
| 
										resourceVersion | Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency | string | 
| 
										uid | UID of the referent. More info: UIDs | string | 
gates
| Name | Description | Schema | 
|---|---|---|
| 
										annotations | typical annotations of k8s | |
| 
										labelSelector | A label selector is a label query over a set of resources. The result of matchLabels and matchExpressions are ANDed. An empty label selector matches all objects. A null label selector matches no objects. | |
| 
										name | string | 
annotations
| Name | Schema | 
|---|---|
| 
										key | string | 
| 
										value | string | 
labelSelector
| Name | Description | Schema | 
|---|---|---|
| 
										matchExpressions | matchExpressions is a list of label selector requirements. The requirements are ANDed. | < matchExpressions > array | 
| 
										matchLabels | matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed. | < string, string > map | 
matchExpressions
| Name | Description | Schema | 
|---|---|---|
| 
										key | key is the label key that the selector applies to. | string | 
| 
										operator | operator represents a key’s relationship to a set of values. Valid operators are In, NotIn, Exists and DoesNotExist. | string | 
| 
										values | values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch. | < string > array | 
secretRef
| Name | Description | Schema | 
|---|---|---|
| 
										apiVersion | API version of the referent. | string | 
| 
										fieldPath | 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. | string | 
| 
										kind | Kind of the referent. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds | string | 
| 
										name | Name of the referent. More info: Names | string | 
| 
										namespace | Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ | string | 
| 
										resourceVersion | Specific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency | string | 
| 
										uid | UID of the referent. More info: UIIDs | string | 
1.5. Subscriptions API
1.5.1. Overview
This documentation is for the Subscription resource for Red Hat Advanced Cluster Management for Kubernetes. The Subscription resource has four possible requests: create, query, delete and update.
1.5.1.1. Version information
Version : 2.2.0
1.5.1.2. Contact information
Contact Email : apiteam@swagger.io
1.5.1.3. License information
						License : Apache 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0.html
Terms of service : http://swagger.io/terms/
					
1.5.1.4. URI scheme
						BasePath : /kubernetes/apis
Schemes : HTTPS
					
1.5.1.5. Tags
- subscriptions.apps.open-cluster-management.io : Create and manage subscriptions
1.5.1.6. External Docs
						Description : Find out more about Swagger.
URL : http://swagger.io
					
1.5.2. Paths
1.5.2.1. Create a subscription
POST /apps.open-cluster-management.io/v1/namespaces/{namespace}/subscriptions
POST /apps.open-cluster-management.io/v1/namespaces/{namespace}/subscriptions1.5.2.1.1. Description
Create a subscription.
1.5.2.1.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
| Body | 
											body | Parameters describing the subscription to be created. | 
1.5.2.1.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.5.2.1.4. Consumes
- 
									subscription/yaml
1.5.2.1.5. Tags
- subscriptions.apps.open-cluster-management.io
1.5.2.1.6. Example HTTP request
1.5.2.1.6.1. Request body
1.5.2.2. Query all subscriptions
GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/subscriptions
GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/subscriptions1.5.2.2.1. Description
Query your subscriptions for more details.
1.5.2.2.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.5.2.2.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.5.2.2.4. Consumes
- 
									subscription/yaml
1.5.2.2.5. Tags
- subscriptions.apps.open-cluster-management.io
1.5.2.3. Query a single subscription
GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/subscriptions/{subscription_name}
GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/subscriptions/{subscription_name}1.5.2.3.1. Description
Query a single subscription for more details.
1.5.2.3.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
| Path | 
											subscription_name | Name of the subscription that you wan to query. | string | 
1.5.2.3.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.5.2.3.4. Tags
- subscriptions.apps.open-cluster-management.io
1.5.2.4. Delete a subscription
DELETE /apps.open-cluster-management.io/v1/namespaces/{namespace}/subscriptions/{subscription_name}
DELETE /apps.open-cluster-management.io/v1/namespaces/{namespace}/subscriptions/{subscription_name}1.5.2.4.1. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
| Path | 
											subscription_name | Name of the subscription that you want to delete. | string | 
1.5.2.4.2. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.5.2.4.3. Tags
- subscriptions.apps.open-cluster-management.io
1.5.3. Definitions
1.5.3.1. Subscription
| Name | Schema | 
|---|---|
| 
										apiVersion | string | 
| 
										kind | string | 
| 
										metadata | |
| 
										spec | |
| 
										status | 
metadata
| Name | Schema | 
|---|---|
| 
										annotations | object | 
| 
										labels | object | 
| 
										name | string | 
| 
										namespace | string | 
spec
| Name | Schema | 
|---|---|
| 
										channel | string | 
| 
										name | string | 
| 
										overrides | < overrides > array | 
| 
										packageFilter | |
| 
										packageOverrides | < packageOverrides > array | 
| 
										placement | |
| 
										timewindow | 
overrides
| Name | Schema | 
|---|---|
| 
										clusterName | string | 
| 
										clusterOverrides | < object > array | 
packageFilter
| Name | Description | Schema | 
|---|---|---|
| 
										annotations | < string, string > map | |
| 
										filterRef | ||
| 
										labelSelector | ||
| 
										version | 
										Pattern :  | string | 
filterRef
| Name | Schema | 
|---|---|
| 
										name | string | 
labelSelector
| Name | Schema | 
|---|---|
| 
										matchExpressions | < matchExpressions > array | 
| 
										matchLabels | < string, string > map | 
matchExpressions
| Name | Schema | 
|---|---|
| 
										key | string | 
| 
										operator | string | 
| 
										values | < string > array | 
packageOverrides
| Name | Schema | 
|---|---|
| 
										packageAlias | string | 
| 
										packageName | string | 
| 
										packageOverrides | < object > array | 
placement
| Name | Schema | 
|---|---|
| 
										clusterSelector | |
| 
										clusters | < clusters > array | 
| 
										local | boolean | 
| 
										placementRef | 
clusterSelector
| Name | Schema | 
|---|---|
| 
										matchExpressions | < matchExpressions > array | 
| 
										matchLabels | < string, string > map | 
matchExpressions
| Name | Schema | 
|---|---|
| 
										key | string | 
| 
										operator | string | 
| 
										values | < string > array | 
clusters
| Name | Schema | 
|---|---|
| 
										name | string | 
placementRef
| Name | Schema | 
|---|---|
| 
										apiVersion | string | 
| 
										fieldPath | string | 
| 
										kind | string | 
| 
										name | string | 
| 
										namespace | string | 
| 
										resourceVersion | string | 
| 
										uid | string | 
timewindow
| Name | Schema | 
|---|---|
| 
										daysofweek | < string > array | 
| 
										hours | < hours > array | 
| 
										location | string | 
| 
										windowtype | enum (active, blocked, Active, Blocked) | 
hours
| Name | Schema | 
|---|---|
| 
										end | string | 
| 
										start | string | 
status
| Name | Schema | 
|---|---|
| 
										lastUpdateTime | string (date-time) | 
| 
										message | string | 
| 
										phase | string | 
| 
										reason | string | 
| 
										statuses | object | 
1.6. PlacementRules API
1.6.1. Overview
This documentation is for the PlacementRule resource for Red Hat Advanced Cluster Management for Kubernetes. The PlacementRule resource has four possible requests: create, query, delete and update.
1.6.1.1. Version information
Version : 2.2.0
1.6.1.2. Contact information
Contact Email : apiteam@swagger.io
1.6.1.3. License information
						License : Apache 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0.html
Terms of service : http://swagger.io/terms/
					
1.6.1.4. URI scheme
						BasePath : /kubernetes/apis
Schemes : HTTPS
					
1.6.1.5. Tags
- placementrules.apps.open-cluster-management.io : Create and manage placement rules
1.6.1.6. External Docs
						Description : Find out more about Swagger.
URL : http://swagger.io
					
1.6.2. Paths
1.6.2.1. Create a placement rule
POST /apps.open-cluster-management.io/v1/namespaces/{namespace}/placementrules
POST /apps.open-cluster-management.io/v1/namespaces/{namespace}/placementrules1.6.2.1.1. Description
Create a placement rule.
1.6.2.1.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
| Body | 
											body | Parameters describing the placement rule to be created. | 
1.6.2.1.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.6.2.1.4. Consumes
- 
									application/yaml
1.6.2.1.5. Tags
- placementrules.apps.open-cluster-management.io
1.6.2.1.6. Example HTTP request
1.6.2.1.6.1. Request body
1.6.2.2. Query all placement rules
GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/placementrules
GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/placementrules1.6.2.2.1. Description
Query your placement rules for more details.
1.6.2.2.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.6.2.2.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.6.2.2.4. Consumes
- 
									application/yaml
1.6.2.2.5. Tags
- placementrules.apps.open-cluster-management.io
1.6.2.3. Query a single placementrule
GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/placementrules/{placementrule_name}
GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/placementrules/{placementrule_name}1.6.2.3.1. Description
Query a single placement rule for more details.
1.6.2.3.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
| Path | 
											placementrule_name | Name of the placementrule that you want to query. | string | 
1.6.2.3.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.6.2.3.4. Tags
- placementrules.apps.open-cluster-management.io
1.6.2.4. Delete a placementrule
DELETE /apps.open-cluster-management.io/v1/namespaces/{namespace}/placementrules/{placementrule_name}
DELETE /apps.open-cluster-management.io/v1/namespaces/{namespace}/placementrules/{placementrule_name}1.6.2.4.1. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
| Path | 
											placementrule_name | Name of the placementrule that you want to delete. | string | 
1.6.2.4.2. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.6.2.4.3. Tags
- placementrules.apps.open-cluster-management.io
1.6.3. Definitions
1.6.3.1. Placementrule
| Name | Schema | 
|---|---|
| 
										apiVersion | string | 
| 
										kind | string | 
| 
										metadata | object | 
| 
										spec | 
spec
| Name | Schema | 
|---|---|
| 
										clusterConditions | < clusterConditions > array | 
| 
										clusterReplicas | integer | 
| 
										clusterSelector | |
| 
										clusters | < clusters > array | 
| 
										policies | < policies > array | 
| 
										resourceHint | |
| 
										schedulerName | string | 
clusterConditions
| Name | Schema | 
|---|---|
| 
										status | string | 
| 
										type | string | 
clusterSelector
| Name | Schema | 
|---|---|
| 
										matchExpressions | < matchExpressions > array | 
| 
										matchLabels | < string, string > map | 
matchExpressions
| Name | Schema | 
|---|---|
| 
										key | string | 
| 
										operator | string | 
| 
										values | < string > array | 
clusters
| Name | Schema | 
|---|---|
| 
										name | string | 
policies
| Name | Schema | 
|---|---|
| 
										apiVersion | string | 
| 
										fieldPath | string | 
| 
										kind | string | 
| 
										name | string | 
| 
										namespace | string | 
| 
										resourceVersion | string | 
| 
										uid | string | 
resourceHint
| Name | Schema | 
|---|---|
| 
										order | string | 
| 
										type | string | 
1.7. Applications API
1.7.1. Overview
This documentation is for the Application resource for Red Hat Advanced Cluster Management for Kubernetes. Application resource has four possible requests: create, query, delete and update.
1.7.1.1. Version information
Version : 2.2.0
1.7.1.2. Contact information
Contact Email : apiteam@swagger.io
1.7.1.3. License information
						License : Apache 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0.html
Terms of service : http://swagger.io/terms/
					
1.7.1.4. URI scheme
						BasePath : /kubernetes/apis
Schemes : HTTPS
					
1.7.1.5. Tags
- applications.app.k8s.io : Create and manage applications
1.7.1.6. External Docs
						Description : Find out more about Swagger.
URL : http://swagger.io
					
1.7.2. Paths
1.7.2.1. Create a application
POST /app.k8s.io/v1beta1/namespaces/{namespace}/applications
POST /app.k8s.io/v1beta1/namespaces/{namespace}/applications1.7.2.1.1. Description
Create a application.
1.7.2.1.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
| Body | 
											body | Parameters describing the application to be created. | 
1.7.2.1.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.7.2.1.4. Consumes
- 
									application/yaml
1.7.2.1.5. Tags
- applications.app.k8s.io
1.7.2.1.6. Example HTTP request
1.7.2.1.6.1. Request body
1.7.2.2. Query all applications
GET /app.k8s.io/v1beta1/namespaces/{namespace}/applications
GET /app.k8s.io/v1beta1/namespaces/{namespace}/applications1.7.2.2.1. Description
Query your applications for more details.
1.7.2.2.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.7.2.2.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.7.2.2.4. Consumes
- 
									application/yaml
1.7.2.2.5. Tags
- applications.app.k8s.io
1.7.2.3. Query a single application
GET /app.k8s.io/v1beta1/namespaces/{namespace}/applications/{application_name}
GET /app.k8s.io/v1beta1/namespaces/{namespace}/applications/{application_name}1.7.2.3.1. Description
Query a single application for more details.
1.7.2.3.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											application_name | Name of the application that you wan to query. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.7.2.3.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.7.2.3.4. Tags
- applications.app.k8s.io
1.7.2.4. Delete a application
DELETE /app.k8s.io/v1beta1/namespaces/{namespace}/applications/{application_name}
DELETE /app.k8s.io/v1beta1/namespaces/{namespace}/applications/{application_name}1.7.2.4.1. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											application_name | Name of the application that you want to delete. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.7.2.4.2. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.7.2.4.3. Tags
- applications.app.k8s.io
1.7.3. Definitions
1.7.3.1. Application
| Name | Schema | 
|---|---|
| 
										apiVersion | string | 
| 
										kind | string | 
| 
										metadata | object | 
| 
										spec | 
spec
| Name | Schema | 
|---|---|
| 
										assemblyPhase | string | 
| 
										componentKinds | < object > array | 
| 
										descriptor | |
| 
										info | < info > array | 
| 
										selector | object | 
descriptor
| Name | Schema | 
|---|---|
| 
										description | string | 
| 
										icons | < icons > array | 
| 
										keywords | < string > array | 
| 
										links | < links > array | 
| 
										maintainers | < maintainers > array | 
| 
										notes | string | 
| 
										owners | < owners > array | 
| 
										type | string | 
| 
										version | string | 
icons
| Name | Schema | 
|---|---|
| 
										size | string | 
| 
										src | string | 
| 
										type | string | 
links
| Name | Schema | 
|---|---|
| 
										description | string | 
| 
										url | string | 
maintainers
| Name | Schema | 
|---|---|
| 
										email | string | 
| 
										name | string | 
| 
										url | string | 
owners
| Name | Schema | 
|---|---|
| 
										email | string | 
| 
										name | string | 
| 
										url | string | 
info
| Name | Schema | 
|---|---|
| 
										name | string | 
| 
										type | string | 
| 
										value | string | 
| 
										valueFrom | 
valueFrom
| Name | Schema | 
|---|---|
| 
										configMapKeyRef | |
| 
										ingressRef | |
| 
										secretKeyRef | |
| 
										serviceRef | |
| 
										type | string | 
configMapKeyRef
| Name | Schema | 
|---|---|
| 
										apiVersion | string | 
| 
										fieldPath | string | 
| 
										key | string | 
| 
										kind | string | 
| 
										name | string | 
| 
										namespace | string | 
| 
										resourceVersion | string | 
| 
										uid | string | 
ingressRef
| Name | Schema | 
|---|---|
| 
										apiVersion | string | 
| 
										fieldPath | string | 
| 
										host | string | 
| 
										kind | string | 
| 
										name | string | 
| 
										namespace | string | 
| 
										path | string | 
| 
										resourceVersion | string | 
| 
										uid | string | 
secretKeyRef
| Name | Schema | 
|---|---|
| 
										apiVersion | string | 
| 
										fieldPath | string | 
| 
										key | string | 
| 
										kind | string | 
| 
										name | string | 
| 
										namespace | string | 
| 
										resourceVersion | string | 
| 
										uid | string | 
serviceRef
| Name | Schema | 
|---|---|
| 
										apiVersion | string | 
| 
										fieldPath | string | 
| 
										kind | string | 
| 
										name | string | 
| 
										namespace | string | 
| 
										path | string | 
| 
										port | integer (int32) | 
| 
										resourceVersion | string | 
| 
										uid | string | 
1.8. Helm API
1.8.1. Overview
This documentation is for the HelmRelease resource for Red Hat Advanced Cluster Management for Kubernetes. The HelmRelease resource has four possible requests: create, query, delete and update.
1.8.1.1. Version information
Version : 2.2.0
1.8.1.2. Contact information
Contact Email : apiteam@swagger.io
1.8.1.3. License information
						License : Apache 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0.html
Terms of service : http://swagger.io/terms/
					
1.8.1.4. URI scheme
						BasePath : /kubernetes/apis
Schemes : HTTPS
					
1.8.1.5. Tags
- helmreleases.apps.open-cluster-management.io : Create and manage helmreleases
1.8.1.6. External Docs
						Description : Find out more about Swagger.
URL : http://swagger.io
					
1.8.2. Paths
1.8.2.1. Create a helmrelease
POST /apps.open-cluster-management.io/v1/namespaces/{namespace}/helmreleases
POST /apps.open-cluster-management.io/v1/namespaces/{namespace}/helmreleases1.8.2.1.1. Description
Create a helmrelease.
1.8.2.1.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
| Body | 
											body | Parameters describing the helmrelease to be created. | 
1.8.2.1.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.8.2.1.4. Consumes
- 
									application/yaml
1.8.2.1.5. Tags
- helmreleases.apps.open-cluster-management.io
1.8.2.1.6. Example HTTP request
1.8.2.1.6.1. Request body
1.8.2.2. Query all helmreleases
GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/helmreleases
GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/helmreleases1.8.2.2.1. Description
Query your helmreleases for more details.
1.8.2.2.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.8.2.2.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.8.2.2.4. Consumes
- 
									application/yaml
1.8.2.2.5. Tags
- helmreleases.apps.open-cluster-management.io
1.8.2.3. Query a single helmrelease
GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/helmreleases/{helmrelease_name}
GET /apps.open-cluster-management.io/v1/namespaces/{namespace}/helmreleases/{helmrelease_name}1.8.2.3.1. Description
Query a single helmrelease for more details.
1.8.2.3.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											helmrelease_name | Name of the helmrelease that you wan to query. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.8.2.3.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.8.2.3.4. Tags
- helmreleases.apps.open-cluster-management.io
1.8.2.4. Delete a helmrelease
DELETE /apps.open-cluster-management.io/v1/namespaces/{namespace}/helmreleases/{helmrelease_name}
DELETE /apps.open-cluster-management.io/v1/namespaces/{namespace}/helmreleases/{helmrelease_name}1.8.2.4.1. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											helmrelease_name | Name of the helmrelease that you want to delete. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.8.2.4.2. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.8.2.4.3. Tags
- helmreleases.apps.open-cluster-management.io
1.8.3. Definitions
1.8.3.1. HelmRelease
| Name | Schema | 
|---|---|
| 
										apiVersion | string | 
| 
										kind | string | 
| 
										metadata | object | 
| 
										repo | |
| 
										spec | object | 
| 
										status | 
repo
| Name | Schema | 
|---|---|
| 
										chartName | string | 
| 
										configMapRef | |
| 
										secretRef | |
| 
										source | |
| 
										version | string | 
configMapRef
| Name | Schema | 
|---|---|
| 
										apiVersion | string | 
| 
										fieldPath | string | 
| 
										kind | string | 
| 
										name | string | 
| 
										namespace | string | 
| 
										resourceVersion | string | 
| 
										uid | string | 
secretRef
| Name | Schema | 
|---|---|
| 
										apiVersion | string | 
| 
										fieldPath | string | 
| 
										kind | string | 
| 
										name | string | 
| 
										namespace | string | 
| 
										resourceVersion | string | 
| 
										uid | string | 
source
github
| Name | Schema | 
|---|---|
| 
										branch | string | 
| 
										chartPath | string | 
| 
										urls | < string > array | 
helmRepo
| Name | Schema | 
|---|---|
| 
										urls | < string > array | 
status
| Name | Schema | 
|---|---|
| 
										conditions | < conditions > array | 
| 
										deployedRelease | 
conditions
| Name | Schema | 
|---|---|
| 
										lastTransitionTime | string (date-time) | 
| 
										message | string | 
| 
										reason | string | 
| 
										status | string | 
| 
										type | string | 
deployedRelease
| Name | Schema | 
|---|---|
| 
										manifest | string | 
| 
										name | string | 
1.9. Policy API
1.9.1. Overview
This documentation is for the Policy resource for Red Hat Advanced Cluster Management for Kubernetes. The Policy resource has four possible requests: create, query, delete and update.
1.9.1.1. Version information
Version : 2.2.0
1.9.1.2. Contact information
Contact Email : apiteam@swagger.io
1.9.1.3. License information
						License : Apache 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0.html
Terms of service : http://swagger.io/terms/
					
1.9.1.4. URI scheme
						BasePath : /kubernetes/apis
Schemes : HTTPS
					
1.9.1.5. Tags
- policy.open-cluster-management.io/v1 : Create and manage policies
1.9.1.6. External Docs
						Description : Find out more about Swagger.
URL : http://swagger.io
					
1.9.2. Paths
1.9.2.1. Create a policy
POST /policy.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}
POST /policy.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}1.9.2.1.1. Description
Create a policy.
1.9.2.1.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
| Body | 
											body | Parameters describing the policy to be created. | 
1.9.2.1.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.9.2.1.4. Consumes
- 
									application/json
1.9.2.1.5. Tags
- policy.open-cluster-management.io
1.9.2.1.6. Example HTTP request
1.9.2.1.6.1. Request body
1.9.2.2. Query all policies
GET /policy.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}
GET /policy.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}1.9.2.2.1. Description
Query your policies for more details.
1.9.2.2.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to apply the policy to, for example, default. | string | 
1.9.2.2.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.9.2.2.4. Consumes
- 
									application/json
1.9.2.2.5. Tags
- policy.open-cluster-management.io
1.9.2.3. Query a single policy
GET /policy.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}
GET /policy.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}1.9.2.3.1. Description
Query a single policy for more details.
1.9.2.3.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											policy_name | Name of the policy that you want to query. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.9.2.3.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.9.2.3.4. Tags
- policy.open-cluster-management.io
1.9.2.4. Delete a policy
DELETE /policy.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}
DELETE /policy.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}1.9.2.4.1. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											policy_name | Name of the policy that you want to delete. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.9.2.4.2. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.9.2.4.3. Tags
- policy.open-cluster-management.io
1.9.3. Definitions
1.9.3.1. Policy
| Name | Description | Schema | 
|---|---|---|
| 
										apiVersion | The versioned schema of Policy. | string | 
| 
										kind | String value that represents the REST resource. | string | 
| 
										metadata | Describes rules that define the policy. | object | 
spec
| Name | Description | Schema | 
|---|---|---|
| 
										remediationAction | Value that represents how violations are handled as defined in the resource. | string | 
| 
										namespaceSelector | Value that represents which namespaces the policy is applied. | string | 
policy-templates
| Name | Description | Schema | 
|---|---|---|
| 
										apiVersion | The versioned schema of Policy. | string | 
| 
										kind | String value that represents the REST resource. | string | 
| 
										metadata | Describes rules that define the policy. | object | 
| complianceType | Used to list expected behavior for roles and other Kubernetes object that must be evaluated or applied to the managed clusters. | string | 
| 
										clusterConditions | Section to define labels. | string | 
| 
										rules | string | 
clusterConditions
| Name | Description | Schema | 
|---|---|---|
| 
										matchLabels | The label that is required for the policy to be applied to a namespace. | object | 
| 
										cloud | The label that is required for the policy to be applied to a cloud provider. | string | 
rules
| Name | Description | Schema | 
|---|---|---|
| 
										apiGroups | List of APIs that the rule applies to. | string | 
| 
										resources | A list of resource types. | object | 
| 
										verbs | A list of verbs. | string | 
1.10. Observability API
1.10.1. Overview
This documentation is for the MultiClusterObservability resource for Red Hat Advanced Cluster Management for Kubernetes. The MultiClusterObservability resource has four possible requests: create, query, delete and update.
1.10.1.1. Version information
Version : 2.2.0
1.10.1.2. Contact information
Contact Email : apiteam@swagger.io
1.10.1.3. License information
						License : Apache 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0.html
Terms of service : http://swagger.io/terms/
					
1.10.1.4. URI scheme
						BasePath : /kubernetes/apis
Schemes : HTTPS
					
1.10.1.5. Tags
- observability.open-cluster-management.io : Create and manage multiclusterobservabilities
1.10.1.6. External Docs
						Description : Find out more about Swagger.
URL : http://swagger.io
					
1.10.2. Paths
1.10.2.1. Create a multiclusterobservability resource
POST /apis/observability.open-cluster-management.io/v1beta1/multiclusterobservabilities
POST /apis/observability.open-cluster-management.io/v1beta1/multiclusterobservabilities1.10.2.1.1. Description
Create a MultiClusterObservability resource.
1.10.2.1.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Body | 
											body | Parameters describing the MultiClusterObservability resource to be created. | 
1.10.2.1.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.10.2.1.4. Consumes
- 
									application/yaml
1.10.2.1.5. Tags
- observability.apps.open-cluster-management.io
1.10.2.1.6. Example HTTP request
1.10.2.1.6.1. Request body
1.10.2.2. Query all multiclusterobservabilities
GET /apis/observability.open-cluster-management.io/v1beta1/multiclusterobservabilities
GET /apis/observability.open-cluster-management.io/v1beta1/multiclusterobservabilities1.10.2.2.1. Description
Query your MultiClusterObservability resources for more details.
1.10.2.2.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
1.10.2.2.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.10.2.2.4. Consumes
- 
									application/yaml
1.10.2.2.5. Tags
- observability.apps.open-cluster-management.io
1.10.2.3. Query a single multiclusterobservability
GET /apis/observability.open-cluster-management.io/v1beta1/multiclusterobservabilities/{multiclusterobservability_name}
GET /apis/observability.open-cluster-management.io/v1beta1/multiclusterobservabilities/{multiclusterobservability_name}1.10.2.3.1. Description
Query a single MultiClusterObservability resource for more details.
1.10.2.3.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											multiclusterobservability_name | Name of the multiclusterobservability that you want to query. | string | 
1.10.2.3.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.10.2.3.4. Tags
- observability.apps.open-cluster-management.io
1.10.2.4. Delete a multiclusterobservability resource
DELETE /apis/observability.open-cluster-management.io/v1beta1/multiclusterobservabilities/{multiclusterobservability_name}
DELETE /apis/observability.open-cluster-management.io/v1beta1/multiclusterobservabilities/{multiclusterobservability_name}1.10.2.4.1. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											multiclusterobservability_name | Name of the multiclusterobservability that you want to delete. | string | 
1.10.2.4.2. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.10.2.4.3. Tags
- observability.apps.open-cluster-management.io
1.10.3. Definitions
1.10.3.1. MultiClusterObservability
| Name | Description | Schema | 
|---|---|---|
| 
										apiVersion | The versioned schema of the MultiClusterObservability. | string | 
| 
										kind | String value that represents the REST resource, MultiClusterObservability. | string | 
| 
										metadata | Describes rules that define the policy. | object | 
spec
| Name | Description | Schema | 
|---|---|---|
| 
										availabilityConfig | 
										The parameter used to select high-availability support. This provides support in the case of a failover, and consumes more resources. | string | 
| 
										enableDownSampling | 
										Enable or disable the downsample. Default value is  | boolean | 
| 
										imagePullPolicy | Pull policy for the Observability images. | string | 
| 
										imagePullSecret | Pull secret for the Observability images. | string | 
| 
										nodeSelector | Supports node selection constraints | object | 
| 
										observabilityAddonSpec | The global settings for all managed clusters, which have the add-on enabled. | |
| 
										retentionResolution1h | 
										The amount of time to retain samples of resolution 2 (1 hour) in a bucket. Default value is 30 days ( | string | 
| 
										retentionResolution5m | 
										The amount of time to retain samples of resolution 1 (5 minutes) in a bucket. Default value is 14 days ( | string | 
| 
										retentionResolutionRaw | The amount of time to retain raw samples of resolution in a bucket. | string | 
| 
										storageConfigObject | Specifies the storage to be used by Observability. | 
observabilityAddonSpec
| Name | Description | Schema | 
|---|---|---|
| 
										enableMetrics | 
										Indicates if the observability add-on sends metrics to the hub cluster. Default value is  | boolean | 
| 
										interval | 
										Interval for when the observability add-on sends metrics to the hub cluster. Default value is 30 seconds ( | integer | 
storageConfigObject
| Name | Description | Schema | 
|---|---|---|
| 
										metricObjectStorage | Object store to configure secrets for metrics. | |
| 
										statefulSetSize | 
										The amount of storage that is applied to the Observability StatefulSets, i.e. Thanos store, rule, compact, and receiver. Default value is  | string | 
| 
										statefulSetStorageClass | 
										Specify the  | string | 
metricObjectStorage
| Name | Description | Schema | 
|---|---|---|
| 
										key | The key of the secret to select from. Must be a valid secret key. | string | 
| 
										name | 
										Name of the  | string | 
1.11. Search customization API
1.11.1. Overview
This documentation is for the searchCustomization resource for Red Hat Advanced Cluster Management for Kubernetes. The SearchCustomization resource has four possible requests: create, query, delete and update.
1.11.1.1. Version information
Version : 2.2.0
1.11.1.2. Contact information
Contact Email : apiteam@swagger.io
1.11.1.3. License information
						License : Apache 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0.html
Terms of service : http://swagger.io/terms/
					
1.11.1.4. URI scheme
						BasePath : /kubernetes/apis
Schemes : HTTPS
					
1.11.1.5. Tags
- search.open-cluster-management.io/v1 : Create and manage persistence volumes
1.11.1.6. External Docs
						Description : Find out more about Swagger.
URL : http://swagger.io
					
1.11.2. Paths
1.11.2.1. Create a searchCustomization
POST /search.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}
POST /search.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}1.11.2.1.1. Description
Create a searchCustomization.
1.11.2.1.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
| Body | 
											body | Parameters describing the policy to be created. | 
1.11.2.1.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.11.2.1.4. Consumes
- 
									searchCustomization/json
1.11.2.1.5. Tags
- search.open-cluster-management.io
1.11.2.1.6. Example HTTP request
1.11.2.1.6.1. Request body
1.11.2.2. Query searchCustomization
GET /search.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}
GET /search.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}1.11.2.2.1. Description
Query your searchCustomization for more details.
1.11.2.2.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to apply the policy to, for example, default. | string | 
1.11.2.2.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.11.2.2.4. Consumes
- 
									searchCustomization/json
1.11.2.2.5. Tags
- search.open-cluster-management.io
1.11.2.3. Query a single policy
GET /search.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}
GET /search.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}1.11.2.3.1. Description
Query a single searchCustomization for more details.
1.11.2.3.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											policy_name | Name of the policy that you want to query. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.11.2.3.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.11.2.3.4. Tags
- search.open-cluster-management.io
1.11.2.4. Delete a searchCustomization
DELETE /search.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}
DELETE /search.open-cluster-management.io/v1/v1alpha1/namespaces/{namespace}/policies/{policy_name}1.11.2.4.1. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											policy_name | Name of the policy that you want to delete. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.11.2.4.2. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.11.2.4.3. Tags
- search.open-cluster-management.io
1.11.3. Definitions
1.11.3.1. SearchCustomization
| Name | Description | Schema | 
|---|---|---|
| 
										apiVersion | The versioned schema of SearchCustomization. | string | 
| 
										kind | String value that represents the REST resource. | string | 
| 
										metadata | Describes rules that define the policy. | object | 
spec
| Name | Description | Schema | 
|---|---|---|
| 
										remediationAction | Value that represents how violations are handled as defined in the resource. | string | 
| 
										namespaces | 
										Value that represents which namespaces to  | string | 
policy-templates
| Name | Description | Schema | 
|---|---|---|
| 
										apiVersion | The versioned schema of SearchCustomization. | string | 
| 
										kind | String value that represents the REST resource. | string | 
| 
										metadata | Describes rules that define the policy. | object | 
| complianceType | Used to list expected behavior for roles and other Kubernetes object that must be evaluated or applied to the managed clusters. | string | 
| 
										clusterConditions | Section to define labels. | string | 
| 
										rules | string | 
clusterConditions
| Name | Description | Schema | 
|---|---|---|
| 
										matchLabels | The label that is required for the policy to be applied to a namespace. | object | 
| 
										cloud | The label that is required for the policy to be applied to a cloud provider. | string | 
rules
| Name | Description | Schema | 
|---|---|---|
| 
										apiGroups | List of APIs that the rule applies to. | string | 
| 
										resources | A list of resource types. | object | 
| 
										verbs | A list of verbs. | string | 
1.12. MultiClusterHub API
1.12.1. Overview
This documentation is for the MultiClusterHub resource for Red Hat Advanced Cluster Management for Kubernetes. MultiClusterHub resource has four possible requests: create, query, delete and update.
1.12.1.1. Version information
Version : 2.2.0
1.12.1.2. Contact information
Contact Email : apiteam@swagger.io
1.12.1.3. License information
						License : Apache 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0.html
Terms of service : http://swagger.io/terms/
					
1.12.1.4. URI scheme
						BasePath : /kubernetes/apis
Schemes : HTTPS
					
1.12.1.5. Tags
- multiclusterhubs.operator.open-cluster-management.io : Create and manage multicluster hub operators
1.12.1.6. External Docs
						Description : Find out more about Swagger.
URL : http://swagger.io
					
1.12.2. Paths
1.12.2.1. Create a MultiClusterHub resource
POST /operator.open-cluster-management.io/v1beta1/namespaces/{namespace}/mch
POST /operator.open-cluster-management.io/v1beta1/namespaces/{namespace}/mch1.12.2.1.1. Description
Create a MultiClusterHub resource to define the configuration for an instance of the multicluster hub.
1.12.2.1.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
| Body | 
											body | Parameters describing the multicluster hub to be created. | 
1.12.2.1.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.12.2.1.4. Consumes
- 
									multiclusterhubs/yaml
1.12.2.1.5. Tags
- multiclusterhubs.operator.open-cluster-management.io
1.12.2.1.6. Example HTTP request
1.12.2.1.6.1. Request body
1.12.2.2. Query all MultiClusterHubs
GET /operator.open-cluster-management.io/v1beta1/namespaces/{namespace}/operator
GET /operator.open-cluster-management.io/v1beta1/namespaces/{namespace}/operator1.12.2.2.1. Description
Query your multicluster hub operator for more details.
1.12.2.2.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.12.2.2.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.12.2.2.4. Consumes
- 
									operator/yaml
1.12.2.2.5. Tags
- multiclusterhubs.operator.open-cluster-management.io
1.12.2.3. Query a MultiClusterHub operator
GET /operator.open-cluster-management.io/v1beta1/namespaces/{namespace}/operator/{multiclusterhub_name}
GET /operator.open-cluster-management.io/v1beta1/namespaces/{namespace}/operator/{multiclusterhub_name}1.12.2.3.1. Description
Query a single multicluster hub operator for more details.
1.12.2.3.2. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											application_name | Name of the application that you want to query. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.12.2.3.3. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.12.2.3.4. Tags
- multiclusterhubs.operator.open-cluster-management.io
1.12.2.4. Delete a MultiClusterHub operator
DELETE /operator.open-cluster-management.io/v1beta1/namespaces/{namespace}/operator/{multicllusterhub_name}
DELETE /operator.open-cluster-management.io/v1beta1/namespaces/{namespace}/operator/{multicllusterhub_name}1.12.2.4.1. Parameters
| Type | Name | Description | Schema | 
|---|---|---|---|
| Header | 
											COOKIE | Authorization: Bearer {ACCESS_TOKEN} ; ACCESS_TOKEN is the user access token. | string | 
| Path | 
											application_name | Name of the multicluster hub operator that you want to delete. | string | 
| Path | 
											namespace | Namespace that you want to use, for example, default. | string | 
1.12.2.4.2. Responses
| HTTP Code | Description | Schema | 
|---|---|---|
| 200 | Success | No Content | 
| 403 | Access forbidden | No Content | 
| 404 | Resource not found | No Content | 
| 500 | Internal service error | No Content | 
| 503 | Service unavailable | No Content | 
1.12.2.4.3. Tags
- multiclusterhubs.operator.open-cluster-management.io
1.12.3. Definitions
1.12.3.1. Multicluster hub operator
| Name | Description | Schema | 
|---|---|---|
| 
										apiVersion | The versioned schema of the MultiClusterHub. | string | 
| 
										kind | String value that represents the REST resource. | string | 
| 
										metadata | Describes rules that define the resource. | object | 
| 
										spec | The resource specification. | 
spec
| availabilityConfig optional | Specifies deployment replication for improved availability. The default value is High. | string | 
|---|---|---|
| 
										customCAConfigmap | Provide the customized OpenShift default ingress CA certificate to Red Hat Advanced Cluster Management. | string | 
| 
										disableHubSelfManagement | Disable automatic import of the hub cluster as a managed cluster. | boolean | 
| 
										disableUpdateClusterImageSets | Disable automatic update of ClusterImageSets. | boolean | 
| 
										hive | (Deprecated) An object that overrides for the default HiveConfig specification. | |
| 
										imagePullSecret | Overrides pull secret for accessing MultiClusterHub operand and endpoint images. | string | 
| 
										ingress | Configuration options for ingress management. | |
| 
										nodeSelector | Set the node selectors. | string | 
| 
										separateCertificateManagement | 
										(Deprecated) Install  | boolean | 
hive
| additionalCertificateAuthorities optional | (Deprecated) A list of references to secrets in the hivenamespace 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. | object | 
|---|---|---|
| 
										backup | (Deprecated) Specifies the configuration for backup integration. If absent, backup integration is disabled. | |
| 
										externalDNS | 
										(Deprecated) Specifies configuration for  | object | 
| 
										failedProvisionConfig | (Deprecated) Used to configure settings related to handling provision failures. | |
| 
										globalPullSecret | 
										(Deprecated) Used to specify a pull secret that is used globally by all of the cluster deployments. For each cluster deployment, the contents of  | object | 
| 
										maintenanceMode | 
										(Deprecated) Can be set to true to disable the hive controllers in situations where you need to ensure nothing is running that adds or acts upon finalizers on Hive types. This should rarely be needed. Sets replicas to  | boolean | 
ingress
| sslCiphers optional | List of SSL ciphers enabled for management ingress. Defaults to full list of supported ciphers. | string | 
|---|
backup
| minBackupPeriodSeconds optional | (Deprecated) Specifies that a minimum of MinBackupPeriodSecondsoccurs in between each backup. This is used to rate limit backups. This potentially batches together multiple changes into one backup. No backups are lost as changes happen during this interval are queued up and result in a backup happening once the interval has been completed. | integer | 
|---|---|---|
| 
										velero | (Deprecated) Velero specifies configuration for the Velero backup integration. | object | 
failedProvisionConfig
| skipGatherLogs optional | (Deprecated) 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. | boolean | 
|---|
status
| components optional | The components of the status configuration. | object | 
|---|---|---|
| 
										conditions | Contains the different conditions for the multicluster hub. | |
| 
										desiredVersion | Indicates the desired version. | string | 
| 
										phase | 
										Represents the active phase of the MultiClusterHub resource. The values that are used for this parameter are:  | string | 
conditions
| lastTransitionTime optional | The last time the condition changed from one status to another. | string | 
|---|---|---|
| 
										lastUpdateTime | The last time this condition was updated. | string | 
| 
										message | Message is a human-readable message indicating details about the last status change. | string | 
| 
										reason | A brief reason for why the condition status changed. | string | 
| 
										status | The status of the condition. | string | 
| 
										type | The type of the cluster condition. | string | 
StatusConditions
| kind required | The resource kindthat represents this status. | string | 
|---|---|---|
| 
										available | Indicates whether this component is properly running. | boolean | 
| 
										lastTransitionTime | The last time the condition changed from one status to another. | metav1.time | 
| 
										lastUpdateTime | The last time this condition was updated. | metav1.time | 
| 
										message | Message is a human-readable message indicating details about the last status change. | string | 
| 
										reason | A brief reason for why the condition status changed. | string | 
| 
										status | The status of the condition. | string | 
| 
										type | The type of the cluster condition. | string |