本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# `UpdateAutoScalingGroup`与 AWS SDK 或 CLI 配合使用
以下代码示例演示如何使用 `UpdateAutoScalingGroup`。
操作示例是大型程序的代码摘录，必须在上下文中运行。您可以在以下代码示例中查看此操作的上下文：
+ [了解基本功能](example_auto-scaling_Scenario_GroupsAndInstances_section.md)
+ [构建和管理弹性服务](example_cross_ResilientService_section.md)
------
#### [ .NET ]
**适用于 .NET 的 SDK (v4)**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv4/AutoScaling#code-examples)中查找完整示例，了解如何进行设置和运行。
```
///
/// Update the capacity of an Auto Scaling group.
///
/// The name of the Auto Scaling group.
/// The name of the EC2 launch template.
/// The maximum number of instances that can be
/// created for the Auto Scaling group.
/// A Boolean value indicating the success of the action.
public async Task UpdateAutoScalingGroupAsync(
string groupName,
string launchTemplateName,
int maxSize)
{
var templateSpecification = new LaunchTemplateSpecification
{
LaunchTemplateName = launchTemplateName,
};
var groupRequest = new UpdateAutoScalingGroupRequest
{
MaxSize = maxSize,
AutoScalingGroupName = groupName,
LaunchTemplate = templateSpecification,
};
var response = await _amazonAutoScaling.UpdateAutoScalingGroupAsync(groupRequest);
if (response.HttpStatusCode == System.Net.HttpStatusCode.OK)
{
Console.WriteLine($"You successfully updated the Auto Scaling group {groupName}.");
return true;
}
else
{
return false;
}
}
```
+ 有关 API 的详细信息，请参阅 *适用于 .NET 的 AWS SDK API 参考[UpdateAutoScalingGroup](https://docs.aws.amazon.com/goto/DotNetSDKV4/autoscaling-2011-01-01/UpdateAutoScalingGroup)*中的。
------
#### [ C\$1\$1 ]
**SDK for C\$1\$1**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/autoscaling#code-examples)中查找完整示例，了解如何进行设置和运行。
```
Aws::Client::ClientConfiguration clientConfig;
// Optional: Set to the AWS Region (overrides config file).
// clientConfig.region = "us-east-1";
Aws::AutoScaling::AutoScalingClient autoScalingClient(clientConfig);
Aws::AutoScaling::Model::UpdateAutoScalingGroupRequest request;
request.SetAutoScalingGroupName(groupName);
request.SetMaxSize(3);
Aws::AutoScaling::Model::UpdateAutoScalingGroupOutcome outcome =
autoScalingClient.UpdateAutoScalingGroup(request);
if (!outcome.IsSuccess()) {
std::cerr << "Error with AutoScaling::UpdateAutoScalingGroup. "
<< outcome.GetError().GetMessage()
<< std::endl;
}
```
+ 有关 API 的详细信息，请参阅 *适用于 C\$1\$1 的 AWS SDK API 参考[UpdateAutoScalingGroup](https://docs.aws.amazon.com/goto/SdkForCpp/autoscaling-2011-01-01/UpdateAutoScalingGroup)*中的。
------
#### [ CLI ]
**AWS CLI**
**示例 1：更新自动扩缩组的大小限制**
该示例更新指定的自动扩缩组，该组的最小大小为 1，最大大小为 10。
```
aws autoscaling update-auto-scaling-group \
--auto-scaling-group-name my-asg \
--min-size 2 \
--max-size 10
```
此命令不生成任何输出。
有关更多信息，请参阅《Amazon EC2 Auto Scaling 用户指南》**中的[设置自动扩缩组的容量限制](https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-capacity-limits.html)。
**示例 2：添加 Elastic Load Balancing 运行状况检查并指定要使用的可用区和子网**
此示例更新指定的自动扩缩组以添加 Elastic Load Balancing 运行状况检查。此命令还`--vpc-zone-identifier`使用多个可用区 IDs 中的子网列表更新的值。
```
aws autoscaling update-auto-scaling-group \
--auto-scaling-group-name my-asg \
--health-check-type ELB \
--health-check-grace-period 600 \
--vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782"
```
此命令不生成任何输出。
有关更多信息，请参阅《Amazon EC2 Auto Scaling 用户指南》**中的 [Elastic Load Balancing 和 Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/autoscaling-load-balancer.html)。
**示例 3：更新置放群组和终止策略**
此示例更新要使用的置放群组和终止策略。
```
aws autoscaling update-auto-scaling-group \
--auto-scaling-group-name my-asg \
--placement-group my-placement-group \
--termination-policies "OldestInstance"
```
此命令不生成任何输出。
有关更多信息，请参阅《Amazon EC2 Auto Scaling 用户指南》**中的[自动扩缩组](https://docs.aws.amazon.com/autoscaling/ec2/userguide/AutoScalingGroup.html)。
**示例 4：使用最新版本的启动模板**
此示例将指定的自动扩缩组更新为使用最新版本的指定启动模板。
```
aws autoscaling update-auto-scaling-group \
--auto-scaling-group-name my-asg \
--launch-template LaunchTemplateId=lt-1234567890abcde12,Version='$Latest'
```
此命令不生成任何输出。
有关更多信息，请参阅《Amazon EC2 Auto Scaling 用户指南》**中的[启动模板](https://docs.aws.amazon.com/autoscaling/ec2/userguide/LaunchTemplates.html)。
**示例 5：使用特定版本的启动模板**
此示例将指定的自动扩缩组更新为使用特定版本的启动模板，而不是最新或默认版本。
```
aws autoscaling update-auto-scaling-group \
--auto-scaling-group-name my-asg \
--launch-template LaunchTemplateName=my-template-for-auto-scaling,Version='2'
```
此命令不生成任何输出。
有关更多信息，请参阅《Amazon EC2 Auto Scaling 用户指南》**中的[启动模板](https://docs.aws.amazon.com/autoscaling/ec2/userguide/LaunchTemplates.html)。
**示例 6：定义混合实例策略并启用容量再平衡**
此示例将指定的自动扩缩组更新为使用混合实例策略并启用容量再平衡。此结构允许您指定具有竞价和按需容量的组，并针对不同的架构使用不同的启动模板。
```
aws autoscaling update-auto-scaling-group \
--cli-input-json file://~/config.json
```
`config.json` 的内容：
```
{
"AutoScalingGroupName": "my-asg",
"CapacityRebalance": true,
"MixedInstancesPolicy": {
"LaunchTemplate": {
"LaunchTemplateSpecification": {
"LaunchTemplateName": "my-launch-template-for-x86",
"Version": "$Latest"
},
"Overrides": [
{
"InstanceType": "c6g.large",
"LaunchTemplateSpecification": {
"LaunchTemplateName": "my-launch-template-for-arm",
"Version": "$Latest"
}
},
{
"InstanceType": "c5.large"
},
{
"InstanceType": "c5a.large"
}
]
},
"InstancesDistribution": {
"OnDemandPercentageAboveBaseCapacity": 50,
"SpotAllocationStrategy": "capacity-optimized"
}
}
}
```
此命令不生成任何输出。
有关更多信息，请参阅《Amazon EC2 Auto Scaling 用户指南》**中的[具有多个实例类型和购买选项的自动扩缩组](https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-purchase-options.html)。
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[UpdateAutoScalingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/update-auto-scaling-group.html)*中的。
------
#### [ Java ]
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/autoscale#code-examples)中查找完整示例，了解如何进行设置和运行。
```
public static void updateAutoScalingGroup(AutoScalingClient autoScalingClient, String groupName,
String launchTemplateName) {
try {
AutoScalingWaiter waiter = autoScalingClient.waiter();
LaunchTemplateSpecification templateSpecification = LaunchTemplateSpecification.builder()
.launchTemplateName(launchTemplateName)
.build();
UpdateAutoScalingGroupRequest groupRequest = UpdateAutoScalingGroupRequest.builder()
.maxSize(3)
.autoScalingGroupName(groupName)
.launchTemplate(templateSpecification)
.build();
autoScalingClient.updateAutoScalingGroup(groupRequest);
DescribeAutoScalingGroupsRequest groupsRequest = DescribeAutoScalingGroupsRequest.builder()
.autoScalingGroupNames(groupName)
.build();
WaiterResponse waiterResponse = waiter
.waitUntilGroupInService(groupsRequest);
waiterResponse.matched().response().ifPresent(System.out::println);
System.out.println("You successfully updated the auto scaling group " + groupName);
} catch (AutoScalingException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[UpdateAutoScalingGroup](https://docs.aws.amazon.com/goto/SdkForJavaV2/autoscaling-2011-01-01/UpdateAutoScalingGroup)*中的。
------
#### [ Kotlin ]
**适用于 Kotlin 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/autoscale#code-examples)中查找完整示例，了解如何进行设置和运行。
```
suspend fun updateAutoScalingGroup(
groupName: String,
launchTemplateNameVal: String,
serviceLinkedRoleARNVal: String,
) {
val templateSpecification =
LaunchTemplateSpecification {
launchTemplateName = launchTemplateNameVal
}
val groupRequest =
UpdateAutoScalingGroupRequest {
maxSize = 3
serviceLinkedRoleArn = serviceLinkedRoleARNVal
autoScalingGroupName = groupName
launchTemplate = templateSpecification
}
val groupsRequestWaiter =
DescribeAutoScalingGroupsRequest {
autoScalingGroupNames = listOf(groupName)
}
AutoScalingClient { region = "us-east-1" }.use { autoScalingClient ->
autoScalingClient.updateAutoScalingGroup(groupRequest)
autoScalingClient.waitUntilGroupExists(groupsRequestWaiter)
println("You successfully updated the Auto Scaling group $groupName")
}
}
```
+ 有关 API 的详细信息，请参阅适用[UpdateAutoScalingGroup](https://sdk.amazonaws.com/kotlin/api/latest/index.html)于 K *otlin 的AWS SDK API 参考*。
------
#### [ PHP ]
**适用于 PHP 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/php/example_code/auto-scaling#code-examples)中查找完整示例，了解如何进行设置和运行。
```
public function updateAutoScalingGroup($autoScalingGroupName, $args)
{
if (array_key_exists('MaxSize', $args)) {
$maxSize = ['MaxSize' => $args['MaxSize']];
} else {
$maxSize = [];
}
if (array_key_exists('MinSize', $args)) {
$minSize = ['MinSize' => $args['MinSize']];
} else {
$minSize = [];
}
$parameters = ['AutoScalingGroupName' => $autoScalingGroupName];
$parameters = array_merge($parameters, $minSize, $maxSize);
return $this->autoScalingClient->updateAutoScalingGroup($parameters);
}
```
+ 有关 API 的详细信息，请参阅 *适用于 PHP 的 AWS SDK API 参考[UpdateAutoScalingGroup](https://docs.aws.amazon.com/goto/SdkForPHPV3/autoscaling-2011-01-01/UpdateAutoScalingGroup)*中的。
------
#### [ PowerShell ]
**适用于 PowerShell V4 的工具**
**示例 1：此示例更新指定自动扩缩组的最小和最大大小。**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -MaxSize 5 -MinSize 1
```
**示例 2：此示例更新指定自动扩缩组的默认冷却时间。**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -DefaultCooldown 10
```
**示例 3：此示例更新指定自动扩缩组的可用区。**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -AvailabilityZone @("us-west-2a", "us-west-2b")
```
**示例 4：此示例更新指定的自动扩缩组以使用 Elastic Load Balancing 运行状况检查。**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -HealthCheckType ELB -HealthCheckGracePeriod 60
```
+ 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 4) [UpdateAutoScalingGroup](https://docs.aws.amazon.com/powershell/v4/reference)中的。
**适用于 PowerShell V5 的工具**
**示例 1：此示例更新指定自动扩缩组的最小和最大大小。**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -MaxSize 5 -MinSize 1
```
**示例 2：此示例更新指定自动扩缩组的默认冷却时间。**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -DefaultCooldown 10
```
**示例 3：此示例更新指定自动扩缩组的可用区。**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -AvailabilityZone @("us-west-2a", "us-west-2b")
```
**示例 4：此示例更新指定的自动扩缩组以使用 Elastic Load Balancing 运行状况检查。**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -HealthCheckType ELB -HealthCheckGracePeriod 60
```
+ 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [UpdateAutoScalingGroup](https://docs.aws.amazon.com/powershell/v5/reference)中的。
------
#### [ Python ]
**适用于 Python 的 SDK（Boto3）**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/auto-scaling#code-examples)中查找完整示例，了解如何进行设置和运行。
```
class AutoScalingWrapper:
"""Encapsulates Amazon EC2 Auto Scaling actions."""
def __init__(self, autoscaling_client):
"""
:param autoscaling_client: A Boto3 Amazon EC2 Auto Scaling client.
"""
self.autoscaling_client = autoscaling_client
def update_group(self, group_name: str, **kwargs: Any) -> None:
"""
Updates an Auto Scaling group.
:param group_name: The name of the group to update.
:param kwargs: Keyword arguments to pass through to the service.
:return: None
:raises ClientError: If there is an error updating the Auto Scaling group.
"""
try:
self.autoscaling_client.update_auto_scaling_group(
AutoScalingGroupName=group_name, **kwargs
)
logger.info(f"Successfully updated Auto Scaling group {group_name}.")
except ClientError as err:
error_code = err.response["Error"]["Code"]
logger.error(f"Failed to update Auto Scaling group {group_name}.")
if error_code == "ResourceInUse":
logger.error(
"The Auto Scaling group '%s' is currently in use and cannot be modified. Please try again later.",
group_name,
)
elif error_code == "ScalingActivityInProgress":
logger.error(
f"A scaling activity is currently in progress for the Auto Scaling group '{group_name}'."
"Please wait for the activity to complete before attempting to update the group."
)
logger.error(f"Full error:\n\t{err}")
raise
```
+ 有关 API 的详细信息，请参阅适用[UpdateAutoScalingGroup](https://docs.aws.amazon.com/goto/boto3/autoscaling-2011-01-01/UpdateAutoScalingGroup)于 *Python 的AWS SDK (Boto3) API 参考*。
------
#### [ Rust ]
**适用于 Rust 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/auto-scaling#code-examples)中查找完整示例，了解如何进行设置和运行。
```
async fn update_group(client: &Client, name: &str, size: i32) -> Result<(), Error> {
client
.update_auto_scaling_group()
.auto_scaling_group_name(name)
.max_size(size)
.send()
.await?;
println!("Updated AutoScaling group");
Ok(())
}
```
+ 有关 API 的详细信息，请参阅适用[UpdateAutoScalingGroup](https://docs.rs/aws-sdk-autoscaling/latest/aws_sdk_autoscaling/client/struct.Client.html#method.update_auto_scaling_group)于 *Rust 的AWS SDK API 参考*。
------
#### [ SAP ABAP ]
**适用于 SAP ABAP 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/asc#code-examples)中查找完整示例，了解如何进行设置和运行。
```
" Example: iv_group_name = 'my-auto-scaling-group'
" Example: iv_max_size = 5
TRY.
ao_asc->updateautoscalinggroup(
iv_autoscalinggroupname = iv_group_name
iv_maxsize = iv_max_size
iv_minsize = iv_min_size ).
MESSAGE 'Auto Scaling group updated successfully' TYPE 'I'.
CATCH /aws1/cx_ascresrccontionfault INTO DATA(lo_contention).
RAISE EXCEPTION lo_contention.
CATCH /aws1/cx_ascscaactivityinprg00 INTO DATA(lo_activity_in_progress).
RAISE EXCEPTION lo_activity_in_progress.
CATCH /aws1/cx_rt_generic INTO DATA(lo_generic_exception).
RAISE EXCEPTION lo_generic_exception.
ENDTRY.
```
+ 有关 API 的详细信息，请参阅适用[UpdateAutoScalingGroup](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)于 S *AP 的AWS SDK ABAP API 参考*。
------
有关 S AWS DK 开发者指南和代码示例的完整列表，请参阅[将此服务与 AWS SDK 配合使用](sdk-general-information-section.md)。本主题还包括有关入门的信息以及有关先前的 SDK 版本的详细信息。