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

# VpcConfig
<a name="sam-property-capacityprovider-vpcconfig"></a>

Mengkonfigurasi pengaturan VPC untuk penyedia kapasitas, termasuk subnet dan grup keamanan EC2 tempat instance akan diluncurkan.

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

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

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

```
[SubnetIds](#sam-capacityprovider-vpcconfig-subnetids): List
[SecurityGroupIds](#sam-capacityprovider-vpcconfig-securitygroupids): List
```

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

 `SubnetIds`   <a name="sam-capacityprovider-vpcconfig-subnetids"></a>
Daftar subnet IDs tempat EC2 instance akan diluncurkan. Setidaknya satu subnet harus ditentukan.  
*Tipe*: Daftar  
*Wajib*: Ya  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[SubnetIds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityprovidervpcconfig.html#cfn-lambda-capacityprovider-capacityprovidervpcconfig-subnetids)` properti `[VpcConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-vpcconfig) ` `AWS::Lambda::CapacityProvider` sumber daya. 

 `SecurityGroupIds`   <a name="sam-capacityprovider-vpcconfig-securitygroupids"></a>
Daftar grup keamanan IDs untuk diasosiasikan dengan EC2 instance. Jika tidak ditentukan, grup keamanan default untuk VPC akan digunakan.  
*Tipe*: Daftar  
*Wajib*: Tidak  
*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 properti `AWS::Lambda::CapacityProvider` sumber daya. `[SecurityGroupIds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityprovidervpcconfig.html#cfn-lambda-capacityprovider-capacityprovidervpcconfig-securitygroupids)` 

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

### Konfigurasi VPC
<a name="sam-property-capacityprovider-vpcconfig-examples-basic"></a>

Contoh berikut menunjukkan konfigurasi VPC dengan beberapa subnet dan grup keamanan.

```
VpcConfig:
  SubnetIds:
    - subnet-12345678
    - subnet-87654321
  SecurityGroupIds:
    - sg-12345678
    - sg-87654321
```

# InstanceRequirements
<a name="sam-property-capacityprovider-instancerequirements"></a>

Menentukan persyaratan untuk EC2 instance yang akan diluncurkan oleh penyedia kapasitas, termasuk arsitektur dan batasan tipe instans.

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

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

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

```
[Architectures](#sam-capacityprovider-instancerequirements-architectures): List
[AllowedTypes](#sam-capacityprovider-instancerequirements-allowedtypes): List
[ExcludedTypes](#sam-capacityprovider-instancerequirements-excludedtypes): List
```

**catatan**  
Anda dapat memilih untuk menentukan salah satu `AllowedTypes` atau `ExcludedTypes` saat menentukan persyaratan instans untuk penyedia kapasitas Anda, tetapi tidak keduanya.

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

 `Architectures`   <a name="sam-capacityprovider-instancerequirements-architectures"></a>
Instruksi mengatur arsitektur untuk instance penyedia kapasitas.  
*Nilai yang valid*: `x86_64` atau `arm64`  
*Tipe*: Daftar  
*Wajib*: Tidak  
*Default*: `x86_64`  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[Architectures](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-instancerequirements.html#cfn-lambda-capacityprovider-instancerequirements-architectures)` properti `[InstanceRequirements](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-instancerequirements)` `AWS::Lambda::CapacityProvider` sumber daya. 

 `AllowedTypes`   <a name="sam-capacityprovider-instancerequirements-allowedtypes"></a>
Daftar jenis EC2 instans yang diizinkan untuk instance penyedia kapasitas.  
*Tipe*: Daftar  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[AllowedInstanceTypes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-instancerequirements.html#cfn-lambda-capacityprovider-instancerequirements-allowedinstancetypes)` properti `[InstanceRequirements](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-instancerequirements)` `AWS::Lambda::CapacityProvider` sumber daya. 

 `ExcludedTypes`   <a name="sam-capacityprovider-instancerequirements-excludedtypes"></a>
Daftar jenis EC2 instance untuk dikecualikan dari penyedia kapasitas.  
*Tipe*: Daftar  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[ExcludedInstanceTypes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-instancerequirements.html#cfn-lambda-capacityprovider-instancerequirements-excludedinstancetypes)` properti `[InstanceRequirements](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-instancerequirements)` `AWS::Lambda::CapacityProvider` sumber daya. 

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

### Konfigurasi persyaratan instans
<a name="sam-property-capacityprovider-instancerequirements-examples-basic"></a>

Contoh berikut menunjukkan persyaratan instance dengan arsitektur tertentu dan batasan tipe instance.

```
InstanceRequirements:
  Architectures:
    - x86_64
  ExcludedTypes:
    - t2.micro
```

# ScalingConfig
<a name="sam-property-capacityprovider-scalingconfig"></a>

Mengonfigurasi cara penyedia kapasitas EC2 menskalakan instans berdasarkan permintaan, termasuk batas instans maksimum dan kebijakan penskalaan.

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

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

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

```
[MaxVCpuCount](#sam-capacityprovider-scalingconfig-maxvcpucount): Integer
[AverageCPUUtilization](#sam-capacityprovider-scalingconfig-averagecpuutilization): Double
```

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

 `MaxVCpuCount`   <a name="sam-capacityprovider-scalingconfig-maxvcpucount"></a>
Jumlah maksimum v CPUs yang dapat disediakan oleh penyedia kapasitas di semua instance komputasi.  
*Tipe*: Integer  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[MaxVCpuCount](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityproviderscalingconfig.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig-maxvcpucount)` properti `[CapacityProviderScalingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig)` `AWS::Lambda::CapacityProvider` sumber daya. 

 `AverageCPUUtilization`   <a name="sam-capacityprovider-scalingconfig-averagecpuutilization"></a>
Target rata-rata persentase pemanfaatan CPU (0-100) untuk keputusan penskalaan. Ketika penggunaan CPU rata-rata melebihi ambang batas ini, penyedia kapasitas akan meningkatkan EC2 instans Amazon. Ketika ditentukan, AWS SAM konstruksi `[CapacityProviderScalingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig)` `AWS::Lambda::CapacityProvider` sumber daya dengan `[ScalingMode](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityproviderscalingconfig.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig-scalingmode)` set ke `'Manual'` dan `[ScalingPolicies](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityproviderscalingconfig.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig-scalingpolicies)` set ke`[{PredefinedMetricType: 'LambdaCapacityProviderAverageCPUUtilization', TargetValue: <this value>}]`.   
*Tipe*: Ganda  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini unik AWS SAM dan tidak memiliki CloudFormation padanan. 

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

### Konfigurasi penskalaan
<a name="sam-property-capacityprovider-scalingconfig-examples-basic"></a>

Contoh berikut menunjukkan konfigurasi penskalaan dengan VCpu jumlah maksimum dan pemanfaatan CPU rata-rata.

```
ScalingConfig:
  MaxVCpuCount: 10
  AverageCPUUtilization: 70.0
```