"description":"HorizontalPodAutoscalerList is a list of HorizontalPodAutoscalers.",
"description":"list of horizontal pod autoscaler objects.",
"required":[
"required":[
"items"
"items"
],
],
...
@@ -2098,7 +2098,7 @@
...
@@ -2098,7 +2098,7 @@
"items":{
"items":{
"$ref":"v1beta1.HorizontalPodAutoscaler"
"$ref":"v1beta1.HorizontalPodAutoscaler"
},
},
"description":"Items is the list of HorizontalPodAutoscalers."
"description":"list of horizontal pod autoscaler objects."
}
}
}
}
},
},
...
@@ -2118,7 +2118,7 @@
...
@@ -2118,7 +2118,7 @@
},
},
"v1beta1.HorizontalPodAutoscaler":{
"v1beta1.HorizontalPodAutoscaler":{
"id":"v1beta1.HorizontalPodAutoscaler",
"id":"v1beta1.HorizontalPodAutoscaler",
"description":"HorizontalPodAutoscaler represents the configuration of a horizontal pod autoscaler.",
"description":"configuration of a horizontal pod autoscaler.",
"properties":{
"properties":{
"kind":{
"kind":{
"type":"string",
"type":"string",
...
@@ -2134,11 +2134,11 @@
...
@@ -2134,11 +2134,11 @@
},
},
"spec":{
"spec":{
"$ref":"v1beta1.HorizontalPodAutoscalerSpec",
"$ref":"v1beta1.HorizontalPodAutoscalerSpec",
"description":"Spec defines the behaviour of autoscaler. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status."
"description":"behaviour of autoscaler. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status."
},
},
"status":{
"status":{
"$ref":"v1beta1.HorizontalPodAutoscalerStatus",
"$ref":"v1beta1.HorizontalPodAutoscalerStatus",
"description":"Status represents the current information about the autoscaler."
"description":"current information about the autoscaler."
}
}
}
}
},
},
...
@@ -2200,31 +2200,29 @@
...
@@ -2200,31 +2200,29 @@
},
},
"v1beta1.HorizontalPodAutoscalerSpec":{
"v1beta1.HorizontalPodAutoscalerSpec":{
"id":"v1beta1.HorizontalPodAutoscalerSpec",
"id":"v1beta1.HorizontalPodAutoscalerSpec",
"description":"HorizontalPodAutoscalerSpec is the specification of a horizontal pod autoscaler.",
"description":"specification of a horizontal pod autoscaler.",
"required":[
"required":[
"scaleRef",
"scaleRef",
"minReplicas",
"maxReplicas"
"maxReplicas",
"target"
],
],
"properties":{
"properties":{
"scaleRef":{
"scaleRef":{
"$ref":"v1beta1.SubresourceReference",
"$ref":"v1beta1.SubresourceReference",
"description":"ScaleRef is a reference to Scale subresource. HorizontalPodAutoscaler will learn the current resource consumption from its status, and will set the desired number of pods by modyfying its spec."
"description":"reference to Scale subresource; horizontal pod autoscaler will learn the current resource consumption from its status, and will set the desired number of pods by modifying its spec."
},
},
"minReplicas":{
"minReplicas":{
"type":"integer",
"type":"integer",
"format":"int32",
"format":"int32",
"description":"MinReplicas is the lower limit for the number of pods that can be set by the autoscaler."
"description":"lower limit for the number of pods that can be set by the autoscaler, default 1."
},
},
"maxReplicas":{
"maxReplicas":{
"type":"integer",
"type":"integer",
"format":"int32",
"format":"int32",
"description":"MaxReplicas is the upper limit for the number of pods that can be set by the autoscaler. It cannot be smaller than MinReplicas."
"description":"upper limit for the number of pods that can be set by the autoscaler; cannot be smaller than MinReplicas."
},
},
"target":{
"cpuUtilization":{
"$ref":"v1beta1.ResourceConsumption",
"$ref":"v1beta1.CPUTargetUtilization",
"description":"Target is the target average consumption of the given resource that the autoscaler will try to maintain by adjusting the desired number of pods. Currently two types of resources are supported: \"cpu\" and \"memory\"."
"description":"target average CPU utilization (represented as a percentage of requested CPU) over all the pods; if not specified it defaults to the target CPU utilization at 80% of the requested resources."
}
}
}
}
},
},
...
@@ -2254,46 +2252,50 @@
...
@@ -2254,46 +2252,50 @@
}
}
}
}
},
},
"v1beta1.ResourceConsumption":{
"v1beta1.CPUTargetUtilization":{
"id":"v1beta1.ResourceConsumption",
"id":"v1beta1.CPUTargetUtilization",
"description":"ResourceConsumption is an object for specifying average resource consumption of a particular resource.",
"required":[
"targetPercentage"
],
"properties":{
"properties":{
"resource":{
"targetPercentage":{
"type":"string",
"type":"integer",
"description":"Resource specifies either the name of the target resource when present in the spec, or the name of the observed resource when present in the status."
"format":"int32",
},
"description":"fraction of the requested CPU that should be utilized/used, e.g. 70 means that 70% of the requested CPU should be in use."
"quantity":{
"type":"string",
"description":"Quantity specifies either the target average consumption of the resource when present in the spec, or the observed average consumption when present in the status."
}
}
}
}
},
},
"v1beta1.HorizontalPodAutoscalerStatus":{
"v1beta1.HorizontalPodAutoscalerStatus":{
"id":"v1beta1.HorizontalPodAutoscalerStatus",
"id":"v1beta1.HorizontalPodAutoscalerStatus",
"description":"HorizontalPodAutoscalerStatus contains the current status of a horizontal pod autoscaler",
"description":"current status of a horizontal pod autoscaler",
"required":[
"required":[
"currentReplicas",
"currentReplicas",
"desiredReplicas",
"desiredReplicas"
"currentConsumption"
],
],
"properties":{
"properties":{
"observedGeneration":{
"type":"integer",
"format":"int64",
"description":"most recent generation observed by this autoscaler."
},
"lastScaleTime":{
"type":"string",
"description":"last time the HorizontalPodAutoscaler scaled the number of pods; used by the autoscaler to control how often the number of pods is changed."
},
"currentReplicas":{
"currentReplicas":{
"type":"integer",
"type":"integer",
"format":"int32",
"format":"int32",
"description":"CurrentReplicas is the number of replicas of pods managed by this autoscaler."
"description":"current number of replicas of pods managed by this autoscaler."
},
},
"desiredReplicas":{
"desiredReplicas":{
"type":"integer",
"type":"integer",
"format":"int32",
"format":"int32",
"description":"DesiredReplicas is the desired number of replicas of pods managed by this autoscaler."
"description":"desired number of replicas of pods managed by this autoscaler."
},
},
"currentConsumption":{
"currentCPUUtilizationPercentage":{
"$ref":"v1beta1.ResourceConsumption",
"type":"integer",
"description":"CurrentConsumption is the current average consumption of the given resource that the autoscaler will try to maintain by adjusting the desired number of pods. Two types of resources are supported: \"cpu\" and \"memory\"."
"format":"int32",
},
"description":"current average CPU utilization over all pods, represented as a percentage of requested CPU, e.g. 70 means that an average pod is using now 70% of its requested CPU."
"lastScaleTimestamp":{
"type":"string",
"description":"LastScaleTimestamp is the last time the HorizontalPodAutoscaler scaled the number of pods. This is used by the autoscaler to controll how often the number of pods is changed."
// ScaleSpec describes the attributes a Scale subresource
// describes the attributes of a scale subresource
typeScaleSpecstruct{
typeScaleSpecstruct{
// Replicas is the number of desired replicas. More info: http://releases.k8s.io/HEAD/docs/user-guide/replication-controller.md#what-is-a-replication-controller"
// desired number of instances for the scaled object.
Replicasint`json:"replicas,omitempty"`
Replicasint`json:"replicas,omitempty"`
}
}
// ScaleStatus represents the current status of a Scale subresource.
// represents the current status of a scale subresource.
typeScaleStatusstruct{
typeScaleStatusstruct{
// Replicas is the number of actual replicas. More info: http://releases.k8s.io/HEAD/docs/user-guide/replication-controller.md#what-is-a-replication-controller
// actual number of observed instances of the scaled object.
Replicasint`json:"replicas"`
Replicasint`json:"replicas"`
// Selector is a label query over pods that should match the replicas count. If it is empty, it is defaulted to labels on Pod template; More info: http://releases.k8s.io/HEAD/docs/user-guide/labels.md#label-selectors
// label query over pods that should match the replicas count. More info: http://releases.k8s.io/HEAD/docs/user-guide/labels.md#label-selectors
@@ -17,37 +17,36 @@ limitations under the License.
...
@@ -17,37 +17,36 @@ limitations under the License.
packagev1beta1
packagev1beta1
import(
import(
"k8s.io/kubernetes/pkg/api/resource"
"k8s.io/kubernetes/pkg/api/unversioned"
"k8s.io/kubernetes/pkg/api/unversioned"
"k8s.io/kubernetes/pkg/api/v1"
"k8s.io/kubernetes/pkg/api/v1"
"k8s.io/kubernetes/pkg/util"
"k8s.io/kubernetes/pkg/util"
)
)
// ScaleSpec describes the attributes a Scale subresource
// describes the attributes of a scale subresource
typeScaleSpecstruct{
typeScaleSpecstruct{
// Replicas is the number of desired replicas. More info: http://releases.k8s.io/HEAD/docs/user-guide/replication-controller.md#what-is-a-replication-controller"
// desired number of instances for the scaled object.
Replicasint`json:"replicas,omitempty"`
Replicasint`json:"replicas,omitempty"`
}
}
// ScaleStatus represents the current status of a Scale subresource.
// represents the current status of a scale subresource.
typeScaleStatusstruct{
typeScaleStatusstruct{
// Replicas is the number of actual replicas. More info: http://releases.k8s.io/HEAD/docs/user-guide/replication-controller.md#what-is-a-replication-controller
// actual number of observed instances of the scaled object.
Replicasint`json:"replicas"`
Replicasint`json:"replicas"`
// Selector is a label query over pods that should match the replicas count. If it is empty, it is defaulted to labels on Pod template; More info: http://releases.k8s.io/HEAD/docs/user-guide/labels.md#label-selectors
// label query over pods that should match the replicas count. More info: http://releases.k8s.io/HEAD/docs/user-guide/labels.md#label-selectors
// Scale subresource, applicable to ReplicationControllers and (in future) Deployment.
// represents a scaling request for a resource.
typeScalestruct{
typeScalestruct{
unversioned.TypeMeta`json:",inline"`
unversioned.TypeMeta`json:",inline"`
// Standard object metadata; More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata.
// Standard object metadata; More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata.
v1.ObjectMeta`json:"metadata,omitempty"`
v1.ObjectMeta`json:"metadata,omitempty"`
// Spec defines the behavior of the scale. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status.
// defines the behavior of the scale. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status.
SpecScaleSpec`json:"spec,omitempty"`
SpecScaleSpec`json:"spec,omitempty"`
// Status represents the current status of the scale. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status. Read-only.
// current status of the scale. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status. Read-only.
StatusScaleStatus`json:"status,omitempty"`
StatusScaleStatus`json:"status,omitempty"`
}
}
...
@@ -70,66 +69,66 @@ type SubresourceReference struct {
...
@@ -70,66 +69,66 @@ type SubresourceReference struct {
Subresourcestring`json:"subresource,omitempty"`
Subresourcestring`json:"subresource,omitempty"`
}
}
// ResourceConsumption is an object for specifying average resource consumption of a particular resource.
typeCPUTargetUtilizationstruct{
typeResourceConsumptionstruct{
// fraction of the requested CPU that should be utilized/used,
// Resource specifies either the name of the target resource when present in the spec, or the name of the observed resource when present in the status.
// e.g. 70 means that 70% of the requested CPU should be in use.
// Quantity specifies either the target average consumption of the resource when present in the spec, or the observed average consumption when present in the status.
"metadata":"Standard object's metadata. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata For now (experimental api) it is required that the name is set to \"ClusterAutoscaler\" and namespace is \"default\".",
"metadata":"Standard object's metadata. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata For now (experimental api) it is required that the name is set to \"ClusterAutoscaler\" and namespace is \"default\".",
"spec":"Spec defines the desired behavior of this daemon set. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status",
"spec":"Spec defines the desired behavior of this daemon set. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status",
"":"HorizontalPodAutoscalerSpec is the specification of a horizontal pod autoscaler.",
"":"specification of a horizontal pod autoscaler.",
"scaleRef":"ScaleRef is a reference to Scale subresource. HorizontalPodAutoscaler will learn the current resource consumption from its status, and will set the desired number of pods by modyfying its spec.",
"scaleRef":"reference to Scale subresource; horizontal pod autoscaler will learn the current resource consumption from its status, and will set the desired number of pods by modifying its spec.",
"minReplicas":"MinReplicas is the lower limit for the number of pods that can be set by the autoscaler.",
"minReplicas":"lower limit for the number of pods that can be set by the autoscaler, default 1.",
"maxReplicas":"MaxReplicas is the upper limit for the number of pods that can be set by the autoscaler. It cannot be smaller than MinReplicas.",
"maxReplicas":"upper limit for the number of pods that can be set by the autoscaler; cannot be smaller than MinReplicas.",
"target":"Target is the target average consumption of the given resource that the autoscaler will try to maintain by adjusting the desired number of pods. Currently two types of resources are supported: \"cpu\" and \"memory\".",
"cpuUtilization":"target average CPU utilization (represented as a percentage of requested CPU) over all the pods; if not specified it defaults to the target CPU utilization at 80% of the requested resources.",
"":"HorizontalPodAutoscalerStatus contains the current status of a horizontal pod autoscaler",
"":"current status of a horizontal pod autoscaler",
"currentReplicas":"CurrentReplicas is the number of replicas of pods managed by this autoscaler.",
"observedGeneration":"most recent generation observed by this autoscaler.",
"desiredReplicas":"DesiredReplicas is the desired number of replicas of pods managed by this autoscaler.",
"lastScaleTime":"last time the HorizontalPodAutoscaler scaled the number of pods; used by the autoscaler to control how often the number of pods is changed.",
"currentConsumption":"CurrentConsumption is the current average consumption of the given resource that the autoscaler will try to maintain by adjusting the desired number of pods. Two types of resources are supported: \"cpu\" and \"memory\".",
"currentReplicas":"current number of replicas of pods managed by this autoscaler.",
"lastScaleTimestamp":"LastScaleTimestamp is the last time the HorizontalPodAutoscaler scaled the number of pods. This is used by the autoscaler to controll how often the number of pods is changed.",
"desiredReplicas":"desired number of replicas of pods managed by this autoscaler.",
"currentCPUUtilizationPercentage":"current average CPU utilization over all pods, represented as a percentage of requested CPU, e.g. 70 means that an average pod is using now 70% of its requested CPU.",
"":"ResourceConsumption is an object for specifying average resource consumption of a particular resource.",
"resource":"Resource specifies either the name of the target resource when present in the spec, or the name of the observed resource when present in the status.",
"quantity":"Quantity specifies either the target average consumption of the resource when present in the spec, or the observed average consumption when present in the status.",
"":"Spec to control the desired behavior of rolling update.",
"":"Spec to control the desired behavior of rolling update.",
"maxUnavailable":"The maximum number of pods that can be unavailable during the update. Value can be an absolute number (ex: 5) or a percentage of desired pods (ex: 10%). Absolute number is calculated from percentage by rounding up. This can not be 0 if MaxSurge is 0. By default, a fixed value of 1 is used. Example: when this is set to 30%, the old RC can be scaled down to 70% of desired pods immediately when the rolling update starts. Once new pods are ready, old RC can be scaled down further, followed by scaling up the new RC, ensuring that the total number of pods available at all times during the update is at least 70% of desired pods.",
"maxUnavailable":"The maximum number of pods that can be unavailable during the update. Value can be an absolute number (ex: 5) or a percentage of desired pods (ex: 10%). Absolute number is calculated from percentage by rounding up. This can not be 0 if MaxSurge is 0. By default, a fixed value of 1 is used. Example: when this is set to 30%, the old RC can be scaled down to 70% of desired pods immediately when the rolling update starts. Once new pods are ready, old RC can be scaled down further, followed by scaling up the new RC, ensuring that the total number of pods available at all times during the update is at least 70% of desired pods.",
"":"Scale subresource, applicable to ReplicationControllers and (in future) Deployment.",
"":"represents a scaling request for a resource.",
"metadata":"Standard object metadata; More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata.",
"metadata":"Standard object metadata; More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata.",
"spec":"Spec defines the behavior of the scale. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status.",
"spec":"defines the behavior of the scale. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status.",
"status":"Status represents the current status of the scale. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status. Read-only.",
"status":"current status of the scale. More info: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status. Read-only.",
"":"ScaleSpec describes the attributes a Scale subresource",
"":"describes the attributes of a scale subresource",
"replicas":"Replicas is the number of desired replicas. More info: http://releases.k8s.io/HEAD/docs/user-guide/replication-controller.md#what-is-a-replication-controller\"",
"replicas":"desired number of instances for the scaled object.",
"":"ScaleStatus represents the current status of a Scale subresource.",
"":"represents the current status of a scale subresource.",
"replicas":"Replicas is the number of actual replicas. More info: http://releases.k8s.io/HEAD/docs/user-guide/replication-controller.md#what-is-a-replication-controller",
"replicas":"actual number of observed instances of the scaled object.",
"selector":"Selector is a label query over pods that should match the replicas count. If it is empty, it is defaulted to labels on Pod template; More info: http://releases.k8s.io/HEAD/docs/user-guide/labels.md#label-selectors",
"selector":"label query over pods that should match the replicas count. More info: http://releases.k8s.io/HEAD/docs/user-guide/labels.md#label-selectors",