本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# `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 ]
**適用於 C\$1\$1 的 SDK**
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：更新 Auto Scaling 群組的大小限制**
此範例將指定的 Auto Scaling 群組更新為大小下限 2，上限為 10。
```
aws autoscaling update-auto-scaling-group \
--auto-scaling-group-name my-asg \
--min-size 2 \
--max-size 10
```
此命令不會產生輸出。
如需詳細資訊，請參閱《Amazon EC2 Auto Scaling 使用者指南》**中的[設定 Auto Scaling 群組的預設限制](https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-capacity-limits.html)。
**範例 2：新增 Elastic Load Balancing 運作狀態檢查，並指定要使用的可用區域和子網路**
此範例更新指定的 Auto Scaling 群組，新增 Elastic Load Balancing 運作狀態檢查。此命令也使用多個可用區中的子網路 ID 清單更新 `--vpc-zone-identifier` 的值。
```
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 使用者指南**》中的 [Auto Scaling 群組](https://docs.aws.amazon.com/autoscaling/ec2/userguide/AutoScalingGroup.html)。
**範例 4：使用最新版的啟動範本**
此範例更新 Auto Scaling 群組，使用最新版的指定啟動範本。
```
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：使用特定版本的啟動範本**
此範例更新指定的 Auto Scaling 群組，使用啟動範本的特定版本，而非最新或預設版本。
```
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：定義混合執行個體政策，並啟用容量重新平衡**
此範例更新指定的 Auto Scaling 群組，使用混合執行個體政策，並啟用容量重新平衡。此結構可讓您指定具有 Spot 和隨需容量的群組，並針對不同的架構使用不同的啟動範本。
```
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 使用者指南」**中的[具備多個執行個體類型及購買選項的 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 ]
**SDK for Java 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 詳細資訊，請參閱*《適用於 Kotlin 的AWS SDK API 參考》*中的 [UpdateAutoScalingGroup](https://sdk.amazonaws.com/kotlin/api/latest/index.html)。
------
#### [ 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 ]
**Tools for PowerShell V4**
**範例 1：此範例更新指定的 Auto Scaling 群組的大小下限和上限。**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -MaxSize 5 -MinSize 1
```
**範例 2：此範例更新指定的 Auto Scaling 群組的預設冷卻時間。**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -DefaultCooldown 10
```
**範例 3：此範例更新指定的 Auto Scaling 群組的可用區域。**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -AvailabilityZone @("us-west-2a", "us-west-2b")
```
**範例 4：此範例更新指定的 Auto Scaling 群組，使用 Elastic Load Balancing 運作狀態檢查。**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -HealthCheckType ELB -HealthCheckGracePeriod 60
```
+ 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V4)》**中的 [UpdateAutoScalingGroup](https://docs.aws.amazon.com/powershell/v4/reference)。
**Tools for PowerShell V5**
**範例 1：此範例更新指定的 Auto Scaling 群組的大小下限和上限。**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -MaxSize 5 -MinSize 1
```
**範例 2：此範例更新指定的 Auto Scaling 群組的預設冷卻時間。**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -DefaultCooldown 10
```
**範例 3：此範例更新指定的 Auto Scaling 群組的可用區域。**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -AvailabilityZone @("us-west-2a", "us-west-2b")
```
**範例 4：此範例更新指定的 Auto Scaling 群組，使用 Elastic Load Balancing 運作狀態檢查。**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -HealthCheckType ELB -HealthCheckGracePeriod 60
```
+ 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V5)》**中的 [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 詳細資訊，請參閱*《適用於 Python (Boto3) 的AWS SDK API 參考》*中的 [UpdateAutoScalingGroup](https://docs.aws.amazon.com/goto/boto3/autoscaling-2011-01-01/UpdateAutoScalingGroup)。
------
#### [ 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 詳細資訊，請參閱*《適用於 Rust 的AWS SDK API 參考》*中的 [UpdateAutoScalingGroup](https://docs.rs/aws-sdk-autoscaling/latest/aws_sdk_autoscaling/client/struct.Client.html#method.update_auto_scaling_group)。
------
#### [ SAP ABAP ]
**適用於 SAP ABAP 的開發套件**
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 詳細資訊，請參閱《適用於 *AWS SAP ABAP 的 SDK API 參考*》中的 [UpdateAutoScalingGroup](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)。
------
如需 AWS SDK 開發人員指南和程式碼範例的完整清單，請參閱 [搭配 AWS SDK 使用此服務](sdk-general-information-section.md)。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。