AWS::Serverless::CapacityProvider - AWS Serverless Application Model
구문속성반환 값예제

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

AWS::Serverless::CapacityProvider

고객 소유 Amazon Elastic Compute Cloud 인스턴스에서 Lambda 관리형 인스턴스를 실행할 수 있는 AWS Lambda 함수의 용량 공급자를 생성합니다. 이 리소스는 EC2 요금 모델을 활용하여 대규모 Lambda 워크로드에 대한 비용 최적화를 제공하는 Lambda 관리형 인스턴스 기능의 일부입니다.

용량 공급자는 EC2 인스턴스의 수명 주기를 관리하고 Lambda 함수가 서버리스 프로그래밍 모델을 유지하면서 고객 소유 컴퓨팅 리소스에서 실행하는 데 필요한 인프라를 제공합니다.

참고

에 배포하면가 AWS SAM 리소스를 CloudFormation 리소스로 AWS CloudFormation AWS SAM 변환합니다. 자세한 내용은 AWS SAM용으로 생성된 CloudFormation 리소스 단원을 참조하십시오.

구문

AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

YAML

Type: AWS::Serverless::CapacityProvider
Properties:
  CapacityProviderName: String
  VpcConfig: VpcConfig
  OperatorRole: String
  Tags: Map
  PropagateTags: Boolean
  InstanceRequirements: InstanceRequirements
  ScalingConfig: ScalingConfig
  KMSKeyArn: String

속성

CapacityProviderName

용량 공급자의 이름입니다. 이 이름은 AWS 계정 및 리전 내에서 고유해야 합니다.

유형: 문자열

필수 항목 여부: 아니요

CloudFormation 호환성:이 속성은 AWS::Lambda::CapacityProvider 리소스의 CapacityProviderName 속성과 유사합니다.

VpcConfig

용량 공급자의 VPC 구성입니다. Amazon EC2 인스턴스가 시작될 VPC 서브넷 및 보안 그룹을 지정합니다.

유형: VpcConfig

필수 항목 여부: 예

CloudFormation 호환성:이 속성은 AWS::Lambda::CapacityProvider 리소스의 VpcConfig 속성으로 직접 전달됩니다.

OperatorRole

고객 계정에서 Amazon EC2 인스턴스 및 관련 리소스를 생성하고 관리할 수 있는 권한이 있는 Lambda에 대한 연산자 역할의 ARN입니다. 제공되지 않은 경우는 필요한 권한이 있는 역할을 AWS SAM 자동으로 생성합니다.

유형: 문자열

필수 항목 여부: 아니요

CloudFormation 호환성:이 속성은 AWS::Lambda::CapacityProvider 리소스의 PermissionsConfig 속성으로 직접 전달됩니다.

Tags

용량 공급자 및 관련 리소스에 적용할 키-값 페어의 맵입니다.

유형: 맵

필수 항목 여부: 아니요

CloudFormation 호환성:이 속성은 AWS::Lambda::CapacityProvider 리소스의 Tags 속성으로 직접 전달됩니다. 의 Tags 속성은 키-값 페어로 AWS SAM 구성됩니다(이 CloudFormation 속성에서는 태그 객체 목록으로 구성됨). 또한는이 Lambda 함수와이 함수에 대해 생성된 기본 역할에 lambda:createdBy:SAM 태그를 AWS SAM 자동으로 추가합니다.

PropagateTags

태그 속성에서 AWS::Serverless::CapacityProvider 생성된 리소스로 태그를 전달할지 여부를 나타냅니다. 생성된 리소스에 태그를 전파True하려면이 값을 로 설정합니다.

유형: 부울

필수 항목 여부: 아니요

CloudFormation 호환성:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

InstanceRequirements

용량 공급자가 사용할 수 있는 컴퓨팅 인스턴스 유형에 대한 사양입니다. 여기에는 아키텍처 요구 사항 및 allowed 또는 excluded 인스턴스 유형이 포함됩니다.

유형: InstanceRequirements

필수 항목 여부: 아니요

CloudFormation compatibility:maps이 속성을에 AWS SAM 매핑합니다InstanceRequirements.

ScalingConfig

용량 공급자의 조정 구성입니다. 용량 공급자가 수요에 따라 Amazon EC2 인스턴스를 확장하는 방법을 정의합니다.

Type: ScalingConfig

필수 항목 여부: 아니요

CloudFormation 호환성:이 속성은 AWS::Lambda::CapacityProvider 리소스의 CapacityProviderScalingConfig 속성으로 직접 전달됩니다.

KMSKeyArn

용량 공급자의 저장 및 전송 중 데이터를 암호화하는 데 사용되는 AWS KMS 키의 ARN입니다.

유형: 문자열

필수 항목 여부: 아니요

CloudFormation 호환성:이 속성은 AWS::Lambda::Function 리소스의 KmsKeyArn 속성으로 직접 전달됩니다.

반환 값

Ref

이 리소스의 논리적 ID가 Ref 내장 함수에 제공되면 용량 공급자의 이름을 반환합니다.

Ref 함수의 사용에 대한 자세한 내용은 AWS CloudFormation 사용자 가이드의 Ref 섹션을 참조하세요.

Fn::GetAtt

Fn::GetAtt은 이 유형의 지정된 속성에 대한 값을 반환합니다. 다음은 사용 가능한 속성과 반환되는 샘플 값.

Fn::GetAtt의 사용에 대한 자세한 내용은 AWS CloudFormation 사용자 가이드의 Fn::GetAtt 섹션을 참조하세요.

Arn

용량 공급자의 ARN입니다.

예제

기본 용량 공급자

다음 예제에서는 VPC 구성을 사용하여 기본 용량 공급자를 생성합니다.

MyCapacityProvider:
  Type: AWS::Serverless::CapacityProvider
  Properties:
    CapacityProviderName: my-capacity-provider
    VpcConfig:
      SubnetIds:
        - subnet-12345678
        - subnet-87654321
      SecurityGroupIds:
        - sg-12345678
    Tags:
      Environment: Production
      Team: ServerlessTeam

확장 기능이 있는 고급 용량 공급자

다음 예시에서는 사용자 지정 인스턴스 요구 사항 및 조정 구성을 사용하여 용량 공급자를 생성합니다.

AdvancedCapacityProvider:
  Type: AWS::Serverless::CapacityProvider
  Properties:
    CapacityProviderName: advanced-capacity-provider
    VpcConfig:
      SubnetIds:
        - subnet-12345678
        - subnet-87654321
      SecurityGroupIds:
        - sg-12345678
    OperatorRole: arn:aws:iam::123456789012:role/MyCapacityProviderRole
    PropagateTags: true
    InstanceRequirements:
      Architectures:
        - x86_64
      ExcludedTypes:
        - t2.micro
    ScalingConfig:
      MaxInstanceCount: 10
      ManualScalingPolicies:
        AverageCPUUtilization: 70.0
    KMSKeyArn: arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012
    Tags:
      Environment: Production
      CostCenter: Engineering