Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

 Erstellt einen Kapazitätsanbieter für AWS Lambda Funktionen, der die Ausführung von Lambda Managed Instances auf kundeneigenen Amazon Elastic Compute Cloud-Instances ermöglicht. Diese Ressource ist Teil der Lambda Managed Instances-Funktion, die mithilfe von EC2 Amazon-Preismodellen eine Kostenoptimierung für umfangreiche Lambda-Workloads ermöglicht. 

 Der Kapazitätsanbieter verwaltet den Lebenszyklus von EC2 Amazon-Instances und stellt die erforderliche Infrastruktur bereit, damit Lambda-Funktionen auf kundeneigenen Rechenressourcen ausgeführt werden können, während das serverlose Programmiermodell beibehalten wird. 

**Anmerkung**  
Bei der Bereitstellung auf werden Ihre AWS CloudFormation AWS SAM Ressourcen in AWS SAM Ressourcen umgewandelt. CloudFormation Weitere Informationen finden Sie unter [Generierte CloudFormation Ressourcen für AWS SAM](sam-specification-generated-resources.md). 

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

Verwenden Sie die folgende Syntax, um diese Entität in Ihrer AWS Serverless Application Model (AWS SAM) -Vorlage zu deklarieren.

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

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

 `CapacityProviderName`   <a name="sam-capacityprovider-capacityprovidername"></a>
Der Name des Kapazitätsanbieters. Dieser Name muss innerhalb Ihres AWS Kontos und Ihrer Region eindeutig sein.  
*Typ:* Zeichenfolge  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[CapacityProviderName](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-capacityprovidername)` Eigenschaft einer `AWS::Lambda::CapacityProvider` Ressource übergeben. 

 `VpcConfig`   <a name="sam-capacityprovider-vpcconfig"></a>
Die VPC-Konfiguration für den Kapazitätsanbieter. Gibt die VPC-Subnetze und Sicherheitsgruppen an, in denen EC2 Amazon-Instances gestartet werden.  
*Typ:* [VpcConfig](sam-property-capacityprovider-vpcconfig.md)  
*Erforderlich*: Ja  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[VpcConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-vpcconfig)` Eigenschaft einer `AWS::Lambda::CapacityProvider` Ressource übergeben. 

 `OperatorRole`   <a name="sam-capacityprovider-operatorrole"></a>
 Der ARN der Operator-Rolle für Lambda mit Berechtigungen zum Erstellen und Verwalten von EC2 Amazon-Instances und zugehörigen Ressourcen im Kundenkonto. Falls nicht angegeben, AWS SAM wird automatisch eine Rolle mit den erforderlichen Berechtigungen generiert.  
*Typ:* Zeichenfolge  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[CapacityProviderOperatorRoleArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityproviderpermissionsconfig.html#cfn-lambda-capacityprovider-capacityproviderpermissionsconfig-capacityprovideroperatorrolearn)` Eigenschaft `[PermissionsConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-permissionsconfig)` einer `AWS::Lambda::CapacityProvider` Ressource übergeben. 

 `Tags`   <a name="sam-capacityprovider-tags"></a>
Eine Zuordnung von Schlüssel-Wert-Paaren, die auf den Kapazitätsanbieter und die zugehörigen Ressourcen angewendet werden sollen.  
*Typ: Karte*  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[Tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-tags)` Eigenschaft einer `AWS::Lambda::CapacityProvider` Ressource übergeben. Die `Tags` Eigenschaft in AWS SAM besteht aus Schlüssel-Wert-Paaren (wohingegen CloudFormation diese Eigenschaft aus einer Liste von Tag-Objekten besteht). Fügt dieser Lambda-Funktion und den für diese Funktion generierten Standardrollen außerdem AWS SAM automatisch ein `lambda:createdBy:SAM` Tag hinzu. 

 `PropagateTags`   <a name="sam-capacityprovider-propagatetags"></a>
 Gibt an, ob Tags aus der Tags-Eigenschaft an Ihre `AWS::Serverless::CapacityProvider` generierten Ressourcen übergeben werden sollen oder nicht. Stellen Sie dies auf ein`True`, um Tags in Ihren generierten Ressourcen zu verbreiten.   
*Typ*: Boolesch  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

 `InstanceRequirements`   <a name="sam-capacityprovider-instancerequirements"></a>
 Spezifikationen für die Typen von Recheninstanzen, die der Kapazitätsanbieter verwenden kann. Dazu gehören Architekturanforderungen `allowed` und/oder `excluded` Instanztypen.  
*Typ:* [InstanceRequirements](sam-property-capacityprovider-instancerequirements.md)  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[InstanceRequirements](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-instancerequirements)` Eigenschaft einer `AWS::Lambda::CapacityProvider` Ressource übergeben. 

 `ScalingConfig`   <a name="sam-capacityprovider-scalingconfig"></a>
 Die Skalierungskonfiguration für den Kapazitätsanbieter. Definiert, wie der Kapazitätsanbieter EC2 Amazon-Instances je nach Bedarf skaliert.  
*Typ:* [ScalingConfig](sam-property-capacityprovider-scalingconfig.md)  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[CapacityProviderScalingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig)` Eigenschaft einer `AWS::Lambda::CapacityProvider` Ressource übergeben. 

 `KmsKeyArn`   <a name="sam-capacityprovider-kmskeyarn"></a>
Der ARN des AWS KMS Schlüssels, der zur Verschlüsselung von Daten im Ruhezustand und bei der Übertragung für den Kapazitätsanbieter verwendet wird.  
*Typ:* Zeichenfolge  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[KmsKeyArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-kmskeyarn)` Eigenschaft einer `AWS::Lambda::CapacityProvider` Ressource übergeben. 

## Rückgabewerte
<a name="sam-resource-capacityprovider-return-values"></a>

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

Wenn die logische ID dieser Ressource für die `Ref` systeminterne Funktion bereitgestellt wird, gibt sie den Namen des Kapazitätsanbieters zurück.

Weitere Informationen zur Verwendung der `Ref` Funktion finden Sie [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)im *AWS CloudFormation Benutzerhandbuch*. 

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

`Fn::GetAtt` gibt einen Wert für ein angegebenes Attribut dieses Typs zurück. Im Folgenden sehen Sie die verfügbaren Attribute und Beispielrückgabewerte. 

Weitere Informationen zur Verwendung `Fn::GetAtt` finden Sie [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)im *AWS CloudFormation Benutzerhandbuch*. 

`Arn`  <a name="Arn-fn::getatt"></a>
Der ARN des Kapazitätsanbieters.

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

### Basiskapazitätsanbieter
<a name="sam-resource-capacityprovider-examples-basic"></a>

Im folgenden Beispiel wird ein Basiskapazitätsanbieter mit VPC-Konfiguration erstellt.

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

### Erweiterter Kapazitätsanbieter mit Skalierung
<a name="sam-resource-capacityprovider-examples-advanced"></a>

Im folgenden Beispiel wird ein Kapazitätsanbieter mit benutzerdefinierten Instanzanforderungen und Skalierungskonfiguration erstellt.

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

Konfiguriert die VPC-Einstellungen für einen Kapazitätsanbieter, einschließlich der Subnetze und Sicherheitsgruppen, in denen EC2 Instances gestartet werden.

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

Verwenden Sie die folgende Syntax, um diese Entität in Ihrer Vorlage AWS Serverless Application Model (AWS SAM) zu deklarieren.

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

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

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

 `SubnetIds`   <a name="sam-capacityprovider-vpcconfig-subnetids"></a>
Eine Liste der Subnetze IDs , in denen EC2 Instances gestartet werden. Es muss mindestens ein Subnetz angegeben werden.  
*Typ*: Liste  
*Erforderlich*: Ja  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[SubnetIds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityprovidervpcconfig.html#cfn-lambda-capacityprovider-capacityprovidervpcconfig-subnetids)` Eigenschaft `[VpcConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-vpcconfig) ` einer `AWS::Lambda::CapacityProvider` Ressource übergeben. 

 `SecurityGroupIds`   <a name="sam-capacityprovider-vpcconfig-securitygroupids"></a>
Eine Liste der Sicherheitsgruppen IDs , die den EC2 Instanzen zugeordnet werden sollen. Wenn nicht angegeben, wird die Standardsicherheitsgruppe für die VPC verwendet.  
*Typ*: Liste  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[SecurityGroupIds](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityprovidervpcconfig.html#cfn-lambda-capacityprovider-capacityprovidervpcconfig-securitygroupids)` Eigenschaft oder `[VpcConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-vpcconfig)` Eigenschaft einer `AWS::Lambda::CapacityProvider` Ressource übergeben. 

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

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

Das folgende Beispiel zeigt eine VPC-Konfiguration mit mehreren Subnetzen und Sicherheitsgruppen.

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

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

Spezifiziert die Anforderungen für EC2 Instances, die vom Kapazitätsanbieter gestartet werden, einschließlich Architekturen und Einschränkungen des Instanztyps.

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

Verwenden Sie die folgende Syntax, um diese Entität in Ihrer Vorlage AWS Serverless Application Model (AWS SAM) zu deklarieren.

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

**Anmerkung**  
Sie können wählen, ob Sie `ExcludedTypes` bei der Definition der Instanzanforderungen für Ihren Kapazitätsanbieter entweder eines `AllowedTypes` oder angeben möchten, aber nicht beide.

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

 `Architectures`   <a name="sam-capacityprovider-instancerequirements-architectures"></a>
Die Befehlssatzarchitekturen für die Kapazitätsanbieter-Instances.  
*Zulässige Werte*: `x86_64` oder `arm64`.  
*Typ*: Liste  
*Required*: No  
*Standardwert*: `x86_64`  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[Architectures](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-instancerequirements.html#cfn-lambda-capacityprovider-instancerequirements-architectures)` Eigenschaft `[InstanceRequirements](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-instancerequirements)` einer `AWS::Lambda::CapacityProvider` Ressource übergeben. 

 `AllowedTypes`   <a name="sam-capacityprovider-instancerequirements-allowedtypes"></a>
Eine Liste der zulässigen EC2 Instanztypen für die Kapazitätsanbieter-Instanz.  
*Typ*: Liste  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[AllowedInstanceTypes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-instancerequirements.html#cfn-lambda-capacityprovider-instancerequirements-allowedinstancetypes)` Eigenschaft `[InstanceRequirements](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-instancerequirements)` einer `AWS::Lambda::CapacityProvider` Ressource übergeben. 

 `ExcludedTypes`   <a name="sam-capacityprovider-instancerequirements-excludedtypes"></a>
Eine Liste von EC2 Instance-Typen, die vom Kapazitätsanbieter ausgeschlossen werden sollen.  
*Typ*: Liste  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[ExcludedInstanceTypes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-instancerequirements.html#cfn-lambda-capacityprovider-instancerequirements-excludedinstancetypes)` Eigenschaft `[InstanceRequirements](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-instancerequirements)` einer `AWS::Lambda::CapacityProvider` Ressource übergeben. 

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

### Konfiguration der Instanzanforderungen
<a name="sam-property-capacityprovider-instancerequirements-examples-basic"></a>

Das folgende Beispiel zeigt Instanzanforderungen mit spezifischen Einschränkungen für Architektur und Instanztyp.

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

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

Konfiguriert, wie der Kapazitätsanbieter EC2 Instances je nach Bedarf skaliert, einschließlich maximaler Instanzlimits und Skalierungsrichtlinien.

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

Verwenden Sie die folgende Syntax, um diese Entität in Ihrer Vorlage AWS Serverless Application Model (AWS SAM) zu deklarieren.

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

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

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

 `MaxVCpuCount`   <a name="sam-capacityprovider-scalingconfig-maxvcpucount"></a>
Die maximale Anzahl von vCPUs , die der Kapazitätsanbieter für alle Recheninstanzen bereitstellen kann.  
*Typ*: Ganzzahl  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[MaxVCpuCount](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityproviderscalingconfig.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig-maxvcpucount)` Eigenschaft `[CapacityProviderScalingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig)` einer `AWS::Lambda::CapacityProvider` Ressource übergeben. 

 `AverageCPUUtilization`   <a name="sam-capacityprovider-scalingconfig-averagecpuutilization"></a>
Der angestrebte durchschnittliche Prozentsatz der CPU-Auslastung (0-100) für Skalierungsentscheidungen. Wenn die durchschnittliche CPU-Auslastung diesen Schwellenwert überschreitet, skaliert der Kapazitätsanbieter EC2 Amazon-Instances. Falls angegeben, AWS SAM Konstrukte `[CapacityProviderScalingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig)` einer `AWS::Lambda::CapacityProvider` Ressource mit den Werten „auf“ `'Manual'` und `[ScalingMode](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityproviderscalingconfig.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig-scalingmode)` „`[ScalingPolicies](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-lambda-capacityprovider-capacityproviderscalingconfig.html#cfn-lambda-capacityprovider-capacityproviderscalingconfig-scalingpolicies)`gesetzt auf`[{PredefinedMetricType: 'LambdaCapacityProviderAverageCPUUtilization', TargetValue: <this value>}]`“.   
*Type*: Double  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent. 

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

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

Das folgende Beispiel zeigt eine Skalierungskonfiguration mit maximaler VCpu Anzahl und durchschnittlicher CPU-Auslastung.

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