ApplyScalingGroup

接口说明

ApplyScalingGroup目前支持以Kubernetes Deployment资源定义格式快速创建ECI伸缩组。同时支持ECI实例对Kubernetes YAML拓展annotation，更多信息，请参见本文的《支持的annotation列表》。

YAML配置与伸缩组的映射关系：通过YAML中定义的namespace、kind、name三元组映射伸缩组name，一个地域（region）下同一个YAMLl配置只能映射同一个伸缩组。例如：

如果使用默认命名空间（namespace）下name为nginx的Deployment YAML配置，则映射同地域（region）下名称为k8s_default_Deployment_nginx的伸缩组。

基于YAML配置管理伸缩组的逻辑：

• 当YAML配置映射伸缩组存在时，会基于YAML配置更新伸缩组。
• 当YAML配置映射伸缩组不存在时，会基于YAML配置创建对应伸缩组。

注意事项

• 当YAML配置未指定VPC、vSwitch、安全组annotation时，系统会自动创建默认VPC，在该VPC下会创建默认交换机，以及创建弹性伸缩的默认安全组（ess-default-sg）。其中，安全组策略默认开放TCP协议的22、3389端口以及ICMP（IPv4）协议，如果您有其他端口协议需求，可另行调整安全组策略。
• 当使用公网镜像时，需配置开启公网访问能力，设置k8s.aliyun.com/eci-with-eip pod annotation开启EIP功能。
• ApplyScalingGroup应用YAML配置后，伸缩组及伸缩配置会立即生效，如果指定replicas＞0，则会自动创建资源。

支持的annotation列表

更多annotation信息，请参考ECI Pod Annotation 。

请求参数

返回数据

示例

请求示例

http(s)://ess.aliyuncs.com/?Action=ApplyScalingGroup
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&Content=apiVersion: apps/v1 kind: Deployment metadata:   name: nginx-deployment   labels:     app: nginx   spec:     replicas: 3     selector:        matchLabels:         app: nginx     template:       metadata:         labels:           app: nginx         annotations:           k8s.aliyun.com/eip-bandwidth: 10           k8s.aliyun.com/eci-with-eip: true         spec:           containers:           - name: nginx             image: nginx:1.14.2             ports:             - containerPort: 80
&RegionId=cn-hangzhou
&Format=YAML
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ApplyScalingGroupResponse>
    <RequestId>CC107349-57B7-4405-B1BF-9BF5AF7F****</RequestId>
    <ScalingGroupId>asg-bp1igpak5ft1flyp****</ScalingGroupId>
</ApplyScalingGroupResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "CC107349-57B7-4405-B1BF-9BF5AF7F****",
  "ScalingGroupId" : "asg-bp1igpak5ft1flyp****"
}

错误码

访问错误中心查看更多错误码。