修改伸缩组

最近更新时间:2018-11-15 15:47:51

1. 接口描述

接口请求域名: as.tencentcloudapi.com 。

本接口(ModifyAutoScalingGroup)用于修改伸缩组。

默认接口请求频率限制:20次/秒。

注意:本接口支持金融区地域。由于金融区和非金融区是隔离不互通的,因此当公共参数 Region 为金融区地域(例如 ap-shanghai-fsi)时,需要同时指定带金融区地域的域名,最好和 Region 的地域保持一致,例如:as.ap-shanghai-fsi.tencentcloudapi.com 。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:ModifyAutoScalingGroup
Version String 公共参数,本接口取值:2018-04-19
Region String 公共参数,详见产品支持的地域列表
AutoScalingGroupId String 伸缩组ID
AutoScalingGroupName String 伸缩组名称,在您账号中必须唯一。名称仅支持中文、英文、数字、下划线、分隔符"-"、小数点,最大长度不能超55个字节。
DefaultCooldown Integer 默认冷却时间,单位秒,默认值为300
DesiredCapacity Integer 期望实例数,大小介于最小实例数和最大实例数之间
LaunchConfigurationId String 启动配置ID
MaxSize Integer 最大实例数,取值范围为0-2000。
MinSize Integer 最小实例数,取值范围为0-2000。
ProjectId Integer 项目ID
SubnetIds.N Array of String 子网ID列表
TerminationPolicies.N Array of String 销毁策略,目前长度上限为1
VpcId String VPC ID,基础网络则填空字符串。修改为具体VPC ID时,需指定相应的SubnetIds;修改为基础网络时,需指定相应的Zones。
Zones.N Array of String 可用区列表
RetryPolicy String 重试策略,取值包括 IMMEDIATE_RETRY 和 INCREMENTAL_INTERVALS,默认取值为 IMMEDIATE_RETRY。

  • IMMEDIATE_RETRY,立即重试,在较短时间内快速重试,连续失败超过一定次数(5次)后不再重试。

  • INCREMENTAL_INTERVALS,间隔递增重试,随着连续失败次数的增加,重试间隔逐渐增大,重试间隔从秒级到1天不等。在连续失败超过一定次数(25次)后不再重试。
  • 3. 输出参数

    参数名称 类型 描述
    RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

    4. 示例

    示例1 修改伸缩组VPC子网信息

    输入示例

    https://as.tencentcloudapi.com/?Action=ModifyAutoScalingGroup
    &AutoScalingGroupId=asg-ka0s0q80
    &VpcId=vpc-hy436tmc
    &SubnetIds.0=subnet-3tmerl37
    &SubnetIds.1=subnet-b0vxjhot
    &<公共请求参数>

    输出示例

    {
      "Response": {
        "RequestId": "c503ddc6-496c-44c9-8cec-e9f1c3f9c11c"
      }
    }

    示例2 修改伸缩组期望实例、最大实例数、最小实例数

    输入示例

    https://as.tencentcloudapi.com/?Action=ModifyAutoScalingGroup
    &AutoScalingGroupId=asg-ka0s0q80
    &DesiredCapacity=3
    &MaxSize=10
    &MinSize=1
    &<公共请求参数>

    输出示例

    {
      "Response": {
        "RequestId": "b41d8d30-21d4-412c-b7f3-53041879968c"
      }
    }

    5. 开发者资源

    API Explorer

    该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

    SDK

    云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

    命令行工具

    6. 错误码

    以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码

    错误码 描述
    InvalidParameter.InScenario 在特定场景下的不合法参数。
    InvalidParameterValue.CvmError CVM参数校验异常。
    InvalidParameterValue.GroupNameDuplicate 伸缩组名称重复。
    InvalidParameterValue.LaunchConfigurationNotFound 找不到指定启动配置。
    InvalidParameterValue.LbProjectInconsistent 负载均衡器项目不一致。
    InvalidParameterValue.LbVpcInconsistent 负载均衡器和伸缩组的VPC不一致。
    InvalidParameterValue.LimitExceeded 取值超出限制。
    InvalidParameterValue.OnlyVpc 账号仅支持VPC网络。
    InvalidParameterValue.Range 取值超出指定范围。
    InvalidParameterValue.Size 伸缩组最大数量、最小数量、期望实例数取值不合法。
    InvalidParameterValue.SubnetIds 子网信息不合法。
    InvalidParameterValue.TooLong 取值过多。
    LimitExceeded 超过配额限制
    LimitExceeded.MaxSizeLimitExceeded 最大实例数大于限制。
    LimitExceeded.MinSizeLimitExceeded 最小实例数低于限制。
    MissingParameter 缺少参数错误
    MissingParameter.InScenario 在特定场景下缺少参数。
    ResourceNotFound.AutoScalingGroupIdNotFound 伸缩组不存在。
    ResourceUnavailable.LaunchConfigurationStatusAbnormal 启动配置状态异常。
    ResourceUnavailable.ProjectInconsistent 项目不一致。