기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS SDK 또는 CLI와 `UpdateAutoScalingGroup` 함께 사용
다음 코드 예시는 `UpdateAutoScalingGroup`의 사용 방법을 보여 줍니다.
작업 예시는 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 다음 코드 예제에서는 컨텍스트 내에서 이 작업을 확인할 수 있습니다.
+ [기본 사항 알아보기](example_auto-scaling_Scenario_GroupsAndInstances_section.md)
+ [복원력이 뛰어난 서비스 구축 및 관리](example_cross_ResilientService_section.md)
------
#### [ .NET ]
**SDK for .NET (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에 대한 자세한 설명은 *AWS SDK for .NET 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에 대한 자세한 설명은 *AWS SDK for C\$1\$1 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 상태 확인을 추가하고 사용할 가용 영역 및 서브넷을 지정하는 방법**
이 예시에서는 Elastic Load Balancing 상태 확인을 추가하도록 지정된 Auto Scaling 그룹을 업데이트합니다. 또한 이 명령은 여러 가용 영역의 서브넷 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 그룹을 업데이트하고 용량 재분배를 활성화합니다. 이 구조를 통해 스팟 및 온디맨드 용량을 사용하는 그룹을 지정하고 아키텍처마다 다른 시작 템플릿을 사용할 수 있습니다.
```
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 ]
**SDK for Kotlin**
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 API를 위한AWS SDK 참조 문서*의 [UpdateAutoScalingGroup](https://sdk.amazonaws.com/kotlin/api/latest/index.html)을 참조하세요.
------
#### [ PHP ]
**SDK for PHP**
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에 대한 자세한 설명은 *AWS SDK for PHP 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: 이 예제에서는 Elastic Load Balancing 상태 확인을 사용하도록 지정된 Auto Scaling 그룹을 업데이트합니다.**
```
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: 이 예제에서는 Elastic Load Balancing 상태 확인을 사용하도록 지정된 Auto Scaling 그룹을 업데이트합니다.**
```
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 ]
**SDK for Python(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) API를 위한AWS SDK 참조 문서*의 [UpdateAutoScalingGroup](https://docs.aws.amazon.com/goto/boto3/autoscaling-2011-01-01/UpdateAutoScalingGroup)을 참조하세요.
------
#### [ Rust ]
**SDK for Rust**
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 세부 정보는 *AWS SDK for Rust API 참조*의 [UpdateAutoScalingGroup](https://docs.rs/aws-sdk-autoscaling/latest/aws_sdk_autoscaling/client/struct.Client.html#method.update_auto_scaling_group)을 참조하세요.
------
#### [ SAP ABAP ]
**SDK for SAP ABAP API**
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 세부 정보는 SDK for SAP ABAP API 참조의 [UpdateAutoScalingGroup](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)을 참조하세요. *AWS *
------
AWS SDK 개발자 안내서 및 코드 예제의 전체 목록은 섹션을 참조하세요[AWS SDK에서이 서비스 사용](sdk-general-information-section.md). 이 주제에는 시작하기에 대한 정보와 이전 SDK 버전에 대한 세부 정보도 포함되어 있습니다.