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

# AWS::Serverless::CapacityProvider
<a name="sam-resource-capacityprovider"></a>

 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 EC2 instans Amazon 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](sam-specification-generated-resources.md). 

## Sintaksis
<a name="sam-resource-capacityprovider-syntax"></a>

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

### YAML
<a name="sam-resource-capacityprovider-syntax.yaml"></a>

```
Type: AWS::Serverless::CapacityProvider
Properties:
  [CapacityProviderName](#sam-capacityprovider-capacityprovidername): String
  [VpcConfig](#sam-capacityprovider-vpcconfig): VpcConfig
  [OperatorRole](#sam-capacityprovider-operatorrole): String
  [Tags](#sam-capacityprovider-tags): Map
  [PropagateTags](#sam-capacityprovider-propagatetags): Boolean
  [InstanceRequirements](#sam-capacityprovider-instancerequirements): InstanceRequirements
  [ScalingConfig](#sam-capacityprovider-scalingconfig): ScalingConfig
  [KmsKeyArn](#sam-capacityprovider-kmskeyarn): String
```

## Sifat-sifat
<a name="sam-resource-capacityprovider-properties"></a>

 `CapacityProviderName`   <a name="sam-capacityprovider-capacityprovidername"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-capacityprovidername)` properti `AWS::Lambda::CapacityProvider` sumber daya. 

 `VpcConfig`   <a name="sam-capacityprovider-vpcconfig"></a>
Konfigurasi VPC untuk penyedia kapasitas. Menentukan subnet VPC dan grup keamanan tempat instans EC2 Amazon akan diluncurkan.  
*Jenis*: [VpcConfig](sam-property-capacityprovider-vpcconfig.md)  
*Wajib*: Ya  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[VpcConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-vpcconfig)` properti `AWS::Lambda::CapacityProvider` sumber daya. 

 `OperatorRole`   <a name="sam-capacityprovider-operatorrole"></a>
 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 `[CapacityProviderOperatorRoleArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityproviderpermissionsconfig.html#cfn-lambda-capacityprovider-capacityproviderpermissionsconfig-capacityprovideroperatorrolearn)` properti `[PermissionsConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-permissionsconfig)` `AWS::Lambda::CapacityProvider` sumber daya. 

 `Tags`   <a name="sam-capacityprovider-tags"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-tags)` properti `AWS::Lambda::CapacityProvider` sumber daya. `Tags`Properti 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`   <a name="sam-capacityprovider-propagatetags"></a>
 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`   <a name="sam-capacityprovider-instancerequirements"></a>
 Spesifikasi untuk jenis contoh komputasi yang dapat digunakan oleh penyedia kapasitas. Ini termasuk persyaratan arsitektur dan `allowed` atau jenis `excluded` instance.  
*Jenis*: [InstanceRequirements](sam-property-capacityprovider-instancerequirements.md)  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[InstanceRequirements](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-instancerequirements)` properti `AWS::Lambda::CapacityProvider` sumber daya. 

 `ScalingConfig`   <a name="sam-capacityprovider-scalingconfig"></a>
 Konfigurasi penskalaan untuk penyedia kapasitas. Mendefinisikan bagaimana penyedia kapasitas menskalakan EC2 instans Amazon berdasarkan permintaan.  
*Jenis*: [ScalingConfig](sam-property-capacityprovider-scalingconfig.md)  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[CapacityProviderScalingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig)` properti `AWS::Lambda::CapacityProvider` sumber daya. 

 `KmsKeyArn`   <a name="sam-capacityprovider-kmskeyarn"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-kmskeyarn)` properti `AWS::Lambda::CapacityProvider` sumber daya. 

## Nilai Pengembalian
<a name="sam-resource-capacityprovider-return-values"></a>

### Ref
<a name="sam-resource-capacityprovider-return-values-ref"></a>

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 [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html) di *Panduan Pengguna AWS CloudFormation *. 

### Fn:: GetAtt
<a name="sam-resource-capacityprovider-return-values-fn--getatt"></a>

`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 [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html) di *Panduan Pengguna AWS CloudFormation * 

`Arn`  <a name="Arn-fn::getatt"></a>
ARN dari penyedia kapasitas.

## Contoh
<a name="sam-resource-capacityprovider-examples"></a>

### Penyedia kapasitas dasar
<a name="sam-resource-capacityprovider-examples-basic"></a>

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
<a name="sam-resource-capacityprovider-examples-advanced"></a>

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
```