AWS::Serverless::CapacityProvider - AWS Serverless Application Model
SintaksisSifat-sifatNilai PengembalianContoh

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AWS::Serverless::CapacityProvider

Membuat penyedia kapasitas untuk AWS Lambda fungsi yang memungkinkan menjalankan Instans Terkelola Lambda pada instans Amazon Elastic Compute Cloud milik pelanggan. Sumber daya ini merupakan bagian dari fitur Instans Terkelola Lambda, yang menyediakan pengoptimalan biaya untuk beban kerja Lambda skala besar dengan memanfaatkan model penetapan harga. EC2

Penyedia kapasitas mengelola siklus hidup EC2 instance dan menyediakan infrastruktur yang diperlukan untuk fungsi Lambda untuk dijalankan pada sumber daya komputasi milik pelanggan sambil mempertahankan model pemrograman tanpa server.

catatan

Ketika Anda menyebarkan ke AWS CloudFormation, AWS SAM mengubah AWS SAM sumber daya Anda menjadi CloudFormation sumber daya. Untuk informasi selengkapnya, lihat CloudFormation Sumber daya yang dihasilkan untuk AWS SAM.

Sintaksis

Untuk mendeklarasikan entitas ini dalam template AWS Serverless Application Model (AWS SAM) Anda, gunakan sintaks berikut.

YAML

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

Sifat-sifat

CapacityProviderName

Nama dari penyedia kapasitas. Nama ini harus unik dalam AWS akun dan wilayah Anda.

Tipe: String

Wajib: Tidak

CloudFormation kompatibilitas: Properti ini mirip dengan CapacityProviderName properti AWS::Lambda::CapacityProvider sumber daya.

VpcConfig

Konfigurasi VPC untuk penyedia kapasitas. Menentukan subnet VPC dan grup keamanan tempat instans EC2 Amazon akan diluncurkan.

Jenis: VpcConfig

Wajib: Ya

CloudFormation kompatibilitas: Properti ini diteruskan langsung ke VpcConfigproperti AWS::Lambda::CapacityProvider sumber daya.

OperatorRole

ARN peran operator untuk Lambda dengan izin untuk membuat dan mengelola EC2 instans Amazon dan sumber daya terkait di akun pelanggan. Jika tidak disediakan, AWS SAM secara otomatis menghasilkan peran dengan izin yang diperlukan.

Tipe: String

Wajib: Tidak

CloudFormation kompatibilitas: Properti ini diteruskan langsung ke PermissionsConfigproperti AWS::Lambda::CapacityProvider sumber daya.

Tags

Peta pasangan nilai kunci untuk diterapkan pada penyedia kapasitas dan sumber daya terkaitnya.

Tipe: Peta

Wajib: Tidak

CloudFormation kompatibilitas: Properti ini diteruskan langsung ke Tags properti AWS::Lambda::CapacityProvider sumber daya. TagsProperti di AWS SAM terdiri dari pasangan kunci-nilai (sedangkan dalam properti CloudFormation ini terdiri dari daftar objek Tag). Selain itu, AWS SAM secara otomatis menambahkan lambda:createdBy:SAM tag ke fungsi Lambda ini, dan ke peran default yang dihasilkan untuk fungsi ini.

PropagateTags

Menunjukkan apakah akan meneruskan tag dari properti Tag ke sumber daya yang Anda AWS::Serverless::CapacityProvider hasilkan atau tidak. Setel ini True untuk menyebarkan tag di sumber daya yang Anda hasilkan.

Tipe: Boolean

Wajib: Tidak

CloudFormation kompatibilitas: Properti ini unik AWS SAM dan tidak memiliki CloudFormation padanan.

InstanceRequirements

Spesifikasi untuk jenis contoh komputasi yang dapat digunakan oleh penyedia kapasitas. Ini termasuk persyaratan arsitektur dan allowed atau jenis excluded instance.

Jenis: InstanceRequirements

Wajib: Tidak

CloudFormation kompatibilitas: AWS SAM memetakan properti ini keInstanceRequirements.

ScalingConfig

Konfigurasi penskalaan untuk penyedia kapasitas. Mendefinisikan bagaimana penyedia kapasitas menskalakan EC2 instans Amazon berdasarkan permintaan.

Jenis: ScalingConfig

Wajib: Tidak

CloudFormation kompatibilitas: Properti ini diteruskan langsung ke CapacityProviderScalingConfig properti AWS::Lambda::CapacityProvider sumber daya

KMSKeyArn

ARN dari AWS KMS kunci yang digunakan untuk mengenkripsi data saat istirahat dan dalam perjalanan untuk penyedia kapasitas.

Tipe: String

Wajib: Tidak

CloudFormation kompatibilitas: Properti ini diteruskan langsung ke KmsKeyArn properti AWS::Lambda::Function sumber daya.

Nilai Pengembalian

Ref

Ketika ID logis dari sumber daya ini disediakan untuk fungsi Ref intrinsik, ia mengembalikan nama penyedia kapasitas.

Untuk informasi lebih lanjut tentang menggunakan fungsi Ref, lihat Ref di Panduan Pengguna AWS CloudFormation .

Fn:: GetAtt

Fn::GetAtt mengembalikan nilai untuk atribut yang ditentukan dari jenis ini. Berikut ini adalah atribut yang tersedia dan nilai-nilai kembali sampel.

Untuk informasi lebih lanjut tentang Fn::GetAtt, lihat Fn::GetAtt di Panduan Pengguna AWS CloudFormation

Arn

ARN dari penyedia kapasitas.

Contoh

Penyedia kapasitas dasar

Contoh berikut membuat penyedia kapasitas dasar dengan konfigurasi 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

Penyedia kapasitas canggih dengan penskalaan

Contoh berikut membuat penyedia kapasitas dengan persyaratan instance khusus dan konfigurasi penskalaan.

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