View a markdown version of this page

AWS::Serverless::CapacityProvider - AWS Serverless Application Model
SyntaxePropriétésValeurs renvoyéesExemples

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

AWS::Serverless::CapacityProvider

Crée un fournisseur de capacité pour les AWS Lambda fonctions qui permettent d'exécuter des instances gérées Lambda sur des instances Amazon Elastic Compute Cloud appartenant au client. Cette ressource fait partie de la fonctionnalité Lambda Managed Instances, qui permet d'optimiser les coûts pour les charges de travail Lambda à grande échelle en utilisant les modèles de tarification Amazon EC2.

Le fournisseur de capacité gère le cycle de vie des instances Amazon EC2 et fournit l'infrastructure nécessaire pour que les fonctions Lambda s'exécutent sur les ressources de calcul appartenant au client tout en conservant le modèle de programmation sans serveur.

Note

Lorsque vous déployez vers AWS CloudFormation, AWS SAM transformez vos AWS SAM ressources en CloudFormation ressources. Pour de plus amples informations, veuillez consulter Générées CloudFormation ressources pour AWS SAM.

Syntaxe

Pour déclarer cette entité dans votre modèle AWS Serverless Application Model (AWS SAM), utilisez la syntaxe suivante.

Propriétés

CapacityProviderName

Nom du fournisseur de capacité. Ce nom doit être unique au sein de votre AWS compte et de votre région.

Type : chaîne

Obligatoire : non

CloudFormation compatibilité  : cette propriété est transmise directement à la CapacityProviderName propriété d'une AWS::Lambda::CapacityProvider ressource.

VpcConfig

Configuration du VPC pour le fournisseur de capacité. Spécifie les sous-réseaux VPC et les groupes de sécurité dans lesquels les instances Amazon EC2 seront lancées.

Type : VpcConfig

Obligatoire : oui

CloudFormation compatibilité  : cette propriété est transmise directement à la VpcConfig propriété d'une AWS::Lambda::CapacityProvider ressource.

OperatorRole

L'ARN du rôle d'opérateur pour Lambda avec les autorisations nécessaires pour créer et gérer des instances Amazon EC2 et les ressources associées dans le compte client. S'il n'est pas fourni, génère AWS SAM automatiquement un rôle avec les autorisations nécessaires.

Type : chaîne

Obligatoire : non

CloudFormation compatibilité  : cette propriété est transmise directement à la CapacityProviderOperatorRoleArn propriété PermissionsConfig d'une AWS::Lambda::CapacityProvider ressource.

Tags

Carte des paires clé-valeur à appliquer au fournisseur de capacité et à ses ressources associées.

Type: carte (map)

Obligatoire : non

CloudFormation compatibilité  : cette propriété est transmise directement à la Tags propriété d'une AWS::Lambda::CapacityProvider ressource. La Tags propriété in AWS SAM se compose de paires clé-valeur (alors que CloudFormation cette propriété consiste en une liste d'objets Tag). Ajoute également AWS SAM automatiquement une lambda:createdBy:SAM balise à cette fonction Lambda et aux rôles par défaut générés pour cette fonction.

PropagateTags

Indique s'il faut transmettre ou non les balises de la propriété Tags à vos ressources AWS::Serverless::CapacityProvider générées. Réglez cette option sur True pour propager les balises dans les ressources que vous avez générées.

Type : valeur booléenne

Obligatoire : non

CloudFormation compatibilité  : cette propriété est unique AWS SAM et n'a pas d' CloudFormation équivalent.

InstanceRequirements

Spécifications relatives aux types d'instances de calcul que le fournisseur de capacité peut utiliser. Cela inclut les exigences en matière d'architecture allowed et/ou les types d'excludedinstances.

Type : InstanceRequirements

Obligatoire : non

CloudFormation compatibilité  : cette propriété est transmise directement à la InstanceRequirements propriété d'une AWS::Lambda::CapacityProvider ressource.

ScalingConfig

Configuration de dimensionnement pour le fournisseur de capacité. Définit la manière dont le fournisseur de capacité fait évoluer les instances Amazon EC2 en fonction de la demande.

Type : ScalingConfig

Obligatoire : non

CloudFormation compatibilité  : cette propriété est transmise directement à la CapacityProviderScalingConfig propriété d'une AWS::Lambda::CapacityProvider ressource.

LoggingConfig

Permet LoggingConfig de configurer la journalisation du système pour le fournisseur de capacité. Les journaux système capturent l'activité de mise à l'échelle et les événements opérationnels et les envoient à un groupe de CloudWatch journaux Amazon à un niveau de journal configurable.

Type : CapacityProviderLoggingConfig

Obligatoire : non

CloudFormation compatibilité  : cette propriété est transmise directement à la LoggingConfig propriété TelemetryConfig d'une AWS::Lambda::CapacityProvider ressource.

KmsKeyArn

L'ARN de la AWS KMS clé utilisée pour chiffrer les données au repos et en transit pour le fournisseur de capacité.

Type : chaîne

Obligatoire : non

CloudFormation compatibilité  : cette propriété est transmise directement à la KmsKeyArn propriété d'une AWS::Lambda::CapacityProvider ressource.

ManagedResourceTags

Applique des balises explicites aux instances Amazon Elastic Compute Cloud et aux autres ressources gérées que le fournisseur de capacité fournit en votre nom.

Type : ManagedResourceTags

Obligatoire : non

CloudFormation compatibilité  : AWS SAM utilise cette propriété pour construire la PropagateTags propriété d'une AWS::Lambda::CapacityProvider ressource.

Valeurs renvoyées

Réf

Lorsque l'ID logique de cette ressource est fourni à la fonction Ref intrinsèque, elle renvoie le nom du fournisseur de capacité.

Pour plus d'informations sur l'utilisation de la fonction Ref, consultez Ref dans le Guide de l'utilisateur AWS CloudFormation .

Ventilateur : GetAtt

Fn::GetAtt renvoie une valeur pour un attribut de ce type indiqué. Voici les attributs disponibles et des exemples de valeurs de retour.

Pour plus d'informations sur l'utilisation de Fn::GetAtt, consultez Fn::GetAtt dans le Guide de l'utilisateur AWS CloudFormation .

Arn

L'ARN du fournisseur de capacité.

Exemples

Fournisseur de capacités de base

L'exemple suivant crée un fournisseur de capacité de base avec une configuration 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

Fournisseur de capacités avancé avec évolutivité

L'exemple suivant crée un fournisseur de capacité avec des exigences d'instance personnalisées et une configuration de dimensionnement.

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