tencent cloud

APIs

문서APIsAuto ScalingData Types

Data Types

다운로드
포커스 모드
폰트 크기
마지막 업데이트 시간: 2026-09-10 11:57:24

Activity

Information of auto scaling activity.

Used by actions: DescribeAutoScalingActivities, DescribeAutoScalingGroupLastActivities.

Name Type Description
AutoScalingGroupId String Auto scaling group ID.
ActivityId String Scaling activity ID.
ActivityType String Scaling activity type. Valid values:
  • SCALE_OUT: Scale out instance(s).
  • SCALE_IN: Scale in instance(s).
  • ATTACH_INSTANCES: Add instance(s).
  • REMOVE_INSTANCES: Terminate instance(s).
  • DETACH_INSTANCES: Remove instance(s).
  • TERMINATE_INSTANCES_UNEXPECTEDLY: Instance(s) unexpectedly terminated in the CVM console.
  • REPLACE_UNHEALTHY_INSTANCE: Replace unhealthy instance(s).
  • START_INSTANCES: Start instance(s).
  • STOP_INSTANCES: Stop instance(s).
  • INVOKE_COMMAND: Execute a command in instance(s).
    		•
    StatusCode String Scaling activity status. Valid values:
  • INIT: initializing.
  • RUNNING: running.
  • SUCCESSFUL: successful.
  • PARTIALLY_SUCCESSFUL: partially successful.
  • FAILED: failed.
  • CANCELLED: canceled.
    		•
    StatusMessage String Description of the scaling activity status.
    Cause String Cause of the scaling activity.
    Description String Description of the scaling activity.
    StartTime Timestamp ISO8601 Start time of the auto scaling activity in UTC standard time.
    EndTime Timestamp ISO8601 End time of the scaling activity in UTC standard time.
    CreatedTime Timestamp ISO8601 Create time of the scaling activity in UTC standard time.
    StatusMessageSimplified String Brief description of the scaling activity status.
    LifecycleActionResultSet Array of LifecycleActionResultInfo Result of the lifecycle hook action in the scaling activity
    DetailedStatusMessageSet Array of DetailedStatusMessage Detailed description of the scaling activity status
    InvocationResultSet Array of InvocationResult Result of the command execution
    RelatedInstanceSet Array of RelatedInstance Related instance information set of the scaling activity.

    Advice

    Suggestions for scaling group configurations.

    Used by actions: DescribeAutoScalingAdvices.

    Name Type Description
    Problem String Problem Description
    Detail String Problem Details
    Solution String Recommended resolutions
    Level String Scaling suggestion warning level. Valid values:
  • WARNING: warning.
  • CRITICAL: critical.
    		•

    AutoScalingAdvice

    Suggestions for scaling group configurations.

    Used by actions: DescribeAutoScalingAdvices.

    Name Type Description
    AutoScalingGroupId String Scaling group ID
    Level String Scaling group warning level. Valid values:
  • NORMAL: normal.
  • WARNING: warning.
  • CRITICAL: critical.
    		•
    Advices Array of Advice A collection of suggestions for scaling group configurations.

    AutoScalingGroup

    Auto scaling group

    Used by actions: DescribeAutoScalingGroups.

    Name Type Description
    AutoScalingGroupId String Auto scaling group ID
    AutoScalingGroupName String Auto scaling group name
    AutoScalingGroupStatus String Current status of the scaling group. Valid values:
  • NORMAL: The scaling group is normal.
  • CVM_ABNORMAL: The launch configuration is abnormal.
  • LB_ABNORMAL: The CLB is abnormal.
  • LB_LISTENER_ABNORMAL: The CLB listener is abnormal.
  • LB_LOCATION_ABNORMAL: The forwarding configuration of the CLB listener is abnormal.
  • VPC_ABNORMAL: The VPC is abnormal.
  • SUBNET_ABNORMAL: The VPC subnet is abnormal.
  • INSUFFICIENT_BALANCE: The balance is insufficient.
  • LB_BACKEND_REGION_NOT_MATCH: The region of the CLB instance backend does not match that of the AS service.
  • LB_BACKEND_VPC_NOT_MATCH: The VPC of the CLB instance does not match that of the scaling group.
    		•
    CreatedTime Timestamp ISO8601 Creation time in UTC format
    DefaultCooldown Integer Default cooldown period in seconds
    DesiredCapacity Integer Desired number of instances
    EnabledStatus String Enabled status. Value range: ENABLED, DISABLED
    ForwardLoadBalancerSet Array of ForwardLoadBalancer List of application load balancers
    InstanceCount Integer Number of instances
    InServiceInstanceCount Integer Number of instances in IN_SERVICE status
    LaunchConfigurationId String Launch configuration ID
    LaunchConfigurationName String Launch configuration name
    LoadBalancerIdSet Array of String List of Classic load balancer IDs
    MaxSize Integer Maximum number of instances
    MinSize Integer Minimum number of instances
    ProjectId Integer Project ID
    SubnetIdSet Array of String List of subnet IDs
    TerminationPolicySet Array of String Destruction policy. valid values are as follows:.
    <Li>OLDEST_INSTANCE: terminate the oldest instance in the scaling group first, default value..
    <Li>NEWEST_INSTANCE: terminate the newest instance in the scaling group first..
    VpcId String VPC ID.
    ZoneSet Array of String List of availability zones
    RetryPolicy String Retry policy. a partially successful scaling operation is considered a failed activity. valid values are as follows:.
    <Li>IMMEDIATE_RETRY: default value, means retry immediately, attempting retries in rapid succession over a short period. cease further retries after a certain number of consecutive failures (5)..
    <Li>INCREMENTAL_INTERVALS: specifies incremental interval retry. with the number of consecutive failures, the retry interval gradually increases. the first 10 retries are quick retry, and the follow-up retry interval gradually expands to 10 minutes, 30 minutes, 60 minutes, and one day..
    <Li>NO_RETRY: there will be no retry until another user call or Alarm information is received..
    InActivityStatus String Whether the auto scaling group is performing a scaling activity. IN_ACTIVITY indicates yes, and NOT_IN_ACTIVITY indicates no.
    Tags Array of Tag List of auto scaling group tags
    ServiceSettings ServiceSettings Service settings
    Ipv6AddressCount Integer The number of IPv6 addresses that an instance has. valid values: 0 and 1. default value: 0, which means the instance does not allocate an IPv6 address. use a private network that supports ip and enable IPv6 CIDR in the subnet. for usage restrictions, see IPv6 usage limits.
    MultiZoneSubnetPolicy String Multi-AZ/subnet policy.
  • PRIORITY: The instances are attempted to be created taking the order of the AZ/subnet list as the priority. If the highest-priority AZ/subnet can create instances successfully, instances can always be created in that AZ/subnet.
  • EQUALITY: Select the AZ/subnet with the least number of instances for scale-out. In this way, each AZ/subnet has an opportunity for scale-out. Instances produced from multiple scale-out operations will be distributed to multiple AZs/subnets.
    		•
    HealthCheckType String Scaling group instance health check type, whose valid values include:
  • CVM: Determine whether an instance is unhealthy based on its network status. An unhealthy network status is indicated by an event where instances become unreachable via PING. Detailed criteria of judgment can be found in Instance Health Check.
  • CLB: Determine whether an instance is unhealthy based on the health check status of CLB. For principles behind CLB health checks, see Health Check.
    		•
    LoadBalancerHealthCheckGracePeriod Integer Grace period of the CLB health check. the scaled-out instances IN IN_SERVICE will not be marked as CLB_UNHEALTHY within the specified time range.
    Default value: 0. value range: [0, 7200]. measurement unit: seconds.
    InstanceAllocationPolicy String Instance assignment policy, whose valid values include LAUNCH_CONFIGURATION and SPOT_MIXED.
  • LAUNCH_CONFIGURATION: Represent the traditional mode of assigning instances according to the launch configuration.
  • SPOT_MIXED: Represent the spot mixed mode. Currently, this mode is supported only when the launch configuration is set to the pay-as-you-go billing mode. In the mixed mode, the scaling group will scale out pay-as-you-go models or spot models based on the predefined settings. When the mixed mode is used, the billing type of the associated launch configuration cannot be modified.
    		•
    SpotMixedAllocationPolicy SpotMixedAllocationPolicy Specifies how to assign pay-as-you-go instances and spot instances.
    A valid value will be returned only when InstanceAllocationPolicy is set to SPOT_MIXED.
    CapacityRebalance Boolean Capacity rebalancing feature, which is applicable only to spot instances within the scaling group. Valid values:
  • TRUE: Enable this feature. When spot instances in the scaling group are about to be automatically recycled by the spot instance service, AS proactively initiates the termination process of the spot instances. If there is a configured scale-in hook, it will be triggered before termination. After the termination process starts, AS asynchronously initiates the scale-out to reach the expected number of instances.
  • FALSE: Disable this feature. AS waits for the spot instance to be terminated before scaling out to reach the number of instances expected by the scaling group.
    		•
    InstanceNameIndexSettings InstanceNameIndexSettings Instance name index settings.
    HostNameIndexSettings HostNameIndexSettings Instance host name index settings.
    ConcurrentScaleOutForDesiredCapacity Boolean This feature allows the system to perform multiple scale out operations concurrently in order to reach the desired capacity. However, the following constraints apply:

    - Compatibility: This option cannot be set if the InstanceAllocationPolicyis SPOT_MIXED or the ScalingMode is WAKE_UP_STOPPED_SCALING.
    - Concurrency Limit: The system currently supports a maximum of two concurrent scale-out operations.
    - Operation Restrictions: Other scaling actions such as scaling to a specific instance count or performing scale in, cannot be executed concurrently.
    Default: FALSE(indicating that concurrent scaling is disabled).

    AutoScalingGroupAbstract

    Brief information of a scaling group.

    Used by actions: DescribeLaunchConfigurations.

    Name Type Description
    AutoScalingGroupId String Scaling group ID
    AutoScalingGroupName String Auto scaling group name.

    AutoScalingNotification

    AS event notification

    Used by actions: DescribeNotificationConfigurations.

    Name Type Description
    AutoScalingGroupId String Auto scaling group ID.
    NotificationUserGroupIds Array of String List of user group IDs.
    NotificationTypes Array of String Notification event list. valid values are as follows:.
    <Li>SCALE_OUT_SUCCESSFUL: scale-out succeeded.
    <Li>SCALE_OUT_FAILED: scale-out failed.
    <Li>SCALE_IN_SUCCESSFUL: scale-in succeeded.
    <Li>SCALE_IN_FAILED: scale-in failed.
    <Li>REPLACE_UNHEALTHY_INSTANCE_SUCCESSFUL: unhealthy instance replacement succeeded.
    <Li>REPLACE_UNHEALTHY_INSTANCE_FAILED: unhealthy instance replacement failed.
    AutoScalingNotificationId String Event notification ID.
    TargetType String Notification receiver type. valid values:.
    USER_GROUP: specifies the user group.
    TDMQ_CMQ_TOPIC: tdmq for cmq topic.
    TDMQ_CMQ_QUEUE: specifies the tdmq cmq queue.
    CMQ_QUEUE: cmq queue. cmq API offline. unable to select.
    CMQ_TOPIC: cmq topic. cmq API offline, unable to select.
    QueueName String TDMQ CMQ queue name.
    TopicName String TDMQ CMQ topic name.

    DataDisk

    Configuration information of data disk in launch configuration. If this parameter is not specified, no data disk will be purchased by default. You can specify only one data disk when purchasing it.

    Used by actions: CreateLaunchConfiguration, DescribeLaunchConfigurations, ModifyLaunchConfigurationAttributes, UpgradeLaunchConfiguration.

    Name Type Required Description
    DiskType String No

    Data disk type. For detailed restrictions on data disk types, see Cloud Disk Types. Value range:

  • LOCAL_BASIC: local hard disk
  • LOCAL_SSD: local SSD
  • CLOUD_BASIC: basic cloud disk
  • CLOUD_PREMIUM: high-performance cloud block storage
  • CLOUD_SSD: SSD cloud disk
  • CLOUD_HSSD: enhanced SSD cloud disk
  • CLOUD_TSSD: ultra-fast SSD CBS
  • CLOUD_BSSD: universal SSD cloud disk
    • The default value is consistent with the system disk type (SystemDisk.DiskType).
    DiskSize Integer No

    Data disk size, in GB. The value range varies according to the data disk type. For specific restrictions, see CVM instance configuration. Default value: 0, which means that no data disk is purchased. For more restrictions, see the product documentation.
    SnapshotId String No

    Data disk snapshot ID, obtain this parameter through the DescribeSnapshots API.
    DeleteWithInstance Boolean No

    Whether the data disk is destroyed with the instance. Value ranges from:

  • TRUE: When the instance is terminated, destroy the data disk. Only hourly postpaid cloud disks are supported.
  • FALSE: When the instance is terminated, retain the data disk.
    		•
    Encrypt Boolean No

    Whether to encrypt the data disk. TRUE means encrypted, FALSE means not encrypted; the specific disk type, region, and KMS rules are validated by CVM.
    ThroughputPerformance Integer No

    Cloud disk performance, unit: MB/s. Using this parameter can purchase additional performance for cloud disks. For feature introduction and type limitations, see: enhanced SSD cloud disk additional performance note.
    Currently only supports Extreme CBS (CLOUD_TSSD) and enhanced SSD cloud disks (CLOUD_HSSD) with capacity > 460 GB.
    BurstPerformance Boolean No

    Burst performance. Whether to enable burst performance. The default value is false. Currently, this parameter only supports Extreme CBS (CLOUD_TSSD) and enhanced SSD CLOUD disk (CLOUD_HSSD) with capacity greater than 460 GB.
    Note: In beta test. Requires ticket submission before usage.
    KmsKeyId String No

    KMS Key ID used for data disk encryption. The key validity, permission, as well as adaptability to disk type and region are validated by CVM.

    DetailedStatusMessage

    Detailed description of scaling activity status

    Used by actions: DescribeAutoScalingActivities, DescribeAutoScalingGroupLastActivities.

    Name Type Description
    Code String Error type
    Zone String AZ information
    InstanceId String Instance ID
    InstanceChargeType String Instance billing mode
    SubnetId String Subnet ID
    Message String Error message
    InstanceType String Instance type

    EnhancedService

    This describes the conditions and configurations of the enhanced services of the instance, such as cloud security, cloud monitor, TencentCloud Automation Tools, and other instance agents.

    Used by actions: CreateLaunchConfiguration, DescribeLaunchConfigurations, ModifyLaunchConfigurationAttributes, UpgradeLaunchConfiguration.

    Name Type Required Description
    SecurityService RunSecurityServiceEnabled No Enables the Cloud Security service. If this parameter is not specified, the Cloud Security service will be enabled by default.
    MonitorService RunMonitorServiceEnabled No Enables the Cloud Monitor service. If this parameter is not specified, the Cloud Monitor service will be enabled by default.
    AutomationToolsService RunAutomationServiceEnabled No Enable TAT service. If this parameter is not specified, the default logic is the same as that of the CVM instance. Note: This field may return null, indicating that no valid values can be obtained.

    Filter

    Describes key-value pair filters used for conditional queries, such as filtering results by ID, name and state.

    • If there are multiple Filter parameters, the relationship among them will be logical AND.
    • If there are multiple Values for the same Filter, the relationship among the Values for the same Filter will be logical OR.

    Used by actions: DescribeAutoScalingActivities, DescribeAutoScalingGroups, DescribeAutoScalingInstances, DescribeLaunchConfigurations, DescribeLifecycleHooks, DescribeNotificationConfigurations, DescribeRefreshActivities, DescribeScalingPolicies, DescribeScheduledActions.

    Name Type Required Description
    Name String Yes Field to be filtered.
    Values Array of String Yes Filter value of the field.

    ForwardLoadBalancer

    Application load balancer

    Used by actions: AttachLoadBalancers, CreateAutoScalingGroup, DescribeAutoScalingGroups, ModifyLoadBalancerTargetAttributes, ModifyLoadBalancers.

    Name Type Required Description
    LoadBalancerId String Yes ID of the load balancer. this parameter is required as an input parameter. you can obtain it through the DescribeLoadBalancers api.
    ListenerId String Yes CLB listener ID. as an input parameter, this parameter is required. you can obtain it through the DescribeLoadBalancers api.
    TargetAttributes Array of TargetAttribute Yes Target rule attribute list. as an input parameter, this parameter is required.
    LocationId String No The forwarding rule ID. note: this parameter is required for layer-7 (http/https) listeners. it can be obtained through the DescribeLoadBalancers api.
    Region String No The region of CLB instance. It defaults to the region of AS service and is in the format of the common parameter Region, such as ap-guangzhou.

    ForwardLoadBalancerIdentification

    Application CLB IDs

    Used by actions: DetachLoadBalancers.

    Name Type Required Description
    LoadBalancerId String Yes ID of the CLB
    ListenerId String Yes Application CLB listener ID
    LocationId String No ID of a forwarding rule. This parameter is required for layer-7 listeners.

    HostNameIndexSettings

    Specifies the serial number of the instance hostname related settings.

    Used by actions: CreateAutoScalingGroup, DescribeAutoScalingGroups, ModifyAutoScalingGroup.

    Name Type Required Description
    Enabled Boolean No

    Whether to enable serial number creation for instance hostname. not enabled by default. valid values:

    TRUE: enable serial number creation for instance hostname. FALSE: disable serial number creation for instance hostname.

    .
    BeginIndex Integer No

    Initial serial number. value range depends on the IndexLength parameter: - when IndexLength is 0, value range is [0, 99999999]. - when IndexLength is [1, 8], value range is [0, 10^IndexLength-1], and the maximum value is the maximum digit of the specified length. default value of initial serial number is as follows: - first-time enabling incremental serial number: default value is 0 (display digits depend on IndexLength, for example if IndexLength is 4, display value is 0000). - non-first-time enabling incremental serial number: continuation of previous incremental serial number, for example if last usage incremented to serial number 069, new default value is 070. note: modification of initial serial number may lead to duplication within the scaling group.

    .
    IndexLength Integer No <P>Incremental serial number length, defaults to 0, means no specified length. value range: 0-8, maximum is integer 8. - length set to 3, display form: 000, 001, 002 ... 010, 011 ... 100 ... 999, maximum is 999. - length set to 0, display form: 0, 1, 2 ... 10, 11 ... 100 ... 1000 ... 10000 ... 99999999, maximum is 99999999. note: continuous incremental serial number exceeding the limit can cause scale-out failure. do not set too small incremental serial number length.

    .

    HostNameSettings

    CVM HostName settings

    Used by actions: CreateLaunchConfiguration, DescribeLaunchConfigurations, ModifyLaunchConfigurationAttributes, UpgradeLaunchConfiguration.

    Name Type Required Description
    HostName String Yes CVM HostName.
  • Dots (.) and hyphens (-) cannot be used as the first or last character of HostName, and cannot be used consecutively.

  • Windows instances are not supported.

  • Instances of other types (e.g., Linux): The length of the character should be within the range of [2, 42]. Multiple dots (.) are allowed. Each segment between dot marks can consist of letters (case-insensitive), digits, and hyphens (-). Using only digits is not allowed.
    		•
    HostNameStyle String No The style of the CVM host name. Valid values include ORIGINAL and UNIQUE, and the default value is ORIGINAL.
  • ORIGINAL: AS passes HostName filled in the input parameters to CVM. CVM may append serial numbers to HostName, which can result in conflicts with HostName of instances in the scaling group.

  • UNIQUE: HostName filled in the input parameters acts as a prefix for the HostName. AS and CVM will expand this prefix to ensure that HostName of the instance in the scaling group is unique.
    		•
    HostNameSuffix String No Hostname suffix of a CVM instance.
  • Dots (.) and hyphens (-) cannot be used as the last character of HostNameSuffix, and cannot be used consecutively.

  • Windows instances are not supported.

  • Instances of other types (e.g., Linux): The length of the character should be within the range of [1, 39], and the combined length with HostName should not exceed 41. Multiple dots (.) are allowed. Each segment between dots can consist of letters (case-insensitive), digits, and hyphens (-).
    		•
    HostNameDelimiter String No Specifies the delimiter for the CVM host name. The default delimiter is a dot (.). Valid values:
    - dot (.)
    - hyphen (-)
    - empty string.
    Delimiter used for concatenating host name, index, and suffix. Assuming host name is testGpu4090, index is 0007, and suffix is server.
    - The delimiter is a period (.), and the final concatenation is testGpu4090.007.server.
    - Specifies the delimiter as a hyphen (-), with the final concatenation as testGpu4090-007-server.
    - Delimiter is an empty string, finally concatenated as testGpu4090007server.

    IPv6InternetAccessible

    This describes the IPv6 address public network accessibility of the instance created by a launch configuration and declares the public network usage billing method of the IPv6 address and the maximum bandwidth.

    Used by actions: CreateLaunchConfiguration, DescribeLaunchConfigurations, ModifyLaunchConfigurationAttributes, UpgradeLaunchConfiguration.

    Name Type Required Description
    InternetChargeType String No Network billing mode. Values include TRAFFIC_POSTPAID_BY_HOUR and BANDWIDTH_PACKAGE. Default value: TRAFFIC_POSTPAID_BY_HOUR. To view the current account type, see Account Type Description (https://www.tencentcloud.com/document/product/1199/49090?from_cn_redirect=1#judge).

  • IPv6 supports TRAFFIC_POSTPAID_BY_HOUR for standard account type.

  • IPv6 supports BANDWIDTH_PACKAGE for classic account type.
    		•
    InternetMaxBandwidthOut Integer No Public network outbound bandwidth cap, unit: Mbps.
    Default value: 0. At this point, no public network bandwidth is allocated to IPv6. The bandwidth cap range varies by model, availability zone, and billing mode. For specific limitations, see Public Network Bandwidth Limit.
    BandwidthPackageId String No Bandwidth package ID, which can be obtained from the BandwidthPackageId in the return value from the DescribeBandwidthPackages API.

    Instance

    Instance information

    Used by actions: DescribeAutoScalingInstances.

    Name Type Description
    InstanceId String Instance ID
    AutoScalingGroupId String Auto scaling group ID
    LaunchConfigurationId String Launch configuration ID
    LaunchConfigurationName String Launch configuration name
    LifeCycleState String Lifecycle status. valid values are as follows:.
    <Li>IN_SERVICE: running.
    <Li>CREATING: specifies the instance is being created..
    <Li>CREATION_FAILED: creation failed..
    <Li>TERMINATING: the instance is being terminated..
    <Li>TERMINATION_FAILED: the instance fails to be terminated..
    <Li>ATTACHING: binding.
    <Li>ATTACH_FAILED: the instance fails to be bound..
    <Li>DETACHING: specifies the unbinding is in progress..
    <Li>DETACH_FAILED: the instance fails to be unbound..
    <Li>ATTACHING_LB: binding to lb.
    <Li>DETACHING_LB: the lb is being unbound..
    <Li>MODIFYING_LB: the lb is being modified..
    <Li>STARTING: the instance is being started up..
    <Li>START_FAILED: the instance fails to be started up..
    <Li>STOPPING: the instance is being shut down..
    <Li>STOP_FAILED: the instance fails to be shut down..
    <Li>STOPPED: the instance is shut down..
    <Li>IN_LAUNCHING_HOOK: the lifecycle hook is being scaled out..
    <Li>IN_TERMINATING_HOOK: the lifecycle hook is being scaled in..
    HealthStatus String Health status. valid values are as follows:.
    <Li>HEALTHY: the instance is in Healthy status..
    <Li>UNHEALTHY: instance ping unreachable.
    <Li>CLB_UNHEALTHY: the instance port listened by clb is unhealthy.
    ProtectedFromScaleIn Boolean Whether to add scale-in protection
    Zone String Availability zone
    CreationType String Creation type. Value range: AUTO_CREATION, MANUAL_ATTACHING.
    AddTime Timestamp ISO8601 Instance join time is displayed in a format that conforms to the ISO8601 standard and uses UTC time.
    InstanceType String Instance type
    VersionNumber Integer Version number
    AutoScalingGroupName String Auto scaling group name
    WarmupStatus String Preheat status. valid values are as follows:.
    <Li>WAITING_ENTER_WARMUP: specifies the instance is waiting to enter preheating..
    <Li>NO_NEED_WARMUP: warming up is not required..
    <Li>IN_WARMUP: preheating..
    <Li>AFTER_WARMUP: indicates the preheating is completed..
    DisasterRecoverGroupIds Array of String Placement group ID. Only one can be specified.

    InstanceChargePrepaid

    This API is used to describe the billing mode of an instance.

    Used by actions: CreateLaunchConfiguration, DescribeLaunchConfigurations, ModifyLaunchConfigurationAttributes, UpgradeLaunchConfiguration.

    Name Type Required Description
    Period Integer Yes Purchased usage period of an instance in months. Value range: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 24, 36.
    RenewFlag String No Auto-renewal flag. Valid values:
  • NOTIFY_AND_AUTO_RENEW: Notify upon expiration and automatically renew.
  • NOTIFY_AND_MANUAL_RENEW: Notify upon expiration but do not auto-renew.
  • DISABLE_NOTIFY_AND_MANUAL_RENEW: Do not notify and do not auto-renew
    • Default value: NOTIFY_AND_MANUAL_RENEW. If this parameter is set to NOTIFY_AND_AUTO_RENEW, and the account balance is sufficient, the instance will automatically renew monthly upon its expiration date.

    InstanceMarketOptionsRequest

    Options related to a CVM bidding request

    Used by actions: CreateLaunchConfiguration, DescribeLaunchConfigurations, ModifyLaunchConfigurationAttributes, UpgradeLaunchConfiguration.

    Name Type Required Description
    SpotOptions SpotMarketOptions Yes Bidding-related options
    MarketType String No Market option type. The value can only be spot currently.

    InstanceNameIndexSettings

    Instance name index settings.

    Used by actions: CreateAutoScalingGroup, DescribeAutoScalingGroups, ModifyAutoScalingGroup.

    Name Type Required Description
    Enabled Boolean No

    Whether to enable instance creation sequencing, disabled by default. valid values:

    TRUE: indicates that instance creation sequencing is enabled; FALSE: indicates that instance creation sequencing is disabled

    .
    Note: This field may return null, indicating that no valid values can be obtained.
    BeginIndex Integer No

    Initial serial number. the value range is related to the IndexLength parameter: - when IndexLength is 0, the value range is [0, 99999999]. - when IndexLength is [1, 8], the value range is [0, 10^IndexLength-1], and the maximum value is the maximum number with the specified digits. the default value of the initial serial number is as follows: - first-time enabling of incremental serial number: the default value is 0 (the display length is related to IndexLength, for example, if IndexLength is 4, the display value is 0000). - non-first-time enabling of incremental serial number: the previous incremental serial number is postponed, for example, if the last usage incremented to serial number 069, the new default initial serial number is 070. note: modifying the initial serial number may lead to duplication within the scaling group.

    .
    Note: This field may return null, indicating that no valid values can be obtained.
    IndexLength Integer No <P>Incremental serial number length, defaults to 0, means no specified length. value range: 0-8, maximum is integer 8. - length set to 3, display form: 000, 001, 002 ... 010, 011 ... 100 ... 999, maximum is 999. - length set to 0, display form: 0, 1, 2 ... 10, 11 ... 100 ... 1000 ... 10000 ... 99999999, maximum is 99999999. note: continuous incremental serial number exceeding the limit can cause scale-out failure. do not set too small incremental serial number length.

    .

    InstanceNameSettings

    Settings of CVM instance names.

    Used by actions: CreateLaunchConfiguration, DescribeLaunchConfigurations, ModifyLaunchConfigurationAttributes, UpgradeLaunchConfiguration.

    Name Type Required Description
    InstanceName String Yes CVM instance name. Value range: 2-108.
    InstanceNameStyle String No Type of CVM instance name. Valid values: ORIGINAL and UNIQUE. Default value: ORIGINAL.

    ORIGINAL: Auto Scaling sends the input parameter InstanceName to the CVM directly. The CVM may append a serial number to the InstanceName. The InstanceName of the instances within the scaling group may conflict.

    UNIQUE: the input parameter InstanceName is the prefix of an instance name. Auto Scaling and CVM expand it. The InstanceName of an instance in the scaling group is unique.
    InstanceNameSuffix String No Name suffix of a CVM instance. The suffix length must be 1 to 105 characters, and the total length of the InstanceName value plus the suffix cannot exceed 107 characters.
    InstanceNameDelimiter String No Specifies the delimiter for the CVM instance name. The default delimiter is a dot (.). Valid values:
    - dot (.)
    - hyphen (-)
    - empty string.
    Delimiter used for concatenating instance name, index, and suffix. Assuming instance name is testGpu4090, index is 0007, and suffix is server.
    - The delimiter is a period (.), and the final concatenation is testGpu4090.007.server.
    - Specifies the delimiter as a hyphen (-), with the final concatenation as testGpu4090-007-server.
    - Delimiter is an empty string, finally concatenated as testGpu4090007server.

    InstanceTag

    Instance tag. This parameter is used to bind tags to newly added instances.

    Used by actions: CreateLaunchConfiguration, DescribeLaunchConfigurations, ModifyLaunchConfigurationAttributes, UpgradeLaunchConfiguration.

    Name Type Required Description
    Key String Yes Tag key
    Value String Yes Tag value

    InternetAccessible

    This describes the internet accessibility of the instance created by a launch configuration and declares the internet usage billing method of the instance and the maximum bandwidth

    Used by actions: CreateLaunchConfiguration, DescribeLaunchConfigurations, ModifyLaunchConfigurationAttributes, UpgradeLaunchConfiguration.

    Name Type Required Description
    InternetChargeType String No Network billing type. Valid values:
  • BANDWIDTH_PREPAID: prepaid by bandwidth;
  • TRAFFIC_POSTPAID_BY_HOUR: postpaid by traffic per hour;
  • BANDWIDTH_POSTPAID_BY_HOUR: postpaid by bandwidth per hour;
  • BANDWIDTH_PACKAGE: bandwidth package users.
    • Default value: TRAFFIC_POSTPAID_BY_HOUR.
    InternetMaxBandwidthOut Integer No Public network outbound bandwidth cap. Unit: Mbps. Default value: 0 Mbps. Bandwidth cap range varies by model. For specific limitations, see Purchase Network Bandwidth.
    PublicIpAssigned Boolean No Whether to assign a public IP address. Valid values:
  • TRUE: Allocate a public IP address.
  • FALSE: Do not allocate a public IP address.
    • When the public network bandwidth is greater than 0 Mbps, you can choose whether to enable this feature. By default, a public IP address is assigned. When the public network bandwidth is 0, assigning a public IP address is not allowed.
    BandwidthPackageId String No Bandwidth package ID, which can be obtained from the BandwidthPackageId in the return value from the DescribeBandwidthPackages API.
    InternetServiceProvider String No Line type. for details on various types of lines and supported regions, refer to EIP IP address type. default value: BGP.

    <Li>BGP: general bgp line..
    For a user who has enabled the static single-line IP allowlist, valid values include:.

    <Li>CMCC: china mobile..
    <Li>CTCC: china telecom..
    <Li>CUCC: china unicom.
    Note: The static single-line IP is only supported in some regions.
    IPv4AddressType String No Specifies the public IP type.

    <Li>WanIP: specifies the public ip address..
    <Li>HighQualityEIP: highqualityip. only Singapore and hong kong (china) support highqualityip..
    <Li>AntiDDoSEIP: anti-ddos eip. only partially supported regions can use anti-ddos eip. details visible in elastic ip product overview..
    If needed to assign an elastic IPv4 address to a resource, specify the elastic IPv4 address type. if only use WanIP, do not set this field.

    High quality IP the anti-ddos feature is only in beta test in some regions. if needed, submit a ticket for consultation.
    AntiDDoSPackageId String No Anti-DDoS service package ID. This is required when you want to request an Anti-DDoS IP.
    IsKeepEIP Boolean No Whether to delete the bound EIP(HighQualityEIP and AntiDDoSEIP) when the instance is destroyed.

    Range of values:

  • TRUE: retain the EIP
  • FALSE: not retain the EIP
    • Note that when the IPv4AddressType field specifies the EIP type, the default behavior is not to retain the EIP.
    WanIP is unaffected by this field and will always be deleted with the instance.
    Changing this field configuration will take effect immediately for resources already bound to a scaling group.

    InvocationResult

    Result of the command execution

    Used by actions: DescribeAutoScalingActivities, DescribeAutoScalingGroupLastActivities.

    Name Type Description
    InstanceId String Instance ID.
    InvocationId String Execution activity ID.
    InvocationTaskId String Task ID.
    CommandId String Command ID.
    TaskStatus String Specifies the execution task status.
    ErrorMessage String Specifies the exception information during execution.

    LaunchConfiguration

    Information set of eligible launch configurations.

    Used by actions: DescribeLaunchConfigurations.

    Name Type Description
    ProjectId Integer

    Project ID of the instance.
    LaunchConfigurationId String

    Launch configuration ID.
    LaunchConfigurationName String

    Startup configuration name.
    InstanceType String

    Instance model.
    SystemDisk SystemDisk

    Instance system disk configuration information.
    DataDisks Array of DataDisk

    Instance data disk configuration information.
    LoginSettings LimitedLoginSettings

    Instance login settings.
    InternetAccessible InternetAccessible

    Public network bandwidth-related information settings.
    SecurityGroupIds Array of String

    Security group to which an instance belongs.
    AutoScalingGroupAbstractSet Array of AutoScalingGroupAbstract

    The scaling group bound to the launch configuration.
    UserData String

    Custom data.
    CreatedTime Timestamp ISO8601

    Launch configuration creation time, in standard UTC time.
    EnhancedService EnhancedService

    Enhanced services enabling situation of the instance and its settings.
    ImageId String

    Image ID.
    LaunchConfigurationStatus String

    Current status of the launch configuration. Value range:

  • NORMAL: Normal
  • IMAGE_ABNORMAL: The launch configuration image is exceptional
  • CBS_SNAP_ABNORMAL: The launch configuration data disk snapshot is exceptional
  • SECURITY_GROUP_ABNORMAL: The launch configuration security group is exceptional

    		•
    InstanceChargeType String

    Instance billing type. The value range is as follows:

  • POSTPAID_BY_HOUR: hourly postpaid
  • SPOTPAID: spot payment
  • PREPAID: prepaid, i.e. monthly subscription
  • CDCPAID: dedicated cluster payment
    		•
    InstanceMarketOptions InstanceMarketOptionsRequest

    Market-related options of the instance, such as spot instance parameters. If the payment mode of the specified instance is spot payment, this parameter is required.
    InstanceTypes Array of String

    Instance model list.
    InstanceTags Array of InstanceTag

    Instance tag list. Instances scaled out will automatically come with tags, supporting up to 10 tags.
    Tags Array of Tag

    Tag list. The tags in this parameter are only used to bind launch configurations and will not be passed to CVM instances scaled out based on the launch configuration.
    VersionNumber Integer

    Version number.
    UpdatedTime Timestamp ISO8601

    Update time in standard UTC format.
    CamRoleName String

    CAM role name, which can be obtained from the roleName in the return value from the DescribeRoleList API.
    LastOperationInstanceTypesCheckPolicy String

    The value of InstanceTypesCheckPolicy last time when operating.
    HostNameSettings HostNameSettings

    Related settings for the CVM host name (HostName).
    InstanceNameSettings InstanceNameSettings

    Related settings for the cloud server instance name (InstanceName).
    InstanceChargePrepaid InstanceChargePrepaid

    Prepaid mode, i.e., parameter settings related to monthly/annual subscription. By specifying this parameter, you can specify the purchase duration of annual and monthly subscription instances, whether to enable auto-renewal, and other attributes. This parameter is required if the billing mode for the specified instance is prepaid.
    DiskTypePolicy String

    Cloud disk type selection policy. Parameter value range:

  • ORIGINAL: use the set cloud disk type
  • AUTOMATIC: automatically select available cloud disk types in the current AZ

    		•
    HpcClusterId String

    Hyper Computing Cluster ID.

    Note: This field is empty by default.
    IPv6InternetAccessible IPv6InternetAccessible

    IPv6 public network bandwidth-related information settings.
    DisasterRecoverGroupIds Array of String

    Placement Group id. Only one can be specified.
    ImageFamily String

    Image family name.
    DedicatedClusterId String

    Local dedicated cluster ID.
    NetworkInterfaces Array of NetworkInterface

    ENI configuration of the launch configuration.

    LifecycleActionResultInfo

    Result information of the lifecycle hook action

    Used by actions: DescribeAutoScalingActivities, DescribeAutoScalingGroupLastActivities.

    Name Type Description
    LifecycleHookId String ID of the lifecycle hook
    InstanceId String ID of the instance
    InvocationId String Execution task ID. You can query the result by using the DescribeInvocations API of TAT.
    InvokeCommandResult String Result of command invocation,
  • SUCCESSFUL: Successful command invocation. It does mean that the task is successfully. You can query the task result with the InvocationId.
  • FAILED: Failed to invoke the command
  • NONE
    		•
    NotificationResult String Notification result, which indicates whether it is successful to notify CMQ/TDMQ.

  • SUCCESSFUL: It is successful to notify CMQ/TDMQ.
  • FAILED: It is failed to notify CMQ/TDMQ.
  • NONE
    		•
    LifecycleActionResult String Result of the lifecyle hook action. Values: CONTINUE, ABANDON
    ResultReason String Reason of the result

  • HEARTBEAT_TIMEOUT: Heartbeat timed out. The setting of DefaultResult is used.
  • NOTIFICATION_FAILURE: Failed to send the notification. The setting of DefaultResult is used.
  • CALL_INTERFACE: Calls the CompleteLifecycleAction to set the result
  • ANOTHER_ACTION_ABANDON: It has been set to ABANDON by another operation.
  • COMMAND_CALL_FAILURE: Failed to call the command. The DefaultResult is applied.
  • COMMAND_EXEC_FINISH: Command completed
  • COMMAND_CALL_FAILURE: Failed to execute the command. The DefaultResult is applied.
  • COMMAND_EXEC_RESULT_CHECK_FAILURE: Failed to check the command result. The DefaultResult is applied.
    		•

    LifecycleCommand

    Remote command execution object.

    Used by actions: CreateLifecycleHook, DescribeLifecycleHooks, ModifyLifecycleHook, UpgradeLifecycleHook.

    Name Type Required Description
    CommandId String Yes Remote command ID. this item is required if you select to execute command.
    Parameters String No Custom parameter. field type is json encoded string, for example: {"varA": "222"}.
    key specifies the custom parameter name, and value specifies the default. both are string type.
    If the parameter value is not provided, the DefaultParameters of Command will be used to replace it.
    Custom parameters support a maximum of 20 entries. the custom parameter name must meet the following standard: number of characters has a cap of 64, value range [a-zA-Z0-9-_].

    LifecycleHook

    Lifecycle hook

    Used by actions: DescribeLifecycleHooks.

    Name Type Description
    LifecycleHookId String Lifecycle hook ID
    LifecycleHookName String Lifecycle hook name
    AutoScalingGroupId String Auto scaling group ID
    DefaultResult String Action to be taken by the scaling group in case of lifecycle hook timeout or LifecycleCommand execution failure. valid values:.
    - CONTINUE execution by default means capacity expansion or reduction.
    - For scale-out hooks, cvms with hook timeout or failed LifecycleCommand execution will be released directly or removed; for scale-in hooks, scale-in activities will continue.
    HeartbeatTimeout Integer Specifies the timeout waiting time of the lifecycle hook in seconds. value range: 30 to 7200.
    LifecycleTransition String Scenario for entering the lifecycle hook. valid values:.
    - INSTANCE_LAUNCHING: the lifecycle hook is being scaled out.
    - INSTANCE_TERMINATING: scale-in lifecycle hook.
    NotificationMetadata String Additional information for the notification target
    CreatedTime Timestamp ISO8601 Creation time. uses UTC for timing.
    NotificationTarget NotificationTarget Notification target
    LifecycleTransitionType String Specifies the scenario type for performing the lifecycle hook. valid values: NORMAL and EXTENSION. default value: NORMAL.
    Description: when set to EXTENSION, the lifecycle hook will be triggered during AttachInstances, DetachInstances, or RemoveInstances API calls. if set to NORMAL, the lifecycle hook will not be triggered by these apis.
    LifecycleCommand LifecycleCommand Remote command execution object.

    LimitedLoginSettings

    This describes the configuration and information related to instance login. For security reasons, sensitive information is not described.

    Used by actions: DescribeLaunchConfigurations.

    Name Type Description
    KeyIds Array of String List of key IDs.

    LoginSettings

    Describes login settings of an instance.

    Used by actions: CreateLaunchConfiguration, ModifyLaunchConfigurationAttributes, UpgradeLaunchConfiguration.

    Name Type Required Description
    Password String No Instance login password. The password complexity requirements vary according to the operating system type. The details are as follows:
    - For a Linux system, the password should contain 8 to 30 characters consisting of at least two of the four character types: lowercase letters, uppercase letters, digits, and special characters.
    - For a Windows system, the password should contain 12 to 30 characters consisting of at least three of the four character types: lowercase letters, uppercase letters, digits, and special characters.
    - If this parameter is not specified, the system will generate a random password and notify the user via the message centerSupported special characters: ( ) ` ~ ! @ # $ % ^ & * - + = | { } [ ] : ; ' , . ? /
    KeyIds Array of String No List of key ids. after associating a key, you can access the instance through the corresponding private key. KeyId can be obtained by calling the api DescribeKeyPairs. key and password cannot be specified simultaneously. the Windows operating system does not support specifying a key. currently, only one key can be specified during purchase.
    KeepImageLogin Boolean No Retain the original settings of the image. This parameter cannot be specified simultaneously with Password or KeyIds.N. It can only be set to TRUE when you create an instance by using a custom image, shared image, or externally imported image. Valid values:
  • TRUE: Retain the login settings of the image.
  • FALSE: Do not retain the login settings of the image.
    • Default value: FALSE.

    Metadata

    Custom Metadata

    Used by actions: CreateLaunchConfiguration, ModifyLaunchConfigurationAttributes.

    Name Type Required Description
    Items Array of MetadataItem No Custom metadata key-value pair list.

    MetadataItem

    A set of key-value pair information for custom Metadata

    Used by actions: CreateLaunchConfiguration, ModifyLaunchConfigurationAttributes.

    Name Type Required Description
    Key String Yes Custom metadata key.
    Value String Yes Custom metadata value.

    MetricAlarm

    Alarming metric of AS

    Used by actions: CreateScalingPolicy, DescribeScalingPolicies, ModifyScalingPolicy.

    Name Type Required Description
    ComparisonOperator String Yes Comparison operator. Value range:
  • GREATER_THAN: greater than
  • GREATER_THAN_OR_EQUAL_TO: greater than or equal to
  • LESS_THAN: less than
  • LESS_THAN_OR_EQUAL_TO: less than or equal to
  • EQUAL_TO: equal to
  • NOT_EQUAL_TO: not equal to
    • MetricName String Yes Metric names, with the following optional fields:
  • CPU_UTILIZATION: CPU utilization.
  • MEM_UTILIZATION: Memory utilization.
  • LAN_TRAFFIC_OUT: Private network outbound bandwidth.
  • LAN_TRAFFIC_IN: Private network inbound bandwidth.
  • WAN_TRAFFIC_OUT: Public network outbound bandwidth.
  • WAN_TRAFFIC_IN: Public network inbound bandwidth.
  • TCP_CURR_ESTAB: TCP connections.
    		•
    Threshold Integer Yes Alarm threshold values:
  • CPU_UTILIZATION: [1, 100], Unit: %.
  • MEM_UTILIZATION: [1, 100], Unit: %.
  • LAN_TRAFFIC_OUT: >0, Unit: Mbps.
  • LAN_TRAFFIC_IN: >0, Unit: Mbps.
  • WAN_TRAFFIC_OUT: >0, Unit: Mbps.
  • WAN_TRAFFIC_IN: >0, Unit: Mbps.
  • TCP_CURR_ESTAB: >0, Unit: Count.
    		•
    Period Integer Yes Time period in seconds. Enumerated values: 60, 300.
    ContinuousTime Integer Yes Number of repetitions. Value range: [1, 10]
    Statistic String No Statistics type. Value range:
  • AVERAGE: average
  • MAXIMUM: maximum
  • MINIMUM: minimum

    • Default value: AVERAGE
    PreciseThreshold Float No Precise alarm threshold values. This parameter is not used as an input argument but is used solely as an output parameter for the query API:
  • CPU_UTILIZATION: (0, 100], Unit: %.
  • MEM_UTILIZATION: (0, 100], Unit: %.
  • LAN_TRAFFIC_OUT: >0, Unit: Mbps.
  • LAN_TRAFFIC_IN: >0, Unit: Mbps.
  • WAN_TRAFFIC_OUT: >0, Unit: Mbps.
  • WAN_TRAFFIC_IN: >0, Unit: Mbps.
  • TCP_CURR_ESTAB: >0, Unit: Count.
    		•

    NetworkInterface

    Elastic Network Interface configuration in the launch configuration.

    Used by actions: CreateLaunchConfiguration, DescribeLaunchConfigurations, ModifyLaunchConfigurationAttributes.

    Name Type Required Description
    InterfaceType String Yes

    Network interface card type. This field is required in the request for each network interface.

    Enumeration values:

    • PRIMARY: Primary network interface
    • SECONDARY: Auxiliary network interface

    When configuring upper-level NetworkInterfaces, the array must explicitly contain and can only contain one PRIMARY. AS does not auto-complete the primary network interface.
    PrivateIpv4AddressCount Integer No

    Total number of private IPv4 addresses requested for the network interface card, including the primary IP.

    Value range: [1, 40]

    Required for SECONDARY network interface card requests; optional for PRIMARY network interface card requests. If left empty, it is processed as 1 only when constructing a CVM request copy during actual scaling, and is not written back to the launch configuration. The explicitly passed in value is passed through to CVM by AS, and finally validated by CVM/VPC.
    SecurityGroupIds Array of String No

    List of security group IDs bound to the ENI.

    Input limit: up to 10.

    For PRIMARY, a non-empty list explicitly configured in the network interface takes precedence over the SecurityGroupIds parameter in the launch configuration; if not configured in the network interface, the SecurityGroupIds parameter in the launch configuration is used. If neither is configured, AS does not specify security groups and proceeds with the CVM default rule. For SECONDARY, only the non-empty list explicitly configured in the network interface is passed through, and the SecurityGroupIds parameter in the launch configuration is not inherited.
    IsKeepENI Boolean No

    Whether to reserve the auxiliary network interface when instance is terminated. Only applicable to SECONDARY.

    Enumeration values:

    • false: Do not retain the auxiliary network interface. It will destroy with the instance.
    • true: Retain the auxiliary network interface.

    Default value: false

    PRIMARY does not allow configuration of true.

    NotificationTarget

    Notification target

    Used by actions: CreateLifecycleHook, DescribeLifecycleHooks, ModifyLifecycleHook, UpgradeLifecycleHook.

    Name Type Required Description
    TargetType String Yes Target type. valid values include CMQ_QUEUE, CMQ_TOPIC, TDMQ_CMQ_QUEUE, TDMQ_CMQ_TOPIC.
  • CMQ_QUEUE, specifies tencent cloud message QUEUE - queueing model. the corresponding product is offline. it is recommended to switch to TDMQ_CMQ_QUEUE.
    • .
  • CMQ_TOPIC, specifies tencent cloud message queue - TOPIC model. the corresponding product is offline. it is recommended to switch to TDMQ_CMQ_TOPIC.
    • .
  • TDMQ_CMQ_QUEUE. specifies the tencent cloud TDMQ message QUEUE - queueing model.
    • .
    <Li>TDMQ_CMQ_TOPIC. specifies tencent cloud tdmq message queue - topic model..
    QueueName String No Queue name. This parameter is required when TargetType is CMQ_QUEUE or TDMQ_CMQ_QUEUE.
    TopicName String No Topic name. This parameter is required when TargetType is CMQ_TOPIC or TDMQ_CMQ_TOPIC.

    RefreshActivity

    Instance refresh activity.

    Used by actions: DescribeRefreshActivities.

    Name Type Description
    AutoScalingGroupId String Scaling group ID.
    RefreshActivityId String Refresh activity ID.
    OriginRefreshActivityId String Original refresh activity ID. exists only in rollback refresh activity.
    RefreshBatchSet Array of RefreshBatch Refresh batch information list.
    RefreshMode String Refresh mode. valid values as follows:.
    <Li>ROLLING_UPDATE_RESET: reinstall the system for rolling updates..
  • ROLLING_UPDATE_REPLACE: Create an instance and replace the old instance with it for rolling updates. This mode does not support the rollback API currently.
    		•
    RefreshSettings RefreshSettings Instance update setting parameters.
    ActivityType String Refresh activity type. Valid values:
  • NORMAL: normal refresh activity.
  • ROLLBACK: rollback refresh activity.
    		•
    Status String Refresh activity status. Valid values:
  • INIT: initializing.
  • RUNNING: running.
  • SUCCESSFUL: successful.
  • FAILED_PAUSE: paused due to the failure of a refresh batch.
  • AUTO_PAUSE: automatically paused due to the pause policy.
  • MANUAL_PAUSE: manually paused.
  • CANCELLED: canceled.
  • FAILED: failed.
    		•
    CurrentRefreshBatchNum Integer Current refresh batch number. for example, 2 indicates the second batch of instances is being refreshed by the current activity.
    StartTime Timestamp ISO8601 The activity start time is refreshed in standard UTC time, in the format YYYY-MM-DDTHH:MM:ssZ.
    Note: This field may return null, indicating that no valid values can be obtained.
    EndTime Timestamp ISO8601 Refresh activity end time, in standard UTC time, in the format YYYY-MM-DDTHH:MM:ssZ.
    Note: This field may return null, indicating that no valid values can be obtained.
    CreatedTime Timestamp ISO8601 Refresh activity creation time, in standard UTC time, in the format YYYY-MM-DDTHH:MM:ssZ.

    RefreshBatch

    Instance refresh batch information, containing the refresh status, instances, start and end time, etc., of the batch.

    Used by actions: DescribeRefreshActivities.

    Name Type Description
    RefreshBatchNum Integer Refresh batch number. For example, a value of 2 indicates that the current batch of instances will be refreshed in the second batch.
    RefreshBatchStatus String Refresh batch status. Valid values:
  • WAITING: pending refresh;
  • INIT: initializing;
  • RUNNING: refreshing;
  • FAILED: refresh failed;
  • PARTIALLY_SUCCESSFUL: partially successful in the batch;
  • CANCELLED: cancelled;
  • SUCCESSFUL: refresh successful.
    		•
    RefreshBatchRelatedInstanceSet Array of RefreshBatchRelatedInstance List of instances linked to a refresh batch.
    StartTime Timestamp ISO8601 Refresh batch start time.
    Note: This field may return null, indicating that no valid value can be obtained.
    EndTime Timestamp ISO8601 Refresh batch end time.
    Note: This field may return null, indicating that no valid value can be obtained.

    RefreshBatchRelatedInstance

    Refresh batch associated instances, including the refresh activity status of individual instances and related scaling activity information.

    Used by actions: DescribeRefreshActivities.

    Name Type Description
    InstanceId String Instance ID.
    InstanceStatus String Refresh instance status. if the instance is removed or terminated during refresh, the status will be updated to NOT_FOUND. valid values:
  • WAITING: pending refresh;
  • INIT: initializing;
  • RUNNING: refreshing;
  • FAILED: refresh FAILED;
  • CANCELLED: CANCELLED;
  • SUCCESSFUL: refresh SUCCESSFUL;
  • NOT_FOUND: instance does NOT exist.
    • .
    LastActivityId String The most recent scaling activity ID during instance refresh can be queried via the DescribeAutoScalingActivities api.
    Please note that scaling activities differ from instance refresh activities; a single instance refresh activity may involve multiple scaling activities.
    InstanceStatusMessage String Describes the instance refresh status.

    RefreshSettings

    Instance refresh settings.

    Used by actions: DescribeRefreshActivities, RollbackInstanceRefresh, StartInstanceRefresh.

    Name Type Required Description
    RollingUpdateSettings RollingUpdateSettings Yes Rolling update settings. This parameter group must be configured if the RefreshMode parameter starts with ROLLING_UPDATE(e.g., ROLLING_UPDATE_RESET).
    CheckInstanceTargetHealth Boolean No Whether to enable the backend service health check for the instance. Default value: FALSE.
    This parameter is valid only for the scaling group bound to CLB. After this feature is enabled, if the instance fails the check after refresh, the port weight of the CLB will be always 0, and it will be marked as a refresh failure. Valid values:
  • TRUE: enable;
  • FALSE: disable.
    		•
    CheckInstanceTargetHealthTimeout Integer No Specifies the timeout period for instance backend service health check, in seconds.
    Value range: [60,7200]. Default value: 1800 seconds.
    This parameter takes effect only when the CheckInstanceTargetHealth parameter is enabled. If an instance health check times out, the instance will be marked as a refresh failure.

    RelatedInstance

    Information of the instances related to the current scaling activity.

    Used by actions: DescribeAutoScalingActivities, DescribeAutoScalingGroupLastActivities.

    Name Type Description
    InstanceId String Instance ID
    InstanceStatus String Status of the instance in the scaling activity. Valid values:
    INIT: Initializing
    RUNNING: Processing the instance
    SUCCESSFUL: Task succeeded on the instance
    FAILED: Task failed on the instance

    RollingUpdateSettings

    Rolling update settings.

    Used by actions: DescribeRefreshActivities, RollbackInstanceRefresh, StartInstanceRefresh.

    Name Type Required Description
    BatchNumber Integer Yes Batch quantity. The batch quantity should be a positive integer greater than 0, but cannot exceed the total number of instances pending refresh.
    BatchPause String No Pause policy between batches. Default value: Automatic. Valid values:
  • FIRST_BATCH_PAUSE: Pause after the first batch of updates is completed.
  • BATCH_INTERVAL_PAUSE: Pause between batches.
  • AUTOMATIC: Do not pause.
    		•
    MaxSurge Integer No The maximum additional quantity of instances. After this parameter is set, create a batch of additional pay-as-you-go instances according to the launch configuration before the rolling update starts. After the rolling update is completed, the additional instances will be terminated.This parameter is used to ensure a certain number of instances available during the rolling update. The maximum additional quantity of instances cannot exceed the number of refreshing instances in a single batch of the rolling update. The rollback process does not support this parameter currently.
    FailProcess String No Failure handling strategy. default value: AUTO_PAUSE. valid values:.
    <Li>AUTO_PAUSE: suspended after refresh fails.
  • AUTO_ROLLBACK: roll back after a refresh fails. each batch rolls back one instance during ROLLBACK, and the CheckInstanceTargetHealth parameter value matches the original refresh activity. no need to roll back if the shrinkage process introduced by the MaxSurge parameter fails. a cancel action will replace the ROLLBACK.
    • .
    <Li>AUTO_CANCEL: cancel after refresh fails.

    RunAutomationServiceEnabled

    Status of TAT service.

    Used by actions: CreateLaunchConfiguration, ModifyLaunchConfigurationAttributes, UpgradeLaunchConfiguration.

    Name Type Required Description
    Enabled Boolean No Enable Tencent Cloud Automation Tools service or not. Valid values:
  • TRUE: enables the TAT service
  • FALSE: disables the TAT service
    		•

    RunMonitorServiceEnabled

    Information related to Tencent Cloud Observability Platform (TCOP, formerly Cloud Monitor).

    Used by actions: CreateLaunchConfiguration, ModifyLaunchConfigurationAttributes, UpgradeLaunchConfiguration.

    Name Type Required Description
    Enabled Boolean No Whether to enable Tencent Cloud Observability Platform (formerly Cloud Monitor) (TCOP). Valid values:
  • TRUE: enable TCOP.
  • FALSE: disable TCOP.

    • Default value: TRUE.

    RunSecurityServiceEnabled

    This describes the information on the Cloud Security service

    Used by actions: CreateLaunchConfiguration, ModifyLaunchConfigurationAttributes, UpgradeLaunchConfiguration.

    Name Type Required Description
    Enabled Boolean No Whether to enable Cloud Workload Protection Platform (CWPP). Valid values:
  • TRUE: enable CWPP.
  • FALSE: disable CWPP.

    • Default value: TRUE.

    ScalingPolicy

    Alarm trigger policy.

    Used by actions: DescribeScalingPolicies.

    Name Type Description
    AutoScalingGroupId String Auto scaling group ID.
    AutoScalingPolicyId String Alarm trigger policy ID.
    ScalingPolicyType String Scaling policy type. Valid values:
    - SIMPLE: A simple policy.
    - TARGET_TRACKING: A target tracking policy.
    ScalingPolicyName String Alarm trigger policy name.
    AdjustmentType String The method to adjust the desired capacity after the alarm is triggered. It’s only available when ScalingPolicyType is Simple. Valid values:
  • CHANGE_IN_CAPACITY: Increase or decrease the desired capacity
  • EXACT_CAPACITY: Adjust to the specified desired capacity
  • PERCENT_CHANGE_IN_CAPACITY: Adjust the desired capacity by percentage
    • AdjustmentValue Integer The adjusted value of desired capacity after the alarm is triggered. This parameter is only applicable to a simple policy.
    Cooldown Integer Cooldown duration in seconds, applies only to simple policies. value range [0,3600]. default cooldown: 300 seconds.
    MetricAlarm MetricAlarm Alarm monitoring metrics of a simple policy.
    PredefinedMetricType String Preset monitoring item. It’s only available when ScalingPolicyType is TARGET_TRACKING. Valid values:
  • ASG_AVG_CPU_UTILIZATION: Average CPU utilization
  • ASG_AVG_LAN_TRAFFIC_OUT: Average private bandwidth out
  • ASG_AVG_LAN_TRAFFIC_IN: Average private bandwidth in
  • ASG_AVG_WAN_TRAFFIC_OUT: Average public bandwidth out
  • ASG_AVG_WAN_TRAFFIC_IN: Average public bandwidth in

    • Note: This field may return null, indicating that no valid values can be obtained.
    TargetValue Integer Target value. It’s only available when ScalingPolicyType is TARGET_TRACKING. Value ranges:
  • ASG_AVG_CPU_UTILIZATION (in %): [1, 100)
  • ASG_AVG_LAN_TRAFFIC_OUT (in Mbps): >0
  • ASG_AVG_LAN_TRAFFIC_IN (in Mbps): >0
  • ASG_AVG_WAN_TRAFFIC_OUT (in Mbps): >0
  • ASG_AVG_WAN_TRAFFIC_IN (in Mbps): >0

    • Note: This field may return null, indicating that no valid values can be obtained.
    EstimatedInstanceWarmup Integer Instance warm-up period (in seconds). It’s only available when ScalingPolicyType is TARGET_TRACKING. Value range: 0-3600.
    Note: This field may return null, indicating that no valid values can be obtained.
    DisableScaleIn Boolean Whether to disable scale-in. It’s only available when ScalingPolicyType is TARGET_TRACKING. Valid values:
  • true: Scaling in is not allowed.
  • false: Allows both scale-out and scale-in

    • Note: This field may return null, indicating that no valid values can be obtained.
    MetricAlarms Array of MetricAlarm List of alarm monitoring metrics. This parameter is only applicable to a target tracking policy.
    Note: This field may return null, indicating that no valid values can be obtained.
    NotificationUserGroupIds Array of String Notification group ID, which is the set of user group IDs.

    ScheduledAction

    This describes the information of a scheduled task.

    Used by actions: DescribeScheduledActions.

    Name Type Description
    ScheduledActionId String Scheduled task ID.
    ScheduledActionName String Scheduled task name.
    AutoScalingGroupId String ID of the auto scaling group where the scheduled task is located.
    StartTime Timestamp ISO8601 Start time of the scheduled task. The value is in Beijing time (UTC+8) in the format of YYYY-MM-DDThh:mm:ss+08:00 according to the ISO8601 standard.
    Recurrence String Specifies the repeating mode of the scheduled task. The Recurrence parameter limits consist of 5 fields separated by space, with the structure: minute, hour, date, month, week.
    EndTime Timestamp ISO8601 End time of the scheduled task. The value is in Beijing time (UTC+8) in the format of YYYY-MM-DDThh:mm:ss+08:00 according to the ISO8601 standard.
    MaxSize Integer Maximum number of instances set by the scheduled task.
    DesiredCapacity Integer Desired number of instances set by the scheduled task.
    MinSize Integer Minimum number of instances set by the scheduled task.
    CreatedTime Timestamp ISO8601 The creation time of the scheduled task. value is in standard UTC time, formatted as YYYY-MM-DDThh:MM:ssZ according to the ISO8601 standard.
    ScheduledType String Scheduled task execution type. Valid values:
  • CRONTAB: repeated execution.
  • ONCE: single execution.
    		•
    DisableUpdateDesiredCapacity Boolean This flag disables the normal update of the DesiredCapacityproperty that would otherwise occur when a scheduled scaling task is triggered.

    Specifies whether the scheduled task triggers proactive modification of the DesiredCapacity when the value is True. DesiredCapacity may be modified by the minSize and maxSize mechanism.
    The following cases assume that DisableUpdateDesiredCapacity is True:
    - When scheduled task triggered, the original DesiredCapacity is 5. The scheduled task changes the minSize to 10, the maxSize to 20, and the DesiredCapacity to 15. Since the DesiredCapacity update is disabled, 15 does not take effect. However, the original DesiredCapacity 5 is less than minSize 10, so the final new DesiredCapacity is 10.
    - When scheduled task triggered, the original DesiredCapacity is 25. The scheduled task changes the minSize to 10 and the maxSize to 20, and the DesiredCapacity to 15. Since the DesiredCapacity update is disabled, 15 does not take effect. However, the original DesiredCapacity 25 is greater than the maxSize 20, so the final new DesiredCapacity is 20.
    - When scheduled task triggered, the original DesiredCapacity is 13. The scheduled task changes the minSize to 10 and the maxSize to 20, and the DesiredCapacity to 15. Since the DesiredCapacity update is disabled, 15 does not take effect, and the DesiredCapacity is still 13.

    ServiceSettings

    Service settings

    Used by actions: CreateAutoScalingGroup, DescribeAutoScalingGroups, ModifyAutoScalingGroup.

    Name Type Required Description
    ReplaceMonitorUnhealthy Boolean No Enables unhealthy instance replacement. If this feature is enabled, AS will replace instances that are flagged as unhealthy by Cloud Monitor. If this parameter is not specified, the value will be False by default.
    ScalingMode String No Valid values:
    CLASSIC_SCALING: this is the typical scaling method, which creates and terminates instances to perform scaling operations.
    WAKE_UP_STOPPED_SCALING: this scaling method first tries to start stopped instances. If the number of instances woken up is insufficient, the system creates new instances for scale-out. For scale-in, instances are terminated as in the typical method. You can use the StopAutoScalingInstances API to stop instances in the scaling group. Scale-out operations triggered by alarms will still create new instances.
    Default value: CLASSIC_SCALING
    ReplaceLoadBalancerUnhealthy Boolean No Enable unhealthy instance replacement. If this feature is enabled, AS will replace instances that are found unhealthy in the CLB health check. If this parameter is not specified, the default value False will be used.
    ReplaceMode String No Replacement mode of the unhealthy replacement service. valid values:.
    RECREATE: rebuild an instance to replace the unhealthy instance.
    RESET: performs a system reinstallation on unhealthy instances while keeping the data disk, private IP address, instance id, and other information unchanged. the instance login settings, hostname, enhanced services, and UserData remain consistent with the current launch configuration.
    Default value: RECREATE.
    AutoUpdateInstanceTags Boolean No Automatic instance Tag update. the default value is False. if this feature is enabled, tags of running instances in a scaling group will be updated as well if the scaling group tags are updated. (this feature takes effect for Tag creation and editing but not Tag deletion.) the update does not take effect immediately due to certain latency.
    DesiredCapacitySyncWithMaxMinSize Boolean No Expected number of instances sync minimum and maximum value. default value is False. this parameter only takes effect in scenarios where the expected number is not passed in to modify scaling group api.
    <Li>True: when modifying the maximum or minimum value, if a conflict exists with the current expected value, synchronously adjust the expected value. for example, if the input minimum value is 2 while the current expected value is 1, the expected value will be synchronously adjusted to 2..
    <Li>False: if a conflict exists between the current expected value when modifying the maximum or minimum value, an error message indicates it is not allowed to be modified..
    PriorityScaleInUnhealthy Boolean No Scaling in unhealthy instances first. If enabled, preferentially selects unhealthy instances during scale in. Default value: False.

    SpotMarketOptions

    Bidding-related options

    Used by actions: CreateLaunchConfiguration, ModifyLaunchConfigurationAttributes, UpgradeLaunchConfiguration.

    Name Type Required Description
    MaxPrice String Yes Bidding price such as "1.05"
    SpotInstanceType String No Spot instance type. The value can only be one-time currently. Default value: one-time.

    SpotMixedAllocationPolicy

    Specifies how to assign pay-as-you-go instances and spot instances in a mixed instance mode.

    Used by actions: CreateAutoScalingGroup, DescribeAutoScalingGroups, ModifyAutoScalingGroup.

    Name Type Required Description
    BaseCapacity Integer No The minimum number of the scaling group’s capacity that must be fulfilled by pay-as-you-go instances. It defaults to 0 if not specified. Its value cannot exceed the max capacity of the scaling group.
    Note: this field may return null, indicating that no valid value can be obtained.
    OnDemandPercentageAboveBaseCapacity Integer No Controls the percentage of pay-as-you-go instances for the additional capacity beyond BaseCapacity. Valid range: 0-100. The value 0 indicates that only spot instances are provisioned, while the value 100 indicates that only pay-as-you-go instances are provisioned. It defaults to 70 if not specified. The number of pay-as-you-go instances calculated on the percentage should be rounded up.
    For example, if the desired capacity is 3, the BaseCapacity is set to 1, and the OnDemandPercentageAboveBaseCapacity is set to 1, the scaling group will have 2 pay-as-you-go instance (one comes from the base capacity, and the other comes from the rounded up value of the proportion), and 1 spot instance.
    Note: this field may return null, indicating that no valid value can be obtained.
    SpotAllocationStrategy String No Specifies how to assign spot instances in a mixed instance mode. Valid values: COST_OPTIMIZED and CAPACITY_OPTIMIZED; default value: COST_OPTIMIZED.

  • COST_OPTIMIZED: the lowest cost policy. For each model in the launch configuration, AS tries to purchase it based on the lowest unit price per core in each availability zone. If the purchase failed, try the second-lowest unit price.

  • CAPACITY_OPTIMIZED: the optimal capacity policy. For each model in the launch configuration, AS tries to purchase it based on the largest stock in each availability zone, minimizing the automatic repossession probability of spot instances.
    Note: this field may return null, indicating that no valid value can be obtained.
    		•
    CompensateWithBaseInstance Boolean No Whether to replace with pay-as-you go instances. Valid values:

  • TRUE: yes. After the purchase of spot instances failed due to insufficient stock and other reasons, purchase pay-as-you-go instances.

  • FALSE: no. The scaling group only tries the configured model of spot instances when it needs to add spot instances.

    Default value: TRUE.
    Note: this field may return null, indicating that no valid value can be obtained.
    		•

    SystemDisk

    System disk configuration of the launch configuration. If this parameter is not specified, the default value is assigned to it.

    Used by actions: CreateLaunchConfiguration, DescribeLaunchConfigurations, ModifyLaunchConfigurationAttributes, UpgradeLaunchConfiguration.

    Name Type Required Description
    DiskType String No

    System disk type. For restrictions on system disk types, see Cloud Disk Types. Value range:

  • LOCAL_BASIC: local hard disk
  • LOCAL_SSD: local SSD
  • CLOUD_BASIC: basic cloud disk
  • CLOUD_PREMIUM: high-performance cloud block storage
  • CLOUD_SSD: SSD cloud disk
  • CLOUD_BSSD: universal SSD cloud disk
  • CLOUD_HSSD: enhanced SSD cloud disk
  • CLOUD_TSSD: ultra-fast SSD CBS
  • Default value: CLOUD_PREMIUM.
    		•
    DiskSize Integer No

    System disk size (GB). Default value: 50
    Encrypt Boolean No

    Whether to encrypt the system disk. TRUE means encrypted, FALSE means not encrypted. The specific disk type, region, and KMS rules are validated by CVM.
    KmsKeyId String No

    KMS Key ID used for system disk encryption. The key validity, permission, as well as adaptability to disk type and region are validated by CVM.

    Tag

    Resource type and tag key-value pair

    Used by actions: CreateAutoScalingGroup, CreateLaunchConfiguration, DescribeAutoScalingGroups, DescribeLaunchConfigurations.

    Name Type Required Description
    Key String Yes Tag key.
    Value String Yes Tag value.
    ResourceType String No Resource type bound to the tag. Type currently supported: "auto-scaling-group", "launch-configuration". They respectively represent scaling group resources and launch configuration resources.

    TargetAttribute

    Load balancer target attribute

    Used by actions: AttachLoadBalancers, CreateAutoScalingGroup, DescribeAutoScalingGroups, ModifyLoadBalancerTargetAttributes, ModifyLoadBalancers.

    Name Type Required Description
    Port Integer Yes Port. value range: [1,65535]. as an input parameter, this parameter is required.
    Weight Integer Yes Weight. value range: [0,100]. this parameter is required as an input parameter.
    이전 주제: DescribeAccountLimits다음 주제: Error Codes

    도움말 및 지원

    문제 해결에 도움이 되었나요?

    피드백

    키워드로 검색
      Enter keywords to search documentation