

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# `AWSSupport-RequestSageMakerLimitIncrease`
<a name="automation-awssupport-requestsagemakerlimitincrease"></a>

 **설명** 

`AWSSupport-RequestSageMakerLimitIncrease` 실행서를 사용하면 단일 작업으로 여러 Amazon SageMaker AI(SageMaker AI) 할당량 증가 요청을 대량으로 제출할 수 있으므로 대규모 기계 학습 워크로드에 대한 할당량 관리를 간소화할 수 있습니다. 실행서는 조정 가능한 SageMaker AI 서비스 할당량에 대해 각 요청을 검증하고, 즉각적인 처리를 위해 자동 승인 임계값 내에서 요청을 라우팅하고, 수동 검토가 필요한 요청에 대한 AWS 지원 사례를 생성합니다. 할당량 증가는 실행서가 실행되는 리전과 동일한 AWS 리전에 적용됩니다.

**중요**  
이 실행서는 P4, P5, Trainium 인스턴스 유형을 포함한 특수 컴퓨팅 인스턴스에 대한 할당량 증가 요청을 지원하지 않습니다. 이러한 인스턴스 유형의 경우 AWS Service Quotas 콘솔 또는 AWS 지원을 통해 개별 할당량 증가 요청을 제출합니다.

실행서는 Amazon Simple Notification Service(Amazon SNS) 알림을 통해 지정된 보안 주체의 승인을 기다리는 동안 최대 1시간 동안 일시 중지됩니다. 승인된 할당량 증가는 되돌릴 수 없으므로 승인하기 전에 `ApproveQuotaCodeLimitMapping` 단계 출력을 주의 깊게 검토하세요.

 [이 자동화 실행(콘솔)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-RequestSageMakerLimitIncrease) 

**문서 유형**

자동화

**소유자**

Amazon

**플랫폼**

Linux, macOS, Windows 

**파라미터**
+ AutomationAssumeRole

  유형: AWS::IAM::Role::Arn

  설명: (선택 사항) (Systems Manager) 자동화가 AWS Identity and Access Management 사용자를 대신하여 작업을 수행하도록 허용하는 (IAM) 역할의 Amazon 리소스 이름 AWS Systems Manager (ARN)입니다. 역할을 지정하지 않은 경우, Systems Manager Automation에서는 이 실행서를 시작하는 사용자의 권한을 사용합니다.
+ ResourcesMapping

  유형: StringList

  설명: (필수) 콜론으로 구분된 값으로 지정된 늘릴 SageMaker AI 서비스 할당량입니다. 다음 세 가지 형식을 지원합니다.
  + `Category:Resource:NewValue` - 범주 및 리소스 이름을 모두 사용할 수 있는 경우. 예시: `spot-training-job:ml.c4.xlarge:25`
  + `Resource:NewValue` - 리소스 이름만 사용할 수 있는 경우. 예시: `max_number_of_experiment_trial_associations:501`
  + `QuotaCode:NewValue` - 직접 할당량 코드를 사용하는 경우. 예시: `L-9xAxx23x:25`

  동일한 요청에서 형식을 쉼표로 구분하여 혼합할 수 있습니다. 최대 50개 항목. 예시: `studio:CodeEditor-ml.r6id.large:787,spot-training-job:ml.c4.xlarge:34,L-99AEC235:2`
+ SNSTopicArn

  유형: 문자열

  설명: (필수) 자동화 실행 중에 승인 알림을 보내는 데 사용되는 Amazon SNS 주제의 ARN입니다.
+ ApproverIAM

  유형: StringList

  설명: (필수) 할당량 증가 요청을 승인하거나 거부할 수 있는 AWS 인증된 보안 주체 목록입니다. 최대 10명의 승인자. 허용되는 형식: IAM 사용자 이름, IAM 사용자 ARN, IAM 역할 ARN 또는 IAM 수임 역할 사용자 ARN.
+ MinimumRequiredApprovals

  유형: 정수

  유효한 값: 1 \$1 2 \$1 3 \$1 4 \$1 5 \$1 6 \$1 7 \$1 8 \$1 9 \$1 10

  기본값: 1

  설명: (선택 사항) 자동화를 재개하는 데 필요한 최소 승인 수입니다. 에 정의된 승인자 수를 초과할 수 없습니다`ApproverIAM`.

**필수 IAM 권한**

실행서를 성공적으로 사용하려면 `AutomationAssumeRole` 파라미터에 다음 작업이 필요합니다.
+ `servicequotas:ListServiceQuotas`
+ `servicequotas:RequestServiceQuotaIncrease`
+ `servicequotas:GetRequestedServiceQuotaChange`
+ `sns:Publish`
+ `ssm:SendAutomationSignal`

 **문서 단계** 

1. `VerifyCategoriesAndResources` - AWS Service Quotas API를 사용하여 조정 가능한 SageMaker AI 서비스 할당량과 비교하여 지정된 모든 범주 및 리소스를 검증합니다. 각 범주 및 리소스 이름이 존재하고 수정 가능한지 확인하고 새 제한이 현재 값보다 낮은 요청을 식별합니다.

1. `BranchOnValidCategoriesFound` - 유효한 할당량 매핑이 발견되었는지 확인합니다. 유효한 매핑이 있는 경우는 로 진행합니다`ApproveQuotaCodeLimitMapping`. 그렇지 않으면가 로 직접 건너뜁니다`GenerateSummaryReport`.

1. `ApproveQuotaCodeLimitMapping` - 처리할 준비가 된 유효한 요청, 설명이 포함된 잘못된 요청(예: 현재 값보다 낮은 제한 또는 지원되지 않는 할당량 코드), 승인 전 검토를 위한 모든 할당량 증가 요청의 전체 분석을 보여주는 자세한 승인 메시지를 준비합니다.

1. `WaitingForApproval` - 자동화를 일시 중지하고 지정된 Amazon SNS 주제에 승인 알림을 보냅니다. 지정된 승인자는 `ApproveQuotaCodeLimitMapping` 단계 출력을 검토하고 요청을 승인하거나 거부해야 합니다. 이 단계는 아무 조치도 취하지 않으면 3600초(1시간) 후에 시간 초과됩니다.

1. `RequestQuotaIncreases` - AWS Service Quotas API를 통해 유효한 각 리소스에 대한 개별 할당량 증가 요청을 제출합니다. API 제한을 방지하기 위해 초당 1회 요청의 속도가 조정됩니다. 지수 재시도로 API 예외를 처리합니다.

1. `WaitForRequestQuotaIncreaseResults` - `PENDING` 상태가 유지되지 않을 때까지 제출된 모든 할당량 증가 요청의 상태를 폴링합니다. 허용되는 터미널 상태는 `CASE_OPENED`, , `APPROVED`, `DENIED`, `NOT_APPROVED`및 `CASE_CLOSED`입니다`INVALID_REQUEST`.

1. `GetRequestQuotaIncreaseResults` - AWS Service Quotas API에서 제출된 모든 할당량 증가 요청의 최종 상태를 검색하고 보고를 위해 지원 사례 IDs 해당 리소스 및 요청 IDs에 매핑합니다.

1. `GenerateSummaryReport` - 총 요청 수, 요청별 세부 정보, 수동 검토가 필요한 요청에 대한 지원 사례 IDs 대한 포괄적인 요약을 컴파일합니다.

 **출력** 

`GenerateSummaryReport.SummaryReport` - 모든 할당량 증가 요청, 상태 및 수동 검토를 위해 생성된 지원 사례 IDs에 대한 포괄적인 요약입니다.