你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Bicep 资源定义
可以使用目标操作部署 autoScalingAutoScalingGroups 资源类型:
- 资源组 - 请参阅 资源组部署命令
有关每个 API 版本中已更改属性的列表,请参阅 更改日志。
资源格式
若要创建 Microsoft.AwsConnector/autoScalingAutoScalingGroups 资源,请将以下 Bicep 添加到模板。
resource symbolicname 'Microsoft.AwsConnector/autoScalingAutoScalingGroups@2024-12-01' = {
location: 'string'
name: 'string'
properties: {
arn: 'string'
awsAccountId: 'string'
awsProperties: {
autoScalingGroupName: 'string'
availabilityZones: [
'string'
]
capacityRebalance: bool
context: 'string'
cooldown: 'string'
defaultInstanceWarmup: int
desiredCapacity: 'string'
desiredCapacityType: 'string'
healthCheckGracePeriod: int
healthCheckType: 'string'
instanceId: 'string'
instanceMaintenancePolicy: {
maxHealthyPercentage: int
minHealthyPercentage: int
}
launchConfigurationName: 'string'
launchTemplate: {
launchTemplateId: 'string'
launchTemplateName: 'string'
version: 'string'
}
lifecycleHookSpecificationList: [
{
defaultResult: 'string'
heartbeatTimeout: int
lifecycleHookName: 'string'
lifecycleTransition: 'string'
notificationMetadata: 'string'
notificationTargetARN: 'string'
roleARN: 'string'
}
]
loadBalancerNames: [
'string'
]
maxInstanceLifetime: int
maxSize: 'string'
metricsCollection: [
{
granularity: 'string'
metrics: [
'string'
]
}
]
minSize: 'string'
mixedInstancesPolicy: {
instancesDistribution: {
onDemandAllocationStrategy: 'string'
onDemandBaseCapacity: int
onDemandPercentageAboveBaseCapacity: int
spotAllocationStrategy: 'string'
spotInstancePools: int
spotMaxPrice: 'string'
}
launchTemplate: {
launchTemplateSpecification: {
launchTemplateId: 'string'
launchTemplateName: 'string'
version: 'string'
}
overrides: [
{
instanceRequirements: {
acceleratorCount: {
max: int
min: int
}
acceleratorManufacturers: [
'string'
]
acceleratorNames: [
'string'
]
acceleratorTotalMemoryMiB: {
max: int
min: int
}
acceleratorTypes: [
'string'
]
allowedInstanceTypes: [
'string'
]
bareMetal: 'string'
baselineEbsBandwidthMbps: {
max: int
min: int
}
burstablePerformance: 'string'
cpuManufacturers: [
'string'
]
excludedInstanceTypes: [
'string'
]
instanceGenerations: [
'string'
]
localStorage: 'string'
localStorageTypes: [
'string'
]
maxSpotPriceAsPercentageOfOptimalOnDemandPrice: int
memoryGiBPerVCpu: {
max: int
min: int
}
memoryMiB: {
max: int
min: int
}
networkBandwidthGbps: {
max: int
min: int
}
networkInterfaceCount: {
max: int
min: int
}
onDemandMaxPricePercentageOverLowestPrice: int
requireHibernateSupport: bool
spotMaxPricePercentageOverLowestPrice: int
totalLocalStorageGB: {
max: int
min: int
}
vCpuCount: {
max: int
min: int
}
}
instanceType: 'string'
launchTemplateSpecification: {
launchTemplateId: 'string'
launchTemplateName: 'string'
version: 'string'
}
weightedCapacity: 'string'
}
]
}
}
newInstancesProtectedFromScaleIn: bool
notificationConfiguration: {
notificationTypes: [
'string'
]
topicARN: 'string'
}
notificationConfigurations: [
{
notificationTypes: [
'string'
]
topicARN: 'string'
}
]
placementGroup: 'string'
serviceLinkedRoleARN: 'string'
tags: [
{
key: 'string'
propagateAtLaunch: bool
value: 'string'
}
]
targetGroupARNs: [
'string'
]
terminationPolicies: [
'string'
]
vpcZoneIdentifier: [
'string'
]
}
awsRegion: 'string'
awsSourceSchema: 'string'
awsTags: {
{customized property}: 'string'
}
publicCloudConnectorsResourceId: 'string'
publicCloudResourceName: 'string'
}
tags: {
{customized property}: 'string'
}
}
属性值
Microsoft.AwsConnector/autoScalingAutoScalingGroups
名字 | 描述 | 价值 |
---|---|---|
位置 | 资源所在的地理位置 | string (必需) |
名字 | 资源名称 | 字符串 约束: 模式 = ^(?=.{0,259}[^\s.]$)(?!.*[<>%&\?/#]) (必需) |
性能 | 此资源的资源特定属性。 | AutoScalingGroupProperties |
标签 | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
AcceleratorCount请求
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | 最大值。 | 整数 (int) |
分钟 | 最小值。 | 整数 (int) |
AcceleratorTotalMemoryMiBRequest
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | MiB 中的内存最大值。 | 整数 (int) |
分钟 | MiB 中的内存最小值。 | 整数 (int) |
AutoScalingGroupProperties
名字 | 描述 | 价值 |
---|---|---|
阿恩 | Amazon 资源名称 (ARN) | 字符串 |
awsAccountId | AWS 帐户 ID | 字符串 |
awsProperties | AWS 属性 | AwsAutoScalingGroupProperties |
awsRegion | AWS 区域 | 字符串 |
awsSourceSchema | AWS 源架构 | 字符串 |
aws标签 | AWS 标记 | AutoScalingGroupPropertiesAwsTags |
publicCloudConnectorsResourceId | 公有云连接器资源 ID | 字符串 |
publicCloudResourceName (公共云资源名称) | 公有云资源名称 | 字符串 |
AutoScalingGroupPropertiesAwsTags
名字 | 描述 | 价值 |
---|
AwsAutoScalingGroupProperties
名字 | 描述 | 价值 |
---|---|---|
autoScalingGroupName | 自动缩放组的名称。 此名称必须为每个帐户的每个区域唯一。 该名称可以包含任何 ASCII 字符 33 到 126,包括大多数标点符号字符、数字和大写字母和小写字母。 不能在名称中使用冒号(:))。 | 字符串 |
可用性区域 | 可在其中创建自动缩放组中的实例的可用性区域列表。 用于在不使用 VPCZoneIdentifier 属性时在每个可用性区域中启动到默认的VP 子网,或者在启动模板中指定现有网络接口 ID 时附加网络接口。 |
字符串[] |
capacity再平衡 | 指示是否启用了容量重新均衡。 否则,将禁用容量重新均衡。 启用容量重新均衡时,每当 Amazon EC2 通知现成实例处于中断风险时,Amazon EC2 自动缩放将尝试启动现成实例。 启动新实例后,它会终止旧实例。 有关详细信息,请参阅 使用容量重新均衡在 Amazon EC2 自动缩放用户指南中处理 Amazon EC2 现成中断。 | 布尔 |
上下文 | 保留。 | 字符串 |
冷却时间 | 仅当使用简单的缩放策略时才需要。 由于简单的缩放策略,在一个缩放活动结束和另一个缩放活动之间开始的时间量(以秒为单位)。 有关详细信息,请参阅 300 秒 |
字符串 |
defaultInstanceWarmup 实例预热 | 在进入 InService 状态后,新实例完成初始化和资源消耗的时间量(以秒为单位)。 在实例刷新期间,Amazon EC2 自动缩放在替换实例之前,在替换实例之前等待预热期。 Amazon EC2 自动缩放还会等待预热期,然后聚合新实例的指标以及用于缩放的 Amazon CloudWatch 指标中的现有实例,从而生成更可靠的使用情况数据。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南 设置自动缩放组的默认实例预热。 若要在组级别管理各种预热设置,建议设置默认实例预热,即使设置为 0 秒也是如此。 若要删除之前设置的值,请包含该属性,但为该值指定 -1 。 但是,我们强烈建议通过指定 0 或其他名义值来启用默认实例预热。 默认值:无 |
整数 (int) |
desiredCapacity | 所需容量是创建时自动缩放组的初始容量,也是其尝试维护的容量。 如果配置自动缩放,则可以超出此容量。 该数字必须大于或等于组的最小大小,并且小于或等于组的最大大小。 如果在创建堆栈时未指定所需的容量,则默认值为组的最小大小。 当达到所需容量时,CloudFormation 会将自动缩放组标记为成功(通过将状态设置为CREATE_COMPLETE)。 但是,如果在指定的启动模板或启动配置中设置了最高现成价格,则所需的容量不会用作成功标准。 请求是否满足取决于现成实例容量和最高价格。 | 字符串 |
desiredCapacityType | 为所需容量指定的值的度量单位。 Amazon EC2 自动缩放仅支持 DesiredCapacityType 基于属性的实例类型选择。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中使用基于属性的实例类型选择 创建自动缩放组。 默认情况下,Amazon EC2 自动缩放指定 units ,这将转换为实例数。 取值: units | vcpu | memory-mib |
字符串 |
healthCheckGracePeriod | Amazon EC2 自动缩放在检查已进入服务的 EC2 实例的运行状况状态并由于运行状况检查失败而将其标记为不正常之前,Amazon EC2 自动缩放等待的时间(以秒为单位)。 如果实例在进入 InService 状态后不会立即通过其运行状况检查,则这非常有用。 有关详细信息,请参阅 0 秒 |
整数 (int) |
healthCheckType | 一个或多个运行状况检查类型的逗号分隔值字符串。 有效值为 EC2 、ELB 和 VPC_LATTICE 。
EC2 是默认的运行状况检查,无法禁用。 有关详细信息,请参阅 EC2 。 |
字符串 |
instanceId | 用于基于启动配置的实例的 ID。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中使用 EC2 实例 创建自动缩放组。 如果指定 LaunchTemplate 、MixedInstancesPolicy 或 LaunchConfigurationName ,则不指定 InstanceId 。 |
字符串 |
instanceMaintenancePolicy 的 | 实例维护策略。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 设置实例维护策略。
InstanceMaintenancePolicy 是 AWS::AutoScaling::AutoScalingGroup 资源的属性。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 实例维护 策略。 |
InstanceMaintenancePolicy 实例维护策略 |
launchConfigurationName | 用于启动实例的启动配置的名称。 仅当未指定 LaunchTemplate 、MixedInstancesPolicy 或 InstanceId 时才是必需的。 |
字符串 |
launchTemplate (启动模板) | 用于指定用于启动实例的启动模板和版本的信息。 也可以通过指定 MixedInstancesPolicy 将启动模板关联到自动缩放组。 有关创建启动模板的详细信息,请参阅 Amazon EC2 自动缩放用户指南中创建自动缩放组 的启动模板。 如果省略此属性,则必须指定 MixedInstancesPolicy 、LaunchConfigurationName 或 InstanceId 。 指定为自动缩放组预配 EC2 实例时要使用的启动模板。 必须指定以下内容:+ 启动模板的 ID 或名称,但不能同时指定这两者。 + 启动模板的版本。
LaunchTemplateSpecification 是 AWS::AutoScaling::AutoScalingGroup 资源的属性。 它也是 AWS::AutoScaling::AutoScalingGroup LaunchTemplate 和 AWS::AutoScaling::AutoScalingGroup LaunchTemplateOverrides 属性类型的属性。 有关创建启动模板的信息,请参阅 AWS::EC2::LaunchTemplate,Amazon EC2 自动缩放用户指南创建自动缩放 组的启动模板。 有关启动模板的示例,请参阅 资源中的 自动缩放模板片段 和 AWS::EC2::LaunchTemplate 部分。 |
LaunchTemplate规范 |
lifecycleHookSpecificationList | 在启动实例之前,要添加到自动缩放组的一个或多个生命周期挂钩。 | LifecycleHookSpecification[] |
loadBalancer名称 | 与此自动缩放组关联的经典负载均衡器的列表。 对于应用程序负载均衡器、网络负载均衡器和网关负载均衡器,请改为指定 TargetGroupARNs 属性。 |
字符串[] |
maxInstanceLifetime | 实例可以在服务中的最大时间量(以秒为单位)。 默认值为 null。 如果指定,则该值必须为 0 或等于或大于 86,400 秒的数字(1 天)。 有关详细信息,请参阅 |
整数 (int) |
最大大小 | 组的最大大小。 使用实例加权的混合实例策略时,Amazon EC2 自动缩放可能需要超过 MaxSize 以满足容量要求。 在此事件中,Amazon EC2 自动缩放永远不会超过 MaxSize 最大实例权重(定义每个实例对组所需容量贡献的单位数的权重)。 |
字符串 |
metricsCollection | 启用自动缩放组的组指标的监视。 默认情况下,这些指标处于禁用状态。 | MetricsCollection[] |
最小大小 | 组的最小大小。 | 字符串 |
mixedInstancesPolicy 的 | 一个嵌入对象,指定混合实例策略。 该策略包括的属性不仅定义了按需实例和现成实例的分布、为现成实例支付的最高费用(可选),以及自动缩放组如何分配实例类型来满足按需容量和现成容量,还定义了指定实例配置信息的属性-启动模板和实例类型。 该策略还可以包括每个实例类型的权重,以及各个实例类型的不同启动模板。 有关详细信息,请参阅 MixedInstancesPolicy 是 AWS::AutoScaling::AutoScalingGroup 资源的属性。 |
MixedInstancesPolicy |
newInstancesProtectedFromScaleIn | 指示在扩展时,Amazon EC2 自动缩放是否保护新启动的实例不受终止。 有关防止实例在横向缩减时终止的详细信息,请参阅 Amazon EC2 自动缩放用户指南使用实例缩减保护。 | 布尔 |
notificationConfiguration | 为 NotificationConfigurations 资源 属性指定 Amazon SNS 通知配置的结构。 有关示例模板片段,请参阅 自动缩放模板代码片段。 有关详细信息,请参阅 在 amazon EC2 自动缩放用户指南中的自动缩放组缩放 时获取 Amazon SNS 通知。 |
通知配置 |
notificationConfigurations | 配置自动缩放组,以在发生指定事件时发送通知。 | NotificationConfiguration[] |
placementGroup | 要在其中启动实例的位置组的名称。 有关详细信息,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中的 放置组。 群集 放置组是单个可用性区域中实例的逻辑分组。 不能指定多个可用性区域和群集放置组。 | 字符串 |
serviceLinkedRoleARN | 自动缩放组用来代表你调用其他 AWS 服务的服务链接角色的 Amazon 资源名称(ARN)。 默认情况下,Amazon EC2 自动缩放使用名为 AWSServiceRoleForAutoScaling 的服务链接角色,如果不存在,则会创建该角色。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 服务链接角色。 |
字符串 |
标签 | 一个或多个标记。 可以标记自动缩放组,并将标记传播到它启动的 Amazon EC2 实例。 标记不会传播到 Amazon EBS 卷。 若要将标记添加到 Amazon EBS 卷,请在启动模板中指定标记,但请谨慎使用。 如果启动模板使用为自动缩放组指定的键指定实例标记,Amazon EC2 自动缩放会用自动缩放组指定的值替代该实例标记的值。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 标记自动缩放组和 实例。 | TagProperty[] |
targetGroupARNs | 要与自动缩放组关联的弹性负载均衡目标组的 Amazon 资源名称(ARN)。 实例注册为目标组的目标。 目标组接收传入流量并将请求路由到一个或多个已注册的目标。 有关详细信息,请参阅 |
字符串[] |
terminationPolicies | 用于选择要终止的实例的策略或策略列表。 按照列出策略的顺序执行这些策略。 有关详细信息,请参阅 Default | AllocationStrategy | ClosestToNextInstanceHour | NewestInstance | OldestInstance | OldestLaunchConfiguration | OldestLaunchTemplate | arn:aws:lambda:region:account-id:function:my-function:my-alias |
字符串[] |
vpZoneIdentifier | 虚拟私有云的子网 ID 列表,可在其中创建自动缩放组中的实例。 如果此资源指定公共子网,并且也位于同一堆栈模板中定义的一个 VPCZoneIdentifier 时,这会保留相同的自动缩放组,并根据指定的子网将旧实例替换为新实例。 可以选择使用 UpdatePolicy 属性指定 CloudFormation 如何处理这些更新。 需要将实例启动到非默认的VP 中。 如果使用 VPCZoneIdentifier 指定 AvailabilityZones ,则为此属性指定的子网必须驻留在这些可用性区域中。 |
字符串[] |
BaselineEbsBandwidthMbps请求
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | 最大值(以 Mbps 为单位)。 | 整数 (int) |
分钟 | 最小值(以 Mbps 为单位)。 | 整数 (int) |
InstanceMaintenancePolicy 实例维护策略
名字 | 描述 | 价值 |
---|---|---|
maxHealthyPercentage | 将上限指定为自动缩放组所需容量的百分比。 它表示在替换实例时可以处于服务和正常运行或挂起状态的组的最大百分比,以支持工作负荷。 值范围为 100 到 200。 若要清除以前设置的值,请指定一个 -1 值。 必须同时指定 MinHealthyPercentage 和 MaxHealthyPercentage ,并且它们之间的差异不能大于 100。 较大的范围会增加可以同时替换的实例数。 |
整数 (int) |
minHealthyPercentage (最小健康百分比) | 将较低的阈值指定为自动缩放组所需容量的百分比。 它表示要保留在服务中的组的最小百分比、正常运行,并准备好在替换实例时支持工作负荷。 值范围为 0 到 100。 若要清除以前设置的值,请指定一个 -1 值。 |
整数 (int) |
实例要求
名字 | 描述 | 价值 |
---|---|---|
acceleratorCount | 实例类型的最小和最大加速器数(GPU、FPGA 或 AWS 推理芯片)。 若要排除启用了加速器的实例类型,请将 Max 设置为 0 。 默认值:AcceleratorCountRequest 没有最小或最大限制是 InstanceRequirements 属性类型的 属性的属性,该属性类型描述实例类型的最小和最大加速键数。 |
AcceleratorCount请求 |
加速器制造商 | 指示实例类型是否必须具有特定制造商的加速器。 + 对于具有 NVIDIA 设备的实例类型,请指定 nvidia 。 + 对于 AMD 设备的实例类型,请指定 amd 。 + 对于 AWS 设备的实例类型,请指定 amazon-web-services 。 + 对于具有 Xilinx 设备的实例类型,请指定 xilinx 。 默认值:任何制造商 |
字符串[] |
加速器名称 | 列出必须位于实例类型的加速器。 + 对于 NVIDIA A100 GPU 的实例类型,请指定 a100 。 + 对于 NVIDIA V100 GPU 的实例类型,请指定 v100 。 + 对于 NVIDIA K80 GPU 的实例类型,请指定 k80 。 + 对于具有 NVIDIA T4 GPU 的实例类型,请指定 t4 。 + 对于 NVIDIA M60 GPU 的实例类型,请指定 m60 。 + 对于 AMD Radeon Pro V520 GPU 的实例类型,请指定 radeon-pro-v520 。 + 对于具有 Xilinx VU9P FPGA 的实例类型,请指定 vu9p 。 默认值:任何加速器 |
字符串[] |
acceleratorTotalMemoryMiB | 实例类型上加速器的最小和最大总内存大小(以 MiB 为单位)。 默认值:AcceleratorTotalMemoryMiBRequest 没有最小或最大限制是 InstanceRequirements 属性类型的 属性的属性,用于描述实例类型的加速器的最小和最大总内存大小(在 MiB 中)。 |
AcceleratorTotalMemoryMiBRequest |
acceleratorTypes | 列出必须位于实例类型的加速器类型。 + 对于具有 GPU 加速器的实例类型,请指定 gpu 。 + 对于具有 FPGA 加速器的实例类型,请指定 fpga 。 + 对于具有推理加速器的实例类型,请指定 inference 。 默认值:任何加速器类型 |
字符串[] |
allowedInstanceTypes | 要对其应用指定属性的实例类型。 将忽略所有其他实例类型,即使它们与指定的属性匹配。 可以将字符串与星号(* )表示的一个或多个通配符一起使用,以允许实例类型、大小或生成。 下面是示例:m5.8xlarge 、c5*.* 、m5a.* 、r* 、*3* 。 例如,如果指定 c5* ,Amazon EC2 自动缩放将允许整个 C5 实例系列,其中包括所有 C5a 和 C5n 实例类型。 如果指定 m5a.* ,Amazon EC2 自动缩放将允许所有 M5a 实例类型,但不允许 M5n 实例类型。 如果指定 AllowedInstanceTypes ,则无法指定 ExcludedInstanceTypes 。 默认值:所有实例类型 |
字符串[] |
裸金属 | 指示是否包括、排除或必需裸机实例类型。 默认值:excluded |
字符串 |
baselineEbs带宽Mbps | 实例类型的最小和最大基线带宽性能(以 Mbps 为单位)。 有关详细信息,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中的 Amazon EBS 优化实例。 默认值:BaselineEbsBandwidthMbpsRequest 的最小或最大限制不是 InstanceRequirements 属性类型的 属性的属性,用于描述实例类型的最小和最大基线带宽性能(以 Mbps 为单位)。 |
BaselineEbsBandwidthMbps请求 |
burstablePerformance (突发性能) | 指示是否包括、排除或需要可突发性能实例类型。 有关详细信息,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中的 可突发性能实例。 默认值:excluded |
字符串 |
cpu制造商 | 列出要包括的特定 CPU 制造商。 + 对于具有 Intel CPU 的实例类型,请指定 intel 。 + 对于具有 AMD CPU 的实例类型,请指定 amd 。 + 对于具有 AWS CPU 的实例类型,请指定 amazon-web-services 。 不要将 CPU 硬件制造商与 CPU 硬件体系结构混淆。 实例将使用在启动模板中指定的 Amazon Machine Image (AMI)的兼容 CPU 体系结构启动。 默认值:任何制造商 |
字符串[] |
excludedInstanceTypes | 要排除的实例类型。 可以将字符串与一个或多个通配符(由星号(* )表示)一起使用,以排除实例系列、类型、大小或代系。 下面是示例:m5.8xlarge 、c5*.* 、m5a.* 、r* 、*3* 。 例如,如果指定 c5* ,则会排除整个 C5 实例系列,其中包括所有 C5a 和 C5n 实例类型。 如果指定 m5a.* ,Amazon EC2 自动缩放将排除所有 M5a 实例类型,但不包括 M5n 实例类型。 如果指定 ExcludedInstanceTypes ,则无法指定 AllowedInstanceTypes 。 默认值:无排除的实例类型 |
字符串[] |
instanceGenerations 实例代数 | 指示是否包括当前或上一代实例类型。 + 对于当前生成实例类型,请指定 current 。 当前代包括当前建议使用的 EC2 实例类型。 这通常包括每个实例系列中最新的两到三代。 有关详细信息,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中的 实例类型。 + 对于上一代实例类型,请指定 previous 。 默认值:任何当前或上一代 |
字符串[] |
localStorage (本地存储) | 指示实例存储卷的实例类型是包含、排除还是必需。 有关详细信息,请参阅适用于 Linux 实例included |
字符串 |
localStorageTypes | 指示所需的本地存储的类型。 + 对于具有硬盘驱动器(HDD)存储的实例类型,请指定 hdd 。 + 对于具有固态驱动器(SSD)存储的实例类型,请指定 ssd 。 默认值:任何本地存储类型 |
字符串[] |
maxSpotPriceAsPercentageOfOptimalOnDemandPrice | [价格保护]现成实例的价格保护阈值,作为已识别的按需价格的百分比。 标识的按需价格是具有指定属性的当前代 C、M 或 R 实例类型最低价格的价格。 如果没有当前代 C、M 或 R 实例类型与属性匹配,则标识的价格来自最低价格的当前代实例类型,或者失败,即与属性匹配的最低定价的上一代实例类型。 当 Amazon EC2 自动缩放选择具有属性的实例类型时,我们将排除其价格超过指定阈值的实例类型。 该参数接受一个整数,Amazon EC2 自动缩放将其解释为百分比。 若要指示没有价格保护阈值,请指定高值,例如 999999 。 如果将 DesiredCapacityType 设置为 vcpu 或 memory-mib ,则价格保护阈值基于每个 vCPU 或每内存价格,而不是每个实例价格。 只能指定 SpotMaxPricePercentageOverLowestPrice 或 MaxSpotPriceAsPercentageOfOptimalOnDemandPrice 之一。 如果未指定,则使用 SpotMaxPricePercentageOverLowestPrice ,该参数的值默认为 100 。 |
整数 (int) |
内存GiBPerVCpu | 实例类型的每个 vCPU 的最小和最大内存量(以 GiB 为单位)。 默认值:MemoryGiBPerVCpuRequest 没有最小或最大限制是 InstanceRequirements 属性类型的 属性的属性,用于描述实例类型每个 vCPU 的最小和最大内存量(在 GiB 中)。 |
MemoryGiBPerVCpuRequest |
内存MiB | 实例类型的最小和最大实例内存大小(以 MiB 为单位)。
MemoryMiBRequest 是 InstanceRequirements 属性类型的 属性的属性,描述 MiB 中实例类型的最小和最大实例内存大小。 |
内存MiBRequest |
networkBandwidth Gbps | 最小和最大网络带宽量(以千兆位/秒为单位)(Gbps)。 默认值:NetworkBandwidthGbpsRequest 没有最小或最大限制是 InstanceRequirements 属性类型的 属性的属性,该属性类型描述实例类型的最小和最大网络带宽(以 Gbps 为单位)。 设置最小带宽不能保证实例将达到最小带宽。 Amazon EC2 将识别支持指定最小带宽的实例类型,但实例的实际带宽有时可能低于指定的最小值。 有关详细信息,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中的 可用实例带宽。 |
NetworkBandwidth GbpsRequest |
networkInterfaceCount | 实例类型的最小和最大网络接口数。 默认值:NetworkInterfaceCountRequest 的最小或最大限制不是 InstanceRequirements 属性类型的 属性的属性,该属性类型描述实例类型的网络接口的最小和最大数目。 |
NetworkInterfaceCountRequest 请求 |
onDemandMaxPricePercentageOverLowestPrice | [价格保护]按需实例的价格保护阈值,其百分比高于已确定的按需价格。 标识的按需价格是具有指定属性的当前代 C、M 或 R 实例类型最低价格的价格。 如果没有当前代 C、M 或 R 实例类型与属性匹配,则标识的价格来自最低价格的当前代实例类型,或者失败,即与属性匹配的最低定价的上一代实例类型。 当 Amazon EC2 自动缩放选择具有属性的实例类型时,我们将排除其价格超过指定阈值的实例类型。 该参数接受一个整数,Amazon EC2 自动缩放将其解释为百分比。 若要关闭价格保护,请指定高值,如 999999 。 如果将 DesiredCapacityType 设置为 vcpu 或 memory-mib ,则根据每个 vCPU 或每内存价格(而不是每个实例价格)应用价格保护阈值。 默认值:20 |
整数 (int) |
requireHibernateSupport | 指示实例类型是否必须提供按需实例休眠支持。 默认值:false |
布尔 |
spotMaxPricePercentageOverLowestPrice | [价格保护]现成实例的价格保护阈值,其百分比高于已确定的现成价格。 标识的现成价格是具有指定属性的当前代 C、M 或 R 实例类型最低价格的价格。 如果没有当前代 C、M 或 R 实例类型与属性匹配,则标识的价格来自最低价格的当前代实例类型,或者失败,即与属性匹配的最低定价的上一代实例类型。 当 Amazon EC2 自动缩放选择具有属性的实例类型时,我们将排除其价格超过指定阈值的实例类型。 该参数接受一个整数,Amazon EC2 自动缩放将其解释为百分比。 若要关闭价格保护,请指定高值,如 999999 。 如果将 DesiredCapacityType 设置为 vcpu 或 memory-mib ,则价格保护阈值基于每个 vCPU 或每内存价格,而不是每个实例价格。 只能指定 SpotMaxPricePercentageOverLowestPrice 或 MaxSpotPriceAsPercentageOfOptimalOnDemandPrice 之一。 默认值:100 |
整数 (int) |
总计本地存储 GB | 实例类型的最小和最大本地存储大小总计(以 GB 为单位)。 默认值:TotalLocalStorageGBRequest 没有最小或最大限制是 InstanceRequirements 属性类型的 属性的属性,用于描述实例类型的最小和最大本地存储大小(以 GB 为单位)。 |
TotalLocalStorageGB 请求 |
vCpuCount | 实例类型的最小和最大 vCPU 数。
VCpuCountRequest 是 InstanceRequirements 属性类型的 属性的属性,描述实例类型的最小和最大 vCPU 数。 |
VCpuCount请求 |
实例分布
名字 | 描述 | 价值 |
---|---|---|
onDemandAllocationStrategy | 启动时要应用于按需实例的分配策略。 可能的实例类型由指定的启动模板替代确定。 下表列出了有效值:+ 最低价格使用价格来确定哪些实例类型是最高优先级,首先在可用性区域中启动最低定价的实例类型。 这是指定 InstanceRequirements 的自动缩放组的默认值。 + 优先设置启动模板的实例类型顺序,从最高优先级到最低优先级(从第一个到最后一个列表)。 Amazon EC2 自动缩放首先启动最高优先级实例类型。 如果无法使用最高优先级实例类型满足所有按需容量,则 Amazon EC2 自动缩放将使用第二个优先级实例类型启动剩余容量,依此类推。 这是未指定 InstanceRequirements 的自动缩放组的默认值,不能用于执行操作的组。 | 字符串 |
onDemandBaseCapacity | 按需实例必须满足的自动缩放组容量的最小量。 当组缩放时,首先启动此基本部分。 此数字的度量单位与组的所需容量相同。 如果在启动模板替代列表中指定加权容量值或更改组的默认所需容量类型设置来更改默认度量单位(实例数),则必须使用相同的度量单位指定此数字。 默认值:0 此设置的更新意味着逐步替换实例以调整当前的按需实例级别。 替换实例时,Amazon EC2 自动缩放会在终止上述实例之前启动新实例。 | 整数 (int) |
onDemandPercentageAboveBaseCapacity | 控制超出 OnDemandBaseCapacity 的附加容量的按需实例和现成实例的百分比。 以数字表示(例如,20 指定 20% 个按需实例、80 个% 现成实例)。 如果设置为 100,则仅使用按需实例。 默认值:100 此设置的更新意味着逐步替换实例以调整当前按需实例和现成实例级别,以增加比基本容量更高的容量。 替换实例时,Amazon EC2 自动缩放会在终止上述实例之前启动新实例。 |
整数 (int) |
spotAllocationStrategy | 启动现成实例时要应用到现成实例的分配策略。 可能的实例类型由指定的启动模板替代确定。 下面列出了有效值:+ 容量优化的请求现成实例,这些实例使用基于可用现成容量以最佳方式选择的池。 此策略具有最低的中断风险。 若要使某些实例类型更有机会先启动,请使用容量优化优先顺序。 + 容量优化优先级:设置启动模板替代的实例类型顺序从最高优先级到最低优先级(从第一个到最后一个列表)。 Amazon EC2 自动缩放尽力遵循实例类型优先级,但首先针对容量进行优化。 请注意,如果按需分配策略设置为优先顺序,则满足按需容量时会应用相同的优先级。 对于指定 InstanceRequirements 的自动缩放组,此值无效。 + 最低价格请求使用可用性区域中价格最低的池的现成实例,跨为 SpotInstancePools 属性指定的现成池数。 为了确保满足所需的容量,可以从多个池接收现成实例。 这是默认值,但它可能会导致高中断率,因为此策略只考虑实例价格,而不是可用的容量。 + 价格容量优化(建议) 价格和容量优化分配策略同时查看价格和容量,以选择不太可能中断且价格最低的现成实例池。 | 字符串 |
spotInstancePools 实例池 | 要在其中分配现成实例的现成实例池数。 现成池根据替代中的不同实例类型确定。 仅在 SpotAllocationStrategy lowest-price 时有效。 值必须介于 1-20 的范围内。 默认值:2 |
整数 (int) |
现货最大价格 | 你愿意为现成实例支付的单位小时的最高价格。 如果最高价格低于所选实例类型的现成价格,则不会启动现成实例。 我们不建议指定最高价格,因为它可能导致中断增加。 当现成实例启动时,需支付当前现成价格。 若要删除之前设置的最高价格,请包含该属性,但为值指定空字符串 ('')。 如果指定最高价格,则实例将比未指定实例更频繁地中断。 有效范围:最小值为 0.001 | 字符串 |
LaunchTemplate (启动模板)
名字 | 描述 | 价值 |
---|---|---|
launchTemplate规范 | 启动模板。 指定为自动缩放组预配 EC2 实例时要使用的启动模板。 必须指定以下内容:+ 启动模板的 ID 或名称,但不能同时指定这两者。 + 启动模板的版本。
LaunchTemplateSpecification 是 AWS::AutoScaling::AutoScalingGroup 资源的属性。 它也是 AWS::AutoScaling::AutoScalingGroup LaunchTemplate 和 AWS::AutoScaling::AutoScalingGroup LaunchTemplateOverrides 属性类型的属性。 有关创建启动模板的信息,请参阅 AWS::EC2::LaunchTemplate,Amazon EC2 自动缩放用户指南创建自动缩放 组的启动模板。 有关启动模板的示例,请参阅 资源中的 自动缩放模板片段 和 AWS::EC2::LaunchTemplate 部分。 |
LaunchTemplate规范 |
重写 | 在启动模板中指定的任何属性都重写相同的属性。 | LaunchTemplate覆盖 |
LaunchTemplate覆盖
名字 | 描述 | 价值 |
---|---|---|
instanceRequirements | 实例要求。 Amazon EC2 自动缩放使用指定的要求来标识实例类型。 然后,它使用按需和现成分配策略从这些实例类型启动实例。 每个自动缩放组最多可以指定四个单独的实例要求集。 这可用于在同一自动缩放组中预配不同 Amazon Machine Images (AMIS) 的实例。 为此,请创建 AMIS 并为每个 AMI 创建新的启动模板。 然后,为每个启动模板创建一组兼容的实例要求。 如果指定 InstanceRequirements ,则无法指定 InstanceType 。 混合实例策略的实例类型的属性。 Amazon EC2 自动缩放使用指定的要求来标识实例类型。 然后,它使用按需和现成分配策略从这些实例类型启动实例。 指定多个属性时,将获得满足所有指定属性的实例类型。 如果为某个属性指定多个值,则获取满足任何指定值的实例类型。 若要限制 Amazon EC2 自动缩放可以标识匹配实例类型的实例类型列表,可以使用以下参数之一,但不能在同一请求中使用这些参数之一:+ AllowedInstanceTypes - 要包括在列表中的实例类型。 将忽略所有其他实例类型,即使它们与指定的属性匹配。
+
ExcludedInstanceTypes - 要从列表中排除的实例类型,即使它们与指定的属性匹配也是如此。 必须指定 VCpuCount 和 MemoryMiB 。 所有其他属性都是可选的。 任何未指定的可选属性都设置为其默认值。 有关示例模板,请参阅 自动缩放模板代码段。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中使用基于属性的实例类型选择 创建自动缩放组。 有关在将哪些实例类型应用到自动缩放组之前确定哪些实例类型与属性匹配的帮助,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中具有指定属性 的预览实例类型。
InstanceRequirements 是 LaunchTemplateOverrides 属性类型的 属性的属性。 |
实例要求 |
instanceType | 实例类型,例如 m3.xlarge 。 必须指定请求的区域和可用性区域中支持的实例类型。 有关详细信息,请参阅 Amazon Elastic Compute Cloud 用户指南中的 实例类型。 每个自动缩放组最多可以指定 40 个实例类型。 |
字符串 |
launchTemplate规范 | 为指定的实例类型或实例要求集提供启动模板。 例如,某些实例类型可能需要具有不同 AMI 的启动模板。 如果未提供,Amazon EC2 自动缩放将使用在 LaunchTemplate 定义中指定的启动模板。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中为实例类型指定不同的启动模板。 每个自动缩放组最多可以指定 20 个启动模板。 替代中指定的启动模板和 LaunchTemplate 定义将计入此限制。 指定为自动缩放组预配 EC2 实例时要使用的启动模板。 必须指定以下内容:+ 启动模板的 ID 或名称,但不能同时指定这两者。 + 启动模板的版本。
LaunchTemplateSpecification 是 AWS::AutoScaling::AutoScalingGroup 资源的属性。 它也是 AWS::AutoScaling::AutoScalingGroup LaunchTemplate 和 AWS::AutoScaling::AutoScalingGroup LaunchTemplateOverrides 属性类型的属性。 有关创建启动模板的信息,请参阅 AWS::EC2::LaunchTemplate,Amazon EC2 自动缩放用户指南创建自动缩放 组的启动模板。 有关启动模板的示例,请参阅 资源中的 自动缩放模板片段 和 AWS::EC2::LaunchTemplate 部分。 |
LaunchTemplate规范 |
weightedCapacity (加权容量) | 如果提供要使用的实例类型列表,则可以根据虚拟 CPU、内存、存储、吞吐量或其他相对性能特征指定每个实例类型提供的容量单位数。 启动现成实例或按需实例时,容量单位将计入所需容量。 Amazon EC2 自动缩放会启动实例,直到完全满足所需的容量,即使这会导致超额。 例如,如果剩余两个单位来满足容量,而 Amazon EC2 自动缩放只能启动一个实例,其 WeightedCapacity 为 5 个单位,则启动实例,所需容量超过三个单位。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 为 Amazon EC2 自动缩放 配置实例权重。 值必须介于 1-999 的范围内。 如果为一个实例类型指定 WeightedCapacity 值,则必须为所有实例类型指定 WeightedCapacity 值。 每个自动缩放组都有三个大小参数(DesiredCapacity 、MaxSize 和 MinSize )。 通常,根据特定数量的实例设置这些大小。 但是,如果配置定义实例类型的权重的混合实例策略,则必须使用用于加权实例的相同单位来指定这些大小。 |
字符串 |
LaunchTemplate规范
名字 | 描述 | 价值 |
---|---|---|
launchTemplateId | 启动模板的 ID。 必须指定 LaunchTemplateID 或 LaunchTemplateName ,但不能同时指定两者。 |
字符串 |
launchTemplate名称 | 启动模板的名称。 必须指定 LaunchTemplateName 或 LaunchTemplateID ,但不能同时指定两者。 |
字符串 |
版本 | 启动模板的版本号。 不支持为模板版本号指定 $Latest 或 $Default 。 但是,可以使用 LatestVersionNumber 内部函数指定 DefaultVersionNumber 或 Fn::GetAtt 。 有关详细信息,请参阅 Fn::GetAtt。 有关使用 Fn::GetAtt 函数的示例,请参阅 资源的 AWS::AutoScaling::AutoScalingGroup 部分。 |
字符串 |
LifecycleHook规范
名字 | 描述 | 价值 |
---|---|---|
defaultResult | 当生命周期挂钩超时过或发生意外故障时,自动缩放组采取的操作。 默认值为 ABANDON 。 有效值:CONTINUE | ABANDON |
字符串 |
heartbeatTimeout (心跳超时) | 生命周期挂钩超时前最长的时间(以秒为单位)。范围从 30 到 7200 秒。 默认值为 3600 秒(1 小时)。 |
整数 (int) |
生命周期钩子名称 | 生命周期挂钩的名称。 | 字符串 |
lifecycleTransition 生命周期 | 生命周期转换。 对于自动缩放组,有两个主要生命周期转换。 + 若要为横向扩展事件创建生命周期挂钩,请指定 autoscaling:EC2_INSTANCE_LAUNCHING 。 + 若要为横向扩展事件创建生命周期挂钩,请指定 autoscaling:EC2_INSTANCE_TERMINATING 。 |
字符串 |
notification元数据 | 在 Amazon EC2 自动缩放向通知目标发送消息时,要包括的其他信息。 | 字符串 |
notificationTargetARN | Amazon EC2 自动缩放在实例处于生命周期挂钩等待状态时将通知发送到的通知目标的 Amazon 资源名称(ARN)。 可以指定 Amazon SNS 主题或 Amazon SQS 队列。 | 字符串 |
roleARN | 允许自动缩放组发布到指定通知目标的 IAM 角色的 ARN。 有关创建此角色的信息,请参阅 Amazon EC2 自动缩放用户指南中为生命周期挂钩 配置通知目标。 仅当通知目标是 Amazon SNS 主题或 Amazon SQS 队列时有效。 | 字符串 |
MemoryGiBPerVCpuRequest
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | GiB 中的内存最大值。 | 整数 (int) |
分钟 | GiB 中的内存最小值。 | 整数 (int) |
内存MiBRequest
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | MiB 中的内存最大值。 | 整数 (int) |
分钟 | MiB 中的内存最小值。 | 整数 (int) |
MetricsCollection
名字 | 描述 | 价值 |
---|---|---|
粒度 | Amazon EC2 自动缩放向 CloudWatch 发送聚合数据的频率。 唯一的有效值为 1Minute 。 |
字符串 |
指标 | 标识要启用的指标。 可以指定以下一个或多个指标:+ GroupMinSize + GroupMaxSize + GroupDesiredCapacity + GroupInServiceInstances + GroupPendingInstances + GroupStandbyInstances + GroupTerminatingInstances + GroupTotalInstances + GroupInServiceCapacity + GroupPendingCapacity + GroupStandbyCapacity + GroupTerminatingCapacity + GroupTotalCapacity + WarmPoolDesiredCapacity + WarmPoolWarmedCapacity + WarmPoolPendingCapacity + WarmPoolTerminatingCapacity + WarmPoolTotalCapacity + GroupAndWarmPoolDesiredCapacity + GroupAndWarmPoolTotalCapacity 如果指定 Granularity 且未指定任何指标, 所有指标都已启用。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 自动缩放组指标。 |
字符串[] |
MixedInstancesPolicy
名字 | 描述 | 价值 |
---|---|---|
instancesDistribution (实例分布) | 实例分布。 使用此结构可以指定按需实例和现成实例的分布,以及用于满足混合实例策略按需和现成容量的分配策略。 有关详细信息,请参阅 InstancesDistribution 是 AWS::AutoScaling::AutoScalingGroup MixedInstancesPolicy 属性类型的属性。 |
实例分布 |
launchTemplate (启动模板) | 一个或多个启动模板以及用于启动 EC2 实例的实例类型(替代),以满足按需和现成容量。 使用此结构可以指定混合实例策略的启动模板和实例类型(替代)。
LaunchTemplate 是 AWS::AutoScaling::AutoScalingGroup MixedInstancesPolicy 属性类型的属性。 |
LaunchTemplate (启动模板) |
NetworkBandwidth GbpsRequest
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | 最大网络带宽量(以千兆位/秒为单位)(Gbps)。 | 整数 (int) |
分钟 | 最小网络带宽量(以千兆位/秒为单位)。 | 整数 (int) |
NetworkInterfaceCountRequest 请求
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | 网络接口的最大数目。 | 整数 (int) |
分钟 | 网络接口的最小数目。 | 整数 (int) |
通知配置
名字 | 描述 | 价值 |
---|---|---|
notificationTypes | 发送通知的事件类型的列表。 事件类型可以包括以下任一类型。
允许的值: + autoscaling:EC2_INSTANCE_LAUNCH + autoscaling:EC2_INSTANCE_LAUNCH_ERROR + autoscaling:EC2_INSTANCE_TERMINATE + autoscaling:EC2_INSTANCE_TERMINATE_ERROR + autoscaling:TEST_NOTIFICATION |
字符串[] |
topicARN | Amazon SNS 主题的 Amazon 资源名称(ARN)。 | 字符串 |
Tag属性
名字 | 描述 | 价值 |
---|---|---|
钥匙 | 标记键。 | 字符串 |
propagateAtLaunch | 如果希望 CloudFormation 将标记复制到作为自动缩放组的一部分启动的 EC2 实例,则设置为 true 。 如果希望标记仅附加到自动缩放组,而不复制到作为自动缩放组的一部分启动的任何实例,则设置为 false 。 |
布尔 |
价值 | 标记值。 | 字符串 |
TotalLocalStorageGB 请求
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | 存储最大值(以 GB 为单位)。 | 整数 (int) |
分钟 | 存储最小值(以 GB 为单位)。 | 整数 (int) |
TrackedResourceTags
名字 | 描述 | 价值 |
---|
VCpuCount请求
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | vCPU 的最大数目。 | 整数 (int) |
分钟 | vCPU 的最小数目。 | 整数 (int) |
ARM 模板资源定义
可以使用目标操作部署 autoScalingAutoScalingGroups 资源类型:
- 资源组 - 请参阅 资源组部署命令
有关每个 API 版本中已更改属性的列表,请参阅 更改日志。
资源格式
若要创建 Microsoft.AwsConnector/autoScalingAutoScalingGroups 资源,请将以下 JSON 添加到模板。
{
"type": "Microsoft.AwsConnector/autoScalingAutoScalingGroups",
"apiVersion": "2024-12-01",
"name": "string",
"location": "string",
"properties": {
"arn": "string",
"awsAccountId": "string",
"awsProperties": {
"autoScalingGroupName": "string",
"availabilityZones": [ "string" ],
"capacityRebalance": "bool",
"context": "string",
"cooldown": "string",
"defaultInstanceWarmup": "int",
"desiredCapacity": "string",
"desiredCapacityType": "string",
"healthCheckGracePeriod": "int",
"healthCheckType": "string",
"instanceId": "string",
"instanceMaintenancePolicy": {
"maxHealthyPercentage": "int",
"minHealthyPercentage": "int"
},
"launchConfigurationName": "string",
"launchTemplate": {
"launchTemplateId": "string",
"launchTemplateName": "string",
"version": "string"
},
"lifecycleHookSpecificationList": [
{
"defaultResult": "string",
"heartbeatTimeout": "int",
"lifecycleHookName": "string",
"lifecycleTransition": "string",
"notificationMetadata": "string",
"notificationTargetARN": "string",
"roleARN": "string"
}
],
"loadBalancerNames": [ "string" ],
"maxInstanceLifetime": "int",
"maxSize": "string",
"metricsCollection": [
{
"granularity": "string",
"metrics": [ "string" ]
}
],
"minSize": "string",
"mixedInstancesPolicy": {
"instancesDistribution": {
"onDemandAllocationStrategy": "string",
"onDemandBaseCapacity": "int",
"onDemandPercentageAboveBaseCapacity": "int",
"spotAllocationStrategy": "string",
"spotInstancePools": "int",
"spotMaxPrice": "string"
},
"launchTemplate": {
"launchTemplateSpecification": {
"launchTemplateId": "string",
"launchTemplateName": "string",
"version": "string"
},
"overrides": [
{
"instanceRequirements": {
"acceleratorCount": {
"max": "int",
"min": "int"
},
"acceleratorManufacturers": [ "string" ],
"acceleratorNames": [ "string" ],
"acceleratorTotalMemoryMiB": {
"max": "int",
"min": "int"
},
"acceleratorTypes": [ "string" ],
"allowedInstanceTypes": [ "string" ],
"bareMetal": "string",
"baselineEbsBandwidthMbps": {
"max": "int",
"min": "int"
},
"burstablePerformance": "string",
"cpuManufacturers": [ "string" ],
"excludedInstanceTypes": [ "string" ],
"instanceGenerations": [ "string" ],
"localStorage": "string",
"localStorageTypes": [ "string" ],
"maxSpotPriceAsPercentageOfOptimalOnDemandPrice": "int",
"memoryGiBPerVCpu": {
"max": "int",
"min": "int"
},
"memoryMiB": {
"max": "int",
"min": "int"
},
"networkBandwidthGbps": {
"max": "int",
"min": "int"
},
"networkInterfaceCount": {
"max": "int",
"min": "int"
},
"onDemandMaxPricePercentageOverLowestPrice": "int",
"requireHibernateSupport": "bool",
"spotMaxPricePercentageOverLowestPrice": "int",
"totalLocalStorageGB": {
"max": "int",
"min": "int"
},
"vCpuCount": {
"max": "int",
"min": "int"
}
},
"instanceType": "string",
"launchTemplateSpecification": {
"launchTemplateId": "string",
"launchTemplateName": "string",
"version": "string"
},
"weightedCapacity": "string"
}
]
}
},
"newInstancesProtectedFromScaleIn": "bool",
"notificationConfiguration": {
"notificationTypes": [ "string" ],
"topicARN": "string"
},
"notificationConfigurations": [
{
"notificationTypes": [ "string" ],
"topicARN": "string"
}
],
"placementGroup": "string",
"serviceLinkedRoleARN": "string",
"tags": [
{
"key": "string",
"propagateAtLaunch": "bool",
"value": "string"
}
],
"targetGroupARNs": [ "string" ],
"terminationPolicies": [ "string" ],
"vpcZoneIdentifier": [ "string" ]
},
"awsRegion": "string",
"awsSourceSchema": "string",
"awsTags": {
"{customized property}": "string"
},
"publicCloudConnectorsResourceId": "string",
"publicCloudResourceName": "string"
},
"tags": {
"{customized property}": "string"
}
}
属性值
Microsoft.AwsConnector/autoScalingAutoScalingGroups
名字 | 描述 | 价值 |
---|---|---|
apiVersion | API 版本 | '2024-12-01' |
位置 | 资源所在的地理位置 | string (必需) |
名字 | 资源名称 | 字符串 约束: 模式 = ^(?=.{0,259}[^\s.]$)(?!.*[<>%&\?/#]) (必需) |
性能 | 此资源的资源特定属性。 | AutoScalingGroupProperties |
标签 | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
类型 | 资源类型 | “Microsoft.AwsConnector/autoScalingAutoScalingGroups” |
AcceleratorCount请求
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | 最大值。 | 整数 (int) |
分钟 | 最小值。 | 整数 (int) |
AcceleratorTotalMemoryMiBRequest
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | MiB 中的内存最大值。 | 整数 (int) |
分钟 | MiB 中的内存最小值。 | 整数 (int) |
AutoScalingGroupProperties
名字 | 描述 | 价值 |
---|---|---|
阿恩 | Amazon 资源名称 (ARN) | 字符串 |
awsAccountId | AWS 帐户 ID | 字符串 |
awsProperties | AWS 属性 | AwsAutoScalingGroupProperties |
awsRegion | AWS 区域 | 字符串 |
awsSourceSchema | AWS 源架构 | 字符串 |
aws标签 | AWS 标记 | AutoScalingGroupPropertiesAwsTags |
publicCloudConnectorsResourceId | 公有云连接器资源 ID | 字符串 |
publicCloudResourceName (公共云资源名称) | 公有云资源名称 | 字符串 |
AutoScalingGroupPropertiesAwsTags
名字 | 描述 | 价值 |
---|
AwsAutoScalingGroupProperties
名字 | 描述 | 价值 |
---|---|---|
autoScalingGroupName | 自动缩放组的名称。 此名称必须为每个帐户的每个区域唯一。 该名称可以包含任何 ASCII 字符 33 到 126,包括大多数标点符号字符、数字和大写字母和小写字母。 不能在名称中使用冒号(:))。 | 字符串 |
可用性区域 | 可在其中创建自动缩放组中的实例的可用性区域列表。 用于在不使用 VPCZoneIdentifier 属性时在每个可用性区域中启动到默认的VP 子网,或者在启动模板中指定现有网络接口 ID 时附加网络接口。 |
字符串[] |
capacity再平衡 | 指示是否启用了容量重新均衡。 否则,将禁用容量重新均衡。 启用容量重新均衡时,每当 Amazon EC2 通知现成实例处于中断风险时,Amazon EC2 自动缩放将尝试启动现成实例。 启动新实例后,它会终止旧实例。 有关详细信息,请参阅 使用容量重新均衡在 Amazon EC2 自动缩放用户指南中处理 Amazon EC2 现成中断。 | 布尔 |
上下文 | 保留。 | 字符串 |
冷却时间 | 仅当使用简单的缩放策略时才需要。 由于简单的缩放策略,在一个缩放活动结束和另一个缩放活动之间开始的时间量(以秒为单位)。 有关详细信息,请参阅 300 秒 |
字符串 |
defaultInstanceWarmup 实例预热 | 在进入 InService 状态后,新实例完成初始化和资源消耗的时间量(以秒为单位)。 在实例刷新期间,Amazon EC2 自动缩放在替换实例之前,在替换实例之前等待预热期。 Amazon EC2 自动缩放还会等待预热期,然后聚合新实例的指标以及用于缩放的 Amazon CloudWatch 指标中的现有实例,从而生成更可靠的使用情况数据。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南 设置自动缩放组的默认实例预热。 若要在组级别管理各种预热设置,建议设置默认实例预热,即使设置为 0 秒也是如此。 若要删除之前设置的值,请包含该属性,但为该值指定 -1 。 但是,我们强烈建议通过指定 0 或其他名义值来启用默认实例预热。 默认值:无 |
整数 (int) |
desiredCapacity | 所需容量是创建时自动缩放组的初始容量,也是其尝试维护的容量。 如果配置自动缩放,则可以超出此容量。 该数字必须大于或等于组的最小大小,并且小于或等于组的最大大小。 如果在创建堆栈时未指定所需的容量,则默认值为组的最小大小。 当达到所需容量时,CloudFormation 会将自动缩放组标记为成功(通过将状态设置为CREATE_COMPLETE)。 但是,如果在指定的启动模板或启动配置中设置了最高现成价格,则所需的容量不会用作成功标准。 请求是否满足取决于现成实例容量和最高价格。 | 字符串 |
desiredCapacityType | 为所需容量指定的值的度量单位。 Amazon EC2 自动缩放仅支持 DesiredCapacityType 基于属性的实例类型选择。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中使用基于属性的实例类型选择 创建自动缩放组。 默认情况下,Amazon EC2 自动缩放指定 units ,这将转换为实例数。 取值: units | vcpu | memory-mib |
字符串 |
healthCheckGracePeriod | Amazon EC2 自动缩放在检查已进入服务的 EC2 实例的运行状况状态并由于运行状况检查失败而将其标记为不正常之前,Amazon EC2 自动缩放等待的时间(以秒为单位)。 如果实例在进入 InService 状态后不会立即通过其运行状况检查,则这非常有用。 有关详细信息,请参阅 0 秒 |
整数 (int) |
healthCheckType | 一个或多个运行状况检查类型的逗号分隔值字符串。 有效值为 EC2 、ELB 和 VPC_LATTICE 。
EC2 是默认的运行状况检查,无法禁用。 有关详细信息,请参阅 EC2 。 |
字符串 |
instanceId | 用于基于启动配置的实例的 ID。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中使用 EC2 实例 创建自动缩放组。 如果指定 LaunchTemplate 、MixedInstancesPolicy 或 LaunchConfigurationName ,则不指定 InstanceId 。 |
字符串 |
instanceMaintenancePolicy 的 | 实例维护策略。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 设置实例维护策略。
InstanceMaintenancePolicy 是 AWS::AutoScaling::AutoScalingGroup 资源的属性。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 实例维护 策略。 |
InstanceMaintenancePolicy 实例维护策略 |
launchConfigurationName | 用于启动实例的启动配置的名称。 仅当未指定 LaunchTemplate 、MixedInstancesPolicy 或 InstanceId 时才是必需的。 |
字符串 |
launchTemplate (启动模板) | 用于指定用于启动实例的启动模板和版本的信息。 也可以通过指定 MixedInstancesPolicy 将启动模板关联到自动缩放组。 有关创建启动模板的详细信息,请参阅 Amazon EC2 自动缩放用户指南中创建自动缩放组 的启动模板。 如果省略此属性,则必须指定 MixedInstancesPolicy 、LaunchConfigurationName 或 InstanceId 。 指定为自动缩放组预配 EC2 实例时要使用的启动模板。 必须指定以下内容:+ 启动模板的 ID 或名称,但不能同时指定这两者。 + 启动模板的版本。
LaunchTemplateSpecification 是 AWS::AutoScaling::AutoScalingGroup 资源的属性。 它也是 AWS::AutoScaling::AutoScalingGroup LaunchTemplate 和 AWS::AutoScaling::AutoScalingGroup LaunchTemplateOverrides 属性类型的属性。 有关创建启动模板的信息,请参阅 AWS::EC2::LaunchTemplate,Amazon EC2 自动缩放用户指南创建自动缩放 组的启动模板。 有关启动模板的示例,请参阅 资源中的 自动缩放模板片段 和 AWS::EC2::LaunchTemplate 部分。 |
LaunchTemplate规范 |
lifecycleHookSpecificationList | 在启动实例之前,要添加到自动缩放组的一个或多个生命周期挂钩。 | LifecycleHookSpecification[] |
loadBalancer名称 | 与此自动缩放组关联的经典负载均衡器的列表。 对于应用程序负载均衡器、网络负载均衡器和网关负载均衡器,请改为指定 TargetGroupARNs 属性。 |
字符串[] |
maxInstanceLifetime | 实例可以在服务中的最大时间量(以秒为单位)。 默认值为 null。 如果指定,则该值必须为 0 或等于或大于 86,400 秒的数字(1 天)。 有关详细信息,请参阅 |
整数 (int) |
最大大小 | 组的最大大小。 使用实例加权的混合实例策略时,Amazon EC2 自动缩放可能需要超过 MaxSize 以满足容量要求。 在此事件中,Amazon EC2 自动缩放永远不会超过 MaxSize 最大实例权重(定义每个实例对组所需容量贡献的单位数的权重)。 |
字符串 |
metricsCollection | 启用自动缩放组的组指标的监视。 默认情况下,这些指标处于禁用状态。 | MetricsCollection[] |
最小大小 | 组的最小大小。 | 字符串 |
mixedInstancesPolicy 的 | 一个嵌入对象,指定混合实例策略。 该策略包括的属性不仅定义了按需实例和现成实例的分布、为现成实例支付的最高费用(可选),以及自动缩放组如何分配实例类型来满足按需容量和现成容量,还定义了指定实例配置信息的属性-启动模板和实例类型。 该策略还可以包括每个实例类型的权重,以及各个实例类型的不同启动模板。 有关详细信息,请参阅 MixedInstancesPolicy 是 AWS::AutoScaling::AutoScalingGroup 资源的属性。 |
MixedInstancesPolicy |
newInstancesProtectedFromScaleIn | 指示在扩展时,Amazon EC2 自动缩放是否保护新启动的实例不受终止。 有关防止实例在横向缩减时终止的详细信息,请参阅 Amazon EC2 自动缩放用户指南使用实例缩减保护。 | 布尔 |
notificationConfiguration | 为 NotificationConfigurations 资源 属性指定 Amazon SNS 通知配置的结构。 有关示例模板片段,请参阅 自动缩放模板代码片段。 有关详细信息,请参阅 在 amazon EC2 自动缩放用户指南中的自动缩放组缩放 时获取 Amazon SNS 通知。 |
通知配置 |
notificationConfigurations | 配置自动缩放组,以在发生指定事件时发送通知。 | NotificationConfiguration[] |
placementGroup | 要在其中启动实例的位置组的名称。 有关详细信息,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中的 放置组。 群集 放置组是单个可用性区域中实例的逻辑分组。 不能指定多个可用性区域和群集放置组。 | 字符串 |
serviceLinkedRoleARN | 自动缩放组用来代表你调用其他 AWS 服务的服务链接角色的 Amazon 资源名称(ARN)。 默认情况下,Amazon EC2 自动缩放使用名为 AWSServiceRoleForAutoScaling 的服务链接角色,如果不存在,则会创建该角色。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 服务链接角色。 |
字符串 |
标签 | 一个或多个标记。 可以标记自动缩放组,并将标记传播到它启动的 Amazon EC2 实例。 标记不会传播到 Amazon EBS 卷。 若要将标记添加到 Amazon EBS 卷,请在启动模板中指定标记,但请谨慎使用。 如果启动模板使用为自动缩放组指定的键指定实例标记,Amazon EC2 自动缩放会用自动缩放组指定的值替代该实例标记的值。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 标记自动缩放组和 实例。 | TagProperty[] |
targetGroupARNs | 要与自动缩放组关联的弹性负载均衡目标组的 Amazon 资源名称(ARN)。 实例注册为目标组的目标。 目标组接收传入流量并将请求路由到一个或多个已注册的目标。 有关详细信息,请参阅 |
字符串[] |
terminationPolicies | 用于选择要终止的实例的策略或策略列表。 按照列出策略的顺序执行这些策略。 有关详细信息,请参阅 Default | AllocationStrategy | ClosestToNextInstanceHour | NewestInstance | OldestInstance | OldestLaunchConfiguration | OldestLaunchTemplate | arn:aws:lambda:region:account-id:function:my-function:my-alias |
字符串[] |
vpZoneIdentifier | 虚拟私有云的子网 ID 列表,可在其中创建自动缩放组中的实例。 如果此资源指定公共子网,并且也位于同一堆栈模板中定义的一个 VPCZoneIdentifier 时,这会保留相同的自动缩放组,并根据指定的子网将旧实例替换为新实例。 可以选择使用 UpdatePolicy 属性指定 CloudFormation 如何处理这些更新。 需要将实例启动到非默认的VP 中。 如果使用 VPCZoneIdentifier 指定 AvailabilityZones ,则为此属性指定的子网必须驻留在这些可用性区域中。 |
字符串[] |
BaselineEbsBandwidthMbps请求
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | 最大值(以 Mbps 为单位)。 | 整数 (int) |
分钟 | 最小值(以 Mbps 为单位)。 | 整数 (int) |
InstanceMaintenancePolicy 实例维护策略
名字 | 描述 | 价值 |
---|---|---|
maxHealthyPercentage | 将上限指定为自动缩放组所需容量的百分比。 它表示在替换实例时可以处于服务和正常运行或挂起状态的组的最大百分比,以支持工作负荷。 值范围为 100 到 200。 若要清除以前设置的值,请指定一个 -1 值。 必须同时指定 MinHealthyPercentage 和 MaxHealthyPercentage ,并且它们之间的差异不能大于 100。 较大的范围会增加可以同时替换的实例数。 |
整数 (int) |
minHealthyPercentage (最小健康百分比) | 将较低的阈值指定为自动缩放组所需容量的百分比。 它表示要保留在服务中的组的最小百分比、正常运行,并准备好在替换实例时支持工作负荷。 值范围为 0 到 100。 若要清除以前设置的值,请指定一个 -1 值。 |
整数 (int) |
实例要求
名字 | 描述 | 价值 |
---|---|---|
acceleratorCount | 实例类型的最小和最大加速器数(GPU、FPGA 或 AWS 推理芯片)。 若要排除启用了加速器的实例类型,请将 Max 设置为 0 。 默认值:AcceleratorCountRequest 没有最小或最大限制是 InstanceRequirements 属性类型的 属性的属性,该属性类型描述实例类型的最小和最大加速键数。 |
AcceleratorCount请求 |
加速器制造商 | 指示实例类型是否必须具有特定制造商的加速器。 + 对于具有 NVIDIA 设备的实例类型,请指定 nvidia 。 + 对于 AMD 设备的实例类型,请指定 amd 。 + 对于 AWS 设备的实例类型,请指定 amazon-web-services 。 + 对于具有 Xilinx 设备的实例类型,请指定 xilinx 。 默认值:任何制造商 |
字符串[] |
加速器名称 | 列出必须位于实例类型的加速器。 + 对于 NVIDIA A100 GPU 的实例类型,请指定 a100 。 + 对于 NVIDIA V100 GPU 的实例类型,请指定 v100 。 + 对于 NVIDIA K80 GPU 的实例类型,请指定 k80 。 + 对于具有 NVIDIA T4 GPU 的实例类型,请指定 t4 。 + 对于 NVIDIA M60 GPU 的实例类型,请指定 m60 。 + 对于 AMD Radeon Pro V520 GPU 的实例类型,请指定 radeon-pro-v520 。 + 对于具有 Xilinx VU9P FPGA 的实例类型,请指定 vu9p 。 默认值:任何加速器 |
字符串[] |
acceleratorTotalMemoryMiB | 实例类型上加速器的最小和最大总内存大小(以 MiB 为单位)。 默认值:AcceleratorTotalMemoryMiBRequest 没有最小或最大限制是 InstanceRequirements 属性类型的 属性的属性,用于描述实例类型的加速器的最小和最大总内存大小(在 MiB 中)。 |
AcceleratorTotalMemoryMiBRequest |
acceleratorTypes | 列出必须位于实例类型的加速器类型。 + 对于具有 GPU 加速器的实例类型,请指定 gpu 。 + 对于具有 FPGA 加速器的实例类型,请指定 fpga 。 + 对于具有推理加速器的实例类型,请指定 inference 。 默认值:任何加速器类型 |
字符串[] |
allowedInstanceTypes | 要对其应用指定属性的实例类型。 将忽略所有其他实例类型,即使它们与指定的属性匹配。 可以将字符串与星号(* )表示的一个或多个通配符一起使用,以允许实例类型、大小或生成。 下面是示例:m5.8xlarge 、c5*.* 、m5a.* 、r* 、*3* 。 例如,如果指定 c5* ,Amazon EC2 自动缩放将允许整个 C5 实例系列,其中包括所有 C5a 和 C5n 实例类型。 如果指定 m5a.* ,Amazon EC2 自动缩放将允许所有 M5a 实例类型,但不允许 M5n 实例类型。 如果指定 AllowedInstanceTypes ,则无法指定 ExcludedInstanceTypes 。 默认值:所有实例类型 |
字符串[] |
裸金属 | 指示是否包括、排除或必需裸机实例类型。 默认值:excluded |
字符串 |
baselineEbs带宽Mbps | 实例类型的最小和最大基线带宽性能(以 Mbps 为单位)。 有关详细信息,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中的 Amazon EBS 优化实例。 默认值:BaselineEbsBandwidthMbpsRequest 的最小或最大限制不是 InstanceRequirements 属性类型的 属性的属性,用于描述实例类型的最小和最大基线带宽性能(以 Mbps 为单位)。 |
BaselineEbsBandwidthMbps请求 |
burstablePerformance (突发性能) | 指示是否包括、排除或需要可突发性能实例类型。 有关详细信息,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中的 可突发性能实例。 默认值:excluded |
字符串 |
cpu制造商 | 列出要包括的特定 CPU 制造商。 + 对于具有 Intel CPU 的实例类型,请指定 intel 。 + 对于具有 AMD CPU 的实例类型,请指定 amd 。 + 对于具有 AWS CPU 的实例类型,请指定 amazon-web-services 。 不要将 CPU 硬件制造商与 CPU 硬件体系结构混淆。 实例将使用在启动模板中指定的 Amazon Machine Image (AMI)的兼容 CPU 体系结构启动。 默认值:任何制造商 |
字符串[] |
excludedInstanceTypes | 要排除的实例类型。 可以将字符串与一个或多个通配符(由星号(* )表示)一起使用,以排除实例系列、类型、大小或代系。 下面是示例:m5.8xlarge 、c5*.* 、m5a.* 、r* 、*3* 。 例如,如果指定 c5* ,则会排除整个 C5 实例系列,其中包括所有 C5a 和 C5n 实例类型。 如果指定 m5a.* ,Amazon EC2 自动缩放将排除所有 M5a 实例类型,但不包括 M5n 实例类型。 如果指定 ExcludedInstanceTypes ,则无法指定 AllowedInstanceTypes 。 默认值:无排除的实例类型 |
字符串[] |
instanceGenerations 实例代数 | 指示是否包括当前或上一代实例类型。 + 对于当前生成实例类型,请指定 current 。 当前代包括当前建议使用的 EC2 实例类型。 这通常包括每个实例系列中最新的两到三代。 有关详细信息,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中的 实例类型。 + 对于上一代实例类型,请指定 previous 。 默认值:任何当前或上一代 |
字符串[] |
localStorage (本地存储) | 指示实例存储卷的实例类型是包含、排除还是必需。 有关详细信息,请参阅适用于 Linux 实例included |
字符串 |
localStorageTypes | 指示所需的本地存储的类型。 + 对于具有硬盘驱动器(HDD)存储的实例类型,请指定 hdd 。 + 对于具有固态驱动器(SSD)存储的实例类型,请指定 ssd 。 默认值:任何本地存储类型 |
字符串[] |
maxSpotPriceAsPercentageOfOptimalOnDemandPrice | [价格保护]现成实例的价格保护阈值,作为已识别的按需价格的百分比。 标识的按需价格是具有指定属性的当前代 C、M 或 R 实例类型最低价格的价格。 如果没有当前代 C、M 或 R 实例类型与属性匹配,则标识的价格来自最低价格的当前代实例类型,或者失败,即与属性匹配的最低定价的上一代实例类型。 当 Amazon EC2 自动缩放选择具有属性的实例类型时,我们将排除其价格超过指定阈值的实例类型。 该参数接受一个整数,Amazon EC2 自动缩放将其解释为百分比。 若要指示没有价格保护阈值,请指定高值,例如 999999 。 如果将 DesiredCapacityType 设置为 vcpu 或 memory-mib ,则价格保护阈值基于每个 vCPU 或每内存价格,而不是每个实例价格。 只能指定 SpotMaxPricePercentageOverLowestPrice 或 MaxSpotPriceAsPercentageOfOptimalOnDemandPrice 之一。 如果未指定,则使用 SpotMaxPricePercentageOverLowestPrice ,该参数的值默认为 100 。 |
整数 (int) |
内存GiBPerVCpu | 实例类型的每个 vCPU 的最小和最大内存量(以 GiB 为单位)。 默认值:MemoryGiBPerVCpuRequest 没有最小或最大限制是 InstanceRequirements 属性类型的 属性的属性,用于描述实例类型每个 vCPU 的最小和最大内存量(在 GiB 中)。 |
MemoryGiBPerVCpuRequest |
内存MiB | 实例类型的最小和最大实例内存大小(以 MiB 为单位)。
MemoryMiBRequest 是 InstanceRequirements 属性类型的 属性的属性,描述 MiB 中实例类型的最小和最大实例内存大小。 |
内存MiBRequest |
networkBandwidth Gbps | 最小和最大网络带宽量(以千兆位/秒为单位)(Gbps)。 默认值:NetworkBandwidthGbpsRequest 没有最小或最大限制是 InstanceRequirements 属性类型的 属性的属性,该属性类型描述实例类型的最小和最大网络带宽(以 Gbps 为单位)。 设置最小带宽不能保证实例将达到最小带宽。 Amazon EC2 将识别支持指定最小带宽的实例类型,但实例的实际带宽有时可能低于指定的最小值。 有关详细信息,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中的 可用实例带宽。 |
NetworkBandwidth GbpsRequest |
networkInterfaceCount | 实例类型的最小和最大网络接口数。 默认值:NetworkInterfaceCountRequest 的最小或最大限制不是 InstanceRequirements 属性类型的 属性的属性,该属性类型描述实例类型的网络接口的最小和最大数目。 |
NetworkInterfaceCountRequest 请求 |
onDemandMaxPricePercentageOverLowestPrice | [价格保护]按需实例的价格保护阈值,其百分比高于已确定的按需价格。 标识的按需价格是具有指定属性的当前代 C、M 或 R 实例类型最低价格的价格。 如果没有当前代 C、M 或 R 实例类型与属性匹配,则标识的价格来自最低价格的当前代实例类型,或者失败,即与属性匹配的最低定价的上一代实例类型。 当 Amazon EC2 自动缩放选择具有属性的实例类型时,我们将排除其价格超过指定阈值的实例类型。 该参数接受一个整数,Amazon EC2 自动缩放将其解释为百分比。 若要关闭价格保护,请指定高值,如 999999 。 如果将 DesiredCapacityType 设置为 vcpu 或 memory-mib ,则根据每个 vCPU 或每内存价格(而不是每个实例价格)应用价格保护阈值。 默认值:20 |
整数 (int) |
requireHibernateSupport | 指示实例类型是否必须提供按需实例休眠支持。 默认值:false |
布尔 |
spotMaxPricePercentageOverLowestPrice | [价格保护]现成实例的价格保护阈值,其百分比高于已确定的现成价格。 标识的现成价格是具有指定属性的当前代 C、M 或 R 实例类型最低价格的价格。 如果没有当前代 C、M 或 R 实例类型与属性匹配,则标识的价格来自最低价格的当前代实例类型,或者失败,即与属性匹配的最低定价的上一代实例类型。 当 Amazon EC2 自动缩放选择具有属性的实例类型时,我们将排除其价格超过指定阈值的实例类型。 该参数接受一个整数,Amazon EC2 自动缩放将其解释为百分比。 若要关闭价格保护,请指定高值,如 999999 。 如果将 DesiredCapacityType 设置为 vcpu 或 memory-mib ,则价格保护阈值基于每个 vCPU 或每内存价格,而不是每个实例价格。 只能指定 SpotMaxPricePercentageOverLowestPrice 或 MaxSpotPriceAsPercentageOfOptimalOnDemandPrice 之一。 默认值:100 |
整数 (int) |
总计本地存储 GB | 实例类型的最小和最大本地存储大小总计(以 GB 为单位)。 默认值:TotalLocalStorageGBRequest 没有最小或最大限制是 InstanceRequirements 属性类型的 属性的属性,用于描述实例类型的最小和最大本地存储大小(以 GB 为单位)。 |
TotalLocalStorageGB 请求 |
vCpuCount | 实例类型的最小和最大 vCPU 数。
VCpuCountRequest 是 InstanceRequirements 属性类型的 属性的属性,描述实例类型的最小和最大 vCPU 数。 |
VCpuCount请求 |
实例分布
名字 | 描述 | 价值 |
---|---|---|
onDemandAllocationStrategy | 启动时要应用于按需实例的分配策略。 可能的实例类型由指定的启动模板替代确定。 下表列出了有效值:+ 最低价格使用价格来确定哪些实例类型是最高优先级,首先在可用性区域中启动最低定价的实例类型。 这是指定 InstanceRequirements 的自动缩放组的默认值。 + 优先设置启动模板的实例类型顺序,从最高优先级到最低优先级(从第一个到最后一个列表)。 Amazon EC2 自动缩放首先启动最高优先级实例类型。 如果无法使用最高优先级实例类型满足所有按需容量,则 Amazon EC2 自动缩放将使用第二个优先级实例类型启动剩余容量,依此类推。 这是未指定 InstanceRequirements 的自动缩放组的默认值,不能用于执行操作的组。 | 字符串 |
onDemandBaseCapacity | 按需实例必须满足的自动缩放组容量的最小量。 当组缩放时,首先启动此基本部分。 此数字的度量单位与组的所需容量相同。 如果在启动模板替代列表中指定加权容量值或更改组的默认所需容量类型设置来更改默认度量单位(实例数),则必须使用相同的度量单位指定此数字。 默认值:0 此设置的更新意味着逐步替换实例以调整当前的按需实例级别。 替换实例时,Amazon EC2 自动缩放会在终止上述实例之前启动新实例。 | 整数 (int) |
onDemandPercentageAboveBaseCapacity | 控制超出 OnDemandBaseCapacity 的附加容量的按需实例和现成实例的百分比。 以数字表示(例如,20 指定 20% 个按需实例、80 个% 现成实例)。 如果设置为 100,则仅使用按需实例。 默认值:100 此设置的更新意味着逐步替换实例以调整当前按需实例和现成实例级别,以增加比基本容量更高的容量。 替换实例时,Amazon EC2 自动缩放会在终止上述实例之前启动新实例。 |
整数 (int) |
spotAllocationStrategy | 启动现成实例时要应用到现成实例的分配策略。 可能的实例类型由指定的启动模板替代确定。 下面列出了有效值:+ 容量优化的请求现成实例,这些实例使用基于可用现成容量以最佳方式选择的池。 此策略具有最低的中断风险。 若要使某些实例类型更有机会先启动,请使用容量优化优先顺序。 + 容量优化优先级:设置启动模板替代的实例类型顺序从最高优先级到最低优先级(从第一个到最后一个列表)。 Amazon EC2 自动缩放尽力遵循实例类型优先级,但首先针对容量进行优化。 请注意,如果按需分配策略设置为优先顺序,则满足按需容量时会应用相同的优先级。 对于指定 InstanceRequirements 的自动缩放组,此值无效。 + 最低价格请求使用可用性区域中价格最低的池的现成实例,跨为 SpotInstancePools 属性指定的现成池数。 为了确保满足所需的容量,可以从多个池接收现成实例。 这是默认值,但它可能会导致高中断率,因为此策略只考虑实例价格,而不是可用的容量。 + 价格容量优化(建议) 价格和容量优化分配策略同时查看价格和容量,以选择不太可能中断且价格最低的现成实例池。 | 字符串 |
spotInstancePools 实例池 | 要在其中分配现成实例的现成实例池数。 现成池根据替代中的不同实例类型确定。 仅在 SpotAllocationStrategy lowest-price 时有效。 值必须介于 1-20 的范围内。 默认值:2 |
整数 (int) |
现货最大价格 | 你愿意为现成实例支付的单位小时的最高价格。 如果最高价格低于所选实例类型的现成价格,则不会启动现成实例。 我们不建议指定最高价格,因为它可能导致中断增加。 当现成实例启动时,需支付当前现成价格。 若要删除之前设置的最高价格,请包含该属性,但为值指定空字符串 ('')。 如果指定最高价格,则实例将比未指定实例更频繁地中断。 有效范围:最小值为 0.001 | 字符串 |
LaunchTemplate (启动模板)
名字 | 描述 | 价值 |
---|---|---|
launchTemplate规范 | 启动模板。 指定为自动缩放组预配 EC2 实例时要使用的启动模板。 必须指定以下内容:+ 启动模板的 ID 或名称,但不能同时指定这两者。 + 启动模板的版本。
LaunchTemplateSpecification 是 AWS::AutoScaling::AutoScalingGroup 资源的属性。 它也是 AWS::AutoScaling::AutoScalingGroup LaunchTemplate 和 AWS::AutoScaling::AutoScalingGroup LaunchTemplateOverrides 属性类型的属性。 有关创建启动模板的信息,请参阅 AWS::EC2::LaunchTemplate,Amazon EC2 自动缩放用户指南创建自动缩放 组的启动模板。 有关启动模板的示例,请参阅 资源中的 自动缩放模板片段 和 AWS::EC2::LaunchTemplate 部分。 |
LaunchTemplate规范 |
重写 | 在启动模板中指定的任何属性都重写相同的属性。 | LaunchTemplate覆盖 |
LaunchTemplate覆盖
名字 | 描述 | 价值 |
---|---|---|
instanceRequirements | 实例要求。 Amazon EC2 自动缩放使用指定的要求来标识实例类型。 然后,它使用按需和现成分配策略从这些实例类型启动实例。 每个自动缩放组最多可以指定四个单独的实例要求集。 这可用于在同一自动缩放组中预配不同 Amazon Machine Images (AMIS) 的实例。 为此,请创建 AMIS 并为每个 AMI 创建新的启动模板。 然后,为每个启动模板创建一组兼容的实例要求。 如果指定 InstanceRequirements ,则无法指定 InstanceType 。 混合实例策略的实例类型的属性。 Amazon EC2 自动缩放使用指定的要求来标识实例类型。 然后,它使用按需和现成分配策略从这些实例类型启动实例。 指定多个属性时,将获得满足所有指定属性的实例类型。 如果为某个属性指定多个值,则获取满足任何指定值的实例类型。 若要限制 Amazon EC2 自动缩放可以标识匹配实例类型的实例类型列表,可以使用以下参数之一,但不能在同一请求中使用这些参数之一:+ AllowedInstanceTypes - 要包括在列表中的实例类型。 将忽略所有其他实例类型,即使它们与指定的属性匹配。
+
ExcludedInstanceTypes - 要从列表中排除的实例类型,即使它们与指定的属性匹配也是如此。 必须指定 VCpuCount 和 MemoryMiB 。 所有其他属性都是可选的。 任何未指定的可选属性都设置为其默认值。 有关示例模板,请参阅 自动缩放模板代码段。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中使用基于属性的实例类型选择 创建自动缩放组。 有关在将哪些实例类型应用到自动缩放组之前确定哪些实例类型与属性匹配的帮助,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中具有指定属性 的预览实例类型。
InstanceRequirements 是 LaunchTemplateOverrides 属性类型的 属性的属性。 |
实例要求 |
instanceType | 实例类型,例如 m3.xlarge 。 必须指定请求的区域和可用性区域中支持的实例类型。 有关详细信息,请参阅 Amazon Elastic Compute Cloud 用户指南中的 实例类型。 每个自动缩放组最多可以指定 40 个实例类型。 |
字符串 |
launchTemplate规范 | 为指定的实例类型或实例要求集提供启动模板。 例如,某些实例类型可能需要具有不同 AMI 的启动模板。 如果未提供,Amazon EC2 自动缩放将使用在 LaunchTemplate 定义中指定的启动模板。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中为实例类型指定不同的启动模板。 每个自动缩放组最多可以指定 20 个启动模板。 替代中指定的启动模板和 LaunchTemplate 定义将计入此限制。 指定为自动缩放组预配 EC2 实例时要使用的启动模板。 必须指定以下内容:+ 启动模板的 ID 或名称,但不能同时指定这两者。 + 启动模板的版本。
LaunchTemplateSpecification 是 AWS::AutoScaling::AutoScalingGroup 资源的属性。 它也是 AWS::AutoScaling::AutoScalingGroup LaunchTemplate 和 AWS::AutoScaling::AutoScalingGroup LaunchTemplateOverrides 属性类型的属性。 有关创建启动模板的信息,请参阅 AWS::EC2::LaunchTemplate,Amazon EC2 自动缩放用户指南创建自动缩放 组的启动模板。 有关启动模板的示例,请参阅 资源中的 自动缩放模板片段 和 AWS::EC2::LaunchTemplate 部分。 |
LaunchTemplate规范 |
weightedCapacity (加权容量) | 如果提供要使用的实例类型列表,则可以根据虚拟 CPU、内存、存储、吞吐量或其他相对性能特征指定每个实例类型提供的容量单位数。 启动现成实例或按需实例时,容量单位将计入所需容量。 Amazon EC2 自动缩放会启动实例,直到完全满足所需的容量,即使这会导致超额。 例如,如果剩余两个单位来满足容量,而 Amazon EC2 自动缩放只能启动一个实例,其 WeightedCapacity 为 5 个单位,则启动实例,所需容量超过三个单位。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 为 Amazon EC2 自动缩放 配置实例权重。 值必须介于 1-999 的范围内。 如果为一个实例类型指定 WeightedCapacity 值,则必须为所有实例类型指定 WeightedCapacity 值。 每个自动缩放组都有三个大小参数(DesiredCapacity 、MaxSize 和 MinSize )。 通常,根据特定数量的实例设置这些大小。 但是,如果配置定义实例类型的权重的混合实例策略,则必须使用用于加权实例的相同单位来指定这些大小。 |
字符串 |
LaunchTemplate规范
名字 | 描述 | 价值 |
---|---|---|
launchTemplateId | 启动模板的 ID。 必须指定 LaunchTemplateID 或 LaunchTemplateName ,但不能同时指定两者。 |
字符串 |
launchTemplate名称 | 启动模板的名称。 必须指定 LaunchTemplateName 或 LaunchTemplateID ,但不能同时指定两者。 |
字符串 |
版本 | 启动模板的版本号。 不支持为模板版本号指定 $Latest 或 $Default 。 但是,可以使用 LatestVersionNumber 内部函数指定 DefaultVersionNumber 或 Fn::GetAtt 。 有关详细信息,请参阅 Fn::GetAtt。 有关使用 Fn::GetAtt 函数的示例,请参阅 资源的 AWS::AutoScaling::AutoScalingGroup 部分。 |
字符串 |
LifecycleHook规范
名字 | 描述 | 价值 |
---|---|---|
defaultResult | 当生命周期挂钩超时过或发生意外故障时,自动缩放组采取的操作。 默认值为 ABANDON 。 有效值:CONTINUE | ABANDON |
字符串 |
heartbeatTimeout (心跳超时) | 生命周期挂钩超时前最长的时间(以秒为单位)。范围从 30 到 7200 秒。 默认值为 3600 秒(1 小时)。 |
整数 (int) |
生命周期钩子名称 | 生命周期挂钩的名称。 | 字符串 |
lifecycleTransition 生命周期 | 生命周期转换。 对于自动缩放组,有两个主要生命周期转换。 + 若要为横向扩展事件创建生命周期挂钩,请指定 autoscaling:EC2_INSTANCE_LAUNCHING 。 + 若要为横向扩展事件创建生命周期挂钩,请指定 autoscaling:EC2_INSTANCE_TERMINATING 。 |
字符串 |
notification元数据 | 在 Amazon EC2 自动缩放向通知目标发送消息时,要包括的其他信息。 | 字符串 |
notificationTargetARN | Amazon EC2 自动缩放在实例处于生命周期挂钩等待状态时将通知发送到的通知目标的 Amazon 资源名称(ARN)。 可以指定 Amazon SNS 主题或 Amazon SQS 队列。 | 字符串 |
roleARN | 允许自动缩放组发布到指定通知目标的 IAM 角色的 ARN。 有关创建此角色的信息,请参阅 Amazon EC2 自动缩放用户指南中为生命周期挂钩 配置通知目标。 仅当通知目标是 Amazon SNS 主题或 Amazon SQS 队列时有效。 | 字符串 |
MemoryGiBPerVCpuRequest
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | GiB 中的内存最大值。 | 整数 (int) |
分钟 | GiB 中的内存最小值。 | 整数 (int) |
内存MiBRequest
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | MiB 中的内存最大值。 | 整数 (int) |
分钟 | MiB 中的内存最小值。 | 整数 (int) |
MetricsCollection
名字 | 描述 | 价值 |
---|---|---|
粒度 | Amazon EC2 自动缩放向 CloudWatch 发送聚合数据的频率。 唯一的有效值为 1Minute 。 |
字符串 |
指标 | 标识要启用的指标。 可以指定以下一个或多个指标:+ GroupMinSize + GroupMaxSize + GroupDesiredCapacity + GroupInServiceInstances + GroupPendingInstances + GroupStandbyInstances + GroupTerminatingInstances + GroupTotalInstances + GroupInServiceCapacity + GroupPendingCapacity + GroupStandbyCapacity + GroupTerminatingCapacity + GroupTotalCapacity + WarmPoolDesiredCapacity + WarmPoolWarmedCapacity + WarmPoolPendingCapacity + WarmPoolTerminatingCapacity + WarmPoolTotalCapacity + GroupAndWarmPoolDesiredCapacity + GroupAndWarmPoolTotalCapacity 如果指定 Granularity 且未指定任何指标, 所有指标都已启用。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 自动缩放组指标。 |
字符串[] |
MixedInstancesPolicy
名字 | 描述 | 价值 |
---|---|---|
instancesDistribution (实例分布) | 实例分布。 使用此结构可以指定按需实例和现成实例的分布,以及用于满足混合实例策略按需和现成容量的分配策略。 有关详细信息,请参阅 InstancesDistribution 是 AWS::AutoScaling::AutoScalingGroup MixedInstancesPolicy 属性类型的属性。 |
实例分布 |
launchTemplate (启动模板) | 一个或多个启动模板以及用于启动 EC2 实例的实例类型(替代),以满足按需和现成容量。 使用此结构可以指定混合实例策略的启动模板和实例类型(替代)。
LaunchTemplate 是 AWS::AutoScaling::AutoScalingGroup MixedInstancesPolicy 属性类型的属性。 |
LaunchTemplate (启动模板) |
NetworkBandwidth GbpsRequest
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | 最大网络带宽量(以千兆位/秒为单位)(Gbps)。 | 整数 (int) |
分钟 | 最小网络带宽量(以千兆位/秒为单位)。 | 整数 (int) |
NetworkInterfaceCountRequest 请求
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | 网络接口的最大数目。 | 整数 (int) |
分钟 | 网络接口的最小数目。 | 整数 (int) |
通知配置
名字 | 描述 | 价值 |
---|---|---|
notificationTypes | 发送通知的事件类型的列表。 事件类型可以包括以下任一类型。
允许的值: + autoscaling:EC2_INSTANCE_LAUNCH + autoscaling:EC2_INSTANCE_LAUNCH_ERROR + autoscaling:EC2_INSTANCE_TERMINATE + autoscaling:EC2_INSTANCE_TERMINATE_ERROR + autoscaling:TEST_NOTIFICATION |
字符串[] |
topicARN | Amazon SNS 主题的 Amazon 资源名称(ARN)。 | 字符串 |
Tag属性
名字 | 描述 | 价值 |
---|---|---|
钥匙 | 标记键。 | 字符串 |
propagateAtLaunch | 如果希望 CloudFormation 将标记复制到作为自动缩放组的一部分启动的 EC2 实例,则设置为 true 。 如果希望标记仅附加到自动缩放组,而不复制到作为自动缩放组的一部分启动的任何实例,则设置为 false 。 |
布尔 |
价值 | 标记值。 | 字符串 |
TotalLocalStorageGB 请求
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | 存储最大值(以 GB 为单位)。 | 整数 (int) |
分钟 | 存储最小值(以 GB 为单位)。 | 整数 (int) |
TrackedResourceTags
名字 | 描述 | 价值 |
---|
VCpuCount请求
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | vCPU 的最大数目。 | 整数 (int) |
分钟 | vCPU 的最小数目。 | 整数 (int) |
用法示例
Terraform (AzAPI 提供程序)资源定义
可以使用目标操作部署 autoScalingAutoScalingGroups 资源类型:
- 资源组
有关每个 API 版本中已更改属性的列表,请参阅 更改日志。
资源格式
若要创建 Microsoft.AwsConnector/autoScalingAutoScalingGroups 资源,请将以下 Terraform 添加到模板。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.AwsConnector/autoScalingAutoScalingGroups@2024-12-01"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
arn = "string"
awsAccountId = "string"
awsProperties = {
autoScalingGroupName = "string"
availabilityZones = [
"string"
]
capacityRebalance = bool
context = "string"
cooldown = "string"
defaultInstanceWarmup = int
desiredCapacity = "string"
desiredCapacityType = "string"
healthCheckGracePeriod = int
healthCheckType = "string"
instanceId = "string"
instanceMaintenancePolicy = {
maxHealthyPercentage = int
minHealthyPercentage = int
}
launchConfigurationName = "string"
launchTemplate = {
launchTemplateId = "string"
launchTemplateName = "string"
version = "string"
}
lifecycleHookSpecificationList = [
{
defaultResult = "string"
heartbeatTimeout = int
lifecycleHookName = "string"
lifecycleTransition = "string"
notificationMetadata = "string"
notificationTargetARN = "string"
roleARN = "string"
}
]
loadBalancerNames = [
"string"
]
maxInstanceLifetime = int
maxSize = "string"
metricsCollection = [
{
granularity = "string"
metrics = [
"string"
]
}
]
minSize = "string"
mixedInstancesPolicy = {
instancesDistribution = {
onDemandAllocationStrategy = "string"
onDemandBaseCapacity = int
onDemandPercentageAboveBaseCapacity = int
spotAllocationStrategy = "string"
spotInstancePools = int
spotMaxPrice = "string"
}
launchTemplate = {
launchTemplateSpecification = {
launchTemplateId = "string"
launchTemplateName = "string"
version = "string"
}
overrides = [
{
instanceRequirements = {
acceleratorCount = {
max = int
min = int
}
acceleratorManufacturers = [
"string"
]
acceleratorNames = [
"string"
]
acceleratorTotalMemoryMiB = {
max = int
min = int
}
acceleratorTypes = [
"string"
]
allowedInstanceTypes = [
"string"
]
bareMetal = "string"
baselineEbsBandwidthMbps = {
max = int
min = int
}
burstablePerformance = "string"
cpuManufacturers = [
"string"
]
excludedInstanceTypes = [
"string"
]
instanceGenerations = [
"string"
]
localStorage = "string"
localStorageTypes = [
"string"
]
maxSpotPriceAsPercentageOfOptimalOnDemandPrice = int
memoryGiBPerVCpu = {
max = int
min = int
}
memoryMiB = {
max = int
min = int
}
networkBandwidthGbps = {
max = int
min = int
}
networkInterfaceCount = {
max = int
min = int
}
onDemandMaxPricePercentageOverLowestPrice = int
requireHibernateSupport = bool
spotMaxPricePercentageOverLowestPrice = int
totalLocalStorageGB = {
max = int
min = int
}
vCpuCount = {
max = int
min = int
}
}
instanceType = "string"
launchTemplateSpecification = {
launchTemplateId = "string"
launchTemplateName = "string"
version = "string"
}
weightedCapacity = "string"
}
]
}
}
newInstancesProtectedFromScaleIn = bool
notificationConfiguration = {
notificationTypes = [
"string"
]
topicARN = "string"
}
notificationConfigurations = [
{
notificationTypes = [
"string"
]
topicARN = "string"
}
]
placementGroup = "string"
serviceLinkedRoleARN = "string"
tags = [
{
key = "string"
propagateAtLaunch = bool
value = "string"
}
]
targetGroupARNs = [
"string"
]
terminationPolicies = [
"string"
]
vpcZoneIdentifier = [
"string"
]
}
awsRegion = "string"
awsSourceSchema = "string"
awsTags = {
{customized property} = "string"
}
publicCloudConnectorsResourceId = "string"
publicCloudResourceName = "string"
}
}
}
属性值
Microsoft.AwsConnector/autoScalingAutoScalingGroups
名字 | 描述 | 价值 |
---|---|---|
位置 | 资源所在的地理位置 | string (必需) |
名字 | 资源名称 | 字符串 约束: 模式 = ^(?=.{0,259}[^\s.]$)(?!.*[<>%&\?/#]) (必需) |
性能 | 此资源的资源特定属性。 | AutoScalingGroupProperties |
标签 | 资源标记 | 标记名称和值的字典。 |
类型 | 资源类型 | “Microsoft.AwsConnector/autoScalingAutoScalingGroups@2024-12-01” |
AcceleratorCount请求
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | 最大值。 | 整数 (int) |
分钟 | 最小值。 | 整数 (int) |
AcceleratorTotalMemoryMiBRequest
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | MiB 中的内存最大值。 | 整数 (int) |
分钟 | MiB 中的内存最小值。 | 整数 (int) |
AutoScalingGroupProperties
名字 | 描述 | 价值 |
---|---|---|
阿恩 | Amazon 资源名称 (ARN) | 字符串 |
awsAccountId | AWS 帐户 ID | 字符串 |
awsProperties | AWS 属性 | AwsAutoScalingGroupProperties |
awsRegion | AWS 区域 | 字符串 |
awsSourceSchema | AWS 源架构 | 字符串 |
aws标签 | AWS 标记 | AutoScalingGroupPropertiesAwsTags |
publicCloudConnectorsResourceId | 公有云连接器资源 ID | 字符串 |
publicCloudResourceName (公共云资源名称) | 公有云资源名称 | 字符串 |
AutoScalingGroupPropertiesAwsTags
名字 | 描述 | 价值 |
---|
AwsAutoScalingGroupProperties
名字 | 描述 | 价值 |
---|---|---|
autoScalingGroupName | 自动缩放组的名称。 此名称必须为每个帐户的每个区域唯一。 该名称可以包含任何 ASCII 字符 33 到 126,包括大多数标点符号字符、数字和大写字母和小写字母。 不能在名称中使用冒号(:))。 | 字符串 |
可用性区域 | 可在其中创建自动缩放组中的实例的可用性区域列表。 用于在不使用 VPCZoneIdentifier 属性时在每个可用性区域中启动到默认的VP 子网,或者在启动模板中指定现有网络接口 ID 时附加网络接口。 |
字符串[] |
capacity再平衡 | 指示是否启用了容量重新均衡。 否则,将禁用容量重新均衡。 启用容量重新均衡时,每当 Amazon EC2 通知现成实例处于中断风险时,Amazon EC2 自动缩放将尝试启动现成实例。 启动新实例后,它会终止旧实例。 有关详细信息,请参阅 使用容量重新均衡在 Amazon EC2 自动缩放用户指南中处理 Amazon EC2 现成中断。 | 布尔 |
上下文 | 保留。 | 字符串 |
冷却时间 | 仅当使用简单的缩放策略时才需要。 由于简单的缩放策略,在一个缩放活动结束和另一个缩放活动之间开始的时间量(以秒为单位)。 有关详细信息,请参阅 300 秒 |
字符串 |
defaultInstanceWarmup 实例预热 | 在进入 InService 状态后,新实例完成初始化和资源消耗的时间量(以秒为单位)。 在实例刷新期间,Amazon EC2 自动缩放在替换实例之前,在替换实例之前等待预热期。 Amazon EC2 自动缩放还会等待预热期,然后聚合新实例的指标以及用于缩放的 Amazon CloudWatch 指标中的现有实例,从而生成更可靠的使用情况数据。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南 设置自动缩放组的默认实例预热。 若要在组级别管理各种预热设置,建议设置默认实例预热,即使设置为 0 秒也是如此。 若要删除之前设置的值,请包含该属性,但为该值指定 -1 。 但是,我们强烈建议通过指定 0 或其他名义值来启用默认实例预热。 默认值:无 |
整数 (int) |
desiredCapacity | 所需容量是创建时自动缩放组的初始容量,也是其尝试维护的容量。 如果配置自动缩放,则可以超出此容量。 该数字必须大于或等于组的最小大小,并且小于或等于组的最大大小。 如果在创建堆栈时未指定所需的容量,则默认值为组的最小大小。 当达到所需容量时,CloudFormation 会将自动缩放组标记为成功(通过将状态设置为CREATE_COMPLETE)。 但是,如果在指定的启动模板或启动配置中设置了最高现成价格,则所需的容量不会用作成功标准。 请求是否满足取决于现成实例容量和最高价格。 | 字符串 |
desiredCapacityType | 为所需容量指定的值的度量单位。 Amazon EC2 自动缩放仅支持 DesiredCapacityType 基于属性的实例类型选择。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中使用基于属性的实例类型选择 创建自动缩放组。 默认情况下,Amazon EC2 自动缩放指定 units ,这将转换为实例数。 取值: units | vcpu | memory-mib |
字符串 |
healthCheckGracePeriod | Amazon EC2 自动缩放在检查已进入服务的 EC2 实例的运行状况状态并由于运行状况检查失败而将其标记为不正常之前,Amazon EC2 自动缩放等待的时间(以秒为单位)。 如果实例在进入 InService 状态后不会立即通过其运行状况检查,则这非常有用。 有关详细信息,请参阅 0 秒 |
整数 (int) |
healthCheckType | 一个或多个运行状况检查类型的逗号分隔值字符串。 有效值为 EC2 、ELB 和 VPC_LATTICE 。
EC2 是默认的运行状况检查,无法禁用。 有关详细信息,请参阅 EC2 。 |
字符串 |
instanceId | 用于基于启动配置的实例的 ID。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中使用 EC2 实例 创建自动缩放组。 如果指定 LaunchTemplate 、MixedInstancesPolicy 或 LaunchConfigurationName ,则不指定 InstanceId 。 |
字符串 |
instanceMaintenancePolicy 的 | 实例维护策略。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 设置实例维护策略。
InstanceMaintenancePolicy 是 AWS::AutoScaling::AutoScalingGroup 资源的属性。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 实例维护 策略。 |
InstanceMaintenancePolicy 实例维护策略 |
launchConfigurationName | 用于启动实例的启动配置的名称。 仅当未指定 LaunchTemplate 、MixedInstancesPolicy 或 InstanceId 时才是必需的。 |
字符串 |
launchTemplate (启动模板) | 用于指定用于启动实例的启动模板和版本的信息。 也可以通过指定 MixedInstancesPolicy 将启动模板关联到自动缩放组。 有关创建启动模板的详细信息,请参阅 Amazon EC2 自动缩放用户指南中创建自动缩放组 的启动模板。 如果省略此属性,则必须指定 MixedInstancesPolicy 、LaunchConfigurationName 或 InstanceId 。 指定为自动缩放组预配 EC2 实例时要使用的启动模板。 必须指定以下内容:+ 启动模板的 ID 或名称,但不能同时指定这两者。 + 启动模板的版本。
LaunchTemplateSpecification 是 AWS::AutoScaling::AutoScalingGroup 资源的属性。 它也是 AWS::AutoScaling::AutoScalingGroup LaunchTemplate 和 AWS::AutoScaling::AutoScalingGroup LaunchTemplateOverrides 属性类型的属性。 有关创建启动模板的信息,请参阅 AWS::EC2::LaunchTemplate,Amazon EC2 自动缩放用户指南创建自动缩放 组的启动模板。 有关启动模板的示例,请参阅 资源中的 自动缩放模板片段 和 AWS::EC2::LaunchTemplate 部分。 |
LaunchTemplate规范 |
lifecycleHookSpecificationList | 在启动实例之前,要添加到自动缩放组的一个或多个生命周期挂钩。 | LifecycleHookSpecification[] |
loadBalancer名称 | 与此自动缩放组关联的经典负载均衡器的列表。 对于应用程序负载均衡器、网络负载均衡器和网关负载均衡器,请改为指定 TargetGroupARNs 属性。 |
字符串[] |
maxInstanceLifetime | 实例可以在服务中的最大时间量(以秒为单位)。 默认值为 null。 如果指定,则该值必须为 0 或等于或大于 86,400 秒的数字(1 天)。 有关详细信息,请参阅 |
整数 (int) |
最大大小 | 组的最大大小。 使用实例加权的混合实例策略时,Amazon EC2 自动缩放可能需要超过 MaxSize 以满足容量要求。 在此事件中,Amazon EC2 自动缩放永远不会超过 MaxSize 最大实例权重(定义每个实例对组所需容量贡献的单位数的权重)。 |
字符串 |
metricsCollection | 启用自动缩放组的组指标的监视。 默认情况下,这些指标处于禁用状态。 | MetricsCollection[] |
最小大小 | 组的最小大小。 | 字符串 |
mixedInstancesPolicy 的 | 一个嵌入对象,指定混合实例策略。 该策略包括的属性不仅定义了按需实例和现成实例的分布、为现成实例支付的最高费用(可选),以及自动缩放组如何分配实例类型来满足按需容量和现成容量,还定义了指定实例配置信息的属性-启动模板和实例类型。 该策略还可以包括每个实例类型的权重,以及各个实例类型的不同启动模板。 有关详细信息,请参阅 MixedInstancesPolicy 是 AWS::AutoScaling::AutoScalingGroup 资源的属性。 |
MixedInstancesPolicy |
newInstancesProtectedFromScaleIn | 指示在扩展时,Amazon EC2 自动缩放是否保护新启动的实例不受终止。 有关防止实例在横向缩减时终止的详细信息,请参阅 Amazon EC2 自动缩放用户指南使用实例缩减保护。 | 布尔 |
notificationConfiguration | 为 NotificationConfigurations 资源 属性指定 Amazon SNS 通知配置的结构。 有关示例模板片段,请参阅 自动缩放模板代码片段。 有关详细信息,请参阅 在 amazon EC2 自动缩放用户指南中的自动缩放组缩放 时获取 Amazon SNS 通知。 |
通知配置 |
notificationConfigurations | 配置自动缩放组,以在发生指定事件时发送通知。 | NotificationConfiguration[] |
placementGroup | 要在其中启动实例的位置组的名称。 有关详细信息,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中的 放置组。 群集 放置组是单个可用性区域中实例的逻辑分组。 不能指定多个可用性区域和群集放置组。 | 字符串 |
serviceLinkedRoleARN | 自动缩放组用来代表你调用其他 AWS 服务的服务链接角色的 Amazon 资源名称(ARN)。 默认情况下,Amazon EC2 自动缩放使用名为 AWSServiceRoleForAutoScaling 的服务链接角色,如果不存在,则会创建该角色。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 服务链接角色。 |
字符串 |
标签 | 一个或多个标记。 可以标记自动缩放组,并将标记传播到它启动的 Amazon EC2 实例。 标记不会传播到 Amazon EBS 卷。 若要将标记添加到 Amazon EBS 卷,请在启动模板中指定标记,但请谨慎使用。 如果启动模板使用为自动缩放组指定的键指定实例标记,Amazon EC2 自动缩放会用自动缩放组指定的值替代该实例标记的值。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 标记自动缩放组和 实例。 | TagProperty[] |
targetGroupARNs | 要与自动缩放组关联的弹性负载均衡目标组的 Amazon 资源名称(ARN)。 实例注册为目标组的目标。 目标组接收传入流量并将请求路由到一个或多个已注册的目标。 有关详细信息,请参阅 |
字符串[] |
terminationPolicies | 用于选择要终止的实例的策略或策略列表。 按照列出策略的顺序执行这些策略。 有关详细信息,请参阅 Default | AllocationStrategy | ClosestToNextInstanceHour | NewestInstance | OldestInstance | OldestLaunchConfiguration | OldestLaunchTemplate | arn:aws:lambda:region:account-id:function:my-function:my-alias |
字符串[] |
vpZoneIdentifier | 虚拟私有云的子网 ID 列表,可在其中创建自动缩放组中的实例。 如果此资源指定公共子网,并且也位于同一堆栈模板中定义的一个 VPCZoneIdentifier 时,这会保留相同的自动缩放组,并根据指定的子网将旧实例替换为新实例。 可以选择使用 UpdatePolicy 属性指定 CloudFormation 如何处理这些更新。 需要将实例启动到非默认的VP 中。 如果使用 VPCZoneIdentifier 指定 AvailabilityZones ,则为此属性指定的子网必须驻留在这些可用性区域中。 |
字符串[] |
BaselineEbsBandwidthMbps请求
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | 最大值(以 Mbps 为单位)。 | 整数 (int) |
分钟 | 最小值(以 Mbps 为单位)。 | 整数 (int) |
InstanceMaintenancePolicy 实例维护策略
名字 | 描述 | 价值 |
---|---|---|
maxHealthyPercentage | 将上限指定为自动缩放组所需容量的百分比。 它表示在替换实例时可以处于服务和正常运行或挂起状态的组的最大百分比,以支持工作负荷。 值范围为 100 到 200。 若要清除以前设置的值,请指定一个 -1 值。 必须同时指定 MinHealthyPercentage 和 MaxHealthyPercentage ,并且它们之间的差异不能大于 100。 较大的范围会增加可以同时替换的实例数。 |
整数 (int) |
minHealthyPercentage (最小健康百分比) | 将较低的阈值指定为自动缩放组所需容量的百分比。 它表示要保留在服务中的组的最小百分比、正常运行,并准备好在替换实例时支持工作负荷。 值范围为 0 到 100。 若要清除以前设置的值,请指定一个 -1 值。 |
整数 (int) |
实例要求
名字 | 描述 | 价值 |
---|---|---|
acceleratorCount | 实例类型的最小和最大加速器数(GPU、FPGA 或 AWS 推理芯片)。 若要排除启用了加速器的实例类型,请将 Max 设置为 0 。 默认值:AcceleratorCountRequest 没有最小或最大限制是 InstanceRequirements 属性类型的 属性的属性,该属性类型描述实例类型的最小和最大加速键数。 |
AcceleratorCount请求 |
加速器制造商 | 指示实例类型是否必须具有特定制造商的加速器。 + 对于具有 NVIDIA 设备的实例类型,请指定 nvidia 。 + 对于 AMD 设备的实例类型,请指定 amd 。 + 对于 AWS 设备的实例类型,请指定 amazon-web-services 。 + 对于具有 Xilinx 设备的实例类型,请指定 xilinx 。 默认值:任何制造商 |
字符串[] |
加速器名称 | 列出必须位于实例类型的加速器。 + 对于 NVIDIA A100 GPU 的实例类型,请指定 a100 。 + 对于 NVIDIA V100 GPU 的实例类型,请指定 v100 。 + 对于 NVIDIA K80 GPU 的实例类型,请指定 k80 。 + 对于具有 NVIDIA T4 GPU 的实例类型,请指定 t4 。 + 对于 NVIDIA M60 GPU 的实例类型,请指定 m60 。 + 对于 AMD Radeon Pro V520 GPU 的实例类型,请指定 radeon-pro-v520 。 + 对于具有 Xilinx VU9P FPGA 的实例类型,请指定 vu9p 。 默认值:任何加速器 |
字符串[] |
acceleratorTotalMemoryMiB | 实例类型上加速器的最小和最大总内存大小(以 MiB 为单位)。 默认值:AcceleratorTotalMemoryMiBRequest 没有最小或最大限制是 InstanceRequirements 属性类型的 属性的属性,用于描述实例类型的加速器的最小和最大总内存大小(在 MiB 中)。 |
AcceleratorTotalMemoryMiBRequest |
acceleratorTypes | 列出必须位于实例类型的加速器类型。 + 对于具有 GPU 加速器的实例类型,请指定 gpu 。 + 对于具有 FPGA 加速器的实例类型,请指定 fpga 。 + 对于具有推理加速器的实例类型,请指定 inference 。 默认值:任何加速器类型 |
字符串[] |
allowedInstanceTypes | 要对其应用指定属性的实例类型。 将忽略所有其他实例类型,即使它们与指定的属性匹配。 可以将字符串与星号(* )表示的一个或多个通配符一起使用,以允许实例类型、大小或生成。 下面是示例:m5.8xlarge 、c5*.* 、m5a.* 、r* 、*3* 。 例如,如果指定 c5* ,Amazon EC2 自动缩放将允许整个 C5 实例系列,其中包括所有 C5a 和 C5n 实例类型。 如果指定 m5a.* ,Amazon EC2 自动缩放将允许所有 M5a 实例类型,但不允许 M5n 实例类型。 如果指定 AllowedInstanceTypes ,则无法指定 ExcludedInstanceTypes 。 默认值:所有实例类型 |
字符串[] |
裸金属 | 指示是否包括、排除或必需裸机实例类型。 默认值:excluded |
字符串 |
baselineEbs带宽Mbps | 实例类型的最小和最大基线带宽性能(以 Mbps 为单位)。 有关详细信息,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中的 Amazon EBS 优化实例。 默认值:BaselineEbsBandwidthMbpsRequest 的最小或最大限制不是 InstanceRequirements 属性类型的 属性的属性,用于描述实例类型的最小和最大基线带宽性能(以 Mbps 为单位)。 |
BaselineEbsBandwidthMbps请求 |
burstablePerformance (突发性能) | 指示是否包括、排除或需要可突发性能实例类型。 有关详细信息,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中的 可突发性能实例。 默认值:excluded |
字符串 |
cpu制造商 | 列出要包括的特定 CPU 制造商。 + 对于具有 Intel CPU 的实例类型,请指定 intel 。 + 对于具有 AMD CPU 的实例类型,请指定 amd 。 + 对于具有 AWS CPU 的实例类型,请指定 amazon-web-services 。 不要将 CPU 硬件制造商与 CPU 硬件体系结构混淆。 实例将使用在启动模板中指定的 Amazon Machine Image (AMI)的兼容 CPU 体系结构启动。 默认值:任何制造商 |
字符串[] |
excludedInstanceTypes | 要排除的实例类型。 可以将字符串与一个或多个通配符(由星号(* )表示)一起使用,以排除实例系列、类型、大小或代系。 下面是示例:m5.8xlarge 、c5*.* 、m5a.* 、r* 、*3* 。 例如,如果指定 c5* ,则会排除整个 C5 实例系列,其中包括所有 C5a 和 C5n 实例类型。 如果指定 m5a.* ,Amazon EC2 自动缩放将排除所有 M5a 实例类型,但不包括 M5n 实例类型。 如果指定 ExcludedInstanceTypes ,则无法指定 AllowedInstanceTypes 。 默认值:无排除的实例类型 |
字符串[] |
instanceGenerations 实例代数 | 指示是否包括当前或上一代实例类型。 + 对于当前生成实例类型,请指定 current 。 当前代包括当前建议使用的 EC2 实例类型。 这通常包括每个实例系列中最新的两到三代。 有关详细信息,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中的 实例类型。 + 对于上一代实例类型,请指定 previous 。 默认值:任何当前或上一代 |
字符串[] |
localStorage (本地存储) | 指示实例存储卷的实例类型是包含、排除还是必需。 有关详细信息,请参阅适用于 Linux 实例included |
字符串 |
localStorageTypes | 指示所需的本地存储的类型。 + 对于具有硬盘驱动器(HDD)存储的实例类型,请指定 hdd 。 + 对于具有固态驱动器(SSD)存储的实例类型,请指定 ssd 。 默认值:任何本地存储类型 |
字符串[] |
maxSpotPriceAsPercentageOfOptimalOnDemandPrice | [价格保护]现成实例的价格保护阈值,作为已识别的按需价格的百分比。 标识的按需价格是具有指定属性的当前代 C、M 或 R 实例类型最低价格的价格。 如果没有当前代 C、M 或 R 实例类型与属性匹配,则标识的价格来自最低价格的当前代实例类型,或者失败,即与属性匹配的最低定价的上一代实例类型。 当 Amazon EC2 自动缩放选择具有属性的实例类型时,我们将排除其价格超过指定阈值的实例类型。 该参数接受一个整数,Amazon EC2 自动缩放将其解释为百分比。 若要指示没有价格保护阈值,请指定高值,例如 999999 。 如果将 DesiredCapacityType 设置为 vcpu 或 memory-mib ,则价格保护阈值基于每个 vCPU 或每内存价格,而不是每个实例价格。 只能指定 SpotMaxPricePercentageOverLowestPrice 或 MaxSpotPriceAsPercentageOfOptimalOnDemandPrice 之一。 如果未指定,则使用 SpotMaxPricePercentageOverLowestPrice ,该参数的值默认为 100 。 |
整数 (int) |
内存GiBPerVCpu | 实例类型的每个 vCPU 的最小和最大内存量(以 GiB 为单位)。 默认值:MemoryGiBPerVCpuRequest 没有最小或最大限制是 InstanceRequirements 属性类型的 属性的属性,用于描述实例类型每个 vCPU 的最小和最大内存量(在 GiB 中)。 |
MemoryGiBPerVCpuRequest |
内存MiB | 实例类型的最小和最大实例内存大小(以 MiB 为单位)。
MemoryMiBRequest 是 InstanceRequirements 属性类型的 属性的属性,描述 MiB 中实例类型的最小和最大实例内存大小。 |
内存MiBRequest |
networkBandwidth Gbps | 最小和最大网络带宽量(以千兆位/秒为单位)(Gbps)。 默认值:NetworkBandwidthGbpsRequest 没有最小或最大限制是 InstanceRequirements 属性类型的 属性的属性,该属性类型描述实例类型的最小和最大网络带宽(以 Gbps 为单位)。 设置最小带宽不能保证实例将达到最小带宽。 Amazon EC2 将识别支持指定最小带宽的实例类型,但实例的实际带宽有时可能低于指定的最小值。 有关详细信息,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中的 可用实例带宽。 |
NetworkBandwidth GbpsRequest |
networkInterfaceCount | 实例类型的最小和最大网络接口数。 默认值:NetworkInterfaceCountRequest 的最小或最大限制不是 InstanceRequirements 属性类型的 属性的属性,该属性类型描述实例类型的网络接口的最小和最大数目。 |
NetworkInterfaceCountRequest 请求 |
onDemandMaxPricePercentageOverLowestPrice | [价格保护]按需实例的价格保护阈值,其百分比高于已确定的按需价格。 标识的按需价格是具有指定属性的当前代 C、M 或 R 实例类型最低价格的价格。 如果没有当前代 C、M 或 R 实例类型与属性匹配,则标识的价格来自最低价格的当前代实例类型,或者失败,即与属性匹配的最低定价的上一代实例类型。 当 Amazon EC2 自动缩放选择具有属性的实例类型时,我们将排除其价格超过指定阈值的实例类型。 该参数接受一个整数,Amazon EC2 自动缩放将其解释为百分比。 若要关闭价格保护,请指定高值,如 999999 。 如果将 DesiredCapacityType 设置为 vcpu 或 memory-mib ,则根据每个 vCPU 或每内存价格(而不是每个实例价格)应用价格保护阈值。 默认值:20 |
整数 (int) |
requireHibernateSupport | 指示实例类型是否必须提供按需实例休眠支持。 默认值:false |
布尔 |
spotMaxPricePercentageOverLowestPrice | [价格保护]现成实例的价格保护阈值,其百分比高于已确定的现成价格。 标识的现成价格是具有指定属性的当前代 C、M 或 R 实例类型最低价格的价格。 如果没有当前代 C、M 或 R 实例类型与属性匹配,则标识的价格来自最低价格的当前代实例类型,或者失败,即与属性匹配的最低定价的上一代实例类型。 当 Amazon EC2 自动缩放选择具有属性的实例类型时,我们将排除其价格超过指定阈值的实例类型。 该参数接受一个整数,Amazon EC2 自动缩放将其解释为百分比。 若要关闭价格保护,请指定高值,如 999999 。 如果将 DesiredCapacityType 设置为 vcpu 或 memory-mib ,则价格保护阈值基于每个 vCPU 或每内存价格,而不是每个实例价格。 只能指定 SpotMaxPricePercentageOverLowestPrice 或 MaxSpotPriceAsPercentageOfOptimalOnDemandPrice 之一。 默认值:100 |
整数 (int) |
总计本地存储 GB | 实例类型的最小和最大本地存储大小总计(以 GB 为单位)。 默认值:TotalLocalStorageGBRequest 没有最小或最大限制是 InstanceRequirements 属性类型的 属性的属性,用于描述实例类型的最小和最大本地存储大小(以 GB 为单位)。 |
TotalLocalStorageGB 请求 |
vCpuCount | 实例类型的最小和最大 vCPU 数。
VCpuCountRequest 是 InstanceRequirements 属性类型的 属性的属性,描述实例类型的最小和最大 vCPU 数。 |
VCpuCount请求 |
实例分布
名字 | 描述 | 价值 |
---|---|---|
onDemandAllocationStrategy | 启动时要应用于按需实例的分配策略。 可能的实例类型由指定的启动模板替代确定。 下表列出了有效值:+ 最低价格使用价格来确定哪些实例类型是最高优先级,首先在可用性区域中启动最低定价的实例类型。 这是指定 InstanceRequirements 的自动缩放组的默认值。 + 优先设置启动模板的实例类型顺序,从最高优先级到最低优先级(从第一个到最后一个列表)。 Amazon EC2 自动缩放首先启动最高优先级实例类型。 如果无法使用最高优先级实例类型满足所有按需容量,则 Amazon EC2 自动缩放将使用第二个优先级实例类型启动剩余容量,依此类推。 这是未指定 InstanceRequirements 的自动缩放组的默认值,不能用于执行操作的组。 | 字符串 |
onDemandBaseCapacity | 按需实例必须满足的自动缩放组容量的最小量。 当组缩放时,首先启动此基本部分。 此数字的度量单位与组的所需容量相同。 如果在启动模板替代列表中指定加权容量值或更改组的默认所需容量类型设置来更改默认度量单位(实例数),则必须使用相同的度量单位指定此数字。 默认值:0 此设置的更新意味着逐步替换实例以调整当前的按需实例级别。 替换实例时,Amazon EC2 自动缩放会在终止上述实例之前启动新实例。 | 整数 (int) |
onDemandPercentageAboveBaseCapacity | 控制超出 OnDemandBaseCapacity 的附加容量的按需实例和现成实例的百分比。 以数字表示(例如,20 指定 20% 个按需实例、80 个% 现成实例)。 如果设置为 100,则仅使用按需实例。 默认值:100 此设置的更新意味着逐步替换实例以调整当前按需实例和现成实例级别,以增加比基本容量更高的容量。 替换实例时,Amazon EC2 自动缩放会在终止上述实例之前启动新实例。 |
整数 (int) |
spotAllocationStrategy | 启动现成实例时要应用到现成实例的分配策略。 可能的实例类型由指定的启动模板替代确定。 下面列出了有效值:+ 容量优化的请求现成实例,这些实例使用基于可用现成容量以最佳方式选择的池。 此策略具有最低的中断风险。 若要使某些实例类型更有机会先启动,请使用容量优化优先顺序。 + 容量优化优先级:设置启动模板替代的实例类型顺序从最高优先级到最低优先级(从第一个到最后一个列表)。 Amazon EC2 自动缩放尽力遵循实例类型优先级,但首先针对容量进行优化。 请注意,如果按需分配策略设置为优先顺序,则满足按需容量时会应用相同的优先级。 对于指定 InstanceRequirements 的自动缩放组,此值无效。 + 最低价格请求使用可用性区域中价格最低的池的现成实例,跨为 SpotInstancePools 属性指定的现成池数。 为了确保满足所需的容量,可以从多个池接收现成实例。 这是默认值,但它可能会导致高中断率,因为此策略只考虑实例价格,而不是可用的容量。 + 价格容量优化(建议) 价格和容量优化分配策略同时查看价格和容量,以选择不太可能中断且价格最低的现成实例池。 | 字符串 |
spotInstancePools 实例池 | 要在其中分配现成实例的现成实例池数。 现成池根据替代中的不同实例类型确定。 仅在 SpotAllocationStrategy lowest-price 时有效。 值必须介于 1-20 的范围内。 默认值:2 |
整数 (int) |
现货最大价格 | 你愿意为现成实例支付的单位小时的最高价格。 如果最高价格低于所选实例类型的现成价格,则不会启动现成实例。 我们不建议指定最高价格,因为它可能导致中断增加。 当现成实例启动时,需支付当前现成价格。 若要删除之前设置的最高价格,请包含该属性,但为值指定空字符串 ('')。 如果指定最高价格,则实例将比未指定实例更频繁地中断。 有效范围:最小值为 0.001 | 字符串 |
LaunchTemplate (启动模板)
名字 | 描述 | 价值 |
---|---|---|
launchTemplate规范 | 启动模板。 指定为自动缩放组预配 EC2 实例时要使用的启动模板。 必须指定以下内容:+ 启动模板的 ID 或名称,但不能同时指定这两者。 + 启动模板的版本。
LaunchTemplateSpecification 是 AWS::AutoScaling::AutoScalingGroup 资源的属性。 它也是 AWS::AutoScaling::AutoScalingGroup LaunchTemplate 和 AWS::AutoScaling::AutoScalingGroup LaunchTemplateOverrides 属性类型的属性。 有关创建启动模板的信息,请参阅 AWS::EC2::LaunchTemplate,Amazon EC2 自动缩放用户指南创建自动缩放 组的启动模板。 有关启动模板的示例,请参阅 资源中的 自动缩放模板片段 和 AWS::EC2::LaunchTemplate 部分。 |
LaunchTemplate规范 |
重写 | 在启动模板中指定的任何属性都重写相同的属性。 | LaunchTemplate覆盖 |
LaunchTemplate覆盖
名字 | 描述 | 价值 |
---|---|---|
instanceRequirements | 实例要求。 Amazon EC2 自动缩放使用指定的要求来标识实例类型。 然后,它使用按需和现成分配策略从这些实例类型启动实例。 每个自动缩放组最多可以指定四个单独的实例要求集。 这可用于在同一自动缩放组中预配不同 Amazon Machine Images (AMIS) 的实例。 为此,请创建 AMIS 并为每个 AMI 创建新的启动模板。 然后,为每个启动模板创建一组兼容的实例要求。 如果指定 InstanceRequirements ,则无法指定 InstanceType 。 混合实例策略的实例类型的属性。 Amazon EC2 自动缩放使用指定的要求来标识实例类型。 然后,它使用按需和现成分配策略从这些实例类型启动实例。 指定多个属性时,将获得满足所有指定属性的实例类型。 如果为某个属性指定多个值,则获取满足任何指定值的实例类型。 若要限制 Amazon EC2 自动缩放可以标识匹配实例类型的实例类型列表,可以使用以下参数之一,但不能在同一请求中使用这些参数之一:+ AllowedInstanceTypes - 要包括在列表中的实例类型。 将忽略所有其他实例类型,即使它们与指定的属性匹配。
+
ExcludedInstanceTypes - 要从列表中排除的实例类型,即使它们与指定的属性匹配也是如此。 必须指定 VCpuCount 和 MemoryMiB 。 所有其他属性都是可选的。 任何未指定的可选属性都设置为其默认值。 有关示例模板,请参阅 自动缩放模板代码段。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中使用基于属性的实例类型选择 创建自动缩放组。 有关在将哪些实例类型应用到自动缩放组之前确定哪些实例类型与属性匹配的帮助,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中具有指定属性 的预览实例类型。
InstanceRequirements 是 LaunchTemplateOverrides 属性类型的 属性的属性。 |
实例要求 |
instanceType | 实例类型,例如 m3.xlarge 。 必须指定请求的区域和可用性区域中支持的实例类型。 有关详细信息,请参阅 Amazon Elastic Compute Cloud 用户指南中的 实例类型。 每个自动缩放组最多可以指定 40 个实例类型。 |
字符串 |
launchTemplate规范 | 为指定的实例类型或实例要求集提供启动模板。 例如,某些实例类型可能需要具有不同 AMI 的启动模板。 如果未提供,Amazon EC2 自动缩放将使用在 LaunchTemplate 定义中指定的启动模板。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中为实例类型指定不同的启动模板。 每个自动缩放组最多可以指定 20 个启动模板。 替代中指定的启动模板和 LaunchTemplate 定义将计入此限制。 指定为自动缩放组预配 EC2 实例时要使用的启动模板。 必须指定以下内容:+ 启动模板的 ID 或名称,但不能同时指定这两者。 + 启动模板的版本。
LaunchTemplateSpecification 是 AWS::AutoScaling::AutoScalingGroup 资源的属性。 它也是 AWS::AutoScaling::AutoScalingGroup LaunchTemplate 和 AWS::AutoScaling::AutoScalingGroup LaunchTemplateOverrides 属性类型的属性。 有关创建启动模板的信息,请参阅 AWS::EC2::LaunchTemplate,Amazon EC2 自动缩放用户指南创建自动缩放 组的启动模板。 有关启动模板的示例,请参阅 资源中的 自动缩放模板片段 和 AWS::EC2::LaunchTemplate 部分。 |
LaunchTemplate规范 |
weightedCapacity (加权容量) | 如果提供要使用的实例类型列表,则可以根据虚拟 CPU、内存、存储、吞吐量或其他相对性能特征指定每个实例类型提供的容量单位数。 启动现成实例或按需实例时,容量单位将计入所需容量。 Amazon EC2 自动缩放会启动实例,直到完全满足所需的容量,即使这会导致超额。 例如,如果剩余两个单位来满足容量,而 Amazon EC2 自动缩放只能启动一个实例,其 WeightedCapacity 为 5 个单位,则启动实例,所需容量超过三个单位。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 为 Amazon EC2 自动缩放 配置实例权重。 值必须介于 1-999 的范围内。 如果为一个实例类型指定 WeightedCapacity 值,则必须为所有实例类型指定 WeightedCapacity 值。 每个自动缩放组都有三个大小参数(DesiredCapacity 、MaxSize 和 MinSize )。 通常,根据特定数量的实例设置这些大小。 但是,如果配置定义实例类型的权重的混合实例策略,则必须使用用于加权实例的相同单位来指定这些大小。 |
字符串 |
LaunchTemplate规范
名字 | 描述 | 价值 |
---|---|---|
launchTemplateId | 启动模板的 ID。 必须指定 LaunchTemplateID 或 LaunchTemplateName ,但不能同时指定两者。 |
字符串 |
launchTemplate名称 | 启动模板的名称。 必须指定 LaunchTemplateName 或 LaunchTemplateID ,但不能同时指定两者。 |
字符串 |
版本 | 启动模板的版本号。 不支持为模板版本号指定 $Latest 或 $Default 。 但是,可以使用 LatestVersionNumber 内部函数指定 DefaultVersionNumber 或 Fn::GetAtt 。 有关详细信息,请参阅 Fn::GetAtt。 有关使用 Fn::GetAtt 函数的示例,请参阅 资源的 AWS::AutoScaling::AutoScalingGroup 部分。 |
字符串 |
LifecycleHook规范
名字 | 描述 | 价值 |
---|---|---|
defaultResult | 当生命周期挂钩超时过或发生意外故障时,自动缩放组采取的操作。 默认值为 ABANDON 。 有效值:CONTINUE | ABANDON |
字符串 |
heartbeatTimeout (心跳超时) | 生命周期挂钩超时前最长的时间(以秒为单位)。范围从 30 到 7200 秒。 默认值为 3600 秒(1 小时)。 |
整数 (int) |
生命周期钩子名称 | 生命周期挂钩的名称。 | 字符串 |
lifecycleTransition 生命周期 | 生命周期转换。 对于自动缩放组,有两个主要生命周期转换。 + 若要为横向扩展事件创建生命周期挂钩,请指定 autoscaling:EC2_INSTANCE_LAUNCHING 。 + 若要为横向扩展事件创建生命周期挂钩,请指定 autoscaling:EC2_INSTANCE_TERMINATING 。 |
字符串 |
notification元数据 | 在 Amazon EC2 自动缩放向通知目标发送消息时,要包括的其他信息。 | 字符串 |
notificationTargetARN | Amazon EC2 自动缩放在实例处于生命周期挂钩等待状态时将通知发送到的通知目标的 Amazon 资源名称(ARN)。 可以指定 Amazon SNS 主题或 Amazon SQS 队列。 | 字符串 |
roleARN | 允许自动缩放组发布到指定通知目标的 IAM 角色的 ARN。 有关创建此角色的信息,请参阅 Amazon EC2 自动缩放用户指南中为生命周期挂钩 配置通知目标。 仅当通知目标是 Amazon SNS 主题或 Amazon SQS 队列时有效。 | 字符串 |
MemoryGiBPerVCpuRequest
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | GiB 中的内存最大值。 | 整数 (int) |
分钟 | GiB 中的内存最小值。 | 整数 (int) |
内存MiBRequest
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | MiB 中的内存最大值。 | 整数 (int) |
分钟 | MiB 中的内存最小值。 | 整数 (int) |
MetricsCollection
名字 | 描述 | 价值 |
---|---|---|
粒度 | Amazon EC2 自动缩放向 CloudWatch 发送聚合数据的频率。 唯一的有效值为 1Minute 。 |
字符串 |
指标 | 标识要启用的指标。 可以指定以下一个或多个指标:+ GroupMinSize + GroupMaxSize + GroupDesiredCapacity + GroupInServiceInstances + GroupPendingInstances + GroupStandbyInstances + GroupTerminatingInstances + GroupTotalInstances + GroupInServiceCapacity + GroupPendingCapacity + GroupStandbyCapacity + GroupTerminatingCapacity + GroupTotalCapacity + WarmPoolDesiredCapacity + WarmPoolWarmedCapacity + WarmPoolPendingCapacity + WarmPoolTerminatingCapacity + WarmPoolTotalCapacity + GroupAndWarmPoolDesiredCapacity + GroupAndWarmPoolTotalCapacity 如果指定 Granularity 且未指定任何指标, 所有指标都已启用。 有关详细信息,请参阅 Amazon EC2 自动缩放用户指南中的 自动缩放组指标。 |
字符串[] |
MixedInstancesPolicy
名字 | 描述 | 价值 |
---|---|---|
instancesDistribution (实例分布) | 实例分布。 使用此结构可以指定按需实例和现成实例的分布,以及用于满足混合实例策略按需和现成容量的分配策略。 有关详细信息,请参阅 InstancesDistribution 是 AWS::AutoScaling::AutoScalingGroup MixedInstancesPolicy 属性类型的属性。 |
实例分布 |
launchTemplate (启动模板) | 一个或多个启动模板以及用于启动 EC2 实例的实例类型(替代),以满足按需和现成容量。 使用此结构可以指定混合实例策略的启动模板和实例类型(替代)。
LaunchTemplate 是 AWS::AutoScaling::AutoScalingGroup MixedInstancesPolicy 属性类型的属性。 |
LaunchTemplate (启动模板) |
NetworkBandwidth GbpsRequest
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | 最大网络带宽量(以千兆位/秒为单位)(Gbps)。 | 整数 (int) |
分钟 | 最小网络带宽量(以千兆位/秒为单位)。 | 整数 (int) |
NetworkInterfaceCountRequest 请求
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | 网络接口的最大数目。 | 整数 (int) |
分钟 | 网络接口的最小数目。 | 整数 (int) |
通知配置
名字 | 描述 | 价值 |
---|---|---|
notificationTypes | 发送通知的事件类型的列表。 事件类型可以包括以下任一类型。
允许的值: + autoscaling:EC2_INSTANCE_LAUNCH + autoscaling:EC2_INSTANCE_LAUNCH_ERROR + autoscaling:EC2_INSTANCE_TERMINATE + autoscaling:EC2_INSTANCE_TERMINATE_ERROR + autoscaling:TEST_NOTIFICATION |
字符串[] |
topicARN | Amazon SNS 主题的 Amazon 资源名称(ARN)。 | 字符串 |
Tag属性
名字 | 描述 | 价值 |
---|---|---|
钥匙 | 标记键。 | 字符串 |
propagateAtLaunch | 如果希望 CloudFormation 将标记复制到作为自动缩放组的一部分启动的 EC2 实例,则设置为 true 。 如果希望标记仅附加到自动缩放组,而不复制到作为自动缩放组的一部分启动的任何实例,则设置为 false 。 |
布尔 |
价值 | 标记值。 | 字符串 |
TotalLocalStorageGB 请求
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | 存储最大值(以 GB 为单位)。 | 整数 (int) |
分钟 | 存储最小值(以 GB 为单位)。 | 整数 (int) |
TrackedResourceTags
名字 | 描述 | 价值 |
---|
VCpuCount请求
名字 | 描述 | 价值 |
---|---|---|
麦克斯 | vCPU 的最大数目。 | 整数 (int) |
分钟 | vCPU 的最小数目。 | 整数 (int) |