DescribeScalingGroupDetail - 查询指定伸缩组详情_弹性伸缩(ESS)-阿里云帮助中心

查看指定伸缩组的基本信息、伸缩组内实例、伸缩配置等信息，您可以通过调用DescribeScalingGroupDetail查询该伸缩组。当ECI类型伸缩组指定OutputFormat参数为YAML时，可以输出K8s Deployment YAML格式内容。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	伸缩组所属的地域 ID。更多信息，请参见地域与可用区。	cn-hangzhou
ScalingGroupId	string	是	伸缩组的 ID。	asg-bp18p2yfxow2dloq****
OutputFormat	string	否	Output 输出格式，现仅支持 yaml。	yaml

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
ScalingGroup	object	弹性伸缩组
VpcId	string	专有网络（VPC）ID。	vpc-wz9fcq97y1vqkd8bijcq6
CreationTime	string	伸缩组的创建时间。	2014-08-14T10:58Z
TotalInstanceCount	integer	伸缩组内所有 ECS 实例的数量。	1
ScalingGroupName	string	伸缩组的名称，同一地域下伸缩组名称唯一。长度为 2~64 个字符，以数字、大小英文字母或中文开头，可以包含数字、下划线（_）、短划线（-）和半角句号（.）。	dyrSuvBOtO1dEdIlIbp****
SpotInstancePools	integer	指定可用实例规格的个数，伸缩组将按成本最低的多个规格均衡创建抢占式实例。取值范围：0~10。	5
StoppedCapacity	integer	伸缩组中处于节省停机效果的实例数量。	1
OnDemandPercentageAboveBaseCapacity	integer	伸缩组满足最小按量实例数（ondemandbasecapacity）要求后，超出的实例中按量实例应占的比例，取值范围：0～100。	20
ModificationTime	string	修改时间。	2014-08-14T10:58Z
MinSize	integer	伸缩组最小实例数。	1
ScalingGroupId	string	伸缩组的 ID。	asg-bp14wlu85wrpchm0****
CompensateWithOnDemand	boolean	当`MultiAZPolicy`取值为`COST_OPTIMIZED`时，如果因价格、库存等原因无法创建足够的抢占式实例，是否允许自动尝试创建按量实例满足 ECS 实例数量要求。可能值： true：允许。 false：不允许。	true
ScalingPolicy	string	指定伸缩组的回收模式。可能值： recycle：伸缩组的回收模式为停机回收模式。 release：伸缩组的回收模式为释放模式。 forcerelease：伸缩组的回收模式为强制释放模式。关于被移出实例的动作，请参见 RemoveInstances 。	recycle
RemovingWaitCapacity	integer	伸缩组中处于移除挂起状态的 ECS 实例的数量。	1
ActiveCapacity	integer	已成功加入伸缩组，并正常运行的 ECS 实例数量。	1
OnDemandBaseCapacity	integer	已有伸缩组内所需要的按量实例数的最小值，可能值：0~1000。即当伸缩组内按量实例个数少于该最小值时，系统将优先创建按量实例。	30
ProtectedCapacity	integer	伸缩组中处于保护中状态的 ECS 实例的数量。	1
HealthCheckType	string	伸缩组的健康检查方式。可能值： NONE：不做健康检查。 ECS：对伸缩组内的 ECS 实例做健康检查。	ECS
LifecycleState	string	伸缩组的状态信息。可能值： Active：生效状态，处于生效状态的伸缩组才能接收执行伸缩规则的请求并触发伸缩活动。 Inactive：失效状态，处于失效状态的伸缩组不接收任何执行伸缩规则的请求。 Deleting：伸缩组正在删除，处于删除中状态的伸缩组不接收任何执行伸缩规则的请求，并且不能修改伸缩组相关参数。	Active
GroupDeletionProtection	boolean	是否开启了伸缩组删除保护。可能值： true：开启伸缩组删除保护，此时不能删除该伸缩组。 false：关闭伸缩组删除保护。	true
ActiveScalingConfigurationId	string	伸缩组内生效的伸缩配置的 ID。	asc-bp1et2qekq3ojr33****
GroupType	string	伸缩组管理的实例类型。取值范围： ECS：伸缩组内管理的伸缩实例为 ECS 实例。 ECI：伸缩组内管理的伸缩实例为 ECI 实例。	ECS
MultiAZPolicy	string	多可用区伸缩组 ECS 实例扩缩容策略。可能值： PRIORITY：根据您定义的虚拟交换机（VSwitchIds）扩缩容。当优先级较高的虚拟交换机所在可用区无法创建 ECS 实例时，自动使用下一优先级的虚拟交换机创建 ECS 实例。 COST_OPTIMIZED：按 vCPU 单价从低到高进行尝试创建。当伸缩配置设置了抢占式计费方式的多实例规格时，优先创建对应抢占式实例。您可以继续通过 CompensateWithOnDemand 参数指定当抢占式实例由于库存等原因无法创建时，是否自动尝试以按量付费的方式创建。说明 COST_OPTIMIZED 仅在伸缩配置设置了多实例规格或者选用了抢占式实例的情况下生效。 BALANCE：在伸缩组指定的多可用区之间均匀分配 ECS 实例。如果由于库存不足等原因可用区之间变得不平衡，您可以通过 API RebalanceInstance 平衡资源。	PRIORITY
RemovingCapacity	integer	正在移出伸缩组的 ECS 实例的数量。	0
PendingWaitCapacity	integer	伸缩组中处于加入挂起状态的 ECS 实例的数量。	0
StandbyCapacity	integer	伸缩组中处于备用状态的实例数量。	1
CurrentHostName	string	说明该参数未开放使用。	hostname
PendingCapacity	integer	正在加入伸缩组，还未完成相关配置的 ECS 实例的数量。	0
LaunchTemplateId	string	伸缩组使用的实例启动模板的 ID。	lt-m5e3ofjr1zn1aw7****
TotalCapacity	integer	当伸缩组设置了实例规格权重，表示伸缩组内所有实例的加权容量总和。否则，表示伸缩组内所有实例的数量。	1
DesiredCapacity	integer	伸缩组内实例的期望数量，伸缩组会自动将 ECS 实例数量维持在期望实例数。	5
SpotInstanceRemedy	boolean	是否开启补齐抢占式实例。开启后，当收到抢占式实例将被回收的系统消息时，伸缩组将尝试创建新的实例，替换掉将被回收的抢占式实例。	true
LaunchTemplateVersion	string	实例启动模板的版本。	Default
RegionId	string	伸缩组所属的地域 ID。	cn-shenzhen
VSwitchId	string	伸缩组关联虚拟交换机的 ID。	vsw-bp1whw2u46cn8zubm****
MaxSize	integer	伸缩组最大实例数。	2
DefaultCooldown	integer	冷却时间，单位秒。	60
VServerGroups	object []	后端服务器组列表。
LoadBalancerId	string	虚拟服务器组所属传统型负载均衡 CLB（原 SLB）实例的 ID。	147b46d767c-cn-qingdao-cm5****
VServerGroupAttributes	object []	后端服务器组属性。
VServerGroupId	string	后端服务器组的 ID。	rsp-bp12bjrny****
Weight	integer	后端服务器组的权重。	1
Port	integer	后端服务器端口。	80
LaunchTemplateOverrides	object []	扩展启动模板的实例规格信息。
WeightedCapacity	integer	指定实例规格的权重，即实例规格的单台实例在伸缩组中表示的容量大小。权重越大，满足期望容量所需的本实例规格的实例数量越少。	4
InstanceType	string	指定的实例规格，会覆盖启动模板中的实例规格。	ecs.c5.xlarge
SpotPriceLimit	float	本参数用于指定实例启动模板覆盖规格（即`LaunchTemplateOverride.InstanceType`）的竞价价格上限。说明仅当`LaunchTemplateId`参数指定了启动模板时，该参数才生效。	0.025
AlbServerGroups	object []	ALB 服务器组的相关信息集合。
AlbServerGroupId	string	ALB 服务器组的 ID。	sgp-ddwb0y0g6y9bjm****
Weight	integer	弹性伸缩将实例添加到 ALB 服务器组后，实例作为后端服务器的权重。	100
Port	integer	弹性伸缩将实例添加到 ALB 服务器组后，实例使用的端口号。	80
ServerGroups	object []	负载均衡服务器组的相关信息集合。说明您可以通过此参数获取伸缩组关联的 ALB 类型服务组和 NLB 类型服务器组的相关信息集合。
ServerGroupId	string	服务器组的 ID。	sgp-i9ouakeaerr*****
Type	string	负载均衡服务器组类型，取值范围： ALB。 NLB。	ALB
Weight	integer	弹性伸缩将实例添加到服务器组后，实例作为后端服务器的权重。	100
Port	integer	弹性伸缩将实例添加到服务器组后，实例使用的端口号。	80
RemovalPolicies	array	实例移出伸缩组的策略的集合。
	string	ECS 实例移出伸缩组的策略的集合。可能值： OldestInstance：移出最早创建的实例。 NewestInstance：移出最新创建的实例。 OldestScalingConfiguration：移出最早由伸缩配置创建的实例。	OldestScalingConfiguration
DBInstanceIds	array	伸缩组关联 RDS 实例的 ID。
	string	伸缩组关联 RDS 实例的 ID。	rm-bp15556qzebg1****
LoadBalancerIds	array	伸缩组关联的负载均衡实例的 ID 列表。
	string	伸缩组关联的负载均衡实例的 ID 列表。	lb-bp19byhscefk3x0li****
VSwitchIds	array	伸缩组关联虚拟交换机的 ID 集合。如果您使用了 VSwitchIds 参数，VSwitchId 参数将被忽略。
	string	伸缩组关联虚拟交换机的 ID 集合。如果您使用了 VSwitchIds 参数，VSwitchId 参数将被忽略。	vsw-bp1whw2u46cn8zubm****
SuspendedProcesses	array	暂停中的流程，如果没有，则返回值为空。可能值： ScaleIn：缩容流程。 ScaleOut：扩容流程。 HealthCheck：健康检查。 AlarmNotification：报警任务。 ScheduledAction：定时任务。
	string	暂停中的流程，如果没有，则返回值为空。可能值： ScaleIn：缩容流程。 ScaleOut：扩容流程。 HealthCheck：健康检查。 AlarmNotification：报警任务。 ScheduledAction：定时任务。	ScaleIn
SystemSuspended	boolean	弹性伸缩是否停止执行伸缩组内的伸缩活动。可能值： true：停止执行伸缩组内的伸缩活动，说明该伸缩组已经连续扩缩容失败超过 7 天。您需要修改伸缩组或者伸缩配置，来恢复伸缩活动的执行。 false：执行伸缩组内的伸缩活动。	true
IsElasticStrengthInAlarm	boolean	说明该参数未开放使用。	false
MonitorGroupId	string	伸缩组关联的云监控应用分组 ID。	1497****
AzBalance	boolean	伸缩组的容量是否在多个可用区间均衡分布（仅当`MultiAZPolicy`参数取值为`COMPOSABLE`策略时生效），可能值： true：伸缩组的容量在多个可用区间均衡分布。 false：伸缩组的容量不在多个可用区间均衡分布。	false
AllocationStrategy	string	容量分配策略，决定了伸缩组如何选择可用的实例规格类型满足容量。容量分布策略同时对按量和抢占式容量生效（仅当`MultiAZPolicy`参数取值为`COMPOSABLE`策略时生效）。可能值： priority：按照配置的实例规格的顺序创建实例。 lowestPrice：按照实例规格单位 vCpu 价格从低到高创建实例。	priority
SpotAllocationStrategy	string	容量分配策略，决定了伸缩组如何选择可用的实例规格类型满足容量。容量分布策略同时对按量和抢占式容量生效（仅当`MultiAZPolicy`参数取值为`COMPOSABLE`策略时生效）。可能值： priority：按照配置的实例规格的顺序创建实例。 lowestPrice：按照实例规格单位 vCpu 价格从低到高创建实例。	lowestPrice
MaxInstanceLifetime	integer	实例在伸缩组中存活的最大时间。单位为秒。取值范围：0 或`[86400, Integer.maxValue]`。其中，0 表示清空 MaxInstanceLifetime 设置过的值（即未设置 MaxInstanceLifetime 值）。默认值：null。说明 ECI 类型的伸缩组或停机不收费的伸缩组不支持设置该参数。	null
CustomPolicyARN	string	自定义缩容策略 Function 函数 ARN。仅当 RemovalPolicies 配置第一个移除策略为 CustomPolicy 时生效。	null
InitCapacity	integer	伸缩组中处于实例扩容前初始化状态的实例数量。	0
ResourceGroupId	string	新创建的伸缩组所属的资源组 ID。说明将新创建的伸缩组归属到指定的资源组中。如果不指定该参数，则归属为默认资源组。	rg-aek2epf32c4uyji
LoadBalancerConfigs	object []	负载均衡配置列表。
LoadBalancerId	string	负载均衡 CLB（原 SLB）实例的 ID。	lb-2zein3ytoeq49cmkbyxr0
Weight	integer	后端服务器的权重。	100
EnableDesiredCapacity	boolean	是否开启期望实例数标识。可能值： true：已开启期望实例数 false：未开启期望实例数	true
Tags	object []	伸缩组的标签信息集合。
TagKey	string	伸缩组的标签键。	Department
TagValue	string	伸缩组的标签值。	Finance
Propagate	boolean	标识该标签是否为可传播标签，可能值： true：伸缩组上的标签只会传播到新创建的实例上，而不会传播到已经在伸缩组中运行的实例上。 false：伸缩组上的标签不会传播到实例上。默认值：false。	false
HealthCheckTypes	array	健康检查类型集合。
	string	健康检查类型集合。	ECS
Output	string	ECI 伸缩组输出详情。目前仅支持 K8s yaml 格式输出。	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

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ScalingGroup": {
    "VpcId": "vpc-wz9fcq97y1vqkd8bijcq6",
    "CreationTime": "2014-08-14T10:58Z\n",
    "TotalInstanceCount": 1,
    "ScalingGroupName": "dyrSuvBOtO1dEdIlIbp****\n",
    "SpotInstancePools": 5,
    "StoppedCapacity": 1,
    "OnDemandPercentageAboveBaseCapacity": 20,
    "ModificationTime": "2014-08-14T10:58Z\n",
    "MinSize": 1,
    "ScalingGroupId": "asg-bp14wlu85wrpchm0****\n",
    "CompensateWithOnDemand": true,
    "ScalingPolicy": "recycle",
    "RemovingWaitCapacity": 1,
    "ActiveCapacity": 1,
    "OnDemandBaseCapacity": 30,
    "ProtectedCapacity": 1,
    "HealthCheckType": "ECS",
    "LifecycleState": "Active",
    "GroupDeletionProtection": true,
    "ActiveScalingConfigurationId": "asc-bp1et2qekq3ojr33****\n",
    "GroupType": "ECS",
    "MultiAZPolicy": "PRIORITY",
    "RemovingCapacity": 0,
    "PendingWaitCapacity": 0,
    "StandbyCapacity": 1,
    "CurrentHostName": "hostname",
    "PendingCapacity": 0,
    "LaunchTemplateId": "lt-m5e3ofjr1zn1aw7****\n",
    "TotalCapacity": 1,
    "DesiredCapacity": 5,
    "SpotInstanceRemedy": true,
    "LaunchTemplateVersion": "Default",
    "RegionId": "cn-shenzhen",
    "VSwitchId": "vsw-bp1whw2u46cn8zubm****\n",
    "MaxSize": 2,
    "DefaultCooldown": 60,
    "VServerGroups": [
      {
        "LoadBalancerId": "147b46d767c-cn-qingdao-cm5****\n",
        "VServerGroupAttributes": [
          {
            "VServerGroupId": "rsp-bp12bjrny****\n",
            "Weight": 1,
            "Port": 80
          }
        ]
      }
    ],
    "LaunchTemplateOverrides": [
      {
        "WeightedCapacity": 4,
        "InstanceType": "ecs.c5.xlarge\n",
        "SpotPriceLimit": 0.025
      }
    ],
    "AlbServerGroups": [
      {
        "AlbServerGroupId": "sgp-ddwb0y0g6y9bjm****\n",
        "Weight": 100,
        "Port": 80
      }
    ],
    "ServerGroups": [
      {
        "ServerGroupId": "sgp-i9ouakeaerr*****\n",
        "Type": "ALB",
        "Weight": 100,
        "Port": 80
      }
    ],
    "RemovalPolicies": [
      "OldestScalingConfiguration"
    ],
    "DBInstanceIds": [
      "rm-bp15556qzebg1****\n"
    ],
    "LoadBalancerIds": [
      "lb-bp19byhscefk3x0li****\n"
    ],
    "VSwitchIds": [
      "vsw-bp1whw2u46cn8zubm****\n"
    ],
    "SuspendedProcesses": [
      "ScaleIn"
    ],
    "SystemSuspended": true,
    "IsElasticStrengthInAlarm": false,
    "MonitorGroupId": "1497****\n",
    "AzBalance": false,
    "AllocationStrategy": "priority",
    "SpotAllocationStrategy": "lowestPrice",
    "MaxInstanceLifetime": 0,
    "CustomPolicyARN": "null",
    "InitCapacity": 0,
    "ResourceGroupId": "rg-aek2epf32c4uyji",
    "LoadBalancerConfigs": [
      {
        "LoadBalancerId": "lb-2zein3ytoeq49cmkbyxr0",
        "Weight": 100
      }
    ],
    "EnableDesiredCapacity": true,
    "Tags": [
      {
        "TagKey": "Department",
        "TagValue": "Finance",
        "Propagate": false
      }
    ],
    "HealthCheckTypes": [
      "ECS"
    ]
  },
  "Output": "apiVersion: apps/v1\nkind: Deployment\nmetadata:\n  name: nginx-deployment\n  labels:\n    app: nginx\n  spec:\n    replicas: 3\n    selector:\n       matchLabels:\n        app: nginx\n    template:\n      metadata:\n        labels:\n          app: nginx\n        annotations:\n          k8s.aliyun.com/eip-bandwidth: 10\n          k8s.aliyun.com/eci-with-eip: true\n        spec:\n          containers:\n          - name: nginx\n            image: nginx:1.14.2\n            ports:\n            - containerPort: 80"
}

错误码

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