View a markdown version of this page

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 Amazon EC2.

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

catatan

Saat Anda menerapkan ke AWS CloudFormation, ubah AWS SAM sumber AWS SAM daya Anda menjadi CloudFormation sumber daya. Untuk informasi selengkapnya, lihat Dihasilkan CloudFormation sumber daya untuk AWS SAM.

Sintaksis

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

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 diteruskan langsung ke CapacityProviderName properti sumber AWS::Lambda::CapacityProvider daya.

VpcConfig

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

Jenis: VpcConfig

Wajib: Ya

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

OperatorRole

ARN peran operator untuk Lambda dengan izin untuk membuat dan mengelola instans Amazon EC2 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 CapacityProviderOperatorRoleArn properti PermissionsConfig sumber AWS::Lambda::CapacityProvider daya.

Tags

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

Tipe: Peta

Wajib: Tidak

CloudFormation kompatibilitas: Properti ini diteruskan langsung ke Tags properti sumber AWS::Lambda::CapacityProvider daya. Pro Tags perti di AWS SAM terdiri dari pasangan kunci-nilai (sedangkan dalam properti CloudFormation ini terdiri dari daftar objek Tag). Juga, 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 AWS::Serverless::CapacityProvider yang dihasilkan atau tidak. Setel ini True untuk menyebarkan tag di sumber daya yang Anda buat.

Tipe: Boolean

Wajib: Tidak

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

InstanceRequirements

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

Jenis: InstanceRequirements

Wajib: Tidak

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

ScalingConfig

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

Jenis: ScalingConfig

Wajib: Tidak

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

LoggingConfig

Gunakan LoggingConfig untuk mengkonfigurasi pencatatan sistem untuk penyedia kapasitas. Log sistem menangkap aktivitas penskalaan dan peristiwa operasional dan mengirimkannya ke grup CloudWatch log Amazon pada tingkat log yang dapat dikonfigurasi.

Jenis: CapacityProviderLoggingConfig

Wajib: Tidak

CloudFormation kompatibilitas: Properti ini diteruskan langsung ke LoggingConfig properti TelemetryConfig sumber AWS::Lambda::CapacityProvider daya.

KmsKeyArn

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

Tipe: String

Wajib: Tidak

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

ManagedResourceTags

Menerapkan tag eksplisit ke instans Amazon Elastic Compute Cloud dan sumber daya terkelola lainnya yang disediakan penyedia kapasitas atas nama Anda.

Jenis: ManagedResourceTags

Wajib: Tidak

CloudFormation kompatibilitas: AWS SAM menggunakan properti ini untuk membangun PropagateTags properti sumber AWS::Lambda::CapacityProvider daya.

Nilai Pengembalian

Referensi

Ketika ID logis sumber daya ini diberikan ke 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 lanjutan dengan penskalaan

Contoh berikut membuat penyedia kapasitas dengan persyaratan instans kustom 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
    LoggingConfig:
      LogGroup: /aws/lambda/capacity-provider/advanced-capacity-provider
      SystemLogLevel: INFO
    ManagedResourceTags:
      Tags:
        CostCenter: cc-1234
        Environment: Production
    Tags:
      Environment: Production
      CostCenter: Engineering