View a markdown version of this page

AWS::Serverless::CapacityProvider - AWS Serverless Application Model
SyntaxEigenschaftenRückgabewerteBeispiele

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

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

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

Anmerkung

Wenn Sie es bereitstellen AWS CloudFormation, AWS SAM wandelt er Ihre Ressourcen in Ressourcen um. AWS SAM CloudFormation Weitere Informationen finden Sie unter Generiert CloudFormation Ressourcen für AWS SAM.

Syntax

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

Eigenschaften

CapacityProviderName

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 Eigenschaft einer AWS::Lambda::CapacityProvider Ressource übergeben.

VpcConfig

Die VPC-Konfiguration für den Kapazitätsanbieter. Gibt die VPC-Subnetze und Sicherheitsgruppen an, in denen Amazon EC2-Instances gestartet werden.

Typ: VpcConfig

Erforderlich: Ja

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die VpcConfig Eigenschaft einer Ressource übergeben. AWS::Lambda::CapacityProvider

OperatorRole

Der ARN der Operatorrolle für Lambda mit Berechtigungen zum Erstellen und Verwalten von Amazon EC2-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 Eigenschaft PermissionsConfig einer AWS::Lambda::CapacityProvider Ressource übergeben.

Tags

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

Gibt an, ob Tags aus der Tags-Eigenschaft an Ihre AWS::Serverless::CapacityProvider generierten Ressourcen übergeben werden sollen oder nicht. Setzen Sie diesen Wert aufTrue, 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 keine CloudFormation Entsprechung.

InstanceRequirements

Spezifikationen für die Typen von Recheninstanzen, die der Kapazitätsanbieter verwenden kann. Dazu gehören Architekturanforderungen allowed und/oder excluded Instanztypen.

Typ: InstanceRequirements

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die InstanceRequirements Eigenschaft einer AWS::Lambda::CapacityProvider Ressource übergeben.

ScalingConfig

Die Skalierungskonfiguration für den Kapazitätsanbieter. Definiert, wie der Kapazitätsanbieter Amazon EC2-Instances je nach Bedarf skaliert.

Typ: ScalingConfig

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die CapacityProviderScalingConfig Eigenschaft einer AWS::Lambda::CapacityProvider Ressource übergeben.

LoggingConfig

Wird verwendetLoggingConfig, um die Systemprotokollierung für den Kapazitätsanbieter zu konfigurieren. Systemprotokolle erfassen Skalierungsaktivitäten und Betriebsereignisse und senden sie auf konfigurierbarer CloudWatch Protokollebene an eine Amazon-Protokollgruppe.

Typ: CapacityProviderLoggingConfig

Required: No

CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die LoggingConfig Eigenschaft TelemetryConfig einer AWS::Lambda::CapacityProvider Ressource übergeben.

KmsKeyArn

Der ARN des AWS KMS Schlüssels, der zum Verschlüsseln 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 Eigenschaft einer AWS::Lambda::CapacityProvider Ressource übergeben.

ManagedResourceTags

Wendet explizite Tags auf die Amazon Elastic Compute Cloud-Instances und andere verwaltete Ressourcen an, die der Kapazitätsanbieter in Ihrem Namen bereitstellt.

Typ: ManagedResourceTags

Required: No

CloudFormation Kompatibilität: AWS SAM verwendet diese Eigenschaft, um die PropagateTags Eigenschaft einer AWS::Lambda::CapacityProvider Ressource zu erstellen.

Rückgabewerte

Punkt

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

Weitere Informationen zur Verwendung der Ref Funktion finden Sie Ref im AWS CloudFormation Benutzerhandbuch.

Fan:: GetAtt

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 Fn::GetAtt im AWS CloudFormation Benutzerhandbuch.

Arn

Der ARN des Kapazitätsanbieters.

Beispiele

Anbieter von Basiskapazität

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

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
    LoggingConfig:
      LogGroup: /aws/lambda/capacity-provider/advanced-capacity-provider
      SystemLogLevel: INFO
    ManagedResourceTags:
      Tags:
        CostCenter: cc-1234
        Environment: Production
    Tags:
      Environment: Production
      CostCenter: Engineering